Tutorial
How to add crypto payments to WooCommerce
Accept Bitcoin, USDT and other coins in your WooCommerce store in about ten minutes: install the plugin, add your key, test it, and go live.
Updated · 5 min read
WooCommerce runs a large share of the world's online stores, and adding crypto to it takes one plugin. This tutorial shows how to set up the free AywaPay plugin so customers can pay in Bitcoin, USDT, Ethereum and more, and orders update on their own.
What the plugin does
- Adds a Pay with crypto option to checkout. It works with the classic checkout and the Checkout block.
- Keeps prices in your store currency and converts at the live rate on the payment page.
- Updates orders automatically: on hold while the payment confirms, Processing when paid, Failed if the invoice expires unpaid. The customer can pay again from their account.
- Notes overpaid and underpaid payments on the order.
- Supports High-Performance Order Storage and has a test mode.
Before you start
- WordPress 6.2 or newer and PHP 7.4 or newer.
- Your site reachable from the internet over HTTPS, so payment callbacks can arrive.
- A AywaPay account with a store. We're in private beta, so request access if you don't have one yet.
Step 1: install the plugin
- Download the plugin zip from the integrations page.
- In WordPress go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now.
- Click Activate.
Step 2: connect your store
- In your AywaPay dashboard open your store, go to API and copy the secret key. You'll confirm it with your 2FA code.
- In WordPress go to WooCommerce → Settings → Payments → AywaPay.
- Paste the secret key, tick Enable and save.
You don't need to set a callback URL in the dashboard. The plugin sends its own with every invoice.
Step 3: test with a test key
Create a test key in your store (it starts with test_) and paste it in the plugin settings instead of the live key. Place an order on your store: the payment page shows buttons to simulate a payment, an overpayment, an underpayment or an expiry. Check that the order moves to the right status each time. When everything works, swap the live key back in.
Step 4: go live
With the live key saved, place one small real order and pay it yourself, for example a few dollars in USDT on TRON. Watch the order move from on hold to Processing. Then you're ready for customers.
Troubleshooting
| Problem | What to check |
|---|---|
| Order stays "Pending payment" | Your site must be reachable over HTTPS. Turn on the debug log in the plugin and look under WooCommerce → Status → Logs (source "aywapay"). The dashboard shows whether each invoice's callback was delivered. |
| Crypto option missing at checkout | Make sure the gateway is enabled and the key is saved. Some coins have a minimum order amount. |
| Need to refund | Refund from the invoice in your dashboard. The customer is paid back in the coin they used. |
What it costs
The plugin is free. You pay 0.5% per payment received, with no setup or monthly fees. Withdrawals to your own wallet cost $0.25 plus the network fee. See pricing.
Frequently asked questions
- Is the WooCommerce crypto plugin free?
- Yes. You only pay the per-payment fee (0.5%) when a customer pays.
- Which coins can WooCommerce customers pay with?
- Bitcoin, Ethereum, USDT on TRON, Ethereum, BNB Smart Chain and Arbitrum, USDC, Litecoin, TRX, BNB and Ethereum Classic. The live list is on the supported coins page.
- Does it work with the WooCommerce Checkout block?
- Yes, both the classic checkout and the Checkout block are supported.