China WeChat Pay

China WeChat Pay

Compatible With: Community 2.0, 2.1, 2.2

Tech Specifications

Current Version:
Stable Build
29 November, 2017
Extensions, Payments & Security
License Type:
Open Software License 3.0 (OSL-3.0)


This module is a payment gateway which allows your site to process payment through China WeChat Pay QR Code API and In-APP Web-based Payment JSAPI.

Other Extensions by Sunflowerbiz


Back to top

WeChat is Chinese social media (instant messaging, commerce and payment services) mobile application software developed by Tencent. It was first released in 2011 and by 2017. It was one of the largest standalone messaging apps by monthly active users, with over 963 million monthly active users. It is widely known as one of the world's most innovative and versatile app, as well as China's "App For Everything", with numerous unique functions and platforms ranging from 'payment' to 'social media' to 'services' to 'shopping' and more, that are equivalent to multiple Google Play or Apple Store's apps, but merged into one. 

WeChat Pay is a digital wallet service incorporated into WeChat, which allows users to perform mobile payments and send money between contacts. As of March 2016, WeChat Pay has over 300 million users worldwide.

The SunflowerBiz China WeChat Pay Module is a payment gateway which allows your site to process payment through China WeChat Pay QR Code API for Chinese Payer to go to "Scan QR Code" in their WeChat in order to complete payment. Also, our module integrates WeChat In-APP Web-based Payment JSAPI to call WeChat payment module to pay their transaction when Chinese Payer opens the Vendor's HTML5 pages on their WeChat. 

Before using this payment module, you have to register Wechat Social Media Account and Wechat pay Merchant Account on Wechat pay official site to get all necessary info after submit application documents and get approved by WeChat pay (Extra fee may be charged by China WeChat pay)


 QR Code Payment API 

The Vendor generates a transaction QR Code according to the WeChat Payment Protocol and the Chinese Payer goes to "Scan QR Code" in their WeChat in order to complete payment. This mode is applicable to payments made on websites, physical stores, media advertising, or other scenarios.


4 Steps to Pay via QR Code API

  • Use Wechat scan QR Code
  • Confirm Pay 
  • Enter Password
  • Payment successful


In-App Web-based Payment JSAPI


The Chinese Payer opens the Vendor's HTML5 pages on their WeChat and calls the WeChat payment module via the JSAPI interface to pay their transaction.


This mode is applicable in the following scenarios:

  • The Chinese Payer enters the Vendor’s official account and completes their payment on the transaction page;
  • The Chinese Payer’s friend shares the Vendor's payment URL in a chat or in Moments and the payer clicks the link to complete their payment;
  • The Payer scans the payment QR Code displayed within the Vendor’s page and opens it in a browser to complete their payment.


5 Steps to Pay via In-App Web-based Payment JSAPI


  • Subscribe the vendors 
  • Enter password
  • Payment successful
  • Return the vendors page
  • Customer receives message


Cross-border Payment

Chinese customers pay transactions in CNY

When Chinese shoppers buy goods overseas, they can pay in CNY by WeChat Pay. The local currency will be converted into CNY based on real-time rate. 

Cross-currency settlement is accepted

Major currencies are included but not limited to GBP, HKD, USD, JPY, CAD, AUD, EUR, NZD, and KRW. WeChat Pay settles each transaction with foreign vendors based on the price in local currency. For unsupported currencies, transactions can be made in US dollar.

T+1 day settlement

T+1 day settlement ensures a fast and safe payment transaction.



Supported currencies



Settlement Model

Settlement per amount: The minimum amount of transfer to Merchant by Tenpay is US$5,000 or its equivalent in other currencies. If the settlement payment to Merchant is less than US$5,000 or its equivalent in other currencies in any settlement period, such settlement payment will not be remitted to Merchant and will be accrued to the next settlement period.

Settlement Period: Settlement shall be made based on T+1, which means a transaction on T day shall be settled on T+1 (in case of a statutory public holiday at the place where Tenpay is located, settlement shall be made on the day following the statutory public holiday).

The Handling Fee of Transfer shall be shared between the Parties, means that the Handling Fee for transfer of settlement payment receivables by Merchant from the PRC banks to a foreign bank shall be borne by Tenpay, and all other charges such as the costs of intermediary banks or receiving banks shall be borne by Merchant.


Application Conditions

  • Business Registration Certificate, Financial License, Anti-Money Laundering Questionnaire, ID certificates of Directors,Main Contacts and Legal Representatives.
  • Industries must be compliant with all the applicable laws and in accordance with WeChat Pay Requirement.



  • Use WeChat Pay QR Code API
  • Support WeChat In-App Web-based Payment JSAPI
  • Support Cross-border Payment
  • Need to register WeChat Social Media Account and WeChat Pay Merchant Account by submitting application form on WeChat pay official site (Extra fee may be charged by WeChat pay) 


Additional Information:




Release Notes

Back to top


  • Compatible with CE: 2.0 2.1 2.2
  • Stability: Stable Build
  • Description:

    Wechat Payment stable version V 1.0.0


Back to top
The best place to start if you need help with a specific extension is to contact the developer. All Magento developers have both a contact email and a support email listed.

Q & A

Back to top


Back to top