Checkout

Integration type API Reference
Payment Page
Payment Link

Coverage

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

Capabilities

RecurringYes
RefundYes
Partial refundsYes
Multiple partial refundsYes
ChargebackNo

Principle of operation

WeChat Pay 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 WeChat Pay as the payment method at checkout.
  2. Authentication and authorization
    Customer is redirected to the WeChat Pay payment page, which contains a QR code to be scanned with WeChat Pay 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.
WeChat Pay payment flow example WeChat Pay payment flow example WeChat Pay payment flow example Desktop
  1. Selection at checkout
    Customer selects WeChat Pay as the payment method at checkout.
  2. Authentication and authorization
    Customer is redirected to the WeChat Pay payment page, which contains the QR code from the issuer's URL 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.
WeChat Pay one-time payment desktop flow 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 WeChat Pay as the payment method at checkout and enters phone number.
  2. Authentication and authorization
    Customer is redirected to WeChat 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.
WeChat Pay recurring payment flow example WeChat Pay recurring payment flow example WeChat Pay recurring payment flow example Desktop
  1. Selection at checkout
    Customer selects WeChat Pay as the payment method at checkout and enters phone number.
  2. Authentication and authorization
    Customer is redirected to the WeChat Pay payment page, which contains the QR code from the issuer's URL to confirm this payment method and agree to be charged in the future ("sign mandate"). This step results in a registered local payment method with a 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.
WeChat Pay recurring payment desktop flow

Brand requirements

Display the WeChat Pay name on the payment page as below:

微信支付
WeChat Pay 2 image areas branding example Download asset *zip