Kenya 🇰🇪
Payouts to Kenya are delivered directly to the beneficiary's mobile money wallet. Two networks are supported: M-Pesa and Airtel Money. The beneficiary is identified by their registered mobile number, so the number must be active on the selected network.
Metadata requirements
Metadata requirements| Element | Description |
|---|---|
currencyCode | Set to KES for all Kenyan Shilling transfers. |
beneficiaryAccountNumber | The beneficiary's mobile money number in international format, without the + (e.g. 2547XXXXXXXX). Must be registered on the network set in paymentMethodValue. |
beneficiaryFirstName | Beneficiary's first name. Required. |
beneficiaryLastName | Beneficiary's last name. Required. |
beneficiaryAccountName | Full name of the beneficiary. Required. |
amount | Value to send. Must be a whole number (no decimals). |
narration | Description of the payment. Required. |
paymentMethodType | The routing method. Must be MobileMoney. |
paymentMethodValue | The mobile money network: MPESA_KEN (M-Pesa) or AIRTEL_KEN (Airtel Money). |
transferPurpose | Must be MobileB2C for mobile money payouts to individuals. |
tenantReference | Your unique transaction tracking ID. Must be unique per request. |
beneficiaryCountryIso | The ISO 2-letter country code for Kenya: KE. |
remittersInfo.remitterCountryIso | The sender's country as an ISO 3-letter code (e.g. KEN). Defaults to GBR if not supplied. |
Sandbox testingUse the test number
254712345001asbeneficiaryAccountNumberin the sandbox environment.
JSON
{
"currencyCode": "KES",
"beneficiaryAccountName": "Jane Doe",
"beneficiaryFirstName": "Jane",
"beneficiaryLastName": "Doe",
"beneficiaryAccountNumber": "254712345001",
"amount": 100,
"narration": "Single Mobile Money Payout KES example",
"paymentMethodType": "MobileMoney",
"paymentMethodValue": "MPESA_KEN",
"transferPurpose": "MobileB2C",
"tenantReference": "KES-PAYOUT-000123",
"beneficiaryCountryIso": "KE",
"remittersInfo": {
"remitterCountryIso": "KEN"
}
}Updated about 24 hours ago
Did this page help you?