Documentation
Beneficiaries
Egypt Beneficiary

Egypt Beneficiary

Payouts to Egypt are made via bank transfer.

Below is a sample request for creating a Egypt beneficiary:

cURL
curl --location '{{baseURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "customerEmail": "ray.jon@mail.com",
    "country": "EG",
    "currency": "EGP",
    "callbackUrl": "https:webhook.site/38a9e6b0-3388-4399-89d4-3ceafa000001",
    "destination": {
         "type": "BANK",
         "accountName": "Example User",
         "accountNumber": "0690000031",
         "bankCode": "ADIB",
         "remittancePurpose": "Paying Installments",
         "beneficiary": {
             "phoneNumber": "01000410066",
             "address": "24 King William Street London",
             "idNumber": "28503122500311",
             "accountNumberType": "IBAN"
         },
         "sender": {
             "city": "Lagos",
             "dateOfBirth": "1990-09-23",
             "idNumber": "2231aaa",
             "idType": "Passport",
             "idExpiry": "2026-09-23",
             "country": "NG"
         }
     }
}'
ParameterDescriptionRequired
typeThis is the payment type. It will be BANK✅
accountNameThis is the name of the beneficiary✅
accountNumberThis is the phone number of the beneficiary✅
bankCodeCode of the receiving bank
See accepted bankCodes here (opens in a new tab)
✅
remittancePurposePurpose of the remittance.
See accepted remittance purposes here (opens in a new tab)
✅
beneficiaryBeneficiary information. Expanded based on sender[type].✅
senderSender information. Expanded based on sender[type].✅
💡

The remittance purpose can be any one of the following values: Individuals Transfers, Education, Paying Installments, Paying Invoices, Paying Expenses.

Beneficiary Parameters

ParameterDescriptionRequired
beneficiary[phoneNumber]Beneficiary's phoneNumber✅
beneficiary[address]Beneficiary's address.✅
beneficiary[idNumber]Beneficiary's ID number✅
beneficiary[accountNumberType]Type of beneficiary account, either IBAN or ACCOUNT✅

Sender Parameters

ParameterDescriptionRequired
sender[city, country]Sender's address details✅
sender[dateOfBirth]Sender's date of birth✅
sender[idType, idNumber]Sender's identification details (type, number, and country).
See accepted id types here (opens in a new tab)
✅
sender[idExpiry]Sender's identification details expiry date✅