Kardlane
Webhook event

rates.updated

Kardlane Rates changed some of your prices: the tiers that changed, the new rate, and the vendor rates behind it. Apply them to your own price list.

Only with automatic prices on (dashboard → Rates → Pricing rules). New price = the market rate your rule picks (vendor order, highest, second highest, lowest, median or average) minus your margin for that tier, rounded down.

field is rate (physical) or ecodeRate. ref is your own tier id if you sent one with PUT /v1/price-list.

A big move from one vendor waits until a second vendor or the next check agrees, so a misread never moves your price. Tiers with no margin are never changed.

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).

Payload
{
  "id": "0f3c9a52-8d6e-4f0e-9b7a-2c1d5e8f4a10",
  "apiVersion": "2026-09-01",
  "type": "rates.updated",
  "createdAt": "2026-10-03T09:21:07.512Z",
  "tenantId": "b1e2c3d4-5f60-4a7b-8c9d-0e1f2a3b4c5d",
  "data": {
    "tradeId": "",
    "externalRef": "",
    "settlementMode": "verdict_only",
    "evidence": {},
    "changes": [
      {
        "cardType": "APPLE_ITUNES",
        "country": "USD",
        "min": 100,
        "max": 500,
        "ref": "rate_8f2c",
        "field": "rate",
        "from": 1129,
        "to": 1135,
        "marketRate": 1175,
        "margin": 40,
        "method": "second_best",
        "why": "second_best of 3 vendor rates",
        "vendors": [
          {
            "name": "Vendor A",
            "rate": 1180,
            "at": "2026-10-16T09:04:00.000Z",
            "source": "check"
          },
          {
            "name": "Vendor B",
            "rate": 1175,
            "at": "2026-10-16T09:06:00.000Z",
            "source": "check"
          }
        ]
      }
    ],
    "idempotencyKey": "rates:…"
  }
}