Before you start
What we send you. Email support@catchbackcards.com and we’ll set you up with:- a sandbox base URL, where the test API lives;
- a sandbox API key, which only works there;
- your test chain and sandbox contract address.
1. Check your key
"scopes": ["nft:orders"] and your program. A 401 means the key is wrong; a 403 means it’s missing the nft:orders scope, so contact us.
2. Pick a pack
List the packs you can sell:pack_type (for example bronze), a price in dollars, and available. Pick one where available is true. To see its odds and every item it can pull, the same view you’d show a customer, call Get a pack’s odds and pool with that pack_type.
3. Create an order for your test wallet
recipientis the wallet the item is delivered to.Idempotency-Keyis your own id for the order. If a call fails or times out, send it again with the same key and you’ll get the same order back, never a second one. You’ll also use it to look the order up.
order, with "status": "awaiting_payment", and a payment. In production you’d hand payment to your customer to pay. Here, copy payment.intent_id: it starts with sbx_pi_.
4. Pay for it (simulated)
5. Open the pack and receive the item
Our background work runs every two minutes. In the sandbox you can also run it straight away by calling tick, so you don’t have to wait:order.status reaches minted. Along the way it moves:
That’s the moment your app shows the customer what they pulled. Check your test wallet: the token is there.
6. Sell it back
Ask for a quote. It fixes the price for 10 minutes:amount_usd is what the customer gets. To accept, the wallet holder signs one transaction that burns the token with the signed quote. The code for that is on the Sell-back page. Then tick and check the quote:
quote.payout.status is sent, the sale is complete, and in the sandbox the payout lands instantly.
That’s the whole flow. To try shipping instead, see Shipping: estimate, create and pay a shipment, burn, then mark it shipped with POST /sandbox/shipments/{id}.
How the sandbox differs from production
All three sandbox endpoints return 404 outside the sandbox.
A full run (TypeScript + viem)
The same flow our own certification suite runs against the sandbox.burnForQuote and CATCHBACK_CARDS_ABI are on the Sell-back page; alice, bob, their viem wallets and CONTRACT are yours.
Next steps
- Webhooks: get each status change pushed to you instead of polling.
- Orders: every status, including refunds and multi-pack orders.
- Go-live checklist: what to confirm before switching to your production key.

