Skip to content

A Checkout expired unpaid

POST

Off by default. A Checkout can still become paid within the Late Window of 72 hours.

Gateway-Signature
required
string

t=<unix seconds>,v1=<hex HMAC-SHA256(secret, "<t>.<raw body>")>. During a secret rotation both secrets sign for 24 hours and the header carries two v1 values.

Example

t=1793980802,v1=9f2c…
Media typeapplication/json
object
id
required

Deduplicate on this. Delivery is at least once.

string

Example

evt_01J9…
type
required
string
Allowed values: payment.confirmed payment.reversed payment.seen checkout.expired balance.low balance.empty test
created_at
required
string format: date-time
mode
required
string
Allowed values: live test
type
required
string
Allowed value: checkout.expired
data
required
object
checkout
required
object
id
required
string

Example

chk_01J9…
reference
required

The Merchant’s own identifier for a Checkout, unique per Merchant and Mode.

string
>= 1 characters <= 64 characters

Example

DEP20261106123456
url
required

The Checkout Link. It carries only an opaque token.

string format: uri

Example

https://pay.voltpay.space/c/8sJk2Qm4Tz
status
required

open can become paid, expired or cancelled. expired can still become paid within the Late Window.

string
Allowed values: open paid expired cancelled
amount
required

An amount in USD. Each Coin counts as 1 USD.

string
/^[0-9]+(\.[0-9]+)?$/

Example

50.00
customer_reference
string | null
pairs
required

The Pairs on offer, fixed at creation.

Array<object>

One Network with one Coin.

object
network
required

One blockchain. Test mode uses the test Network codes.

string
Allowed values: tron bsc ethereum arbitrum solana base polygon optimism avalanche tron_nile bsc_testnet ethereum_sepolia arbitrum_sepolia solana_devnet
coin
required

The coin, identified on-chain by its contract and never by this symbol.

string
Allowed values: usdt usdc
payment
One of:
object
id
required

Derived from the Transfer, so one Transfer can never become two Payments.

string

Example

pay_6f1c…
status
required

seen may still be reversed. confirmed is Final or accepted early. reversed disappeared after being confirmed.

string
Allowed values: seen confirmed reversed
checkout_id
required
string

Example

chk_01J9…
reference
required

The Merchant’s own identifier for a Checkout, unique per Merchant and Mode.

string
>= 1 characters <= 64 characters

Example

DEP20261106123456
customer_reference
required
string | null
requested_amount
required

An amount in USD. Each Coin counts as 1 USD.

string
/^[0-9]+(\.[0-9]+)?$/

Example

50.00
amount
required

What actually arrived, kept exactly. The Merchant credits this.

string
/^[0-9]+(\.[0-9]+)?$/
amount_base_units
required

An on-chain amount in integer base units, as a string because it can exceed any JSON number.

string
/^[0-9]+$/

Example

49003700
decimals
required

The Coin’s decimals on this Network. BSC uses 18, most others 6.

integer

Example

6
match_result
required

How the amount that arrived compares with the Checkout.

string
Allowed values: exact under over late
matched_by
required

The evidence that matched the Transfer to the Checkout. A sender or transaction hash a Payer posted is never evidence.

string
Allowed values: exact_amount reservation tag_digits late manual
network
required

One blockchain. Test mode uses the test Network codes.

string
Allowed values: tron bsc ethereum arbitrum solana base polygon optimism avalanche tron_nile bsc_testnet ethereum_sepolia arbitrum_sepolia solana_devnet
coin
required

The coin, identified on-chain by its contract and never by this symbol.

string
Allowed values: usdt usdc
contract
required

The Coin’s contract on this Network.

string

Example

TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
address
required

The Receive Address the money went to.

string

Example

TSeJkUh4Qv67VNFwY8LaAxERygNdy6NQZK
address_name
required
string

Example

Main TRON 3
from
required

The on-chain sender.

string
tx_hash
required
string
log_index
required
integer
block_number
required
integer format: int64
confirmed_by
required
One of:

final met the Network’s Confirmation Rule. early used the faster rule under the Early Limit.

string
Allowed values: final early
fee
required
One of:

An exact decimal amount. Never parse it into a float.

string
/^[0-9]+(\.[0-9]+)?$/

Example

49.0037
confirmed_at
required
string | null format: date-time
expires_at
required
string format: date-time
created_at
required
string format: date-time

Example

{
"id": "chk_01J9…",
"reference": "DEP20261106123456",
"url": "https://pay.voltpay.space/c/8sJk2Qm4Tz",
"status": "open",
"amount": "50.00",
"pairs": [
{
"network": "tron",
"coin": "usdt"
}
],
"expires_at": "2026-11-06T13:34:56Z",
"created_at": "2026-11-06T13:04:56Z"
}

Any 2xx within 10 seconds counts as delivered. Anything else retries for 3 days.