Payments
Crypto Payments — Hosted checkout & API for 110+ 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
Swap 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

🎨 Guides

What Is a White-Label Crypto Payment Gateway?

A white-label gateway lets you offer crypto payments — or a full exchange — under your own brand. Here is what that means and how CryptoPayr makes it possible.

Jul 12, 2026 · 2 min Read →
🔌 Guides

Webhooks and Idempotency: Building a Reliable Crypto Integration

A short, practical guide for developers: how to verify CryptoPayr webhooks, handle retries safely with idempotency, and never double-fulfil an order.

Jul 8, 2026 · 2 min Read →
🛡️ Guides

How Crypto Payments Eliminate Chargebacks

Chargebacks cost online businesses billions a year. Here is why crypto payments remove them entirely — and what that means for your margins and your stress levels.

Jun 25, 2026 · 2 min Read →