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].

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