How to add crypto payments to a WooCommerce store
Add crypto payments to WooCommerce by installing a gateway plugin and connecting it to a processor or wallet. Test checkout in sandbox before going live.
Vahe HakobyanEditor-in-chief
Updated Oct 6, 20263 min readFact-checked
On this page
- Confirmed crypto transfers cannot be reversed; refunds come from your wallet.
- Check gateway support for coins, networks, country, and WooCommerce version.
- Crypto payments are taxable business income under US rules.
A gateway links your checkout to a processor or wallet. It shows a payment address and updates the order when the payment arrives.
What does a crypto gateway do?
The gateway links your WooCommerce checkout to a processor or your own wallet. It shows an address and amount, watches the blockchain, and marks the order paid after confirmations. Some gateways convert payments to dollars; others send crypto to your wallet.
What to prepare before installing
Before you install, confirm the gateway supports your coins, networks, country, and WooCommerce version. Check its compatibility list and last update date. You generally need WordPress admin access and SSL, and some gateways also need a wallet address or API credentials.
How to add crypto payments step by step
Setup happens inside WordPress, and you test before live orders.
- 1Install the pluginInstall the gateway from its official listing in WordPress and confirm it works with your WooCommerce version.
- 2Connect credentials and statusesPaste the API key and secret, enter your wallet address if needed, and set which WooCommerce status means awaiting payment, paid, or failed.
- 3Select coins and networksTurn on only the coins and networks your gateway supports for your country.
- 4Test and verifyPlace a sandbox order, then check that the order is marked paid only after enough confirmations.
What to do after launch
After launch, keep records of every crypto payment. US federal tax treats digital assets as property, and income from digital assets is taxable. Export the order, amount, coin, network, and fair market value on the payment date. Form 1040 asks a digital assets question.
Frequently asked questions
No. A sole proprietor can accept crypto payments, though many owners form an LLC or corporation for liability and tax reasons.
Some gateways convert each payment through a service provider. Others send coins to your wallet, so you carry price risk, and a custodian adds counterparty risk.
The payment may not reach your wallet, and a crypto transfer cannot be reversed. If it arrives, you are the one who can refund it.
Yes. You report income when you receive it. A later sale or trade of the coins is a separate capital event.
