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
Language
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.00 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

Launch a Hosted Crypto Checkout on Webflow Without a Developer

Add hosted checkouts or payment links to Webflow, follow a security-first checklist, test webhooks, and go live fast with CryptoPayr.

Sep 9, 2026 · 10.00 min Read →
📝 Guides

Cut Chargebacks, Run Batch Payouts for Gaming Platforms

How gaming platforms eliminate chargebacks, run batch stablecoin payouts, and make crypto invisible. Integration and compliance checklist inside.

Sep 8, 2026 · 8.00 min Read →
📝 Guides

Seconds to an Hour: Crypto Settlement Times for Merchants and Platforms

Operational guide for merchants and platforms that links chain finality, gateway policies, pre funded buffers, and webhooks to real crypto settlement times.

Sep 7, 2026 · 13.00 min Read →