# Saudi Arabia

## Domestic Payment (real-time)

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
Saudi Riyal (SAR)
tr
td
code
countryCode
td
SA
tr
td
Earliest Beneficiary Credit
td
real-time
tr
td
Cut-Off Time (UK Time)
td
N/A
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
0.01
tr
td
Maximum 
code
targetAmount
td
19999.99
### Required data

| API field name | Required | Field length | Description |
|  --- | --- | --- | --- |
| `purposeOfPayment.code` | ✅ | 6 | The code that represents the purpose of the payment. See [Additional data](/access/products/marketplaces/coverage/bank/additionalinfo) for the full list of accepted values. |
| `bankDetails.iban` | ✅ | 24 | Beneficiary IBAN. |
| `bankDetails.swiftBic` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `bankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party.**Must be**:`PT03 (Beneficiary)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the party.**Available values:**`PD01 (Company)``PD02 (Individual)` |
| `parties.personalDetails.titleCode` | Conditional | 4 | Title code for the individual (applicable when party entity type is "Individual").**Available values**:`TI01 (Ms)``TI02 (Miss)``TI03 (Mr)``TI04 (Mrs)``TI05 (Dr)``TI06 (Mx)``TI99 (Misc)` |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. If the beneficiary is an individual, the full name should be provided (no initials). |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. |
| `parties.personalDetails.companyName` | Conditional | Max 140 | If the beneficiary is a company, this should be the full company name.  Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space.  |
| `parties.personalDetails.dateOfBirth` | Strongly recommended | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.email` | Strongly recommended | Max 50 | Beneficiary's email address |
| `parties.personalDetails.telephony.phoneNumber` | Strongly recommended | 5-20 | Phone number of the beneficiary. |
| `parties.personalDetails.telephony.prefix` | Strongly recommended | 1-3 | Phone dialing country code of the beneficiary. |
| `parties.address.street` | Strongly recommended | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street. |
| `parties.address.additionalAddressLine` | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
| `parties.address.city` | Strongly recommended | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.postCodeOrZipCode` | Strongly recommended | 5 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.countryCode` | Strongly recommended | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.Enter the [2 character ISO 3166-1 standard country code](http://www.iso.org/iso/country_codes) in API request. |


 [Additional data](/access/products/account-payouts/v2/coverage/additionalinfo) is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB). 

## Domestic Payment (same-day)

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
Saudi Riyal (SAR)
tr
td
code
countryCode
td
SA
tr
td
Earliest Beneficiary Credit
td
same-day
tr
td
Cut-Off Time (UK Time)
td
09:00
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
0.01
tr
td
Maximum 
code
targetAmount
td
9999999.99
### Required data

| API field name | Required | Field length | Description |
|  --- | --- | --- | --- |
| `purposeOfPayment.code` | ✅ | 6 | The code that represents the purpose of the payment. See [Additional data](/access/products/marketplaces/coverage/bank/additionalinfo) for the full list of accepted values. |
| `bankDetails.iban` | ✅ | 24 | Beneficiary IBAN. |
| `bankDetails.swiftBic` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `bankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party.**Must be**:`PT03 (Beneficiary)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the party.**Available values:**`PD01 (Company)``PD02 (Individual)` |
| `parties.personalDetails.titleCode` | Conditional | 4 | Title code for the individual (applicable when party entity type is "Individual").**Available values**:`TI01 (Ms)``TI02 (Miss)``TI03 (Mr)``TI04 (Mrs)``TI05 (Dr)``TI06 (Mx)``TI99 (Misc)` |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. If the beneficiary is an individual, the full name should be provided (no initials). |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. |
| `parties.personalDetails.companyName` | Conditional | Max 140 | If the beneficiary is a company, this should be the full company name.  Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space.  |
| `parties.personalDetails.dateOfBirth` | Strongly recommended | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.email` | Strongly recommended | Max 50 | Beneficiary's email address. |
| `parties.personalDetails.telephony.phoneNumber` | Strongly recommended | 5-20 | Phone number of the beneficiary. |
| `parties.personalDetails.telephony.prefix` | Strongly recommended | 1-3 | Phone dialing country code of the beneficiary. |
| `parties.address.street` | ✅ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street. |
| `parties.address.additionalAddressLine` | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
| `parties.address.city` | ✅ | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.postCodeOrZipCode` | Strongly recommended | 5 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.countryCode` | ✅ | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.Enter the [2 character ISO 3166-1 standard country code](http://www.iso.org/iso/country_codes) in API request. |


 [Additional data](/access/products/account-payouts/v2/coverage/additionalinfo) is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB). 

## Domestic wire payment

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
Saudi Riyal (SAR)
tr
td
code
countryCode
td
SA
tr
td
Earliest Beneficiary Credit
td
T+1
tr
td
Cut-Off Time (UK Time)
td
15:00
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
0.01
tr
td
Maximum 
code
targetAmount
td
9999999.99
### Required data

| API field name | Required | Field length | Description |
|  --- | --- | --- | --- |
| `purposeOfPaymentNarrative` | ✅ | Max 35 | Description for purpose of payment. |
| `bankDetails.iban` | ✅ | 24 | Beneficiary IBAN. |
| `bankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `bankDetails.swiftBic` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party.**Must be**:`PT03 (Beneficiary)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the party.**Available values:**`PD01 (Company)``PD02 (Individual)` |
| `parties.personalDetails.titleCode` | Conditional | 4 | Title code for the individual.**Available values**:`TI01 (Ms)``TI02 (Miss)``TI03 (Mr)``TI04 (Mrs)``TI05 (Dr)``TI06 (Mx)``TI99 (Misc)`  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials).  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name.   Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization.  Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager.   Mandatory if `parties.personalDetails.typeCode` is:`PD01 (Company)``PD03 (Institution)``PD04 (Government)``PD99 (Other)`  |
| `parties.personalDetails.dateOfBirth` | ✅ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.email` | Strongly recommended | Max 50 | Beneficiary's email address. |
| `parties.personalDetails.telephony.phoneNumber` | Strongly recommended | 5-20 | Phone number of the beneficiary. |
| `parties.personalDetails.telephony.prefix` | Strongly recommended | 1-3 | Phone dialing country code of the beneficiary. |
| `parties.identity.identityTypeCode` | ✅ | 4 | Beneficiary's identity document type.**Available values**:`ID12 (National ID)``ID02 (Tax ID)` |
| `parties.identity.identityNumber` | ✅ | 11 | Beneficiary's identity number. The tax ID number can be up to 10 digits in length. The national ID number is exactly 11 digits in length. |
| `parties.identity.issuingCountry` | ✅ | 2 | The country code of the beneficiary's identity document.Enter the [2 character ISO 3166-1 standard country code](/access/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |
| `parties.address.street` | ✅ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street. |
| `parties.address.additionalAddressLine` | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
| `parties.address.city` | ✅ | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.postCodeOrZipCode` | ❌ | 5 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.countryCode` | ✅ | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.Enter the [2 character ISO 3166-1 standard country code](/access/products/reference/supported-countries-currencies#iso-country-codes) in API request. |


 Any company making payroll payments into Saudi Arabia should review the requirements to ensure compliance with the Wages Protection System (WPS). This route is not integrated with WPS in this country. For further information on how to format your payments to Saudi Arabia, contact your Relationship Manager or Corporate Support Manager. 

## International WIRE

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
a
Available WIRE currencies
tr
td
code
countryCode
td
SA
tr
td
Earliest Beneficiary Credit
td
The estimated delivery time will vary by country and currency.
tr
td
Cut-Off Time (UK Time)
td
a
Currency specific
tr
td
Decimal Places
td
2
tr
td
Minimum 
code
targetAmount
td
0.01
tr
td
Maximum 
code
targetAmount
td
9999999.99
### Submission data

| API field name | Required? | Field length | Description |
|  --- | --- | --- | --- |
| `bankDetails.iban` | ✅ | 24 | Beneficiary IBAN. |
| `bankDetails.bankCode` | ❌ | Max 35 | Bank code of the beneficiary (bank). |
| `bankDetails.branchCode` | ❌ | Max 35 | Branch code of the beneficiary (bank). |
| `bankDetails.swiftBic` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `bankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `parties.personalDetails.partyTypeCode` | ✅ | 4 | Type of the party.**Must be**:`PT03 (Beneficiary)` |
| `parties.personalDetails.typeCode` | ✅ | 4 | Entity description code for the party.**Available values:**`PD01 (Company)``PD02 (Individual)` |
| `parties.personalDetails.titleCode` | Conditional | 4 | Title code for the individual.**Available values**:`TI01 (Ms)``TI02 (Miss)``TI03 (Mr)``TI04 (Mrs)``TI05 (Dr)``TI06 (Mx)``TI99 (Misc)`  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials).  Mandatory if `parties.personalDetails.typeCode` is:`PD02`  |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials).  Mandatory if `parties.personalDetails.typeCode` is:`PD02 (Individual)`  |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization.  Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager.   Mandatory if `parties.personalDetails.typeCode` is:`PD01 (Company)``PD03 (Institution)``PD04 (Government)``PD99 (Other)`  |
| `parties.personalDetails.dateOfBirth` | Strongly recommended | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.email` | Strongly recommended | Max 50 | Beneficiary's email address. |
| `parties.personalDetails.telephony.phoneNumber` | Strongly recommended | 5-20 | Phone number of the beneficiary. |
| `parties.personalDetails.telephony.prefix` | Strongly recommended | 1-3 | Phone dialing country code of the beneficiary. |
| `parties.address.street` | Strongly recommended | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street. |
| `parties.address.additionalAddressLine` | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
| `parties.address.city` | Strongly recommended | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.postCodeOrZipCode` | ❌ | 5 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.countryCode` | Conditional | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.  Mandatory if any of the optional beneficiary address details are provided. Enter the [2 character ISO 3166-1 standard country code](/access/products/reference/supported-countries-currencies#iso-country-codes) in your API request.  |


 [Additional data](/access/products/account-payouts/v2/coverage/additionalinfo) is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).