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 '{{sandboxURL}}/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": "221773285433",
        "sender": {
            "country": "NG",
            "accountName": "Peter Ebueku"
    },
}
 
}'
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