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.
- A China Mainland WeChat Official Account – Service account.
- A China Mainland WeChat Pay account.
- WP Weixin installed, activated, enabled and properly configured.
- 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.
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.
This section describes how to install the plugin and get it working.
- Upload the plugin files to the
- Activate the plugin through the ‘Plugins’ screen in WordPress
- Edit plugin settings
Contributors & Developers
“Payment gateway for WooCommerce – Woo WeChatPay” is open source software. The following people have contributed to this plugin.Contributors
“Payment gateway for WooCommerce – Woo WeChatPay” has been translated into 1 locale. Thank you to the translators for their contributions.
Interested in development?
- 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
- 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
- Disable all the Alipay-related payment gateways (looking for
zhifubaoin the gateway ID) in WeChat browser by default to prevent conflicts
pay-again.phptemplate file to
woowechatpay_filter_wechat_gatewaysfilter 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
- 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