Create a trade
https://api.kardlane.com/v1/tradesHand a gift card to Kardlane. The bot asks your vendors for rates, sends the card to the best one, reads their reply and tells you the outcome by webhook.
Idempotent on externalRef: posting the same reference again returns the trade you already created (200, status: "duplicate").
Answered immediately with 202 — the card read, rate requests and everything after run in the background.
Several cards in one sale: vendors often pay a different rate for one 200 card than for two 100 cards. When the photos show several cards, vendors are asked per card (e.g. “100 x 2”) — even if the sale says one card — and every webhook carries cardFindings saying so. Send cards with what your customer declared so a mismatch is flagged as split.
Authorization#
Bearer token: Bearer <your project API key>. Create keys in the dashboard under your project’s Integration page.
Body#
Your own id for this sale. Echoed on every webhook; the idempotency key.
A card-type code from List card types, e.g. APPLE_ITUNES. An unknown value is rejected with a suggestion — and counted: your project’s alert recipients get a WhatsApp alert (at most once a day per card type), and Kardlane sees which types to add. You can send a sale you can’t map with your own category name as cardType (no photos or code needed) just to have it counted.
The card’s currency / region, e.g. USD, CAD, GBP.
Face value of the card (for several cards, their total).
The rate you pay your customer per 1 unit of card value, in your payout currency. Never replaced by a vendor rate.
HTTPS links to the card photos — every card, front and back (up to 20 are read). HEIC is converted before vendors see it.
The redemption code, for e-codes. Vendors are asked with CODE (their “e-code” means a picture of a digital card, priced differently).
The card’s PIN, when it has one (e.g. Razer Gold). Stored encrypted, sent only to the chosen vendor, never returned.
The cards your customer said they’re selling, e.g. [100, 100] for two 100 cards, or [200] for one. Must add up to value. Kardlane checks it against the photos and reports any difference in cardFindings. When the photos are unclear, vendors are asked per card as declared.
Responses#
externalRef was already sent.