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.


📘

Kenya payouts are currently in beta.

Metadata requirements

ElementDescription
currencyCodeSet to KES for all Kenyan Shilling transfers.
beneficiaryAccountNumberThe beneficiary's mobile money number in international format, without the + (e.g. 2547XXXXXXXX). Must be registered on the network set in paymentMethodValue.
beneficiaryFirstNameBeneficiary's first name. Required.
beneficiaryLastNameBeneficiary's last name. Required.
beneficiaryAccountNameFull name of the beneficiary. Required.
amountValue to send. Must be a whole number (no decimals).
narrationDescription of the payment. Required.
paymentMethodTypeThe routing method. Must be MobileMoney.
paymentMethodValueThe mobile money network: MPESA_KEN (M-Pesa) or AIRTEL_KEN (Airtel Money).
transferPurposeMust be MobileB2C for mobile money payouts to individuals.
tenantReferenceYour unique transaction tracking ID. Must be unique per request.
beneficiaryCountryIsoThe ISO 2-letter country code for Kenya: KE.
remittersInfo.remitterCountryIsoThe sender's country as an ISO 3-letter code (e.g. KEN). Defaults to GBR if not supplied.
🚧

Sandbox testing

Use the test number 254712345001 as beneficiaryAccountNumber in 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"
    }
}

Did this page help you?