Description
MutoPay for WooCommerce lets your customers pay with any cryptocurrency token across 7+ blockchain networks. You always receive your preferred stablecoin (USDC, USDT, or DAI).
How it works:
- Customer selects “Pay with Crypto” at checkout
- They’re redirected to MutoPay’s hosted payment page
- Customer connects their wallet and pays with any token
- MutoPay converts the payment to your preferred stablecoin
- Your WooCommerce order is automatically updated via webhook
Supported chains: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche
Features:
- No frontend JS — uses MutoPay’s hosted payment page
- Automatic order status updates via webhooks
- WP-Cron fallback polling for reliability
- HMAC-SHA256 webhook signature verification
- Debug logging for troubleshooting
- HPOS (High-Performance Order Storage) compatible
External Service
This plugin relies on the MutoPay payment processing service to handle cryptocurrency payments. When a customer selects crypto payment at checkout, the plugin communicates with the MutoPay API (https://mutopay.com/api/) to create and monitor payments.
Data sent to MutoPay includes: order total, currency, order number, item count, customer email, and your store URL. No sensitive payment card data is ever transmitted.
Installation
- From WP Admin, go to Plugins Add New Upload Plugin, choose the
mutopay-for-woocommerce.zipfile, then install and activate. (Alternatively, upload the unzippedmutopay-for-woocommercefolder to/wp-content/plugins/via FTP.) - After activation, WordPress redirects you to the MutoPay settings page automatically.
- Click “Connect to MutoPay”. You’ll be sent to mutopay.com to sign in, then bounced back with your API key and webhook secret configured for you. No manual copy-paste.
- Set your settlement wallet address in your MutoPay dashboard if you haven’t already. The plugin won’t let you enable the gateway without it.
- Toggle the gateway on, save, and run a test checkout.
FAQ
-
What currencies are supported?
-
MutoPay supports 30+ fiat currencies including USD, EUR, GBP, SAR, AED, JPY, and more. Your store’s currency is automatically converted to USD for on-chain settlement.
-
How do I set up webhooks?
-
The “Connect to MutoPay” button handles webhook setup automatically. The plugin generates a webhook URL on your store and registers it with MutoPay along with a shared HMAC secret during the OAuth flow. No manual configuration is required.
-
Can I issue refunds through the plugin?
-
Crypto payments cannot be refunded automatically. You’ll need to arrange manual refunds directly to the customer’s wallet address.
-
What happens if webhooks fail?
-
The plugin includes a WP-Cron fallback that polls MutoPay for payment status every 15 minutes. Orders will be updated even if webhooks are blocked by your firewall.
-
Is my webhook URL behind HTTP auth or a firewall?
-
The webhook URL must be publicly accessible for MutoPay to deliver payment notifications. If your site is behind HTTP auth (common in staging), the WP-Cron fallback will handle order updates instead.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“MutoPay for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “MutoPay for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.4
- Removed “Powered by MutoPay” attribution from the default checkout description shown to customers. Per WordPress.org guidelines, credit links must not appear on user-facing interfaces without explicit admin opt-in. Merchants can still add any description they choose in the gateway settings.
1.0.3
- Annotated Plugin Check warnings: the connect (OAuth) callback uses a state token rather than a nonce for CSRF, and the cron poller’s order meta query is intentionally bounded.
1.0.2
- Security: added a one-time state parameter to the MutoPay connect (OAuth) callback to defend against CSRF, plus an explicit capability check on the callback handler.
1.0.1
- Moved inline admin scripts into enqueued JS files for WordPress.org guideline compliance.
1.0.0
- Initial release
- Payment gateway with hosted checkout redirect
- Webhook receiver with HMAC-SHA256 verification
- WP-Cron fallback polling
- HPOS compatibility