Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
List refund requests or retrieve a single refund by chargeback ID.
GET /api/v1/chargebacks/
curl --request GET \
--url https://app.kulmipay.com/api/v1/chargebacks/ \
--header "Authorization: Bearer ISSecretKey_live_xxxxxxxxxxxxxxxx"
<?php
require_once __DIR__ . "/vendor/autoload.php";
use KulmiPay\KulmiPayPHP\Refunds;
$refunds = new Refunds();
$refunds->init([
"token" => "ISSecretKey_live_xxxxxxxxxxxxxxxx",
]);
$allRefunds = $refunds->retrieve();
[
{
"chargeback_id": "CB_12345",
"session_id": "pay-session-123",
"transaction": {
"transaction_id": "txn_xyz789",
"currency": "KES",
"value": "1500.00",
"status": "CHARGEBACK-PENDING"
},
"amount": "1500.00",
"reason": "Duplicate payment",
"status": "PENDING",
"resolution": null,
"staff_created": false,
"created_at": "2026-05-28T09:00:00Z",
"updated_at": "2026-05-28T09:00:00Z"
}
]
GET /api/v1/chargebacks/{chargeback_id}/
curl --request GET \
--url https://app.kulmipay.com/api/v1/chargebacks/CB_12345/ \
--header "Authorization: Bearer ISSecretKey_live_xxxxxxxxxxxxxxxx"
$oneRefund = $refunds->retrieve("CB_12345");
| Field | Description |
|---|---|
chargeback_id | Refund or chargeback alias ID. |
session_id | Checkout payment session ID when the refund is linked to checkout. |
transaction | Wallet transaction attached to the refund. |
amount | Refund amount. |
reason | Refund reason supplied at creation. |
status | Current refund status. |
resolution | Resolution note when available. |
staff_created | Whether the refund was created internally by KulmiPay staff. |
created_at | Time the refund was created. |
updated_at | Time the refund was last updated. |