Payment gateway for WooCommerce – Woo WeChatPay


Woo WeChatPay is a companion plugin for WP Weixin that adds a WeChat Pay payment gateway to WooCommerce-powered websites.
Customers can pay both in the WeChat browser (JSAPI), mobile browsers (H5), or from their computer via a QR code.
Upon purchase and if activated in settings, customers may receive a notification in the WeChat Official Account with a templated message if they are a follower.


Important Notes

  • Does NOT support cross-border payments (possibly planned for v1.4).
  • Make sure to read the “TROUBLESHOOT, FEATURE REQUESTS AND 3RD PARTY INTEGRATION” section below and the full documentation before contacting the author.


This plugin adds the following major features to WooCommerce and WP Weixin:

  • Payment of WooCommerce orders in WeChat mobile app: uses the WeChat JSAPI for a seamless experience.
  • Payment of WooCommerce orders in mobile web browser app: calls the WeChat H5 API for a seamless experience.
  • Payment of WooCommerce orders with WeChat via QR Code: for customers using WeChat Pay in classic browsers.
  • Support for “pay again”: allows customers to continue the payment process of Pending orders.
  • Refund of WooCommerce orders: possibility to refund orders manually in a few clicks, and support for automatic refund in case the transaction failed.
  • Templated message notification in WeChat: send a WeChat templated message to the customer upon purchase (if following the Official Account – completely customisable via filters).
  • Multi-currency support: using an exchange rate against Chinese Yuan configured in the settings.

Compatible with WooCommerce Multilingual, WPML, Ultimate Member, WordPress Multisite, and many caching plugins.

Troubleshoot, feature requests and 3rd party integration

Unlike most WeChat integration plugins, Woo WeChatPay is provided for free.

Woo WeChatPay is regularly updated, and bug reports are welcome, preferably on Github. Each bug report will be addressed in a timely manner, but issues reported on WordPress may take significantly longer to receive a response.

Woo WeChatPay has been tested with the latest version of WordPress and WooCommerce – in case of issue, please ensure you are able to reproduce it with a default installation of WordPress, WooCommerce plugin, and Storefront theme and any of the aforementioned supported plugins if used before reporting a bug.

Feature requests (such as “it would be nice to have XYZ”) or 3rd party integration requests (such as “it is not working with XYZ plugin” or “it is not working with my theme”) will be considered only after receiving a red envelope (红包) of a minimum RMB 500 on WeChat (guarantee of best effort, no guarantee of result).

To add the author on WeChat, click here, scan the WeChat QR code, and add “Woo WeChatPay” as a comment in your contact request.


  • The WooCommerce checkout page with the WeChat Pay payment gateway in classic browsers.
  • The WooCommerce checkout page with the WeChat Pay payment gateway in WeChat.
  • The QR code payment screen in classic browsers.
  • The WooCommerce WeChat Pay payment gateway settings page.
  • The WeChat Pay settings added to the WP Weixin settings page.


This section describes how to install the plugin and get it working.

  1. Upload the plugin files to the /wp-content/plugins/woo-wechatpay directory.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Edit plugin settings


مئی 20, 2020
按照插件的要求填写了相关的各种密钥,但是到最后一步支付的时候仍然显示“处理结果时出错,请重试”,无法支付,求帮助,如果有热心的大神,希望能帮助我,我的邮箱。 Filled in the relevant keys according to the requirements of the plug-in, but the last step of payment still shows “An error occurred while processing the results, please try again” ,my
پروری 27, 2020
پروری 22, 2020
Adopted in my website for more than one week, so far so good. To use this plugin, wp weixin plugin need to be installed first, after setting finished,in Woocommerce payment tools page, wechat pay will be showed in the list. what you need to do is click on-button. The developer even design some pages for the wechat,like checkout page and call back page, mobile device also work fine. Thanks.
اپریل 5, 2024 1 reply
<!– wp:paragraph –> <p class=””> 事实上,微信方面已经对海外所有人开放了。微信资料可以以海外护照认证,可以绑定信用卡。支付宝也一样。</p> <!– /wp:paragraph –>
Read all 5 reviews

Contributors & Developers

“Payment gateway for WooCommerce – Woo WeChatPay” is open source software. The following people have contributed to this plugin.


“Payment gateway for WooCommerce – Woo WeChatPay” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Payment gateway for WooCommerce – Woo WeChatPay” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Remove WooCommerce compatbility tag (reason: irrelevant)
  • WordPress tested up to: 6.4.3


  • Commit to ensure compatibility until WP Weixin 1.4


  • Bugfix: version sync


  • WP Weixin tested up to: 1.3.13


  • WordPress tested up to: 5.4.1
  • WP Weixin tested up to: 1.3.12


  • WC tested up to: 4.0.0
  • WP Weixin tested up to: 1.3.11
  • Translation updates


  • WC tested up to: 3.9.2
  • WP Weixin tested up to: 1.3.10


  • WC tested up to: 3.9.1
  • WP Weixin tested up to: 1.3.9


  • WP Weixin tested up to: 1.3.8
  • Minor fixes


  • WP Weixin tested up to: 1.3.7


  • Added email notification to admin in case of rare edge case of paid WeChat Pay transaction with order not found in WooCommerce
  • Minor bugfix & optimisation
  • WC tested up to: 3.9.0
  • Change plugin display name to comply with WordPress guidelines more tightly


  • Bump version to match WP Weixin
  • Require WP Weixin v1.3.5
  • Remove commented code
  • Add call to wp_weixin_ajax_safe
  • Add support for mobile web browsers using the H5 API, with gateway configuration and WeChat merchant platform backend help


  • Major overall code refactor
  • Multisite support
  • Use new WP Weixin functions instead of using the classes directly
  • Use WooCommerce logger everywhere
  • Refund reason sent to WeChat
  • Ensure compatibility with other plugins using WeChat Pay API
  • Add woo_wechatpay_templated_message action hook
  • Disable all the Alipay-related payment gateways (looking for alipay or zhifubao in the gateway ID) in WeChat browser by default to prevent conflicts
  • Rename pay-again.php template file to redirected-pay.php.
  • Add woowechatpay_filter_wechat_gateways filter to control the available payment gateways in WeChat browser
  • Attempt to refund order automatically in case of failure
  • Update checkout script (fix undefined index has_full_address warning)
  • Update documentation
  • Update translation

Special thanks:

  • Thanks @alexlii for extensive testing, translation, suggestions and donation!
  • Thanks @lssdo for translation
  • Thanks @kzgzs for improvement suggestions


  • Preserve cart on checkout
  • Mobile WeChat payment: do not leave checkout when payment is cancelled
  • Handle refunds via WeChat Pay
  • Adjust methods visibility
  • Add WooCommerce logger
  • Fix currency rate conversion
  • Add gateway description


  • Better error log
  • Fix “pay again”


  • Public plugin on WordPress repository


  • Remove WP Package Updater – no more private plugin, please update to the public plugin (v1.1)


  • Adjust rewrite rules registration


  • Rearrange hooks firing sequence
  • Add icons and banners
  • Add readme.txt


  • Coding standards


  • Add WP Package Updater


  • First version