This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

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 (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 (H5): uses the WeChat JSAPI 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


Read all 2 reviews

Contributors & Developers

“Woo WeChatPay” is open source software. The following people have contributed to this plugin.


Translate “Woo WeChatPay” into your language.

Interested in development?

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



  • 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