Kenya Beneficiary
Transactions to Kenya are processed via M-Pesa, with options to pay to mobile money (phone numbers), paybill, and till numbers as available methods.
📘 Phone number format To make a successful M-Pesa(KES) transfer request,
ensure that you enter phone numbers in this format 2570123454433 or
09002090384
Below are sample requests for creating different types of Kenya beneficiaries:
cURL
curl --location '{{baseURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
"reference": "TEST_REF_1",
"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",
"accountName": "Jane Doe"
}
}'| Parameter | Description | Required |
|---|---|---|
| type | This is the payment type. In this case, it must be MOBILEMONEY | ✅ |
| accountNumber | This is the phone number of the beneficiary | ✅ |
| accountName | This is the name of the beneficiary | ✅ |
| network | The mobile network, it must be MPESA | ✅ |