Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.khaime.com/llms.txt

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

​
Refunds

Khaime supports full and partial refunds through the underlying payment gateway.

​
Creating a Refund

curl -X POST https://api.khaime.com/api/v1/partner/refunds \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "456",
    "amount": 2500,
    "reason": "Customer requested refund"
  }'
FieldTypeRequiredDescription
transaction_idstringYesThe original transaction ID
amountintegerNoPartial refund amount in minor units. Omit for full refund.
reasonstringNoReason for the refund

​
Response

{
  "success": true,
  "data": {
    "refund_id": "ref_abc123",
    "status": "processing",
    "amount": 2500,
    "currency": "USD"
  }
}

​
Webhook

When the refund completes, Khaime sends a refund.completed webhook.

​
Refund Timelines

GatewayProcessing Time
Stripe5-10 business days
Paystack3-5 business days
Refunds are processed in the currency the customer originally paid in. If the customer paid in NGN, the refund is issued in NGN regardless of your baseline currency.