trade.escalated
A person needs to decide — the agent wasn’t sure, a check held it back (e.g. the vendor isn’t trusted yet), the vendor redeemed only some cards, or someone stopped the bot. review carries the agent’s conclusion and how to resolve it via the API.
cardFindings is here too when the photos showed something you should know — see trade.succeeded.
review.suggestedVerdict is succeeded, failed, partial or null (couldn’t tell).
review.partial lists each card’s outcome when only some were redeemed; Kardlane’s fee applies to the verified-redeemed cards however you resolve.
review.requote is set when the vendor re-quoted after the card went out and the new rate wasn’t accepted automatically. Answer it with POST /v1/trades/{id}/requote (review.requote.decide).
A trade can escalate again after trade.resumed; each round has its own idempotencyKey (…:escalated:r1).
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).