| Available | Yes |
targetCurrency | Chinese Yuan Renminbi (CNY) |
countryCode | CN |
| Earliest beneficiary credit | real-time |
| Cut-off time (UTC) | N/A |
| Decimal places | 2 |
Minimum targetAmount | 1.00 |
Maximum targetAmount | 50000.00 |
- 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.
- Currently only supports B2C payouts.
These details must be provided before the corridor can be enabled:
Company website
- The company's website address.
- Example:
worldpay.com
- Example:
- If the company does not have its own website, provide the relevant government or regulatory website containing the company's registration details.
- Example:
register.fca.org.uk/s/firm?id=001b000000MgGDbAAN
- Example:
- The company's website address.
Company Registration Number (CRN)
- The official company registration number of the remitter.
- Example:
05593466(Worldpay AP Ltd.)
- Example:
- The official company registration number of the remitter.
Company registration country
- The 2-character ISO 3166-1 alpha-2 country code of the country where the CRN was issued.
- Example:
GB
- Example:
- The 2-character ISO 3166-1 alpha-2 country code of the country where the CRN was issued.
| API field name | Required? | Field length | Description |
|---|---|---|---|
purposeOfPaymentCode | ✅ | 6 | The code that represents the purpose of the payment. See the Accepted purpose of payment codes for Alipay section below to view the full list of accepted values. |
bankDetails.beneficiaryAccountNumber | ✅ | Max 64 | Provide the beneficiary's phone number or email address associated with their Alipay account. If using a phone number, you:
If using an email address, you:
|
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. Must be:
|
parties.personalDetails.titleCode | ✅ | 4 | Title code for the individual. Available values:
|
parties.personalDetails.firstName | ✅ | Max 50 | Beneficiary first name. Full name should be provided (no initials). |
parties.personalDetails.middleName | ❌ | Max 50 | Beneficiary middle name. |
parties.personalDetails.lastName | ✅ | Max 50 | Beneficiary last name. Full name should be provided (no initials). |
parties.personalDetails.dateOfBirth | Strongly recommended | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
parties.address.street | Strongly recommended | Max 35 | Beneficiary's residential house number/name and street e.g. 1 Main Street. |
parties.address.additionalAddressLine | ❌ | Max 35 | Beneficiary's residential address e.g. apartment no., unit, studio. |
parties.address.city | Strongly recommended | Max 35 | Beneficiary's city or town of their residential address. |
parties.address.postcodeOrZipCode | ❌ | Max 10 | Beneficiary's postal code or zip code of their residential address. |
parties.address.countryCode | Strongly recommended | 2 | Beneficiary's country of their residential address. Enter the 2 character ISO 3166-1 standard country code in your API request. |
| Accepted value | Description |
|---|---|
| WPEXPE | Advertising expenses |
| WPFSER | Advisory fees |
| WPSCVE | Construction expenses |
| WPREMT | Liberalized remittance |
| WPRENT | Property rental |
| WPSALR | Salary payment |
| WPCHRG | Service charges |
| WPTAXS | Tax payment |
The purpose codes listed above represent the payment purposes that are currently supported for Alipay.
| Available | Yes |
targetCurrency | Chinese Yuan Renminbi (CNY) |
countryCode | CN |
| Earliest beneficiary credit | T+1 |
| Cut-off time (UTC) | 10:00 |
| Decimal places | 2 |
Minimum targetAmount | 1.00 |
Maximum targetAmount | 9999999.99 |
| 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 | 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.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 | 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 | ❌ | 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 | 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 in your API request. |
Important
Additional data is required if the requester of the payout is either:
| Available | Yes |
targetCurrency | Available WIRE currencies |
countryCode | CN |
| Earliest beneficiary credit | The estimated delivery time will vary by country and currency. |
| Cut-off time (UTC) | Currency specific |
| Decimal places | 2 |
Minimum targetAmount | 0.01 |
Maximum targetAmount | 9999999.99 |
| 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 | 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 | ❌ | 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 requester of the payout is either: