WeChat Pay

WeChat Pay
Accept WeChat Pay to reach over one billion Chinese consumers with in-app and QR-code-based mobile payment flows for cross-border sales
Payment typeWallet
Payment flowRedirect

Checkout

Integration type API v1
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

WeChat Pay, part of China’s most widely used social platform, is among the top mobile payment solutions in the country, serving almost 1 billion consumers. Its seamless in-app payments and integration across digital services make it a preferred choice for online transactions.

Merchants targeting China rely on WeChat Pay acceptance to ensure coverage of the nation’s core digital payment ecosystem.

Principle of operation

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

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.
  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
  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

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
  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
  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:

微信支付

Looking for help? Contact us
Stay informed with Changelog