China
Alipay (Wallet)
Overview
| Available | Yes |
targetCurrency | Chinese Yuan Renminbi (CNY) |
countryCode | CN |
| Earliest Beneficiary Credit | real-time |
| Cut-Off Time (UK Time) | N/A |
| Decimal Places | 2 |
Minimum targetAmount | 1.00 |
Maximum targetAmount | 50000.00 |
Additional Information
- Beneficiaries must enable the Alipay Quick Collect service in their Alipay account
- The Alipay remittance service is available for payouts to linked bank accounts in China. Beneficiaries must register using a mobile number from mainland China and have a "Resident Identity Card" issued by China. Work passes and student passes are not supported.
- Alipay no longer supports beneficiaries registered with mobile numbers from Hong Kong, Taiwan and Macao.
Important
Currently, this route is only available for Payment Service Providers (PSP) or Money Service Business (MSB) merchants.
Submission data
Required Remitter Details:
| API field name | Required? | Field length | Description |
|---|---|---|---|
narrative | ✅ | Max 50 | Your company website. For example: worldpay.com If you do not have your own website, please use the local government website with the relavant company information instead. For example: register.fca.org.uk/s/firm?id=001b000000MgGDbAAN |
parties.personalDetails.identity.identityTypeCode | ✅ | 4 | Type of identification Must be:
Condition Mandatory if parties.partyTypeCode is:
|
parties.personalDetails.identity.identityNumber | ✅ | Max 35 | Identification number of the remitter i.e. the "Company Registration Number" For example, WorldPay AP Ltd. would have a CRN of "05593466" Condition Mandatory if parties.partyTypeCode is:
|
parties.personalDetails.identity.issuingCountry | ✅ | 2 | Enter the 2 character ISO 3166-1 standard country code where the "Company Registration Number" was issued. Condition Mandatory if parties.partyTypeCode is:
|
Beneficiary Details:
| API field name | Required? | Field length | Description |
|---|---|---|---|
purposeOfPaymentNarrative | ✅ | Max 22 | The code that represents the purpose of the payment. See the Purpose of Payment section below to view the full list of accepted values. |
bankDetails.beneficiaryAccountNumber | ✅ | 13 | Please provide the beneficiary's phone number associated with the Alipay account. Must include:
|
bankDetails.bankName | ✅ | Max 35 | Name of the beneficiary bank. Must be:
|
parties.personalDetails.partyTypeCode | ✅ | 4 | Type of the party. Must be:
|
parties.personalDetails.typeCode | ✅ | 4 | Entity description code for the party. Available values:
|
parties.personalDetails.titleCode | Conditional | 4 | Title code for the Individual. Available values:
Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.firstName | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.middleName | ❌ | Max 50 | Beneficiary middle name. |
parties.personalDetails.lastName | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.companyName | Conditional | Max 140 | Full name of the organization. Important 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. Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.dateOfBirth | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
parties.personalDetails.email | ✅ | Max 50 | Beneficiary's email address associated with the Alipay account. |
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 | ❌ | Max 10 | 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 API request. |
Purpose of Payment
| Accepted Value | Description |
|---|---|
| ADVERTISING_EXPENSES | Advertising Expenses |
| ADVISORY_FEES | Advisory Fees |
| CONSTRUCTION_EXPENSES | Construction Expenses |
| LIBERALIZED_REMITTANCE | Liberalized Remittance |
| PROPERTY_RENTAL | Property Rental |
| SALARY_PAYMENT | Salary Payment |
| SERVICE_CHARGES | Service Charges |
| TAX_PAYMENT | Tax Payment |
Domestic Payment
Overview
| Available | Yes |
targetCurrency | Chinese Yuan Renminbi (CNY) |
countryCode | CN |
| Earliest Beneficiary Credit | T+1 |
| Cut-Off Time (UK Time) | 10:00 |
| Decimal Places | 2 |
Minimum targetAmount | 1.00 |
Maximum targetAmount | 9999999.99 |
Submission data
| API field name | Required? | Field length | Description |
|---|---|---|---|
bankDetails.beneficiaryAccountNumber | ✅ | Max 32 | Account number of the beneficiary. |
bankDetails.bankCode | ✅ | 12 | Enter your bank's CNAPS Code, which is exactly 12 digits in length |
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:
|
parties.personalDetails.typeCode | ✅ | 4 | Entity description code for the party. Available values:
|
parties.personalDetails.titleCode | Conditional | 4 | Title code for the Individual. Available values:
Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.firstName | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.middleName | ❌ | Max 50 | Beneficiary middle name. |
parties.personalDetails.lastName | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.companyName | Conditional | Max 140 | Full name of the organization. Important 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. Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.dateOfBirth | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
parties.personalDetails.identity.identityTypeCode | Conditional | 4 | Type of identification. Must be:
Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.identity.identityNumber | Conditional | 18 | Enter the 18 digit Business Registration Number. Payments that include a Business Registration Number will be accepted as Corporate payments. Condition Mandatory if parties.personalDetails.identity.identityTypeCode is:
|
parties.personalDetails.identity.issuingCountry | Conditional | 2 | Beneficiary's country code of their identification document. Enter the 2 character ISO 3166-1 standard country code in your API request. Condition Mandatory if parties.personalDetails.identity.identityTypeCode is:
|
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 | ❌ | Max 10 | 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 API request. |
Important
Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).
International WIRE
Overview
| Available | Yes |
targetCurrency | Available WIRE currencies |
countryCode | CN |
| Earliest Beneficiary Credit | The estimated delivery time will vary by country and currency. |
| Cut-Off Time (UK Time) | Currency specific |
| Decimal Places | 2 |
Minimum targetAmount | 0.01 |
Maximum targetAmount | 9999999.99 |
Submission data
| API field name | Required? | Field length | Description |
|---|---|---|---|
bankDetails.beneficiaryAccountNumber | ✅ | 6-12 | Account number of the beneficiary. |
bankDetails.bankCode | ✅ | 3 | Bank code of the beneficiary (bank). |
bankDetails.branchCode | ✅ | 3 | 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:
|
parties.personalDetails.typeCode | ✅ | 4 | Entity description code for the party. Available values:
|
parties.personalDetails.titleCode | Conditional | 4 | Title code for the Individual. Available values:
Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.firstName | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.middleName | ❌ | Max 50 | Beneficiary middle name. |
parties.personalDetails.lastName | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.companyName | Conditional | Max 140 | Full name of the organization. Important 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. Condition Mandatory if parties.personalDetails.typeCode is:
|
parties.personalDetails.dateOfBirth | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
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 | ❌ | Max 10 | 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 code of their residential (if payee is an individual) or registered (if payee is a company) address. Condition Mandatory if any of the optional Beneficiary address details are provided. Enter the 2 character ISO 3166-1 standard country code in your API request. |
Important
Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).