{
"id": "evt_4b8e0f2a91c3d5e7f6a0b1c2d3e4f5a6",
"type": "nft_order.updated",
"created_at": "2026-11-16T18:04:52.118Z",
"data": {
"order": {
"order_id": "okx-ord-7f3a9c21",
"id": "3d2b8f0e-6c1a-4f7e-9a51-2b0d8c4e7f13",
"status": "minted",
"pack_type": "bronze",
"category": "pokemon",
"odds": "standard",
"price": 25,
"recipient": "0x8f3c...e21a",
"mint_chain": "evm:196",
"paid_at": "2026-11-16T18:04:40.002Z",
"pull": {
"card_id": "a1c4e2f8-7b3d-4c5e-9f1a-2b3c4d5e6f70",
"category": "pokemon",
"name": "Charizard ex 199/165 PSA 10",
"value": 412.5,
"pulled_at": "2026-11-16T18:04:41.317Z"
},
"token": {
"chain": "evm:196",
"contract": "0x7b1e...c0de",
"token_id": "81264573985362058461377125337283195667",
"status": "confirmed",
"tx": "0x9f2a..."
},
"failure_reason": null,
"created_at": "2026-11-16T18:02:11.420Z"
}
}
}Order updated
We send this to your webhook URL. An order changed status after you created it: paid, rolled, minted, mint_failed, expired, refund_due, refunded. data.order is the order as Get an order returns it. For a multi-pack order it fires for each unit, carrying the order’s order_id, its batch_id and the unit number.
The payload is the current state, not a diff: several quick changes can arrive as one event with the latest status, and an intermediate status may never be sent on its own. Setup, signatures and retries: Webhooks.
{
"id": "evt_4b8e0f2a91c3d5e7f6a0b1c2d3e4f5a6",
"type": "nft_order.updated",
"created_at": "2026-11-16T18:04:52.118Z",
"data": {
"order": {
"order_id": "okx-ord-7f3a9c21",
"id": "3d2b8f0e-6c1a-4f7e-9a51-2b0d8c4e7f13",
"status": "minted",
"pack_type": "bronze",
"category": "pokemon",
"odds": "standard",
"price": 25,
"recipient": "0x8f3c...e21a",
"mint_chain": "evm:196",
"paid_at": "2026-11-16T18:04:40.002Z",
"pull": {
"card_id": "a1c4e2f8-7b3d-4c5e-9f1a-2b3c4d5e6f70",
"category": "pokemon",
"name": "Charizard ex 199/165 PSA 10",
"value": 412.5,
"pulled_at": "2026-11-16T18:04:41.317Z"
},
"token": {
"chain": "evm:196",
"contract": "0x7b1e...c0de",
"token_id": "81264573985362058461377125337283195667",
"status": "confirmed",
"tx": "0x9f2a..."
},
"failure_reason": null,
"created_at": "2026-11-16T18:02:11.420Z"
}
}
}Headers
t=<unix seconds>,v1=<hex>. v1 is the HMAC-SHA256 of <t>.<raw request body>, keyed with your whole secret, whsec_ included. Compute it over the raw bytes before any JSON parsing, compare in constant time, and refuse a t more than 300 seconds from your clock. Each retry is signed afresh.
Body
Response
Answer any 2xx within 5 seconds, and do slow work after you've answered. Anything else counts as a failure, including a redirect (we never follow one). We retry after 1 minute, 5 minutes, 30 minutes, 2, 6, 12 and 24 hours, then drop the event after 8 attempts; poll to catch up. Delivery is at-least-once and unordered, so dedupe on id.

