curl -X POST https://catchbackcards.com/api/partner/v2/tokens/81264573985362058461377125337283195667/burn \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "quote_id": "0x5e0c...91ab", "holder_signature": "0x9b2e...1c" }'
{
"quote_id": "0x5e0c...91ab",
"tx_hash": "0x3f8a...d41e"
}
Tokens & sell-back
Burn without gas
EVM only. The holder signs the quote instead of sending a transaction; we send the burn and pay its gas.
POST
/
api
/
partner
/
v2
/
tokens
/
{tokenId}
/
burn
curl -X POST https://catchbackcards.com/api/partner/v2/tokens/81264573985362058461377125337283195667/burn \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "quote_id": "0x5e0c...91ab", "holder_signature": "0x9b2e...1c" }'
{
"quote_id": "0x5e0c...91ab",
"tx_hash": "0x3f8a...d41e"
}
Scope:
nft:orders
For a holder with no native coin on the mint chain. The holder signs the quote (a signature, not a transaction, so no gas), you send us that signature, and our wallet sends burnWithQuoteFor(quote, signature, holderSignature). It works for a sell-back quote and for each token’s burn in a paid shipment. The payout or shipment then follows exactly as for a burn the holder sent.
How the holder signs: Sell-back.
- The signature authorizes only that quote: its token, payout, amount and expiry, once. It is checked on chain, so we can’t burn a token without it.
- We check the burn before sending it, so a refusal sends nothing and burns nothing.
- Smart-contract wallets (ERC-1271) can sign too.
- Retrying after a
202can send a second transaction, which reverts harmlessly withQuoteAlreadyUsed. Follow the quote instead of retrying.
The quote to burn with: a sell-back
quote_id, or the token’s quote_id in a paid shipment.Response
202. The burn is sent, not yet final. Follow the quote (Get a quote, thesellback.updated webhook) or the shipment as usual.
Errors
| Status | Code | When |
|---|---|---|
400 | BAD_JSON | The body isn’t JSON |
400 | BAD_QUOTE_ID | quote_id is missing |
400 | BAD_HOLDER_SIGNATURE | holder_signature isn’t hex, or isn’t the holder’s signature over this quote |
400 | RELAY_NOT_SUPPORTED | A Solana program; sign the quote’s transaction instead |
403 | NOT_HOLDER | The token moved after the quote |
404 | UNKNOWN_TOKEN | No such token on your program’s contract |
404 | UNKNOWN_QUOTE | No such quote for this token |
409 | TOKEN_BURNED | The token was already sold back or shipped |
409 | QUOTE_USED | This quote was already burned with |
409 | QUOTE_EXPIRED | Get a new quote, or renew the shipment |
409 | NOT_PAID | The shipment’s shipping isn’t paid yet |
409 | QUOTE_NOT_RELAYABLE | The quote was issued before this endpoint existed; get a new one |
409 | Your program has no contract yet | |
502 | CHAIN_REFUSED | The chain refused the burn; nothing was burned |
503 | CONTRACT_PAUSED | Burns are paused by CatchBack; retry later |
curl -X POST https://catchbackcards.com/api/partner/v2/tokens/81264573985362058461377125337283195667/burn \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "quote_id": "0x5e0c...91ab", "holder_signature": "0x9b2e...1c" }'
{
"quote_id": "0x5e0c...91ab",
"tx_hash": "0x3f8a...d41e"
}

