BNB Smart Chain is the fast, cheap network: a block about every second, and a network fee of cents or less. CoinsFlow is a BNB payment gateway for BNB itself and for USDT and USDC on the chain: a payment is paid about 15 seconds after your customer sends it, and withdrawable about 15 seconds after that. It costs 0.5% per payment.
How it works
- Create an invoice on BNB Smart Chain (
bsc) in BNB, USDT or USDC, priced in the coin or in US dollars: one API call from your shop, or a few clicks in the dashboard. - Your customer opens the payment page: a fresh
0x…address, the exact amount, a QR code, and the network, named, so a token is not sent on the wrong chain. - We see the payment in its first block, about a second after it is sent, and the payment page tells your customer it is on its way.
- At 15 confirmations, about 15 seconds, it is paid: your server gets the signed
invoice.paidwebhook, and the money is in your balance. - At 30 confirmations, about 15 seconds later, it is final and withdrawable: to your own wallet on BNB Smart Chain, by hand or automatically.
BNB Smart Chain on CoinsFlow, in numbers
| Coins on BNB Smart Chain | BNB, and USDT and USDC as BEP-20 tokens |
|---|---|
| Payment seen | in its first block, about a second after your customer sends it |
| Paid | 15 confirmations, about 15 seconds |
| Final, and withdrawable | 30 confirmations, about 15 seconds after that |
| Customer’s network fee | cents or less, paid in BNB |
| Our fee | 0.5% of each payment |
| Address | a fresh 0x… address for each invoice |
| Invoice open for | 3 days, or up to 7 if you ask; a late payment is still credited |
| Smallest withdrawal | 0.0005 BNB, 1 USDT, 1 USDC |
A $40 order paid in BNB, in numbers
| Price | $40.00, asked in BNB at the current price, rounded up to 6 decimals |
|---|---|
| Payment seen | in its first block, about a second after the customer sends it: invoice.detected |
| Paid | at 15 confirmations, about 15 seconds: invoice.paid |
| Our fee | $0.20 (0.5%), taken in BNB when it is credited |
| Customer’s network fee | cents or less, paid in BNB by the customer on top |
| In your balance | about $39.80 worth of BNB, withdrawable about 15 seconds later |
The same order in USDT or USDC on BNB Smart Chain asks for exactly 40.00 tokens and leaves 39.80 in your balance, at the same speed and for the same cents of network fee. That is the cheapest way to take the dollar tokens on CoinsFlow: see Accept USDT.
Read from our own node
Payments are read from a BNB Smart Chain node we run ourselves, like every network we take. Nobody else's API decides whether you were paid.
A BNB payment API in one call
One request makes the invoice, here in cURL, Node.js and Python. There is no SDK to install. For USDT or USDC on BNB Smart Chain, change asset.
curl https://api.coinsflow.app/v1/invoices \
-H "Authorization: Bearer $COINSFLOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1042" \
-d '{"chain":"bsc","asset":"BNB","priceAmount":"40.00","orderId":"order-1042"}'Send your customer to the paymentUrl in the answer, and fulfil the order on the invoice.paid webhook. To try it with no money first, add "test": true to the body and simulate the payment. Every field is in the API docs.