Mobile Transfers - Airtel Money - ZamuPay API Documentation

Zamupay 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:
https://docs.zamupay.com/data-types-1946182m0
and scroll to the MCCMNC codes section.

Use the Find Transaction Routes API:
https://docs.zamupay.com/find-transaction-routes-25375898e0
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"
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Mobile Transfers - Airtel Money

Sample Mobile Transfer Request - Airtel Money#

Sample Response#

Request

Responses

Sample Mobile Transfer Request - Airtel Money

Sample Response