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
curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
"reference": "<samplereference>",
"customerEmail": "ray.jon@mail.com",
"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 | ✅ |