Kardlane
API Reference

Decide a re-quote

POSThttps://api.kardlane.com/v1/trades/{id}/requote

Answer a vendor that restated the rate after getting the card, when Kardlane escalated it instead of accepting (review.requote on trade.escalated).

accept: Kardlane tells the vendor to load (your project’s re-quote reply), takes the new rate as agreed and hands the trade back to the bot, with a trade.resumed webhook. The trade only succeeds when the vendor confirms the load; then you get trade.succeeded as usual.

decline: Kardlane asks the vendor to return the card. The trade stays escalated for you to close with POST /resolve.

A rate below your customer rate is refused with 409 loss (and the per-unit margin) unless you send allowLoss: true.

Use this, not resolve with succeeded, while the vendor is waiting for an answer: succeeded settles the trade before the card is loaded.

Authorization#

Authorizationheaderrequired

Bearer token: Bearer <your project API key>. Create keys in the dashboard under your project’s Integration page.

Path parameters#

idstringrequired

The escalated trade.

Body#

action"accept" | "decline"required

Your answer to the vendor.

allowLossboolean

Accept even though the new rate is below your customer rate.

bystring

Who decided (shown on the timeline as “… (API)”).

Responses#

200The vendor was messaged.
409no_requote (nothing waiting on this trade) or loss (below your customer rate without allowLoss).
502WhatsApp couldn’t be reached. Nothing changed; retry.
curl -X POST https://api.kardlane.com/v1/trades/6abea25d-0c1f-4a43-9d1e-3b5c2f0edad5/requote \
  -H "Authorization: Bearer $KARDLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "accept",
    "by": "ops@yourcompany.com"
  }'
{
  "tradeId": "6abea25d-0c1f-4a43-9d1e-3b5c2f0edad5",
  "action": "accept",
  "status": "UPLOADED",
  "rate": 1120,
  "margin": 40,
  "replied": "Ok, proceed ✅"
}