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.
Note
This guide helps you integrate WeChat Pay in your online checkout flow. For in-person payments with Stripe Terminal, visit Additional payment methods.
Checkout
Direct API
iOS
Android
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.
Enable WeChat Pay as a payment method
When creating a new Checkout Session, you need to:
- Enable WeChat Pay in your Dashboard. Stripe automatically displays WeChat Pay to eligible customers using dynamic payment methods . If you currently specify payment _ method _ types , see the migration guide .
- Pass the client as web in the payment _ method _ options. wechat _ pay hash.
- Make sure all your line _ items use the same currency.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 while testing routes you to a Stripe hosted page, which allows you to simulate authorizing the test payment.