Kardlane
Get started

How a trade works

What the bot does between your request and the verdict.

The journey#

  1. Intake

    The bot reads the card photos (code, value, how many cards) and checks the card against every earlier trade. A certain repeat — the same photo or code as a card that sold, is in progress, or was rejected as used — is closed straight away as trade.failed (kind duplicate, naming the earlier sale) before any vendor sees it.

  2. Collecting quotes

    Every matching vendor group is asked for a rate — by default USD 100 APPLE/ITUNES (with CODE for a typed code, one line per denomination for several cards). Each vendor has its own deadline; the window closes the moment every vendor has quoted or clearly said they’re not buying — replies in an unusual shape are read within seconds, so a vendor answering with a price-list line doesn’t hold everyone up. Only answers to this question count — never an earlier trade’s price or a broadcast price list.

  3. Choosing a vendor

    Quotes are converted to one comparable rate (per unit, in your payout currency) and the best profitable one wins, subject to your routing rules. Unprofitable or missing quotes → escalated.

  4. Sending the card

    The card goes to the chosen vendor, captioned with exactly what they were asked. If every quote leaves less than your margin threshold, the negative margin setting decides: send to the best anyway and report it, or a person decides. If the vendor re-quotes lower after getting the card (a re-quote), the card moves to a vendor that quoted more for this trade when there is one; otherwise the margin decides, then negative margin.

  5. Reading the outcome

    The vendor’s own credit line, matched to your card by its code, is read exactly and settles the trade at whatever the vendor actually paid — with any difference from what was agreed reported. Otherwise an AI agent reads the replies; a clear, verified outcome settles automatically (for trusted vendors) and anything else comes to you. Slow vendors can be checked in with, and stated waits are honoured.

  6. When the vendor rejects it

    Used or empty cards fail. Otherwise Kardlane does what a person would: sends the photos again, crops each card out and straightens it, or offers the card to the next vendor that quoted. What’s left fails as retryable so your customer can resubmit. Every failure carries the vendor’s proof.

  7. After it closes

    A credit that arrives after the trade went to a person still closes it automatically. If the vendor changes its word after the trade closed — a reversal, a credit after a failure — you get trade.verdict_changed; the trade itself never flips.

Every case in detail: How Kardlane decides and the scenario map.

Statuses#

StatusMeaning
SOURCINGAsking vendors for rates.
QUOTEDA vendor was chosen; the card is being sent.
UPLOADEDThe card is with a vendor; waiting for their verdict. Also after a re-route to the next vendor, or after you accept a re-quote.
CONFIRMEDSucceeded — the vendor redeemed and paid.
FAILEDThe card was rejected (or was a certain repeat).
ESCALATEDWaiting for a person to decide. A late vendor credit (or a clear used-card report) can still close it.
CANCELLEDClosed as handled outside Kardlane.

Several trades with the same vendor#

Trades run in parallel, and vendor groups are shared, so every vendor message is attributed to the right trade — or held back. A reply to one of our rate requests counts only for that trade; an untargeted reply that could belong to several is read only by the AI, which is told about all our open requests. A verdict only settles automatically when it’s tied to this card (a reply to its card message, or its code repeated) whenever a look-alike card of ours is with the same vendor; otherwise a person decides. And look-alike cards are spread across vendors when another is almost as good — or numbered in the caption (“card #2”) when they can’t be.

When does a trade settle automatically?#

Only when the agent is confident, every piece of evidence it cites is really in the vendor’s messages, an independent second check agrees, the payout matches the agreed rate, and the vendor is trusted (marked trusted, or has earned it). Otherwise the trade escalates with the agent’s reading attached — see Deciding escalations.