1. Mobile Money Requests
Almara Pay Documentation
  • Introduction
  • Definitions
    • Data Types
    • Error Codes
    • MCCMNC Codes
  • Authorization
    • Overview
    • Token Request
      POST
    • Find Transaction Routes
      GET
    • Health Check
      GET
  • Payouts
    • Overview
    • Payment Order Request Information
    • Mobile Money Requests
      • Overview
      • Mobile Transfers- Safaricom (M-Pesa)
        POST
      • Mobile Transfers - Airtel Money
        POST
    • Payment Order Requests - Business Transfers
      POST
    • Payment Order Requests - Bank Transfers
      POST
    • Find Payment Order By OriginatorConversationId
      GET
    • Reject Order By OriginatorConversationId
      POST
  • Pay-Ins
    • Payment Links
      • Overview
      • Create Payment Link
      • Find Payment Links By Id
      • Update Payment Link
    • Express Deposits
      • Overview
      • Express Deposit Request
      • Find Express Deposit By OriginatorConversationId
    • C2B IPN (Callback)
      • C2B IPN Overview
  • Card Payments
    • Overview
    • Checkout Order Request
      POST
    • Query Checkout Request
      GET
    • Checkout Callback Request
      POST
  • Account Validation
    • Overview
    • Account Number Validation Request
    • Find KYC Status by SystemTraceAuditNumber
    • Account Validation
    • Find Account Validation Status by SystemTraceAuditNumber
  • Platform Services
    • Airtime Purchase
      • Overview
      • Airtime Purchase
      • Find Airtime Purchases By OriginatorConversationId
    • Customer Accounts
      • Balance Check
      • Find Charges By TransactionTypeId
    • Bill Payments
      • Overview
      • Bill Request Validation
      • Bill Request Payment
      • Find Bill Services
      • Find Bill Number By Service Id and Account Number
      • Find Bill Request By Originator Converstion Id
      • Bill Number
  1. Mobile Money Requests

Mobile Transfers - Airtel Money

Developing
POST
/v1/payment-order/new-order
Almara Pay supports outbound payments (B2C) via Mobile Transfers to Airtel Money wallets.
This integration is for Airtel Money.
Confirm the MCCMNC codes from the Zamupay Data Types Documentation:
and scroll to the MCCMNC codes section.
Use the Find Transaction Routes API:
to get the route ID and channel type.
Note: A valid token is required for authentication as it expires every hour. Refer to Token Request to generate a new token.

Sample Mobile Transfer Request - Airtel Money#

{
	"originatorConversationId": "BBS217380556926",
	"paymentNotes": "Derick Koskei",
	"paymentOrderLines": [
		{
			"remitter": {
				"name": "Nicholas Kimeli Koskei",
				"address": "74 Honeywell Blvd Mirrabooka Perth",
				"phoneNumber": "+41478565808",
				"idType": "National ID",
				"idNumber": "189537279",
				"dateOfBirth": "1997/08/14",
				"country": "AU",
				"nationality": "AU",
				"ccy": 36,
				"financialInstitution": "TFS",
				"sourceOfFunds": "Salary",
				"principalActivity": "Family"
			},
			"recipient": {
				"name": "Juliet Kimeli",
				"phoneNumber": "+254777772240",  // Airtel based Phone number
				"financialInstitution": null,
				"primaryAccountNumber": "+254799992240", // Airtel based Phone number
				"address": "Kenya",
				"idNumber": "22068155",
				"mccmnc": "63902", //  Airtel
				"ccy": 404,
				"country": "KE",
				"purpose": "Family",
				"institutionIdentifier": null
			},
			"transaction": {
				"routeId": "4a45b519-0d3b-1111-8286-062ab3a3eac8",
				"ChannelType": 1,
				"amount": 1100,
				"reference": "ABC123TT",
				"systemTraceAuditNumber": "DDS217380BB6"
			}
		}
	]
}

Sample Response#

{
  "message": {
    "appDomainName": "LIVE",
    "systemConversationId": "16780000-a97d-3024-8e07-08d93713929d",
    "originatorConversationId": "origiqjwwqwqnnmqeqersationId",
    "remarks": "order submission accepted",
    "timestamp": "2021-06-24T13:25:49.5292326Z"
  }
}

Request

Authorization

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/payment-order/new-order'
Response Response Example
{}
Modified at 2026-04-30 06:15:45
Previous
Mobile Transfers- Safaricom (M-Pesa)
Next
Payment Order Requests - Business Transfers
Built with