Commerce & ops

Chargeback representment

Dispute details → a representment narrative, an evidence checklist, the right reason code, and a win-likelihood.

POST /v1/chargeback$0.15/dispute · 15 credits, charged only on success

Send this

{
  "reason": "Cardholder claims product never arrived",
  "transaction": {
    "amount": 129,
    "currency": "USD",
    "date": "2026-06-12",
    "descriptor": "ACME STORE"
  },
  "evidence": [
    "Tracking shows delivered 2026-06-15",
    "Signed at door"
  ],
  "network": "visa"
}

Every response carries usage — the credits burned and your remaining balance. A failed call never burns credits.

Try it live against your own key in the interactive reference; every account gets 500 free credits a month, no card.

Get this back

{
  "reasonCategory": "product_not_received",
  "recommendedAction": "fight",
  "narrative": "The cardholder disputes non-receipt; however carrier tracking…",
  "evidenceChecklist": [
    {
      "item": "Carrier tracking with delivery confirmation",
      "have": true
    }
  ],
  "winLikelihood": 0.82,
  "rationale": "Delivery confirmation directly rebuts non-receipt.",
  "usage": {
    "credits": 15,
    "balanceRemaining": 449
  }
}

Four ways in. Same $0.15/dispute.

curl
curl https://api.kynth.studio/v1/chargeback \
  -H "Authorization: Bearer ksk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Cardholder claims product never arrived","transaction":{"amount":129,"currency":"USD","date":"2026-06-12","descriptor":"ACME STORE"},"evidence":["Tracking shows delivered 2026-06-15","Signed at door"],"network":"visa"}'
TypeScript
import { KynthCore } from "@kynth/api";

const kynth = new KynthCore({ apiKey: process.env.KYNTH_API_KEY! });
const result = await kynth.chargeback({
  "reason": "Cardholder claims product never arrived",
  "transaction": {
    "amount": 129,
    "currency": "USD",
    "date": "2026-06-12",
    "descriptor": "ACME STORE"
  },
  "evidence": [
    "Tracking shows delivered 2026-06-15",
    "Signed at door"
  ],
  "network": "visa"
});
Python
from kynth import Kynth

client = Kynth(api_key=os.environ["KYNTH_API_KEY"])
result = client.chargeback(
    reason="Cardholder claims product never arrived",
    transaction={
    "amount": 129,
    "currency": "USD",
    "date": "2026-06-12",
    "descriptor": "ACME STORE"
  },
    evidence=[
    "Tracking shows delivered 2026-06-15",
    "Signed at door"
  ],
    network="visa",
)
MCP
// One-time setup in your MCP client (Claude, Cursor, …):
{ "mcpServers": { "kynth-core": {
    "command": "npx", "args": ["@kynth/api-mcp"],
    "env": { "KYNTH_API_KEY": "ksk_live_…" } } } }

// Then the agent just calls the kynth_chargeback tool.

More from commerce & ops