A Payment is confirmed
The one event a Merchant must handle. Credit data.payment.amount, the true amount that arrived. On by default.
Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”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…Request Bodyrequired
Section titled “Request Bodyrequired”object
Deduplicate on this. Delivery is at least once.
object
object
Derived from the Transfer, so one Transfer can never become two Payments.
seen may still be reversed. confirmed is Final or accepted early. reversed disappeared after being confirmed.
The Merchant’s own identifier for a Checkout, unique per Merchant and Mode.
An amount in USD. Each Coin counts as 1 USD.
What actually arrived, kept exactly. The Merchant credits this.
An on-chain amount in integer base units, as a string because it can exceed any JSON number.
The Coin’s decimals on this Network. BSC uses 18, most others 6.
How the amount that arrived compares with the Checkout.
The evidence that matched the Transfer to the Checkout. A sender or transaction hash a Payer posted is never evidence.
One blockchain. Test mode uses the test Network codes.
The coin, identified on-chain by its contract and never by this symbol.
The Coin’s contract on this Network.
The Receive Address the money went to.
The on-chain sender.
Examples
{ "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" } }}Responses
Section titled “Responses”Any 2xx within 10 seconds counts as delivered. Anything else retries for 3 days.