**Last updated**: 17 November 2025 | [**Change log**](/products/apms/changelog/)

Pilot
If you are interested in piloting AlipayCN, please contact your Relationship Manager.

# Alipay China

A key payment method in China.

Note
Make yourself familiar with our [API principles](/products/reference/api-principles) to ensure a resilient integration.

details
summary
Product overview
AlipayCN is one of China's most widely used digital payment platforms, offering seamless transactions both in-app and on web.
Similar to domestic online/in-app payments, the amount is deducted from your customer's Alipay account in real-time. Alipay converts these payments into your currency and sends the amount directly your acquirer.

AlipayCN supports a redirect flow meaning your customers are redirected from your website, or mobile application, to the AlipayCN payment page where they authorize and confirm the payment.

### Why use AlipayCN?

- popularity and high usage: AlipayCN is one of the dominant players in the Chinese market with an ever growing user base
- attracting Chinese tourists: Chinese tourists are known to use Alipay heavily for cross-border payments, with 93% awareness in this market
- high approval rates and low chargeback/dispute rate
- frictionless experience for Chinese customers while benefiting from a secure and scalable payment infrastructure


### Feature summary

| Payment type | Recurring | Reversals | Partial reversals | Auth and settlement (sale) | Customer country | Authorisation timescale* |
|  --- | --- | --- | --- | --- | --- | --- |
| Digital wallet | ❌ | Refund - yesCancel- No | Partial refund - yesPartial cancel- No | ✅ | China | 10 mins |


- Maximum Transaction Value: 300.000 CNY - if you require a higher amount please contact your Relationship Manager


### Acceptance currencies

| Market | Currency |
|  --- | --- |
| UK | CNY1 AUD2, GBP2 EUR2, CAD2, SGD2, JPY2, USD2 |
| Europe | CNY1, HKD2, AUD2, GBP2, EUR2, CAD2, SGD2, JPY2, USD2 |
| Hong Kong | HKD1 |
| Singapore | CNY1 |


1 Indicates that you can authorize in this currency, but you receive funds in a different currency
2 Indicates that you can authorize and receive funds in the same currency without any FX consideration (depending on your contract)

### Customer journey

#### Desktop with QR code scanned on a mobile device

![Desktop shopper journey](/assets/alipaycn-desktop-journey.7cc72f14e9c93ca21a0e51607b268af65f1fce1f75a80b1a723738b5b491f671.05bf66c6.png)

1. Your customer selects AlipayCN as a payment method on your desktop site
2. Your customer is redirected to the AlipayCN payment page which displays the AlipayCN QR code
3. Your customer scans the QR code using the scan function within their AlipayCN mobile app
4. Your customer is presented with the transaction details and funding options. Your customer then confirms the payment
5. Your customer enters the payment password to authenticate the transaction
6. Your customer receives successful payment confirmation
7. Back on your customer's desktop browser, AlipayCN confirms that the payment is successful and returns your customer to your payment success page (defined by the `successURL`)


#### Mobile device with AlipayCN app

![Mobile shopper journey](/assets/alipaycn-mobile-journey.1f59ab03084dad2b736eee3905c8ae5d15233af1aafde6a7ccc0cb4761e117d4.05bf66c6.png)

1. Your customer selects AlipayCN as a payment method on your mobile browser site/ in-app checkout page
2. Your customer is redirected to AlipayCN app on their mobile device to confirm the payment. If the AlipayCN app is not installed, your customer is prompted to install the app
3. Your customer keys in the payment password to authenticate the transaction
4. Your customer receives successful payment confirmation
5. Your customer clicks the "Done" button and returns to the your payment success page (defined by the `successURL)`


## Get started

Get started using our [API reference](/products/apms/openapi) and set your headers.

## Request

`POST` `https://try.access.worldpay-bsh.securedataplatform.com/apmPayments`

### Example requests

### Parameters

## Response

#### Successful request response

* an HTTP code 201
* a `paymentId` which is unique to the payment - we recommend storing the "id" as this can be used to manage the payment later
* a url to redirect your customer to the APM provider to complete the payment
* a link to query the payment status
* an object which will give flow information such as `method` (e.g. `alipaycn`) and type (`direct`)
* a `commandId` generated by us identifying a single merchant interaction (e.g. `cmdYNdIHBPJwbkjLiykzTx0`)


### Example response

Successful
{
  "paymentId": "HZ75WBkfRwmD9YzLSZFnQ5v2I5ddQFtUqfQjfH6MtZWlDSUrxrcX5x_wn93uYUZBrpxTgfQTxtQsmy9dE_z-m-zZvrP-LeCRz0uWrqdvJK9lFEMgr042IFWuXU4qz5JB5ruD3eXP8P1s6nqEcRq5d-NwnkVtXPzEhC9FQ_77m3c",
  "lastEvent": "pending",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay-bsh.securedataplatform.com/apmPayments/HZ75WBkfRwmD9YzLSZFnQ5v2I5ddQFtUqfQjfH6MtZWlDSUrxrcX5x_wn93uYUZBrpxTgfQTxtQsmy9dE_z-m-zZvrP-LeCRz0uWrqdvJK9lFEMgr042IFWuXU4qz5JB5ruD3eXP8P1s6nqEcRq5d-NwnkVtXPzEhC9FQ_77m3c"
    }
  },
  "_actions": {},
  "redirect": "https://secure-test.worldpay-bsh.securedataplatform.com/jsp/test/shopper/APMSTSimulator.jsp?customerRef=3413879489&paymentMethod=ALIPAY_CN",
  "paymentInstrument": {
    "method": "alipay_cn",
    "type": "direct"
  },
  "commandId": "cmdEy5vwB0krLe9eMwAcE66c0"
}
Error response
{
  "errorName": "bodyDoesNotMatchSchema",
  "message": "The json body provided does not match the expected schema",
  "validationErrors": [
    {
      "errorName": "fieldHasInvalidValue",
      "message": "Field is mandatory",
      "jsonPath": "$.instruction.value.amount"
    }
  ]
}
#### Errors

Check out our API reference for the full [error code schema](/products/apms/openapi/other/payment#other/payment/response&c=400).

**Next steps**

[Manage your Alipay China payment](/products/apms/manage/)