Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewChoose your payments solutionGet started with payments
Online payments
Invoice integrations
Payment methods
Payment Methods OverviewGlobal
EU & UK
APAC
7-Eleven
Alipay CN
Pay with QR Code (Desktop Website Browser) - Alipay CNMobile App - Alipay CN
Mobile Website Browser - Alipay CNMini Program - Alipay CNCustoms Declaration - Alipay CN
Alipay HK
Atome
Boost
DANA
DOKU Wallet
Dragonpay
DuitNow
E.SUN (Taiwan ATM & Internet banking)
FPS
FPX
GCash
GoPay
GrabPay - Malaysia
GrabPay - Singapore
Indonesian Bank Transfer
Indonesian Convenience Stores - BETA
Jenius Pay
Kakao Pay
Kiosk Payments
Konbini
Korean Local Cards - BETA
LinkAja
Naver Pay - BETA
OVO
Pay-easy
Payco - BETA
PayNow
Philippines Online Banking
PromptPay
Rabbit LINE Pay
Samsung Pay - BETA
ShopeePay
Taiwan Convenience Stores
Tesco Lotus
Thailand Online Banking
Toss Pay - BETA
Touch 'n Go
TrueMoney
WeChat Pay
Zip - BETA
NORTH AMERICA & LATAM

Mobile App - Alipay CN

Accept Alipay from your shopper’s Android or iOS phone on your mobile app.

Step 1. Initialize a Payment Intent

Create a Payment Intent with the Create a Payment Intent API API.

POST /api/v1/pa/payment_intents/create

JSON

Step 2. Obtain the payment URL

When a shopper selects to pay with Alipay on their mobile app, call the Confirm a Payment Intent API API to get a payment URL, which you can redirect the shopper to their Alipay app to complete the payment.

POST /api/v1/pa/payment_intents/{id}/confirm

JSON

You will get a response similar to the following. Note that the package_name is only available for Android.

JSON

Step 3. Redirect to the Alipay App to complete the payment

You can use the url returned in the confirm Payment Intent response to redirect the shopper to the Alipay app. Shoppers will complete payment in the Alipay mobile app.

We recommend using the native method to check if the Alipay app is installed. On success, try invoking it natively. If invocation fails or if Alipay is not installed, switch to a WebView client to open the fallback URL. The logic is illustrated by the following code sample:

Android

Specify the package name in the <queries> tags of AndroidManifest.xml to enable access to the corresponding app.

Kotlin

Redirect shoppers to the app.

Kotlin

iOS

Redirect shoppers to the app.

Swift

After the customer completes payment, Alipay will redirect the customer to your app, as dictated by the scheme URL specified in your return URL in the Create a Payment Intent API request.

Step 4. Query the payment result status

To get the payment result, we suggest you poll the status of the Payment Intent via the Retrieve a Payment Intent API API. You may start polling the Payment Intent status after the shopper is redirected back to your mobile app, i.e., the return_url passed when creating the Payment Intent.

GET /api/v1/pa/payment_intents/{id}

In addition, Airwallex will notify you of the payment result asynchronously via the webhooks. Please refer to the webhook documentation to set up your webhook accordingly. Although subscribing to webhook events is optional, it is recommended to subscribe to the payment_intent.succeeded webhook which indicates that the shopper has paid the order.