Accept Bitcoin payments
Give each customer a BTC deposit address on Bitcoin and receive every payment in your own wallet, minus 1.25%. Free to integrate: no account, no API key.
How to accept Bitcoin
Create a BTC deposit address
Send one request with the URL to notify and the Bitcoin wallet that receives the money. The same callback URL always returns the same address.
curl "https://api.trezorpay.com/btc/create/?callback=https://your.shop/paid?order=42&address=bc1qg975h6gdx5mryeac72h6lj2nzygugxhyuukqvs&pending=1"Show the address to your customer
Display
address_in, with a QR code from/btc/qrcode/if you like. Your customer pays at least 0.00008 BTC; the address never expires and can be paid any number of times.Receive the funds and a signed callback
After 1 confirmations (about 10 minutes), we forward the payment to your wallet and call your URL with
pending=0,value_forwarded_coin,txid_out,coin=btc, signed inx-ca-signature. Answer*ok*.
BTC on Bitcoin
Bitcoin blocks come every ten minutes. Each payment is forwarded in one transaction that pays your wallet and the fee together, its network fee taken from the payment.
For BTC, the network cost of forwarding comes out of the payment itself: you receive the amount paid minus our fee and the gas of the forward.
Prefer to see the numbers first? Try the simulator, or read how fees and callbacks work.
Bitcoin payments: questions
What is the minimum Bitcoin payment?
0.00008 BTC. A smaller payment is still recorded and shown in /logs/, but it is not forwarded, so that the network cost can never eat the payment.
How long until a Bitcoin payment reaches my wallet?
We forward it once it has 1 confirmations on Bitcoin, which takes about 10 minutes on average, then send your server a signed callback with the forwarding transaction id.
Who pays the network fee for Bitcoin?
The network fee of the forwarding transaction is taken from the BTC payment itself, so you never hold BTC for fees.
Do I need an account to accept Bitcoin?
No. There is no sign-up and no API key: one request to /btc/create/ with your callback URL and your Bitcoin wallet returns a deposit address. Funds go straight to that wallet.