Market specifications

Do you want to know more information about Jordan'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
`JO`	`JOD`	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
`beneficiary_name`	Yes	Yes	Yes
`beneficiary_lastname`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`bank_account`	Yes	Yes	Yes
`purpose`	-	-	Yes
`remitter_full_name`	-	-	Yes
`remitter_document_type`	-	-	Yes
`remitter_document`	-	-	Yes
`remitter_birth_date`	-	-	Yes
`remitter_address`	-	-	Yes
`remitter_country`	-	-	Yes
`remitter_nationality`	-	-	Yes

Wallet transfers

Wallet transfers parameters	B2C	B2B	P2P
`login`	Yes	Yes	Yes
`pass`	Yes	Yes	Yes
`external_id`	Yes	Yes	Yes
`beneficiary_name`	Yes	Yes	Yes
`beneficiary_lastname`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`account_type`	Yes	Yes	Yes
`bank_account`	Yes	Yes	Yes
`phone`	Yes	Yes	Yes
`purpose`	-	-	Yes
`remitter_full_name`	-	-	Yes
`remitter_document_type`	-	-	Yes
`remitter_document`	-	-	Yes
`remitter_birth_date`	-	-	Yes
`remitter_address`	-	-	Yes
`remitter_country`	-	-	Yes
`remitter_nationality`	-	-	Yes

Payment methods

Jordan supports payouts via Bank transfers and Wallet transfers. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Use Wallet transfers for instant payments to mobile wallets. Use Bank transfers when sending funds directly to a bank account.

Bank transfers

Bank transfers in Jordan require detailed account information, including IBAN. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the bank codes section for 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.
`beneficiary_name`	First name of the beneficiary. Maximum 50 characters.
`beneficiary_lastname`	Last name of the beneficiary. Maximum 50 characters.
`country`	Country code. For Jordan, use `JO`.
`amount`	Payout amount. Use up to 2 decimal places.
`currency`	Payout currency. For Jordan, use `JOD` or `USD`.
`bank_account`	Alphanumeric 30 chars IBAN Format. All Jordan IBANs begin with 'JO' and are exactly 30 characters long (e.g JO94BJOR0010000000000131000301).
`purpose`	Reason for the payout. `EPREMT` for Remittance (P2P). Mandatory only for remittance (P2P).
`remitter_full_name`	Full name of the sender. Maximum 200 characters.
`remitter_document_type`	Type of identification document: `ID` for national identification number or `PASS` for passport.
`remitter_document`	Document number of the sender. Maximum 45 characters.
`remitter_birth_date`	Sender’s birth date in `YYYY-MM-DD` format.
`remitter_address`	Full address of the sender. Maximum 200 characters.
`remitter_country`	ISO 3166-1 alpha-2 code of the sender.
`remitter_nationality`	ISO 3166-1 alpha-2 code of the sender's nationality.

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "68907654",
  "beneficiary_name": "DLOCAL Jordan",
  "beneficiary_lastname": "Limited",
  "country": "JO",
  "amount": "1",
  "currency": "JOD",
  "bank_account": "JO94BJOR0010000000000131000301",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "68907654",
  "beneficiary_name": "Omar",
  "beneficiary_lastname": "Al-Majali",
  "country": "JO",
  "amount": "100",
  "currency": "JOD",
  "bank_account": "JO94BJOR0010000000000131000301",
  "purpose": "EPREMT",
  "remitter_full_name": "John Doe",
  "remitter_address": "123 Example Street, Amman, Jordan",
  "remitter_nationality": "CO",
  "remitter_document_type": "PASSPORT",
  "remitter_document": "CO1234567",
  "remitter_country": "BR",
  "remitter_birth_date": "1980-05-15",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

Wallet transfers

Wallet transfers enable real-time transfers using a mobile phone number or alias linked to a wallet.

The account_type field must indicate the type of wallet being used (M for mobile phone number or A for alias). The phone or bank_account field must be present and correctly formatted based on the account_type.

Mandatory parameters

The table below outlines the required parameters for Wallet transfers.

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.
`beneficiary_name`	First name of the beneficiary. Maximum 50 characters.
`beneficiary_lastname`	Last name of the beneficiary. Maximum 50 characters.
`country`	Country code. For Jordan, use `JO`.
`amount`	Payout amount. Use up to 2 decimal places.
`currency`	Payout currency. For Jordan, use `JOD`.
`account_type`	Type of wallet being used: `M` (mobile phone number), `A` (alias).
`bank_account`	Alias. Maximum 45 characters. Mandatory if account type is `A` (alias).
`phone`	Mobile phone number. Can be sent either with 9 digits (e.g. 123456789) or with the country code plus 9 digits (e.g. +962123456789). Mandatory if account type is `M` (mobile phone number).
`purpose`	Reason for the payout. `EPREMT` for Remittance (P2P). Mandatory only for remittance (P2P).
`remitter_full_name`	Full name of the sender. Maximum 200 characters.
`remitter_document_type`	Type of identification document: `ID` for national identification number or `PASS` for passport.
`remitter_document`	Document number of the sender. Maximum 45 characters.
`remitter_birth_date`	Sender’s birth date in `YYYY-MM-DD` format.
`remitter_address`	Full address of the sender. Maximum 200 characters.
`remitter_country`	ISO 3166-1 alpha-2 code of the sender.
`remitter_nationality`	ISO 3166-1 alpha-2 code of the sender's nationality.

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "68907654",
  "beneficiary_name": "DLOCAL Jordan",
  "beneficiary_lastname": "Limited",
  "country": "JO",
  "amount": "1",
  "currency": "JOD",
  "account_type": "M",
  "phone": "+962123456789",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "68907654",
  "beneficiary_name": "Omar",
  "beneficiary_lastname": "Al-Majali",
  "country": "JO",
  "amount": "100",
  "currency": "JOD",
  "account_type": "M",
  "bank_account": "JO94BJOR0010000000000131000301",
  "phone": "+962123456789",
  "purpose": "EPREMT",
  "remitter_full_name": "John Doe",
  "remitter_address": "123 Example Street, Amman, Jordan",
  "remitter_nationality": "CO",
  "remitter_document_type": "PASSPORT",
  "remitter_document": "CO1234567",
  "remitter_country": "BR",
  "remitter_birth_date": "1980-05-15",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Jordan.

Bank codes

These are the values the bank_code parameter can take in Jordan (positions 5 to 8 in the IBAN to be sent in the bank_account parameter).

Bank name	Bank code
Arab Bank	ARAB
Arab Banking Corporation	ABCJ
Arab Jordan Investment Bank	AJIB
Ayapay	AYAP
Bank AlEtihad	UBSI
Bank of Jordan	BJOR
Blom	BLOM
Cairo Amman Bank	CAAB
Capital Bank of Jordan	EFBK
Citi	CITI
Dinarak	DNRK
Egyptian Arab Land Bank	ARLB
Gadha	GDHA
Housing Bank for Trade and Finance	HBHO
Islamic International Arab Bank	IIBA
Jordan Ahli Bank	JONB
Jordan Commercial Bank	JGBA
Jordan Islamic Bank	JIBA
Jordan Investment and Finance Bank	JIFB
Jordan Kuwait Bank	JKBA
Mared	MDFT
MEPS	MEPS
National Bank of Kuwait	NBOK
Orange Money	ORNG
Safwa Islamic Bank	JDIB
Societe Generale de Banque-Jordanie	SGME
UWallet	UWLT
ZainCash	ZAIN