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 '{{sandboxURL}}/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