Disputes

Handle chargebacks. List chargebacks on a payment, then accept (concede) or reverse (won representment).

3 endpoints

GET/v1/payments/{id}/chargebacksOptional

List the chargebacks raised against a payment.

{
  "items": [
    {
      "id": "cbk_6f708192a3b4",
      "paymentId": "pay_1a2b3c4d5e6f",
      "amount": 15000,
      "status": "received",
      "reasonCode": "10.4",
      "bankChargebackId": "bcb_2026041300019",
      "receivedAt": "2026-04-20T09:00:00Z"
    }
  ]
}

POST/v1/payments/{id}/chargebacks/{cbid}/acceptOptional

Concede the chargeback (bookkeeping only — the received-path ledger reversal stays as the financial truth). Terminal.

JSONRequest Example

{}

JSONResponse Example

{
  "chargebackId": "cbk_6f708192a3b4",
  "status": "accepted",
  "resolvedAt": "2026-04-21T12:00:00Z"
}

POST/v1/payments/{id}/chargebacks/{cbid}/reverseOptional

Reverse the chargeback after winning the representment. Posts the undo ledger legs (proportionally apportioned across all owners for a marketplace split). Terminal.

JSONRequest Example

{}

JSONResponse Example

{
  "chargebackId": "cbk_6f708192a3b4",
  "status": "reversed",
  "resolvedAt": "2026-04-25T15:00:00Z"
}

Category Summary

Total Endpoints

Base Domain

api.pay.kvell.group