WordPress + WooCommerce

Accept crypto payments in WooCommerce

Accept USDT and USDC in your WordPress store with hosted checkout, verified payment updates and automatic return to the order.

Built for your store’s payment flow

Receive in your own wallet

Choose an active receiving wallet and a supported network/token in CrptoX. The plugin never asks for your private keys or recovery phrase.

Hosted checkout and return

Customers open the CrptoX payment page from checkout, then return to their order. Classic checkout, Checkout Blocks and HPOS are supported.

Verified order updates

Signed webhooks and server-to-server invoice checks update order status. Returning to the store alone does not mark an order as paid.

Installation and setup

Create a CrptoX merchant account before setup. Keep TEST and LIVE wallets, API keys and webhook secrets separate.

Create merchant account
  1. In WordPress, open Plugins → Add New → Upload Plugin. Upload this ZIP and activate it with WooCommerce enabled.
  2. In CrptoX TEST mode, add an active receiving wallet for the network and token you will use.
  3. Create a TEST API key in your CrptoX merchant panel and enter it in the plugin settings.
  4. Open WooCommerce → Settings → Payments → CrptoX. Set https://crptox.com, TEST mode, the API key, network and token.
  5. Select your store currency and enter the amount equal to one token. Update this rate yourself when needed. IRR and IRT are separate currencies.
  6. Save and test the connection. Add the plugin’s displayed TEST/LIVE webhook URLs in CrptoX, select the events listed by the plugin, and copy each signing secret to its matching field.
  7. Place a TEST order, complete payment, and verify that the order becomes paid after server verification. Switch to LIVE only with matching live wallets, keys and webhook secrets.
Open plugin settings in merchant panel

Store currency and token conversion

Select your store currency and enter the amount equal to one token. Update this rate yourself when needed. IRR and IRT are separate currencies.

For example, if you set one USDT to 100,000 IRT, a 200,000 IRT order costs 2 USDT. This is an example, not a market price. Rate changes apply to new orders. Existing orders keep their original quote.

Choose the right network and token

Use the network and token contract shown on the payment page. The same wallet address on different EVM networks does not make payments interchangeable.

TRON
USDT
BNB Smart Chain (BSC)
USDT
Ethereum
USDT / USDC
Polygon PoS
USDT / USDC
Payment Methods

Fix common checkout problems

  • No payment option? Check that the plugin is enabled and its TEST or LIVE key matches an active wallet. Select a supported network and token in the gateway settings.
  • Order pending? Check the CrptoX invoice, sent amount and network. Check webhook delivery and its matching secret. Returning to the store alone does not confirm payment.
  • Unexpected token amount? The store uses your manual conversion rate, not a live rate. Check the currency and unit, especially rial versus toman. Existing orders keep their original quote.

WooCommerce plugin questions

Can my store use USD, EUR, rial or toman?

Select your store currency and enter the amount equal to one token. Update this rate yourself when needed. IRR and IRT are separate currencies.

Does it support Checkout Blocks and HPOS?

Customers open the CrptoX payment page from checkout, then return to their order. Classic checkout, Checkout Blocks and HPOS are supported.

Do I need to provide a wallet private key?

Choose an active receiving wallet and a supported network/token in CrptoX. The plugin never asks for your private keys or recovery phrase.

How should I test before accepting live payments?

Place a TEST order, complete payment, and verify that the order becomes paid after server verification. Switch to LIVE only with matching live wallets, keys and webhook secrets.

Plans and network fees

Check current plan prices and invoice limits before starting. Network fees are separate. Successful sandbox and live payments share the plan allowance.

Other ways to use CrptoX