1. Mobile Money Requests
Monexia Documentation
  • Introduction
  • Definitions
    • Data Types
    • Callbacks Overview
    • Monexia Transactions Response Codes for Payouts
    • MCCMNC Codes
    • API Credentials
  • 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
  • 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 By Currency Code
      • 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 Saving
  1. Mobile Money Requests

Mobile Transfers - Airtel Money

Developing
POST
/v1/payment-order/new-order
Monexia supports outbound payments (B2C) via Mobile Transfers to Airtel Money wallets.
This integration is for Airtel Money.
Confirm the MCCMNC codes from 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 Koskei",
				"address": "74 Honeywell",
				"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": "63903", //  Airtel
				"ccy": 404,
				"country": "KE",
				"purpose": "Family",
				"institutionIdentifier": null
			},
			"transaction": {
				"routeId": "4a45b519-0d3b-1111-8286-062ab3a3eac8",
				"ChannelType": 1,
				"amount": 1100,
				"reference": "ABC123TT", 
				"systemTraceAuditNumber": "DDS217380BB6" // must be unique
			}
		}
	]
}

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
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/payment-order/new-order'
Response Response Example
{}
Modified at 2026-07-17 13:47:48
Previous
Mobile Transfers- Safaricom (M-Pesa)
Next
Payment Order Requests - Business Transfers
Built with