Documentation
Beneficiaries
Kenya Beneficiary

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",
    }
}
ParameterDescriptionRequired
typeThis is the payment type. It will be MOBILEMONEY
accountNumberThis is the phone number of the beneficiary
accountNameThis is the name of the beneficiary
networkThe phone number's mobile network, in this case, MPESA