Documentation
Beneficiaries
Algeria Beneficiary

Algeria Beneficiary

Before making a payment to an Algeria bank account, you must add the account as a beneficiary. Note that payments to Algeria beneficiaries are via SWIFT.

Below is a sample request for creating an Algeria beneficiary:

cURL
curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
  "reference": "<sample-reference>",
  "country": "DZ",
  "currency": "USD",
  "destination": {
    "type": "SWIFT",
    "accountName": "Ahmed Benali",
    "accountNumber": "1234567890",
    "swiftCode": "BNALDZDZ",
    "bankName": "Banque Nationale d'\''Algérie",
    "bankAddress": "54 Rue Didouche Mourad",
    "bankCity": "Algiers",
    "bankPostCode": "00000",
    "bankCountry": "DZ",
    "remittancePurpose": "FAMILY_SUPPORT",
    "beneficiary": {
      "type": "BUSINESS",
      "country": "DZ",
      "city": "Algiers",
      "postCode": "00000",
      "address": "54 Rue Didouche Mourad"
    },
    "sender": {
      "type": "INDIVIDUAL",
      "accountName": "John Smith",
      "country": "US",
      "city": "New York",
      "address": "123 Main St",
      "postCode": "10001",
      "dateOfBirth": "1985-03-15",
      "countryOfBirth": "US"
    }
  }
}'

The parameters for adding Algeria SWIFT beneficiaries are:

ParameterDescriptionRequired
countryCountry of beneficiary payload. Must be DZ.
currencyCurrency of transfer. Must be USD.
destination.typeDestination type. Must be SWIFT.
accountNameBeneficiary account name.
accountNumberBeneficiary account number.
swiftCodeSWIFT/BIC code (8 or 11 chars, uppercase letters/numbers).
bankNameReceiving bank name.
bankAddressReceiving bank address.
bankCityReceiving bank city.
bankPostCodeReceiving bank postal code.
bankCountryReceiving bank country.
remittancePurposeRemittance purpose. Must be one of the supported enumerations below.
💡

The remittance purpose can be any one of the following values: FAMILY_SUPPORT, EDUCATION, GIFT_AND_DONATION, MEDICAL_TREATMENT, MAINTENANCE_EXPENSES, TRAVEL, SMALL_VALUE_REMITTANCE, LIBERALIZED_REMITTANCE, OTHER, CONSTRUCTION_EXPENSES, HOTEL_ACCOMMODATION, ADVERTISING_EXPENSES, ADVISORY_FEES, BUSINESS_INSURANCE, INSURANCE_CLAIMS, DELIVERY_FEES, EXPORTED_GOODS, SERVICE_CHARGES, LOAN_PAYMENT, OFFICE_EXPENSES, PROPERTY_PURCHASE, PROPERTY_RENTAL, ROYALTY_FEES, SHARES_INVESTMENT, FUND_INVESTMENT, TAX_PAYMENT, TRANSPORTATION_FEES, UTILITY_BILLS, PERSONAL_TRANSFER, SALARY_PAYMENT, OTHER_FEES, COMPUTER_SERVICES, REWARD_PAYMENT, INFLUENCER_PAYMENT.

Sender Parameters (Business)

ParameterDescriptionRequired
sender[type]Must be BUSINESS.
sender[accountName]Sender account name.
sender[country]Sender country.
sender[city]Sender city.
sender[address]Sender address.
sender[postCode]Sender postal code.
sender[businessRegistrationNumber]Business registration number.

Sender Parameters (Individual)

ParameterDescriptionRequired
sender[type]Must be INDIVIDUAL.
sender[accountName]Sender account name.
sender[country]Sender country.
sender[city]Sender city.
sender[address]Sender address.
sender[postCode]Sender postal code.
sender[dateOfBirth]Sender date of birth (YYYY-MM-DD).
sender[countryOfBirth]Sender country of birth.

Beneficiary Parameters

ParameterDescriptionRequired
beneficiary[type]Must be BUSINESS in this schema.
beneficiary[country]Beneficiary country.
beneficiary[city]Beneficiary city.
beneficiary[postCode]Beneficiary postal code.
beneficiary[address]Beneficiary address.