Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Webhook payloads for chargeback and reversal status changes.
reversal_event to receive notifications when a chargeback is created or its status changes.
Chargeback events use the chargeback read shape from the KulmiPay backend, plus your configured challenge.
DISPUTED, OVERDUE, COMPLETED, or CANCELLED.{
"chargeback_id": "CB_12345",
"session_id": "pay-session-123",
"transaction": {
"transaction_id": "txn_xyz789",
"currency": "KES",
"value": "1500.00",
"running_balance": "51500.00",
"narrative": "M-Pesa collection",
"trans_type": "SALE",
"status": "CHARGEBACK-PENDING",
"created_at": "2026-05-28T08:23:11Z",
"updated_at": "2026-05-28T08:24:05Z"
},
"amount": "1500.00",
"reason": "Duplicate payment",
"status": "DISPUTED",
"resolution": null,
"staff_created": false,
"created_at": "2026-05-28T09:00:00Z",
"updated_at": "2026-05-28T09:10:00Z",
"challenge": "your-configured-secret"
}
| Field | Description |
|---|---|
chargeback_id | Chargeback alias ID. |
transaction | Wallet transaction related to the reversal. |
amount | Amount under dispute or reversal. |
reason | Chargeback reason. |
status | Current chargeback status. |
challenge | Your configured challenge value. Verify it before processing the event. |