WooCommerce

This page covers everything you need to know about the China Payments Plugin + WooCommerce integration.

Setting up WeChat Pay, Alipay, and UnionPay for WooCommerce

In order for WooCommerce orders to process correctly, Webhooks must be configured properly.

Feel free to read the documentation below or watch this video that covers everything you need to know about setting up WooCommerce integration for China Payments Plugin.

How to Accept WeChat Pay with WooCommerce

To setup WooCommerce, follow these instructions:

Make sure you've already followed the Setup Process before proceeding.

To activate WeChat Pay, Alipay, and UnionPay for WooCommerce, ensure you have WooCommerce installed.

Go to the WooCommerce Payment Settings, and enable WeChat Pay by China Payments Plugin, Alipay by China Payments Plugin, and UnionPay by China Payments Plugin.

Under "WeChat Pay by China Payments Plugin", you'll see these settings:

WeChat Pay for WooCommerce Settings

The currency of the WooCommerce checkout must match the payout currency of your Stripe account.

Update the Description and Message boxes to change what appears on the frontend during the checkout process.

Under "Alipay by China Payments Plugin", you'll see these settings:

Alipay for WooCommerce Settings

Under "UnionPay by China Payments Plugin", you'll see these settings:

The UnionPay payment method settings allow you to configure the title and description shown to customers at checkout. UnionPay uses an inline card form powered by Stripe Elements — customers enter their card details directly on your checkout page without being redirected.

See how these settings look for your customers on the frontend in the checkout flow documentation for WooCommerce.

WooCommerce Checkout Flow

With the Inline QR code option left as-is, the QR code will appear like this in your WooCommerce checkout:

QR code generated when checking out with WeChat Pay for WooCommerce

When customers scan the QR code and complete payment on their mobile device, your website will automatically refresh and redirect customers to the payment confirmation page, as set in your WooCommerce settings.

The checkout flow is built to check Stripe for payment confirmation every 5 seconds.

UnionPay Checkout Flow

When a customer selects UnionPay at checkout, a secure inline card form appears directly on the checkout page. The customer enters their card number, expiration date, and CVC, then clicks "Place Order." The payment is confirmed instantly via Stripe — no redirect is needed.

Checkout Optimizations (PRO)

PRO users can enable Checkout Optimizations to automatically localize the entire WooCommerce checkout to Simplified Chinese and display prices in CNY alongside your store currency. See the Checkout Optimizations documentation for details.