Search BlockBee
Search BlockBee blog posts and documentation.
Instant Crypto Settlement to Your Own Wallet: How It Works
What instant settlement means in crypto payments, how forwarding to your own wallet works step by step, and what decides how fast you are paid.
Short answer
In crypto payments, "instant settlement" means the gateway sends each payment on to your wallet as soon as the blockchain confirms it, instead of holding a balance and paying you on a schedule. The wait is set by the blockchain and by how many confirmations you ask for, not by a payout calendar.
BlockBee works this way. Each confirmed payment is forwarded, minus the fee, to the wallet address you choose. BlockBee keeps no balance for you to withdraw.
Two ways a gateway can pay you
| Holds a balance (custodial) | Forwards each payment | |
|---|---|---|
| Where the money goes first | The provider's wallet | A payment address the gateway creates for that order |
| When you get it | When you withdraw, or on a payout schedule | Once the payment has the confirmations you set |
| If the provider freezes accounts or fails | Your balance is at risk | Nothing waits at the provider |
| Who controls the receiving wallet | The provider | You |
A custodial gateway can suit a business that wants the provider to handle conversion and bank payouts. The cost is that your money sits with a third party until you move it. Our guide to custodial and non-custodial gateways covers the trade-offs in more detail.
How forwarding works with BlockBee
- You create a payment. Your system calls the API, or a plugin or hosted checkout does it for you. BlockBee returns a unique address for that order.
- The customer pays that address from any wallet or exchange.
- BlockBee spots the transaction. If you set
pending=1, BlockBee sends a webhook while the payment is still unconfirmed. Treat it as a notice, not as proof of payment. - The blockchain confirms it. You choose how many confirmations to wait for with the
confirmationsparameter; the minimum is 1. - BlockBee forwards the funds. It deducts its fee and the network fee and sends the rest to your address. The confirmed webhook includes the forwarding transaction hash (
txid_out), the amount forwarded (value_forwarded_coin) and the fee (fee_coin). - Your system replies
*ok*. BlockBee marks the payment Done and stops retrying the webhook.
The custom payment flow guide walks through each call. Always verify the webhook signature before you mark an order paid.
What decides how fast you are paid
- The blockchain. Networks produce blocks at different speeds. A Bitcoin block takes about 10 minutes on average; many other networks confirm in seconds.
- Your confirmation setting. More confirmations cost time but lower the risk of a reversed transaction. Many businesses ask for more on large orders.
- Network congestion. When a network is busy, transactions wait longer to be included.
- Forwarding priority. For Bitcoin, Ethereum, ERC-20 tokens and Litecoin you can set a
priority. A higher priority confirms the forwarding transaction sooner and costs a higher network fee.
Settling in stablecoins
If you want to avoid price swings, you have two options:
- Accept stablecoins directly. BlockBee supports USDT and USDC on networks such as Ethereum, Solana, Polygon, Base and BNB Smart Chain, USDT on Tron and TON, and other dollar and euro stablecoins. See the full list and minimums.
- Convert incoming coins automatically. With SwapBee rules in the dashboard, a payment in one coin can be exchanged for another, such as a stablecoin where that pair is available, before it reaches you. Conversion is best effort: if no quote is available at that moment, you receive the original coin.
To end up with dollars or euros in a bank, forward payments to your deposit address at an exchange and sell there. BlockBee does not pay out to bank accounts.
Paying out from the same funds
If you also send money, for example to sellers, affiliates or staff, you can route incoming payments into a BlockBee Self-Custodial Wallet and send payouts from it by API or from the dashboard. See our guide to mass payouts.
This wallet uses threshold signatures. Three key shares exist: BlockBee holds one encrypted share, and you hold your API key and a recovery key. Any two are needed to sign, so BlockBee cannot move the funds on its own. If you lose both your API key and your recovery key, the funds cannot be recovered, so store both safely.
Questions to ask any provider that promises instant settlement
- Do you hold my funds at any point, and for how long?
- Who controls the wallet the money lands in?
- How many confirmations do you wait for, and can I change that?
- Which fees come out of each payment: your fee, the network fee, conversion?
- What is the minimum payment per coin, and what happens to smaller ones?
- How do you tell my system a payment is complete, and do you retry if it doesn't answer?
Frequently asked questions
Is crypto settlement really instant?
Not quite. It is as fast as the blockchain confirms the payment, from seconds to tens of minutes, and there is no extra wait for a payout run.
Can I be paid in dollars instantly?
Not with BlockBee. It pays in crypto. You can receive stablecoins such as USDC or USDT, or forward funds to an exchange and convert them there.
What if the customer sends less than the minimum?
Each coin has a minimum transaction amount. BlockBee ignores payments below it and the funds are lost, so show the minimum to customers before they pay.
What if the customer pays less than the order total?
Your webhook reports the amount received. Compare it with the amount due before you fulfil the order. If you use the hosted checkout, you can set a payment tolerance and mark partial payments as paid.
Do I need to run a node or server?
No. BlockBee watches the blockchains and forwards payments for you. You need a wallet address for each coin you accept and, for the API, a server that receives webhooks.
To set it up, create an account, add your wallet addresses and choose a checkout, plugin or the API.
Support
Review Us
