WeChat Pay via Adyen
This feature is currently a Private Beta release. Contact Chargebee Support to enable WeChat Pay via Adyen for your live and test sites.
WeChat Pay is a popular digital wallet payment method that allows customers to complete payments through the WeChat Pay app. Chargebee supports WeChat Pay as a payment method via the Adyen payment gateway.
For web payments, customers complete the payment through a QR code (on desktop) or a redirect flow (on mobile), depending on their device. Payment status is confirmed via Adyen webhooks.
Supported countries and currencies
The countries and currencies supported by WeChat Pay via Adyen depend on your Adyen merchant configuration. Refer to the Adyen WeChat Pay documentation for the full list of supported currencies and regions.
Prerequisites
To accept WeChat Pay payments using Chargebee, you must:
- Ensure the Adyen payment gateway is configured in your Chargebee site. Learn more
- Confirm that WeChat Pay is enabled in your Adyen account.
- Have a Merchant Account configured for WeChat Pay in Adyen, with API credentials and webhooks enabled.
- Ensure your Chargebee site supports the currencies and regions required for WeChat Pay, as configured in Adyen.
Integration options
You can integrate WeChat Pay via Adyen using the following methods:
| Integration method | Description |
|---|---|
| Chargebee Hosted Pages | Use Chargebee’s hosted checkout pages to accept WeChat Pay payments with minimal integration effort. |
| Chargebee JS | Embed WeChat Pay as a payment method within your custom checkout using Chargebee JS. |
| API (Payment Intent) | Integrate WeChat Pay using Chargebee APIs for a fully custom checkout and payment flow. |
Supported tokens
This integration supports the following set of tokens:
| Token | Description | Format and Sample |
|---|---|---|
| Chargebee Payment Intent ID | This is the Payment Intent ID returned after a successful authorization process using Chargebee JS. | Format: payment_intent[id] |
Configure WeChat Pay in Chargebee
Follow these steps to configure WeChat Pay via Adyen in your Chargebee site:
- Log in to the Chargebee app.
- Go to Settings > Configure Chargebee > Payment Gateways.
- Select the relevant Adyen instance from the list.
- On the Configure Adyen page, enable WeChat Pay under the list of supported payment methods.
- Click Apply to save changes.
Note
WeChat Pay availability depends on your Adyen merchant configuration.
Configure smart routing for WeChat Pay
When you configure WeChat Pay through Adyen, smart routing for the relevant currencies is automatically enabled. Check the Smart Routing settings, and if another gateway is already assigned to those currencies, adjust the Smart Routing settings manually to allocate WeChat Pay.
Follow these steps to modify Smart Routing settings:
- Log in to the Chargebee app.
- Go to Settings > Configure Chargebee > Payment Gateways.
- Click Manage Rules under Smart Routing.
- Go to the WeChat Pay section and click Add a Gateway for the relevant currency. If you already have a gateway assigned, click Edit.
- From the Choose a payment gateway drop-down menu, select the relevant Adyen instance with WeChat Pay enabled.
- Click Save.
Enable WeChat Pay to pay for subscriptions
WeChat Pay is a one-time payment method and cannot be used for recurring payments. To use it for subscriptions, configure your Chargebee site to allow all one-time payment methods for subscriptions.
Note
While testing, ensure Allow customers to pay for subscriptions with payment methods that only support one-time payments and One-time Payments - Enable button are enabled under Settings > Configure Chargebee > Checkout & Self-Serve Portal.
Follow these steps to enable one-time payment methods for subscriptions:
- In the Chargebee app, go to Settings > Configure Chargebee > Checkout & Self-Serve Portal.
- Select the Configuration tab and enable Allow customers to pay for subscriptions with payment methods that only support one-time payments.
Checkout flow
Your customer performs the following steps during checkout using WeChat Pay via Adyen:
- Initiate checkout and proceed to the payment step.
- Select WeChat Pay as the payment method.
- On desktop, scan the displayed QR code using the WeChat Pay app. On mobile, you are redirected to complete the payment within WeChat Pay.
- Confirm the payment in WeChat Pay.
- Once payment is authorised, you are redirected back to the merchant's website.
Testing
Sandbox testing
WeChat Pay currently has no test platform in Adyen. Contact Adyen to enable testing via a simulator. If you have a personal WeChat account, you can test your integration by following Adyen's guidance for test transactions.
Ensure webhooks are configured to receive AUTHORISATION updates during testing.
Production testing
Before going live:
- Ensure WeChat Pay is enabled in your Adyen live account.
- Verify webhook configuration is complete (mandatory for payment status updates).
- Perform end-to-end testing using a real WeChat Pay account and a device to complete the redirect or QR flow.
Reconciliation
For financial reconciliation between Chargebee and Adyen:
- Use the Chargebee transaction field id_at_gateway, which maps to the pspReference in Adyen.
Follow these steps to reconcile transactions:
- Retrieve the id_at_gateway value from the Chargebee transaction details.
- Locate the corresponding pspReference in Adyen reports for WeChat Pay transactions.
- Match transactions using this reference to ensure financial consistency.
Limitations and important points
- WeChat Pay cannot be added as a payment method via the customer portal or the Chargebee app. Customers must complete the WeChat Pay flow.
- WeChat Pay does not support storing payment methods for recurring billing. Each transaction requires explicit customer authorization.
- WeChat Pay does not support chargebacks. Refunds must be issued manually if needed.
- WeChat Pay has no test platform in Adyen. Contact Adyen to arrange testing.
Was this article helpful?