Documentation
Beneficiaries
Ethiopia Beneficiary

Ethiopia Beneficiary

Payouts to Ethiopia are made via mobile money (SAFARICOM, ETHIO).

Below is a sample request for creating an Ethiopian beneficiary:

cURL
curl --location '{{baseURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "customerEmail": "ray.jon@mail.com",
    "country": "ET",
    "currency": "ETB",
    "destination": {
        "type": "MOBILEMONEY",
        "network": "ETHIO",
        "accountName": "Nathan Nathan",
        "accountNumber": "251912345678",
        "sender": {
            "country": "NG",
            "accountName": "Jane Doe"
    },
}
 
}'
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. Must be one of: SAFARICOM or ETHIO✅
senderSender information. Expanded based on sender[type].✅

Sender Parameters

ParameterDescriptionRequired
sender[accountName]Name of the sender.
A space separated first and last name must be provided for individual senders e.g John Doe
✅
sender[country]Sender's country