Market specifications

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

Country reference

`country` code	`currency` code	`amount` decimals	`document_type` name	`document_id` format
`SA`	`SAR`	2	National ID Card	10 digits. All numeric.

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	P2P
`login`	Yes	Yes	Yes
`pass`	Yes	Yes	Yes
`external_id`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`beneficiary_name`	Yes	Yes	Yes
`beneficiary_lastname`	Yes	Yes	Yes
`bank_branch`	Yes	Yes	Yes
`address`	Yes	Yes	Yes
`city`	Yes	Yes	Yes
`bank_account`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`purpose`	-	Yes	Yes
`remitter_full_name`	-	-	Yes
`remitter_nationality`	-	-	Yes
`remitter_address`	-	-	Yes
`remitter_city`	-	-	Yes
`remitter_postal_code`	-	-	Yes
`remitter_country`	-	-	Yes
`remitter_birth_date`	-	-	Yes
`remitter_document_type`	-	-	Yes
`remitter_document`	-	-	Yes

Payment methods

Saudi Arabia 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 Saudi Arabia 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.

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 Saudi Arabia, use `SA`.
`beneficiary_name`	First name of the beneficiary. Maximum 10 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 Saudi IBANs begin with 'SA' and are exactly 24 characters long. Ex: SA0380000000608010167519.
`amount`	Payout amount. Use up to 2 decimal places.
`currency`	Payout currency. For Saudi Arabia, use `SAR` or `USD`.
`purpose`	Reason for the payout. `EPREMT` for Remittance (P2P), `EPBTOB` for Business to Business (B2B).
`remitter_full_name`	Full name of the sender. Maximum 100 characters. Mandatory only for remittance (P2P).
`remitter_nationality`	ISO 3166-1 alpha-2 code of the sender's nationality. Mandatory only for remittance (P2P).
`remitter_address`	Full address of the sender. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter_city`	City of the sender. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter_postal_code`	Postal code of the sender. Maximum 20 characters. Mandatory only for remittance (P2P).
`remitter_country`	ISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P).
`remitter_birth_date`	Sender’s birth date in `YYYYMMDD` format. Mandatory only for remittance (P2P).
`remitter_document_type`	Type of identification document: `ID` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter_document`	Document number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "896986598",
  "country": "SA",
  "beneficiary_name": "Juan",
  "beneficiary_lastname": "Lopez",
  "bank_branch": "SAMASARIXXX",
  "address": "As Sulimaniyah",
  "city": "Riyadh",
  "bank_account": "SA0380000000608010167519",
  "amount": "1000",
  "currency": "SAR"
}