Kenya Beneficiary

Payouts to Kenya are made via mobile money (M-Pesa only).

📘
Phone number format
To make a successful M-Pesa(KES) transfer request, ensure that you enter the number in this format 2570123454433 or 09002090384

Below is a sample request for creating Kenya beneficiary:

curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "customerEmail": "[email protected]",
    "country": "KE",
    "currency": "KES",
    "callbackUrl": "https://webhook.site/38a9e6b0-3388-4399-89d4-3ceafa000001",
    "destination": {
        "network": "MPESA"
        "type": "MOBILEMONEY",
        "accountNumber": "254712200002",
    }
}
'

Parameter	Description	Required
type	This is the payment type. It will be `MOBILEMONEY`	✅
accountNumber	This is the phone number of the beneficiary	✅
accountName	This is the name of the beneficiary	✅
network	The phone number's mobile network, in this case, `MPESA`	✅

📘Phone number format

📘
Phone number format