Payments
Crypto Payments — Hosted checkout & API for 30+ coins White Label — Your brand on the entire payment flow Processing — Auto-convert, withdrawals & controls Payouts — Mass crypto payouts by API or file Platform — Marketplace payments & commissions
Plugins Affiliate Pricing Blog Docs Contact
Sign in
All articles

How to Accept Crypto Payments on WooCommerce

WooCommerce doesn't ship with a crypto option, but adding one is a ten-minute job. Here's the exact setup — plugin, API key, webhook — plus which of the two CryptoPayr plugins you actually need.

CryptoPayr Jun 10, 2026 3 min read

WooCommerce will happily take cards, PayPal and bank transfers out of the box. Crypto isn't on that list. The good news is you don't need to touch a line of code to add it — you need the right plugin, an API key, and about ten minutes.

One wrinkle to get out of the way first: there are two CryptoPayr plugins for WooCommerce, and picking the wrong one is the most common reason setup goes sideways.

Which plugin you need

WooCommerce changed its checkout a couple of years back. The old one is the "classic" checkout; the new one is built from Cart & Checkout Blocks. Your payment plugin has to match whichever you're running.

Not sure which you have? Open your Checkout page in the editor. If it's made of blocks, you want the Blocks plugin. If it's the [woocommerce_checkout] shortcode, you want the classic one. When in doubt, the Blocks plugin also falls back to the classic checkout, so it's the safer pick.

The setup, step by step

  1. Grab the plugin. Download it from the CryptoPayr plugins page and install it the usual way: Plugins → Add New → Upload Plugin, then activate.
  2. Create an API key. In your CryptoPayr dashboard, generate an API key for the store and copy it.
  3. Paste it into the gateway. Under WooCommerce → Settings → Payments you'll now see CryptoPayr. Enable it and drop your API key in.
  4. Set the webhook. The plugin gives you a webhook URL — copy it back into your CryptoPayr dashboard so we can tell the store when a payment confirms. This is what flips an order from "pending" to "processing" on its own.
  5. Send a test order. Buy something cheap, pay it on the hosted checkout, and watch the order update by itself.

That webhook step is the one people skip, and then they wonder why paid orders sit on "pending." If an order doesn't update after you've paid, the webhook is the first thing to check.

What your customer sees

At checkout they pick "Pay with cryptocurrency," land on a hosted page, choose a coin and network, and get an address and a QR code. You price everything in your normal currency; they pay the crypto equivalent at a rate locked for the checkout window. Once the network confirms, the webhook fires and the order completes. No redirect to a sketchy third-party processor, no asking the customer to do maths.

Two things worth turning on

If you'd rather not sit on volatile coins, switch on auto-conversion so takings settle into a stablecoin. And if you sell internationally, this is where crypto quietly earns its keep — a customer in a country your card processor doesn't like can still pay you in USDT without anything declining.

That's the whole job. Download the plugin, or read the API docs if you'd rather wire it up yourself.

Start accepting crypto today

Open a free CryptoPayr account and take your first crypto payment the same day.

Get started for free

Keep reading

🧭 Crypto 101

Coins, Networks and Confirmations: The Three Words That Demystify Crypto Checkout

Why does a crypto checkout ask which "network"? What's a confirmation, and why wait for one? Three words explain almost everything a merchant needs to know — here they are, in plain language.

Jun 10, 2026 · 3 min Read →
🛡️ Company

Where Your Money Lives: How CryptoPayr Keeps Funds and Data Safe

Handing a payment gateway your revenue is an act of trust. Here's a plain account of how CryptoPayr handles your balance, your keys and your customers' data — and the boundaries we hold.

Jun 10, 2026 · 3 min Read →
🔗 Product

Get Paid Without an Invoice: Reusable Payment Links

Sometimes you don't need a store or an integration — you need a link you can send. Here's how reusable payment links let you charge a fixed price or take any amount, with nothing to build.

Jun 10, 2026 · 3 min Read →