Skip to content

A Payment is confirmed

POST

The one event a Merchant must handle. Credit data.payment.amount, the true amount that arrived. On by default.

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
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: payment.confirmed
data
required
object
payment
required
object
id
required

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

string
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
reference
required

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

string
>= 1 characters <= 64 characters
customer_reference
required
string | null
requested_amount
required

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

string
/^[0-9]+(\.[0-9]+)?$/
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]+$/
decimals
required

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

integer
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
address
required

The Receive Address the money went to.

string
address_name
required
string
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]+)?$/
confirmed_at
required
string | null format: date-time

Examples

Exampledefault
{
"id": "evt_01J9…",
"type": "payment.confirmed",
"created_at": "2026-11-06T13:10:02Z",
"mode": "live",
"data": {
"payment": {
"id": "pay_6f1c…",
"status": "confirmed",
"checkout_id": "chk_01J9…",
"reference": "DEP20261106123456",
"customer_reference": "user_8f21",
"requested_amount": "50.00",
"amount": "49.0037",
"amount_base_units": "49003700",
"decimals": 6,
"match_result": "under",
"matched_by": "tag_digits",
"network": "tron",
"coin": "usdt",
"contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"address": "TSeJkUh4Qv67VNFwY8LaAxERygNdy6NQZK",
"address_name": "Main TRON 3",
"from": "TL…",
"tx_hash": "8f3a…",
"log_index": 0,
"block_number": 87754008,
"confirmed_by": "final",
"fee": "1.029078",
"confirmed_at": "2026-11-06T13:10:01Z"
}
}
}

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