QBitFlow for WooCommerce

QBitFlow for WooCommerce lets you accept cryptocurrency payments directly in your WooCommerce store. Powered by smart contracts, payments go straight to your wallet — no middleman, no custody risk.

Features

• Non-Custodial — Funds go directly to your wallet via smart contracts

• Multiple Cryptocurrencies — ETH, SOL, USDC, USDT, and more

• Itemized checkout — Taxes, shipping and fees appear as separate lines on the QBitFlow checkout, adding up exactly to your order total

• Processing fee, your choice — “Use my QBitFlow setting”, “Customer pays” (a last line on the QBitFlow checkout, so you receive the full order total) or “Store pays”; members follow their organization

• One-click webhook — “Connect webhook” registers your store with QBitFlow and keeps the signing secret; deliveries are verified locally

• Orders that settle themselves — Webhooks, the return page and a background check every 15 minutes all confirm payments, so an order never stays pending because one notification was missed

• One checkout per order — Going back, double-clicking or retrying reuses the same QBitFlow checkout; a changed cart replaces it; a payment can never be collected twice for one order

• Refunds, recorded automatically — Approve or send refunds in the QBitFlow dashboard; the plugin records them in WooCommerce (full or partial) from QBitFlow’s webhooks and lists pending requests

• Accepted coins at checkout — Customers see which coins your wallets accept, right under the payment method (classic and block checkout)

• Failed payment attempts on the order — A declined or mismatching attempt is noted on the order, with its reason, while the customer can still retry

• Crypto column and QBitFlow filter — The orders list shows the coin, the transaction and the payment state of each order, and filters orders awaiting payment or with a refund request

• Accounting export — Download every payment, refund and fee of your QBitFlow account as CSV or JSON, for any range of days (long ranges are fetched in pieces)

• WP-CLI — wp qbitflow status, connect-webhook, reconcile, export and settings

• Member keys — Keys of a QBitFlow member space work too; what the organization reserves is shown read-only

• Connection status at a glance — Your QBitFlow account, test or live mode, accepted currencies, webhook health and PHP security in the settings

• Block Checkout Support — Works with both classic and block-based checkout

• HPOS compatible — Works with High-Performance Order Storage

• Test Mode — Try the full payment flow without spending any real cryptocurrency

• Debug Logging — Built-in logging for troubleshooting

How It Works

• Customer selects “Pay with Crypto” at checkout

• Customer is redirected to QBitFlow’s secure payment page, which already knows their details

• Customer pays with their preferred cryptocurrency

• Payment is confirmed on-chain and the order is updated automatically

• Customer receives an invoice with the transaction details

Test Mode — Try Before Going Live

QBitFlow provides a test mode that lets you simulate the entire payment flow — checkout, on-chain confirmation, webhooks, order updates — without spending any real cryptocurrency.

• Create a Test API Key from your QBitFlow dashboard

• Paste it into the plugin settings at WooCommerce → Settings → Payments → QBitFlow, and click Connect webhook

• Place a test order (test checkouts are capped at $5) — everything works exactly like production, but no real funds are moved

When you’re ready to accept real payments, replace the test key with a Live API Key, save, and click Connect webhook again (test and live have separate webhooks).

For more details, see the QBitFlow Test Mode Documentation.

Learn more

• Accept crypto on WooCommerce — full overview — how the non-custodial checkout works, which chains and tokens your customers can pay with, and pricing.

• Step-by-step setup guide — install the plugin, connect your wallet, and take your first crypto payment.

• QBitFlow documentation — API keys, test mode, webhooks, and full API reference.

Requirements

• WordPress 6.4 or later

• WooCommerce 8.0 or later

• PHP 8.2 or later (a release with the php2shell fixes is strongly recommended: 8.2.35, 8.3.36, 8.4.27, 8.5.12 or later)

• A store priced in US dollars, or a USD exchange rate provided through the qbitflow_wc_usd_rate filter

• A QBitFlow account ( sign up free )

External services

This plugin relies on QBitFlow, a third-party cryptocurrency payment service, to function. QBitFlow processes crypto payments non-custodially (funds go directly to your wallet via smart contracts). Without it, the gateway cannot create payments.

app. Every request is authenticated with the QBitFlow API key you enter in the plugin settings.

What data is sent, and when:

• At checkout, when a customer chooses to pay with QBitFlow: the buyer’s email address, first and last name, phone number and billing address (to find or create the matching customer on QBitFlow, identified by a hash of the email), and the order details (product names, amounts with taxes, shipping and fees, the order number and a reference made of a random store id and the order id, and the return addresses of your store) to create the payment session the customer is redirected to.

• When the customer returns to your store, in a background check every 15 minutes for unpaid orders, and when you click “Refresh from QBitFlow”: the order’s QBitFlow checkout id, to read whether it was paid.

• When an order is cancelled: its open checkout id, to close it.

• In the plugin settings: a request identifying your API key’s account and mode, the currencies your wallets accept, your webhook’s status and, for an organization member’s key, whether the organization lets it open checkouts (refreshed at most every 10 minutes); when you click “Connect webhook”, your store’s webhook address and site name, to register it.

• When the checkout shows the accepted coins and they are not cached (at most once an hour, in the background): a request reading the currencies your wallets accept.

• When you download the accounting export (in the plugin settings, or wp qbitflow export ): the date range you chose, to receive your QBitFlow payments, refunds and fees for it.

• Every hour: a request listing pending refund requests, to show how many wait for you.

• When the plugin is deleted: a request removing your store’s webhook from QBitFlow.

Webhooks QBitFlow sends to your store are verified locally with the signing secret: nothing is sent back to QBitFlow to verify them. The plugin does not send any data to QBitFlow outside of these actions.

This service is provided by QBitFlow. By using it you agree to their terms and privacy policy:

• Terms of Service: https://qbitflow.app/terms

• Privacy Policy: https://qbitflow.app/privacy