Market specifications

Do you want to know more information about United Arab Emirates's market? Go to the Expand Your Reach in Africa’s eCommerce Market article.

`country` code	`currency` code	`amount` decimals	`document_type` name
`AE`	`AED`	2	ID

Document validations

Validation	Name	Length	Type	Example
Document	ID	18	characters	NNN-NNNN-NNNNNNN-N
Document	PASS	up to 12	characters	ABCD1234

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B
`login`	Yes	Yes
`pass`	Yes	Yes
`external_id`	Yes	Yes
`country`	Yes	Yes
`beneficiary_name`	Yes	Yes
`beneficiary_lastname`	Yes	Yes
`bank_branch`	Yes	Yes
`address`	Yes	Yes
`city`	Yes	Yes
`bank_account`	Yes	Yes
`amount`	Yes	Yes
`currency`	Yes	Yes
`purpose`	-	Yes
`bdate`	Yes	-
`nationality`	Yes	-
`document_type`	Yes	-
`document_id`	Yes	-

Payment methods

United Arab Emirates supports payouts via Bank transfers. This method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Bank transfers

Bank transfers in United Arab Emirates require detailed account information, including SWIFT code, address, city, and IBAN. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the document validations section for ID and Passport format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`login`	API authentication credentials. Maximum 32 characters.
`pass`	API authentication credentials. Maximum 32 characters.
`external_id`	Unique transaction identifier. Maximum 100 characters.
`country`	Country code. For United Arab Emirates, use `AE`.
`beneficiary_name`	First name of the beneficiary. Maximum 50 characters. English and Arabic supported.
`beneficiary_lastname`	Last name of the beneficiary. Maximum 50 characters. English and Arabic supported.
`bank_branch`	SWIFT code (8 or 11 alphanumeric characters in upper case).
`address`	Full address of the beneficiary. Maximum 35 characters. English and Arabic supported.
`city`	City of the beneficiary. Maximum 35 characters. English and Arabic supported.
`bank_account`	IBAN Format. All United Arab Emirates IBANs begin with 'AE' and are exactly 23 characters long. Ex: AE070331234567890123456.
`amount`	Payout amount. Use up to 2 decimal places.
`currency`	Payout currency. For United Arab Emirates, use `AED` or `USD`.
`bdate`	Birth date of the beneficiary. Format `YYYYMMDD`. Mandatory only for B2C.
`nationality`	Nationality of the beneficiary. ISO 3166-1 alpha-2 code. Mandatory only for B2C.
`document_type`	Document type of the beneficiary: `ID` for UAE national ID, `PASS` for Passport. Mandatory only for B2C.
`document_id`	Document of the beneficiary. See document validations below. Mandatory only for B2C.
`purpose`	Reason for the payout. `EPBTOB` for Business to Business (B2B). Mandatory only for B2B.

Example request

{
  "external_id": "896986598",
  "country": "AE",
  "beneficiary_name": "Juan",
  "beneficiary_lastname": "Lopez",
  "bank_branch": "ALEHAEAD",
  "address": "As Sulimaniyah",
  "city": "Riyadh",
  "bank_account": "AE070331234567890123456",
  "amount": "1000",
  "currency": "AED",
  "bdate": "19901230",
  "nationality": "AE",
  "document_type": "ID",
  "document_id": "123-4567-8901234-5"
}