Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewUpgrade your integration
Online payments
OverviewFind your use caseUse Managed Payments
In-person payments
Payment methods
Payment scenarios
Beyond payments

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.

Caution

Stripe can automatically present the relevant payment methods to your customers by evaluating currency, payment method restrictions, and other parameters.

  • Follow the Accept a payment guide to build a Checkout integration that uses dynamic payment methods.
  • If you don’t want to use dynamic payment methods, follow the steps below to manually configure the payment methods in your Checkout integration.

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:

  1. Add wechat_pay to the list of payment_method_types
  2. Pass the client as 'web' in the payment_method_options.wechat_pay hash
  3. Make sure all your line_items use the same currency
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'


Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['wechat_pay'],

  # or you can take multiple payment methods with
  # payment_method_types: ['card', 'wechat_pay', ...]

  # Specify the client (currently, Checkout only supports a client value of "web")
  payment_method_options: {
    wechat_pay: {
      client: 'web',
    },
  },
  line_items: [{
    price_data: {
      currency: 'usd',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

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.

See also

Was this page helpful?
YesNo