Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.kulmipay.com/llms.txt

Use this file to discover all available pages before exploring further.

Use the chargebacks API to retrieve refund requests for your KulmiPay account. The same API returns both refund requests you created and refund records created during chargeback handling.

​
List refunds

GET /api/v1/chargebacks/ 
curl --request GET \
  --url https://app.kulmipay.com/api/v1/chargebacks/ \
  --header "Authorization: Bearer ISSecretKey_live_xxxxxxxxxxxxxxxx"

​
Example response

[
  {
    "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"
  }
]

​
Retrieve one refund

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"

​
Response fields

FieldDescription
chargeback_idRefund or chargeback alias ID.
session_idCheckout payment session ID when the refund is linked to checkout.
transactionWallet transaction attached to the refund.
amountRefund amount.
reasonRefund reason supplied at creation.
statusCurrent refund status.
resolutionResolution note when available.
staff_createdWhether the refund was created internally by KulmiPay staff.
created_atTime the refund was created.
updated_atTime the refund was last updated.