Skip to content

States and confirmations

  • 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’s status.
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.

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_units is the integer on the chain, and decimals places its point.
  • match_result says how amount compares with the request.

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.

NetworkFinal whenTypicallyEarly ruleTypically
TRONSolidified blockAbout 1 minuteNone: Final is already fastNone
EthereumThe finalized blockAbout 16 minutes12 blocksAbout 2.5 minutes
BNB Smart ChainThe finalized block1 to 2 secondsNone: Final is already fastNone
SolanaFinalized commitmentUnder 1 secondNone: Final is already fastNone
ArbitrumThe finalized blockAbout 19 minutes60 seconds after its block, by the chain's clockAbout 1 minute

Times were read from each chain on 6 November 2026. They are readings, not promises.

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_by says which rule confirmed a Payment: final or early.
  • Only a Payment confirmed early can later be reversed, short of a rare deep reorganisation.
  • 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.