stripe-express doc logo
Launch Stripe Express

Create Stripe WeChat Pay Element

How to create WeChat Pay Element

WeChat Pay enables Chinese consumers to pay directly via online transfer from their account. Customers are given a QR Code to scan using their WeChat mobile application to approve payments. The seller will be paid in the seller's own currency as configured on Stripe.


  • A premium license

Activate Payment methods in your Stripe Settings

WeChat & Alipay Pay is not enabled by default, as you must manually activate it in your payment methods list in your Stripe Dashboard.

you'll need to set up AliPay or WeChat Pay in your Stripe settings. Click the Settings tab on the left, then click Payment methods: wechat-activation

Click Activate next to AliPay or WeChat Pay. Wait for processing, until the status is "Live" or you recevied a confirmation email.

Setting up a Stripe WebHook

WeChat pay needs stripe webhook events. For how to setup a stripe webhook, refer to setting-up-webhook

Create WeChat Pay element

Exactly same as create element

  1. Switch to Elments tab and click Create button.
  2. In category, choose Digital Wallet or Checkout Form (Both of them are only shown in premium version).
  3. Choose WeChat Pay and give an amount to finish the creation.
  4. Copy the element shortcode to your page.

Test WeChat Pay

Click on the button: wechat button

Generate QR code: wechat dialog

wechat dialog qrcode

Scan QR code in WeChat:

FAQ on WeChat

Q. What is the refund policy for these payment methods? Alipay: Payments made with Alipay can only be submitted for refund within 90 days from the date of the original charge. After 90 days, it is no longer possible to refund the charge.

WeChat Pay: Payments made with WeChat Pay can only be submitted for refund within 180 days from the date of the original charge. After 180 days, it is no longer possible to refund the charge.

Q. How do QR codes work? A QR code is simply a generated image, which is then translated into a URL. When viewing a QR code with your device's camera, you will be automatically asked to open the link on your device.

Q. Is it possible to “long press” on QR code to trigger wechat pay? Case 1. If your customer visits your payment page from mobile browser like Chrome, then there is no way to wake up WeChat app with scanning the code. But don’t worry, most of Chinese are used to download/screen capture the QR Code as image and then scan it from WeChat by importing.

Case 2). If customer visit/open your payment page in built-in browser from WeChat, then customer can long press the code and then there is an action called “Scan QR Code” from context menu as below, these actions can directly command WeChat.