Elevate your WooCommerce store to the next level with our WooCommerce Crypto Payments addon. Seamlessly integrate MetaMask, the widely acclaimed cryptocurrency wallet, with WooCommerce to give your customers increased security, freedom, and convenience during checkout.
Below, you’ll find the instructions guiding you through the installation, configuration, and process of importing/exporting products using this invaluable add-on.
Video Tutorial
Watch the tutorial video below for a quick walkthrough of the add-on’s features and setup process.
For detailed instructions, please continue reading the full documentation. If you still have any questions, feel free to submit a support ticket.
Installation
- Install the Woocommerce plugin & activate it.
- Install the WooCommerce Crypto Payments add-on and activate it.
- A new Crypto Payments submenu will be added under the main WooCommerce menu.

Metamask Installation
- Go to the official MetaMask website: https://metamask.io/
- Look for the “Download” button or “Get Chrome Extension” (or respective browser) and install the MetaMask extension.
- Follow the on-screen instructions to add the extension to your browser.
- Once added, a new tab or window will open, guiding you through the process of setting up your MetaMask wallet. Create a new wallet or import an existing one if you have one.


NOTE: Currently, our add-on supports the Ethereum Mainnet and allows payments in both ETH and USDC (ERC-20 token). We’re actively working on incorporating support for additional tokens and blockchain networks in future updates.
Activate Your License Key
You can set up your license key by navigating to the License tab located on the primary menu of WooCommerce. Upon purchase, the license keys will be delivered to your email address.
Simply enter your license key into the designated field and then click on the Activate button.

MetaMask Configuration
To configure the Crypto Payments, navigate to Woocommerce > Settings > Payments > Crypto payments > Enable the toggle and click on Finish Setup.

Enable/Disable (Enable Crypto Payments): Here, you can check/uncheck this payment option to enable/disable this payment gateway on the checkout page.
Enable/Disable (Enable Crypto Payments testing): Here, you can check/uncheck this payment option to enable/disable the testing of the payment gateway on the checkout page. You can use test networks like Sepolia.

Title: Here you can set the Gateway title.
Description: Here you can add the description that the user will see during checkout.
Wallet Address: Add your wallet address where you want to receive the payment.
USDC contract address: Add your USDC contract address where you want to receive the payment.
Crypto Token: Here, you can select which crypto token will be selected by default when the “Pay with Crypto Payments” option is selected on the checkout page.
Once you set these details, then during checkout, the Pay with Metamask option will display.

After a successful payment with Metamask, this is how it shows on the order received screen:


If you have WooCommerce emails enabled, then both the administrator and customer will receive the following crypto payment details via their emails.




After a successful payment with Metamask, this is how it shows on the order screen:


Legacy / HPOS Compatibility
To configure the Crypto Payments with the High-performance order storage (HPOS) or with Legacy order data storage, navigate to Woocommerce > Settings > Advanced > Features > Order data storage > Select one of the 2 options based on your requirements (WordPress posts storage or High-performance order storage) > Check the radio button and click on the “Save Changes” button. You can also check the checkbox of “Enable compatibility mode,” but it is an optional step.

FAQ’s
Is MetaMask safe for online transactions?
Yes, MetaMask is renowned for its security features. It provides users with control over their private keys, ensuring a secure and private shopping experience.
Are there any additional fees for using MetaMask for transactions?
The addon itself does not incur additional fees. However, users might encounter standard Ethereum transaction fees, which are independent of the addon.
What if my customers don’t have MetaMask installed?
To use MetaMask for transactions, customers need to have the MetaMask extension installed in their browser.
Does your addon support all networks and tokens?
Currently, our add-on supports the Ethereum Mainnet and allows payments in both ETH and USDC (ERC-20 token). We’re actively working on incorporating support for additional tokens and blockchain networks in future updates.
Changelog’s
1.0.6
- Fix: Addressed security recommendations in accordance with WordPress coding standards.
- Fix: Resolved performance-related issues identified by PHPCS.
1.0.5
- New: Added live currency prices alongside supported cryptocurrencies.
- New: Added detailed crypto payment information to the order thank you page.
- New: Added crypto payment details in customer and admin email notifications.
1.0.4
- New: Introduced compatibility with the WooCommerce Blocks checkout experience.
1.0.3
- New: Added New USD Coin support.
- New: Added Support Testnet Coins for testing.
- Fix: Improved Checkout functionality with MetaMask wallet.
1.0.2
- Fix: Fixed the License Module.
1.0.1
- Fix: Fixed fatal error caused by missing WooCommerce plugin.
1.0.0
- Initial Release.