BlockBee Logo

Search BlockBee

Search BlockBee blog posts and documentation.

Crypto Checkout
Share
May 22, 2026 • 5 min read

Crypto Checkout: Help Customers Choose, Pay and Track Their Payment

Guides

How to make the crypto payment step clear: what customers must see, how to separate payment, confirmation and fulfilment, where Swap Everything fits, and what to measure after launch.

What a good crypto checkout does

A good crypto checkout tells the customer exactly what to send, on which network, to which address and by when, then shows them their payment is on its way. On your side, the order changes only when your server receives a verified notification. BlockBee's hosted Checkout runs the payment page for you; if you build your own screen, the same rules apply.

Make the payment instructions impossible to miss

Show the customer:

  • The asset and the network. Name both, for example USDT on Tron, so the customer sends the coin and chain the payment instructions ask for.
  • The exact amount, in crypto and in your store currency.
  • The address and a QR code, with separate copy buttons for address and amount. Show the amount next to the QR code too, because some wallets ignore the amount inside it.
  • The minimum. Payments below a coin's minimum are ignored and the funds are lost, so BlockBee's docs tell custom integrations to display it prominently.
  • The deadline, if the payment expires. A Checkout payment's expiry must be at least one hour away.

BlockBee Checkout handles the payment interface, coin selection and live status on a hosted page that adapts to mobile and desktop and can carry your logo. If you build your own screen, BlockBee's custom payment flow guide covers the amounts, QR code, copy buttons and minimum.

Separate payment, confirmation and fulfilment

Treat three moments separately, in your own wording:

  1. Payment sent, not yet confirmed. In a custom flow you can enable pending webhooks, sent when the transaction is detected but unconfirmed. BlockBee suggests them for quick feedback on slower chains such as Bitcoin.
  2. Payment confirmed. The confirmed webhook arrives after the number of confirmations you set. Hosted Checkout sends a single webhook, once the payment is complete and confirmed. For Checkout and PoS, the confirmation count is in Payment Settings: a higher number is slower, and BlockBee warns that 0 might be unsafe, so don't use it.
  3. Order fulfilled. Ship, grant access or credit the account only after your server has verified the confirmed notification.

On a custom screen, BlockBee's docs recommend pushing the update to the customer when the webhook arrives, for example by WebSockets, server-sent events or email, rather than relying on page refreshes.

Give customers more ways to pay with Swap Everything

Swap Everything adds SwapBee conversion to eligible BlockBee Checkout flows, including payment links, e-commerce payments and subscription payments. A customer can pay with a supported coin you don't accept directly, or the same asset on another network, and SwapBee converts it into one of your configured receiving coins. Your receiving coins and addresses stay as they are. Customers who hold a coin you accept can still pay directly: direct and swap options share one searchable coin selector with network filters.

In the swap flow, the customer:

  1. chooses a coin and network;
  2. checks the quote: what to send, what you receive, the swap provider and how long the quote is valid;
  3. adds a refund address from their own wallet if asked, then sends the exact amount to the payment address or its QR code, following the displayed network, deadline and any memo or tag;
  4. follows progress in the checkout, with Track on SwapBee for more detail.

Before you turn it on:

  • Fees: swap fees are charged to the customer, and Swap Everything adds no extra cost for you. Your usual service and network fees still apply.
  • Limits: supported coins, networks and amounts depend on the available route and quote.
  • Eligibility: in your profile's Payment Settings, find "Accept payments in other coins (we swap them to the coins above)", check your receiving coins and addresses, enable it and save. If the switch isn't available, contact BlockBee to check access. Deposit flows aren't included.
  • Exchanges automation: while swap checkout is active for a profile, that profile's Exchanges automation rules pause.

Process notifications correctly

With hosted Checkout:

  • Put your order ID and an unguessable per-payment value in the notify_url, and reject notifications whose value you don't recognise.
  • Verify the signature in the x-ca-signature header before trusting any field.
  • Reply with HTTP 200 and the body *ok*. Anything else counts as a failure and BlockBee retries, so make the handler idempotent using the payment_id.
  • Match the webhook's payment_id, and the fiat value and currency you requested, to the stored order. For reconciliation, store paid_amount and paid_coin (what the customer paid, in crypto) and paid_amount_fiat (that payment in your fiat currency); don't compare a crypto amount directly with a fiat order total. If you set a payment tolerance, the webhook reports the amount the customer actually paid, not the requested value.
  • Once domain verification applies to your account, keep notify_url and redirect_url on domains verified for the profile. Existing accounts need this from 1 February 2027, and accounts created on or after 20 October 2026 from the start.

Our website setup guide covers the server side in more detail.

Roll-out checklist and what to measure

Before launch:

  • receiving addresses set for every coin you receive; supported swap options checked separately;
  • notification and redirect domains verified;
  • webhook endpoint public over HTTPS, verifying signatures, returning *ok* and skipping duplicates;
  • confirmation count reviewed, and not 0;
  • Swap Everything decision made, including its effect on Exchanges automation;
  • a small real payment above the coin's minimum completed end to end, because BlockBee has no sandbox or test mode;
  • support staff briefed on wrong-network and below-minimum cases.

No account yet? Register with BlockBee.

After launch, we recommend tracking a few numbers against your own baseline rather than an industry benchmark:

  • crypto payments started versus confirmed;
  • payments that expired unpaid;
  • support contacts by cause, such as wrong network, below minimum or an expired quote;
  • time from payment start to confirmed webhook, by coin.

FAQ

What if a customer pays on the wrong network?

BlockBee's webhook troubleshooting lists a payment in a different coin or chain from the one the address was generated for as a reason no webhook arrives, so the order won't update. Don't promise that such payments can be recovered; prevent them by naming the network clearly.

Who pays the fees?

By default, fees are deducted from the payment before it is forwarded to you. For Checkout, Payment Settings can add BlockBee's service fee or the estimated blockchain fee to the customer's total. Swap fees in Swap Everything are charged to the customer. See the fee calculator for your rate.

How long does confirmation take?

It depends on the coin and the confirmation count you require; more confirmations take longer. Bitcoin blocks, for example, arrive about every 10 minutes on average, with no guaranteed minimum or maximum delay. Show progress rather than promising a time.

Can I use the redirect instead of the webhook?

Use the redirect for the customer's thank-you page, not as proof of payment. BlockBee's docs recommend validating payments with the notify_url.

Is Swap Everything available on my account?

Look for the switch in your profile's Payment Settings. If it isn't there, contact BlockBee. It applies to eligible Checkout flows, not deposit flows.

Crypto payments made simple

Start accepting cryptocurrency payments with BlockBee

Create an account, generate your API key, and accept Bitcoin, USDT, Ethereum, and 100+ cryptocurrencies through hosted checkout, APIs, plugins, or payment links.

Start now

0% fees for 7 days!

BlockBee Logo
Cryptocurrency solutions to
grow your business

Review Us

BlockBee rating on Cryptwerk
TrustPilot Logo
© BlockBee 2026. All Rights reserved.