Back to blog

Tutorial

How to accept crypto payments on WooCommerce (without a custodial processor)

QBitFlow Team

6 min read

On this page · 11 sections

You built your WooCommerce store. You've got products, a checkout flow, and customers who want to pay in crypto. The question is: which payment gateway do you actually trust with your money?

Most crypto payment plugins for WooCommerce work the same way: they collect your customer's payment, hold it in their own wallet, and send you a payout, minus fees, minus a wait, minus any guarantee they won't freeze your account if something looks "suspicious." That's not crypto. That's a bank with extra steps.

This guide covers how to accept crypto payments on WooCommerce the non-custodial way: funds go directly from your customer's wallet to yours, on-chain, with no middleman holding anything.


What "non-custodial" actually means for your store

When a customer pays through a custodial processor, the money lands in the processor's wallet first. You're trusting them to forward it. If they freeze your account, dispute a transaction, or go under, your money is stuck.

Non-custodial means the smart contract routes the payment directly to your wallet address. QBitFlow never holds your funds. Every payment has an on-chain transaction hash you can verify on Etherscan, BaseScan or Solscan. There's no one to call to "release" your money because no one ever had it.

For a WooCommerce merchant, this matters for three reasons:

  1. No chargebacks. Crypto transactions are final. A customer can't call their bank and reverse a payment you already received.
  2. No holds. There's no processor deciding whether your business is "high-risk" this week.
  3. No conversion. You receive exactly what the customer paid: USDC stays USDC, ETH stays ETH. No auto-swap, no slippage, no surprise exchange rate.

What you need before you start

  • A WooCommerce store (WordPress + WooCommerce plugin installed)
  • A crypto wallet you control: MetaMask, Coinbase Wallet or another browser-extension or mobile wallet
  • About 10 minutes

Step 1: Sign up and add your wallet

Go to qbitflow.app/get-started. Sign up with an email and password.

Start in test mode: switch the dashboard to Test and add a wallet in Settings → Wallets, one for each chain you want to be paid on. You connect it from a browser extension or by scanning a QR code with your mobile wallet, then sign a message to prove it's yours. You're not pasting a public address anywhere, and nothing asks for a seed phrase or private key.

To pay your own test orders, get test tokens from the dashboard's faucet (each wallet once every 6 hours per chain). No real money at risk while you're getting set up.


Step 2: Install the WooCommerce plugin

The QBitFlow WooCommerce plugin is live in the official WordPress.org plugin directory. Install it in one click, no ZIP files:

  1. In your WordPress admin, go to Plugins → Add New
  2. Search for "QBitFlow"
  3. Click Install Now, then Activate

That's it. (You can also find it at wordpress.org/plugins/qbitflow-for-woocommerce, or read the source on GitHub.)


Step 3: Create an API key and configure the plugin

Back in your QBitFlow dashboard, still in test mode:

  1. Go to Settings → API keys and create a key
  2. Copy it: you'll paste it into the plugin settings

In WordPress:

  1. Go to WooCommerce → Settings → Payments → QBitFlow
  2. Tick Enable
  3. Paste your API key
  4. Save. The screen shows Test or Live, from the key itself.
  5. Click Connect webhook: the plugin registers your store with QBitFlow and keeps the signing secret, so your orders update as soon as a payment confirms.

That's the integration. Your checkout now shows a crypto payment option alongside any other payment methods you have enabled. Place an order of $5 or less (test mode's cap) and pay it with your test tokens to see the whole flow.


What your customers see at checkout

When a customer selects crypto payment, they're sent to QBitFlow's hosted checkout page, with your logo and your colors. They pick the chain and coin, connect their wallet (browser extension or mobile QR), and sign. No account to create. Once the transaction confirms on-chain, your WooCommerce order updates automatically.

The customer pays the network fee on top. You pay QBitFlow's 0.99% fee (down to 0.5% as your volume grows), taken on-chain in the same transaction. No monthly subscription, no setup fee, no hidden charges.


Chains and tokens you can accept

Your customers can pay on Ethereum, Base or Solana, in each chain's own coin or in a supported token such as USDC, USDT or EURC. You choose which coins each of your wallets accepts in the dashboard, and the WooCommerce page lists every one we support today.

If your customers prefer stablecoins, USDC on Base is a cheap one to transact: low network fees, dollar-pegged. If they're paying in ETH or SOL, that works too.


What about subscriptions?

Right now, the WooCommerce plugin handles one-time payments: physical products, digital downloads, one-off orders. Recurring billing through the plugin is on the roadmap.

If you need crypto subscriptions today, QBitFlow supports them through its API and SDKs. The customer signs one allowance for a number of periods, each capped at a maximum, and QBitFlow bills one period on each due date. A few things worth knowing:

  • Subscriptions are paid in tokens (USDC, USDT and others), not in native ETH or SOL
  • When the allowance runs low, your customer is prompted to top up; they can top up or cancel from their own page
  • A free trial starts with a signed message that moves no funds; to continue after it, the customer signs the subscription itself

Want recurring billing wired into your WooCommerce store specifically? Reach out and we'll point you at the API path.


Accounting: the part most crypto plugins skip

You can export every payment, bill, refund and fee you earned, as CSV or JSON, up to 3 months per export. Each row is one event: its type, time, chain, block, transaction hash and explorer link, the token, the gross amount, QBitFlow's fee and the net amount, in the token and in USD. Gross always equals the fees plus the net, so there's no reconstructing fee splits from block explorer data. And CSV cells are written so a spreadsheet never runs them as formulas.

This matters because "how do I handle accounting?" is one of the first questions any Stripe-using merchant asks when considering crypto. Most crypto processors give you a transaction list. QBitFlow gives you one row per event, with the amounts that actually moved on-chain.


How it compares to the alternatives

QBitFlowNowPaymentsBitPay
Custodial?No: direct to your walletYesYes
WooCommerce plugin✅ Live✅✅
ChargebacksNone (crypto is final)NoneNone
Fee0.99%, down to 0.5% with volume0.5–1% + spread1–2%
Subscriptions✅ On-chain (via API; plugin = one-time)Limited❌
ChainsEthereum, Base, SolanaManyBTC, ETH, others
Funds held by processorNeverYesYes

The fee comparison isn't the main point. The main point is that with custodial processors, you're trusting a company with your money. With QBitFlow, you're trusting math.


Get started

  1. Sign up at qbitflow.app/get-started
  2. Add your wallet in test mode
  3. Install the plugin from your WordPress admin (Plugins → Add New → search "QBitFlow")
  4. Paste a test API key into the plugin settings
  5. Run a test order with faucet tokens
  6. Go live: nothing carries over from test, so add your mainnet wallets, create a live API key and paste it in the plugin

Questions? The docs are at qbitflow.app/docs. If you get stuck, reach out and we'll walk you through it.

Subscribe to our newsletter

New posts in your inbox. You confirm your address first.

Take your first payment today. In test mode, for free.