States and confirmations
A Checkout
Section titled “A Checkout”openpaidThe Payer paid in time.openexpiredpaidPaid late, within 72 hours of expiry.openexpiredNobody paid.opencancelledYour server cancelled it.
| Status | Meaning |
|---|---|
open |
Waiting for the Payer. A live Checkout holds a Hold on your balance. |
paid |
A confirmed Payment is attached. Credit from its Callback. |
expired |
The time ran out. The Hold is released. |
cancelled |
Your server cancelled it. |
- A Checkout whose money has been seen neither expires nor cancels. It waits for that Payment.
- A reversed Payment leaves its Checkout
paid. Act on the Payment’sstatus.
A Payment
Section titled “A Payment”| Status | Meaning | Do |
|---|---|---|
seen |
In a block, but not Final. It could still be reversed. | Never credit. |
confirmed |
Final, or accepted by the early rule. | Credit amount. |
reversed |
Confirmed, then gone from the chain. Rare. | Take back what you credited. The Fee is refunded. |
Which amount to credit
Section titled “Which amount to credit”Credit amount, what arrived. It can differ from requested_amount.
{ "id": "pay_6f1c…", "status": "confirmed", "reference": "ORDER-1042", "requested_amount": "50.00", "amount": "49.0037", "amount_base_units": "49003700", "decimals": 6, "match_result": "under", "confirmed_by": "final", "fee": "1.029078"}- Amounts are decimal strings. Never parse them as floats.
amount_base_unitsis the integer on the chain, anddecimalsplaces its point.match_resultsays howamountcompares with the request.
Confirmations
Section titled “Confirmations”A payment is seen when it is in a block, and Final when it can no longer be reversed. Each Network has its own rule.
| Network | Final when | Typically | Early rule | Typically |
|---|---|---|---|---|
| TRON | Solidified block | About 1 minute | None: Final is already fast | None |
| Ethereum | The finalized block | About 16 minutes | 12 blocks | About 2.5 minutes |
| BNB Smart Chain | The finalized block | 1 to 2 seconds | None: Final is already fast | None |
| Solana | Finalized commitment | Under 1 second | None: Final is already fast | None |
| Arbitrum | The finalized block | About 19 minutes | 60 seconds after its block, by the chain's clock | About 1 minute |
Times were read from each chain on 6 November 2026. They are readings, not promises.
The early rule
Section titled “The early rule”Ethereum and Arbitrum take many minutes to reach Final. A Payment at or below your Early Limit is confirmed by the faster early rule.
- The Early Limit is 1,000 USD by default. Change it in Settings, under Business. At 0, every Payment waits for Final.
confirmed_bysays which rule confirmed a Payment:finalorearly.- Only a Payment confirmed early can later be
reversed, short of a rare deep reorganisation.
Guarantees
Section titled “Guarantees”- One Payment for each Checkout. A second transfer waits in the Unmatched inbox.
- One transfer, one Payment. Deduplicate on the Payment
id. - Late, never lost. If VoltPay falls behind, it reads the chain from where it stopped.
- Dust is ignored. A transfer under 1 USD that matches no open Checkout exactly is dropped.