POST /orders, follow it with GET /orders/{id} or the nft_order.updated webhook, and prove the pull with GET /orders/{id}/verification.
Order statuses
The pull and the token
Once paid and opened, the order carries:pull: the item pulled (card_id,category,name,value,pulled_at).pull.valueis the item’s value when it was pulled; it anchors the sell-back offer.token: the NFT. On EVM it haschain,contract,token_id,statusandtx; on a Solana program it hascollectionandassetinstead ofcontract.
token.status: pending (reserved, not sent), submitted, confirmed, failed (being retried), or burned once the token has been sold back or shipped.
Multi-pack orders
A multi-pack order (quantity 2-10) is one payment for quantity × the pack price. Each pack inside it is a unit: once the payment settles, every unit opens, mints and (if it has to) refunds on its own, exactly like a single order.
priceis the total due;unit_pricethe price of one pack. Each unit is in the single-order shape plusbatch_idandunit(1 toquantity), and carries its ownpullandtoken.GET /orders/{id}with yourIdempotency-Keyor the order’sidreturns the whole order; with one unit’sidit returns that unit.- The order’s
status:awaiting_paymentuntil paid; once paid, the units’ status when they all agree (paid,rolled,minted,refund_due,refunded,expired, …); otherwiseprocessingwhile any unit is still moving, andcompletedonce every unit is final (for example somemintedand onerefunded). - Refunds are per unit. A unit that can’t open after payment goes to
refund_dueon its own and refunds its share of the payment. A payment that arrives after the 24-hour window refunds every unit its share (paid_after_expiry). - In
GET /ordersand in webhooks the units appear one by one, each with the order’sorder_id, itsbatch_idand itsunitnumber.
Provably fair
Every pack is opened provably fairly.GET /orders/{id}/verification returns the proof for an order’s pull, and a public verify_url your customer can open to re-run the check without a key.
