Checkout

Integration type API Reference
Payment Page
Payment Link

Coverage

CountriesChina (CN)
CurrenciesChinese Yuan Renminbi (CNY)
Min amount0.01 CNY
Max amount3,000.00 CNY

Capabilities

RecurringYes
RefundYes
Partial refundsYes
Multiple partial refundsYes
ChargebackNo

Principle of operation

Alipay supports both one-time and recurring payment flows, providing flexibility for a range of business models.

Payment The payment method is not saved with the merchant, and a consumer is required to authenticate themselves each time a one-time purchase is requested. Mobile
  1. Selection at checkout
    Customer selects Alipay as the payment method at checkout.
  2. Authentication and authorization
    Customer is redirected to their app to confirm this payment method.
  3. Payment initiation
    Once the payment is authenticated in the app, the transaction is processed seamlessly.
  4. Merchant notification
    Merchant receives a notification Webhook confirming the payment status.
Alipay payment flow example Alipay payment flow example Alipay payment flow example Desktop
  1. Selection at checkout
    Customer selects Alipay as the payment method at checkout.
  2. Authentication and authorization
    Customer is redirected to the Alipay payment page, which contains a QR code to be scanned with the Alipay app to confirm payment.
  3. Payment initiation
    Once the payment is authenticated in the app, the transaction is processed seamlessly.
  4. Merchant notification
    Merchant receives a notification Webhook confirming the payment status.
Alipay payment flow step 1 Recurring payments

Both follow-up CIT and MIT payments are available with the same token. For recurring payments, customers can easily cancel the mandate at any time within their app — in such cases, Solidgate cancels the subscription and notifies the merchant. The notification about a cancelled mandate is only available to payment providers that can notify when the payment method is no longer linked.

Only one active mandate is allowed per customer per merchant. Since a mandate is generated only during the initial payment, any upsells or additional subscriptions must use the existing recurring token.


  • If a token exists, use it for the upsell
  • If no token exists, run the initial payment flow to create a new mandate
Mobile
  1. Selection at checkout
    Customer selects Alipay as the payment method at checkout and enters phone number.
  2. Authentication and authorization
    Customer is redirected to Alipay app to confirm the payment and authorize future automatic debits ("sign mandate"). This process registers the local payment method with the merchant.
  3. Payment initiation
    Once the payment is authenticated in the app, the transaction is processed seamlessly.
  4. Merchant notification
    Merchant receives a notification Webhook confirming the payment status.
Alipay recurring payment flow example Alipay recurring payment flow example Alipay recurring payment flow example Desktop
  1. Selection at checkout
    Customer selects Alipay as the payment method at checkout and enters phone number.
  2. Authentication and authorization
    Customer is redirected to the Alipay payment page, where a QR code is displayed for scanning with the Alipay app to confirm the payment and authorize future automatic debits (“sign mandate”). This process registers the local payment method with the merchant.
  3. Payment initiation
    Once the payment is authenticated in the app, the transaction is processed seamlessly.
  4. Merchant notification
    Merchant receives a notification Webhook confirming the payment status.
Alipay payment flow step 2

Brand requirements

Merchants must display the Alipay + Partner brand and the wallet brand based on available image area, and apply the required changes on both desktop and mobile platforms before and after the authorization screen:

Alipay QR code display
  • 2 image areas: Show wallet brand and Alipay+ Partner image.
  • 1 image area: Display wallet brand as an image and Alipay+ Partner brand as text.
  • No image area: Display both brands as text.

Merchant should display the wallet brand name on the payment page as below:

支付宝
Alipay 2 image areas branding example Download asset *zip Alipay + Partner 1 image area branding example Download asset *zip Alipay + Partner blue No image area branding example Download asset *zip

After authorization is successful, the merchant should display the payment method along with Alipay + Partner wallet branding as below.