trade.failed
The vendor rejected the card. failure.message is a short reason you can show your customer as-is — written from what the vendor reported, with any card code removed.
cardFindings is here too when the photos showed something you should know — see trade.succeeded.
failure.kind is one of already_redeemed, invalid, duplicate (also: a certain repeat of a card that sold, is in progress, or was rejected — closed before any vendor saw it), wrong_card, unreadable, blocked (zombie card), not_active, vendor_refused, other.
failure.class says whether it was the card’s fault: card_dead, card_problem, not_active, resend, vendor_refused. failure.retryable: true means the card may be fine — the customer can submit it again and Kardlane won’t treat it as a repeat. See Failure reasons.
failure.proof is the vendor’s own evidence: their screenshots (type: "image", download from url with your API key) and words (type: "text", card codes masked). Attach it if you mark cards as bad.
failure.duplicateOf: for a repeat card, your externalRef of the earlier sale it repeats.
Delivery#
Sent as a signed POST to your project’s webhook URL — see the Webhooks guide to verify the signature. Delivery is at-least-once: dedupe on the X-Kardlane-Delivery header (or data.idempotencyKey).