Back to blog

Tutorial

Crypto payments for WooCommerce: accept USDC and more without a custodian

QBitFlow Team

8 min read

On this page · 11 sections

WooCommerce gives you control over your store. Your products, your branding, your customer data. Then you get to the payments page and you're back to asking permission.

Card processors don't serve every country. PayPal holds funds during disputes. Even dedicated crypto payment plugins often route your money through a processor's wallet before releasing it to you on their schedule, which trades one middleman for another.

This guide shows a different setup: your customer pays, the money goes straight into your wallet, and the blockchain handles the rest. No intermediary sitting on your funds.

Why accept crypto payments on WooCommerce at all?

Most merchants don't switch payment processors unless something is actually broken.

Here's what's broken:

The geo-gate. Traditional processors gate both sides of a transaction by country. Some customers literally can't pay you: their card gets declined, or your processor doesn't support their region. QBitFlow's checkout needs no card and no account: a customer with a wallet and a supported coin can pay you.

The payout delay. Most processors hold your money for days before releasing it to your bank. With direct on-chain settlement, the funds are in your wallet once the transaction confirms. No separate payout schedule.

No chargebacks. Blockchain payments are final. No reversal after you've shipped. You can still issue refunds yourself (that's your choice), but the customer can't claw it back through a card network. Merchants are still responsible for applicable consumer laws and disputes in their jurisdiction: this removes the unilateral reversal mechanism, not the obligation to handle genuine disputes.

The custodian problem with most WooCommerce crypto plugins

There's a subtlety most merchants miss: many "crypto payment plugins" still hold your money in the middle.

The flow looks like: customer wallet → processor wallet → your bank account (days later, via wire). You've changed the customer's experience without fixing your own payout problem.

QBitFlow's model: customer wallet → your wallet, in one transaction. QBitFlow's fee is split in that same on-chain transaction: at 0.99%, 99.01% goes to your wallet and 0.99% to QBitFlow, with no separate payout step. The contracts handling this are open-source on github.com/QBitFlow and verifiable on-chain.

Your money, once it confirms.

What your customers see at checkout

When a customer chooses to pay with crypto, they're sent to QBitFlow's hosted payment page. They pick the chain and the coin, review the amount, connect their wallet (a browser extension, or a mobile wallet by QR code) and sign. No account creation on their end, and no details to type again: the plugin passes along what WooCommerce already has.

The WooCommerce order status updates automatically once the payment confirms on-chain, and the customer is sent back to your store.

The network fee is the customer's, on top of the price and separate from QBitFlow's fee. For a token payment it's taken in the token they pay with; for a payment in a chain's own coin (ETH, SOL), it's that transaction's fee. On Ethereum and Base, a customer's first payment in a token also asks them to approve it once, paid in ETH.

What you can accept

Your customers can pay on Ethereum, on Base (lower network fees, built on Ethereum) and on Solana (near-zero network fees): in each chain's own coin, or in a supported token like USDC, USDT, EURC or DAI.

You choose which coins each of your wallets accepts in the dashboard. Customers pay from whichever supported combination you've turned on. The WooCommerce page lists every coin we support today.

How to accept USDC on WooCommerce in under 30 minutes

The plugin is live in the official WordPress plugin directory, so you can install it in one click straight from your WordPress admin. No ZIP to download, no code to touch.

1. Create your account Sign up at qbitflow.app/get-started with an email and a password.

2. Add your wallet, in test mode Switch the dashboard to Test, then add a wallet in Settings → Wallets: this is the wallet that receives your payments. Connect it from a browser extension or scan a QR code with your mobile wallet, then sign a message to prove it's yours. You're not pasting a public address, and nothing asks for a seed phrase or private key at any step.

To pay your test orders, get test tokens from the dashboard's faucet: each wallet once every 6 hours per chain.

3. Create your API key In the dashboard under Settings → API keys. A key created in test mode only ever sees test payments.

4. Install the plugin In your WordPress admin, go to Plugins → Add New, search for "QBitFlow", then click Install Now and Activate. Your existing WooCommerce products don't need to be duplicated: the plugin uses order data from WooCommerce directly.

Prefer to install manually? Download the ZIP from the plugin's releases and upload it via Plugins → Add New → Upload Plugin.

5. Enter your API key in WooCommerce Under WooCommerce → Settings → Payments → QBitFlow, tick Enable, paste the API key and save. The screen shows Test or Live from the key itself. Then click Connect webhook: the plugin registers your store with QBitFlow for the key's mode.

6. Run a test payment Place an order of $5 or less (test mode's cap) and pay it with your test tokens. QBitFlow's signed webhook updates the order; the return page and a check every 15 minutes confirm it too if the webhook is late.

7. Go live Nothing carries over from test. Switch the dashboard to Live, add your mainnet wallets, create a live API key, paste it in the plugin's settings and click Connect webhook again (test and live each have their own). You're accepting payments.

Most stores complete this the same day, often in 30 minutes or less once you have a wallet ready.

Full docs at qbitflow.app/docs.

Accounting, the part most merchants forget

Crypto accounting is painful without the right export.

QBitFlow exports every payment, subscription bill, refund and fee you earned, as CSV or JSON, up to 3 months per export. Each row is one event, with its type (payment, subscriptionHistory, refund, organizationFee or referralFee), its time, the 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, plus your own order reference.

The amounts are the on-chain split, so gross always equals the fees plus the net. No manual block-explorer archaeology, and CSV cells are written so a spreadsheet never runs them as formulas.

It gives your accountant the payment data in one file. What they do with it for your books stays their call.

Pricing

QBitFlow's fee is 0.99% per transaction, 0.75% once your last 30 days pass $50,000 and 0.5% from $100,000, with 0.5% on your first $5,000. No setup fee, no monthly fee, no withdrawal fee. The fee is taken in the same on-chain transaction that pays you: you don't receive a gross amount and get invoiced separately. The network fee is separate, and your customer pays it.

The more you process, the lower your rate: no plan to pick, no negotiation.

How QBitFlow compares to other WooCommerce crypto plugins

QBitFlowCoinGate
SettlementDirect to your walletCustodial (payout schedule)
SubscriptionsYes (on-chain, tokens only)No
WP directoryYesYes
Fee0.99%, down to 0.5% with volume1–1.5%
Fiat conversionNo: crypto stays cryptoYes
ChainsEthereum, Base, SolanaETH, BTC, others

If you need fiat in your bank account immediately, a custodial processor like CoinGate may be a better fit today. If you want payments settling directly into a wallet you control, QBitFlow is built for that.

Is this right for your store?

Good fit:

  • You want USDC, ETH or SOL going directly into your wallet, with no payout wait
  • You sell to a global audience and some of your customers can't use card processors
  • You sell digital subscriptions and want real on-chain recurring billing (through the API today; the plugin handles one-time payments)
  • You run a standard WooCommerce store and want setup done in under 30 minutes

Not the right fit:

  • You need automatic conversion to fiat before it hits your bank
  • Your customers don't hold crypto wallets

Support

Questions while setting up? qbitflow.app/docs covers the full technical flow, and if something isn't covered, write to us. If your checkout breaks, there's a human on the other end.

Frequently asked questions

Does QBitFlow hold my funds? No. QBitFlow's fee is split in the same on-chain transaction as the payment itself. Your share goes straight to your wallet and QBitFlow's fee to ours, in one step, with no intermediate custody.

What happens if a customer sends the wrong token or uses the wrong network? QBitFlow's checkout doesn't let the customer select an unsupported token or chain: they choose from what your wallets accept. If they send from an exchange directly (bypassing the checkout), that's a wallet-level transfer outside QBitFlow and needs manual reconciliation.

Have the smart contracts had a security audit? Not yet: the contracts have not been formally audited. They're open-source (github.com) and verifiable on-chain: the Ethereum and Base contracts are verified on their explorers, and Solana's verified build is pending. A formal third-party audit is on the roadmap. You can review the code before going live.

Does QBitFlow convert crypto to fiat? No. You receive the exact token the customer paid with, in your wallet. If you want fiat, you'd off-ramp via your own exchange.

Can I refund a crypto payment? Yes. Your customer asks from their QBitFlow invoice page, and you approve or refuse in the dashboard. You sign the transfer from the wallet that was paid, so the money goes back without anyone holding it, and you pay the refund's network fee. Once it's sent, the plugin records it on the order by itself, a partial refund for its share.

Is the plugin available in the WordPress directory? Yes, it's live in the official WordPress plugin directory. Install it in one click from your WordPress admin: Plugins → Add New, search "QBitFlow", Install Now, Activate. (You can still install manually from the ZIP if you prefer.)

What WooCommerce version does it support? WooCommerce 8.0 or later, on WordPress 6.4+ and PHP 8.2+. The plugin's page has the current compatibility and release notes.


Install the plugin in one click from the WordPress plugin directory and get started at qbitflow.app/get-started.

Subscribe to our newsletter

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

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