Accept a WeChat Pay payment
Use the Payment Intents and Payment Methods APIs to accept WeChat Pay, a digital wallet popular with customers from China.
Caution
Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.
If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the Dashboard.
WeChat Pay is a single-use payment method. Customers pay with WeChat Pay by scanning the QR code that they see during Checkout. Completing the payment redirects customers back to your website.
Determine compatibility
A Checkout Session must satisfy all of the following conditions to support WeChat Pay payments:
- Prices for all line items must be in the same currency. If you have line items in different currencies, create separate Checkout Sessions for each currency.
- You can only use one-time line items (WeChat Pay Checkout Sessions don’t support recurring subscription plans).
Accept a payment
Note
This guide builds on the foundational accept a payment Checkout integration.
This guides you through enabling WeChat Pay and shows the differences between accepting a card payment and using WeChat Pay.
Enable WeChat Pay as a payment method
When creating a new Checkout Session, you need to:
- Add
wechat_
to the list ofpay payment_
method_ types - Pass the
client
as'web'
in thepayment_
hashmethod_ options. wechat_ pay - Make sure all your
line_
use the same currencyitems
Fulfill your orders
After accepting a payment, learn how to fulfill orders.
Test your integration
When testing your Checkout integration, select WeChat Pay as the payment method and click the Pay button, which renders a QR code.
Scanning the QR code in test mode routes you to a Stripe hosted page, which allows you to simulate authorizing the test payment.