{
"id": "evt_2e4a6c8e0b1d3f5a7c9e1b3d5f7a9c0e",
"type": "nft_shipment.updated",
"created_at": "2026-11-17T16:04:02.010Z",
"data": {
"shipment": {
"quote_id": "0xa93f...0c2d",
"status": "redeemed",
"shipping_cost": 9.85,
"holder": "0x8f3c...e21a",
"expires_at": "2026-11-17T18:41:02.000Z",
"paid_at": "2026-11-16T18:41:02.000Z",
"burn": null,
"fulfilment": {
"status": "shipped",
"carrier": "USPS",
"service": "Priority Mail",
"tracking_number": "9400111899223456789012",
"tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223456789012",
"shipped_at": "2026-11-17T16:02:11.000Z",
"expected_delivery": "2026-11-20",
"delivered_at": null,
"created_at": "2026-11-16T19:05:30.000Z"
}
}
}
}Shipment updated
We send this to your webhook URL. A shipment was paid (ready), a token was burned (redeemed), or the box moved: fulfilment.status pending, processing, shipped, delivered, cancelled, needs_review.
data.shipment has the fields of the one-token shape: quote_id, status, shipping_cost, holder, expires_at, paid_at, burn and fulfilment. In a multi-token shipment each event is about one token (its quote_id); Get a shipment with that quote_id returns the whole box. On Solana burn is null in the event: fetch the GET for a fresh transaction. A burn window lapsing sends no event. Setup, signatures and retries: Webhooks.
{
"id": "evt_2e4a6c8e0b1d3f5a7c9e1b3d5f7a9c0e",
"type": "nft_shipment.updated",
"created_at": "2026-11-17T16:04:02.010Z",
"data": {
"shipment": {
"quote_id": "0xa93f...0c2d",
"status": "redeemed",
"shipping_cost": 9.85,
"holder": "0x8f3c...e21a",
"expires_at": "2026-11-17T18:41:02.000Z",
"paid_at": "2026-11-16T18:41:02.000Z",
"burn": null,
"fulfilment": {
"status": "shipped",
"carrier": "USPS",
"service": "Priority Mail",
"tracking_number": "9400111899223456789012",
"tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223456789012",
"shipped_at": "2026-11-17T16:02:11.000Z",
"expected_delivery": "2026-11-20",
"delivered_at": null,
"created_at": "2026-11-16T19:05:30.000Z"
}
}
}
}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.

