| Field |
Individual |
Company |
Permitted Data |
Notes |
| Beneficiary Entity Type |
No |
Yes |
‘company’ only |
Due to restrictions imposed by our partner bank, the beneficiary of a CNY payment must be a company incorporated in mainland China. CNY payments to individuals in China are not permitted. |
| Beneficiary First Name |
Yes |
No |
1-255 characters* |
|
| Beneficiary Last Name |
Yes |
No |
1-255 characters* |
|
| Beneficiary Company Name |
No |
Yes |
1-255 characters* |
|
| Beneficiary Address |
No |
Yes |
1-255 characters* |
|
| Beneficiary City |
No |
Yes |
1-255 characters* |
|
| Beneficiary Postcode |
No |
Yes |
1-12 characters* |
Only required when sending payments to Canada, Mexico and the USA. |
| Beneficiary State or Province |
No |
Yes |
1-255 characters* |
Only required when sending payments to Canada, Mexico and the USA. |
| Beneficiary Country |
No |
Yes |
2 letter ISO country code |
|
| IBAN |
No |
Yes |
15-34 alphanumeric characters; spaces permitted |
IBAN must be used when sending payments to all IBAN countries. When sending to non-IBAN countries, account number must be used. |
| Account Number |
No |
Yes |
Varies per destination country |
When sending payments to non-IBAN countries, account number must be used. IBAN must be used when sending to all IBAN countries. |
| CLABE |
Yes |
Yes |
18 digits |
CLABE must be used instead of account number or IBAN when sending payments in any currency to Mexico. CLABE is the banking standard for the numbering of bank accounts in Mexico (equivalent to the Account Number in other jurisdictions). |
| BIC SWIFT |
No |
Yes |
Valid ISO 9362 SWIFT BIC code; 8 or 11 alphanumeric characters |
BIC SWIFT must be used when sending payments to any country except the USA. When sending to the USA, ABA must be used. |
| CNAPS |
No |
Yes |
12 digits |
The CNAPS code is the domestic bank routing number used in China (equivalent to a UK sort code or US ABA number). CNAPS is only required when sending CNY payments to China. CNY payments to any other jurisdiction do not require the CNAPS code. |
| ABA |
No |
Yes |
9 digits |
American banks are identified by a 9 digit ABA number, also known as ‘Routing Number’. The ABA should be valid for FedWIRE payments. Some ABA values are only valid for FedACH payments. Payments to FedACH-only ABAs will fail. The ABA is required for all payments to the USA. |
| Payment Currency |
No |
Yes |
3 letter ISO currency code |
|
| Payment Amount |
No |
Yes |
Numeric amount |
|
| Payment Reference |
No |
Yes |
1-255 characters* |
|
| Payment Reason |
No |
Yes |
1-255 characters* |
A Payment Purpose Code is mandatory when sending CNY payments. The Payment Purpose Code must be inserted into the Payment Reason field. The list of available payment purpose codes is available here. |
| Payer Entity Type |
Notes |
Yes |
‘individual’ or ‘company’ only |
Only 'company' is supported at the current time. |
| Payer First Name |
No |
No |
1-255 characters* |
|
| Payer Last Name |
No |
No |
1-255 characters* |
|
| Payer Company Name |
No |
Yes |
1-255 characters* |
|
| Payer Address |
No |
Yes |
1-255 characters* |
|
| Payer City |
No |
Yes |
1-255 characters* |
|
| Payer Postcode |
Yes |
Yes |
1-12 characters* |
Only required when sending payments to Canada, Mexico and the USA. |
| Payer State or Province |
No |
Yes |
1-255 characters* |
Only required when sending payments to Canada, Mexico and the USA. |
| Payer Country |
No |
Yes |
2 letter ISO country code |
|
| Payer Date of Birth |
No |
No |
ISO 8601 format (YYYY-MM-DD). |
|
| Payer Identification Type |
No |
Yes |
‘incorporation_number’ only |
|
| Payer Identification Value |
No |
Yes |
1-255 characters* |
|
