**Last updated**: 13 March 2026 | [**Change log**](/access/products/apms/changelog/)

# Alipay+

A cross-border payment solution that connects businesses with a vast network of digital wallets across Asia and globally.

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

details
summary
Product overview
Alipay+, also written as Alipay Plus or Alipay Uni, acts as a unified gateway, allowing international buyers to pay with their preferred local e-wallets.

* For both online and in-store transactions, Alipay+ facilitates real-time deductions from your customer's local e-wallet, automatically converting payments into the merchant's currency and sending the amount directly to their acquirer.
* Its unified integration significantly simplifies cross-border payment acceptance, reducing the cost associated with managing multiple individual e-wallet integrations.
* Its streamlined process enables high conversion rates, with low chargeback/dispute rates.


### Feature summary

| Payment type | Recurring | Reversals | Partial reversals | Auth and settlement (sale) |
|  --- | --- | --- | --- | --- |
| Digital wallet | ❌ | Refund - yesCancel - no | Partial refund - yesPartial cancel - no | ✅ |


Maximum payment amount USD 10,000.00. If you require a higher amount please discuss your requirements with your Relationship Manager or Support team.

### Supported wallets

| Wallet | Market |
|  --- | --- |
| Alipay | Chinese mainland |
| AlipayHK | Hong Kong SAR, China |
| BillEase | Philippines |
| Boost | Malaysia |
| BPI | Philippines |
| DANA | Indonesia |
| GCash | Philippines |
| Hipay | Mongolia |
| K Plus | Thailand |
| Kakao Pay | South Korea |
| Kredivo | Indonesia |
| NAVER Pay | South Korea |
| Rabbit LINE Pay | Thailand |
| Tinaba | Italy |
| Touch 'n' Go eWallet | Malaysia |
| Toss Pay | South Korea |
| TrueMoney Wallet | Thailand |


Note
Alipay+ retains discretion regarding wallet onboarding approvals. We cannot guarantee the universal availability of all wallets across all merchants.

### Acceptance currencies

| Market | Currency |
|  --- | --- |
| UK | GBP1, CNY2, HKD2, EUR2, KRW2, PHP2, THB2, MNT2, MYR2, IDR2 |
| Europe | EUR1, CNY2, HKD2, KRW2, PHP2, THB2, MNT2, MYR2, IDR2 |
| Hong Kong | HKD1, CNY2, EUR2, KRW2, PHP2, THB2, MNT2, MYR2, IDR2 |
| Singapore | SGD1, CNY2, HKD2, EUR2, KRW2, PHP2, THB2, MNT2, MYR2, IDR2 |
| Japan | JPY1 |


1Indicates that you can authorize and receive funds in the same currency without any FX consideration for all wallets.
2Indicates that you can authorize in this currency, but you receive funds in a different currency for some wallets.

### Customer journey

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

![Desktop QR customer journey in 7 steps](/access/assets/alipay-desktop-qrjourney.cc8b64a7fde56fb28dedd7fb71bf348b90c0b75260abf03281293cd86efa8a72.05bf66c6.png)

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


#### Desktop username and password log in

![Desktop username and password log in in 5 steps](/access/assets/alipay-desktop-username-and-password-log-in.2badb171aeeee6a751d07a5b9446f3aa91e2f6ba8e971dbc19c57f99598446bc.05bf66c6.png)

1. Your customer chooses Alipay+ as their payment method on your desktop site.
2. They click on the checkout button and are taken to the Alipay+ checkout page. Alipay+ determines your customer's locally available wallets using their IP address. Locally available wallets are displayed at the top of the page, with other wallets below. Your customer chooses their preferred wallet.
3. Your customer confirms payment in the wallet application, e.g. Alipay CN - KaKaoPay.
4. They receive confirmation that the payment is successful.
5. Your customer is redirected back to your specified `successURL`.


#### Mobile device with Alipay+ app

![Mobile customer journey in 5 steps](/access/assets/alipay-mobile-journey.c2eb5f6a93587a30e3878d671e6a5d8bcf0092cca74fe4bf2a56be98fec2da4d.05bf66c6.png)

1. Your customer chooses Alipay+ as their payment method on your mobile browser site/ in-app checkout page.
2. They click on the checkout button and are taken to the Alipay+ checkout page. Alipay+ determines your customer's locally available wallets using their IP address. Locally available wallets are displayed at the top of the page and other wallets below. Your customer chooses their preferred wallet.
3. Your customer confirms payment in wallet application e.g. Alipay CN - KaKaoPay.
4. They receive confirmation that the payment is successful.
5. Your customer is redirected back to your specified `successURL`.


Best practice
For an optimized mobile experience, we strongly recommend passing `deviceData` object in the request.
Supplying these fields ensures that customers who do not have the underlying wallet app on their phone do not see errors.

## Get started

Use our [API reference](/access/products/apms/openapi) and set your headers.

## Request

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

### Example requests

### Parameters

## Response

### 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_UNI",
  "paymentInstrument": {
    "method": "alipay_uni",
    "type": "direct"
  },
  "commandId": "cmdEy5vwB0krLe9eMwAcE66c0"
}
```

Error response

```json
{
  "errorName": "bodyDoesNotMatchSchema",
  "message": "The json body provided does not match the expected schema",
  "validationErrors": [
    {
      "errorName": "fieldHasInvalidValue",
      "message": "Field is mandatory",
      "jsonPath": "$.instruction.value.amount"
    }
  ]
}
```

### Schema

#### Errors

Check out our API reference for [more responses or error codes](/access/products/apms/openapi/other/payment#other/payment/response&c=400).

## Simulation

To simulate payment outcomes and trigger webhooks in our Try environment you can send a request prompting our simulator.

You receive a `redirect` link to our simulator where you can choose different payment outcomes:

| Simulator outcome option | Payment status | Description |
|  --- | --- | --- |
| Authorised | `authorized` | Payment authorized successfully. |
| Authorised and Captured | `sentForSettlement` | Your customer’s payment is in the process of being settled. |
| Refused | `refused` | Unsuccessful payment - failure response from the provider. |
| Error | `error` | Error in processing the payment or the session timed out. |
| Shopper Cancelled | `cancelled` | Your customer cancelled the transaction. |


Furthermore, you can use magic values in amount to generate specific outcomes. Adding an amount other than the below magic values shows a happy path.

| Simulator flow | Magic value | Outcome |
|  --- | --- | --- |
| Sale | 500 | Error in sale response |
| Reversals with amount | 700 | Error in reversal response, received via webhooks |


**Next steps**

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