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"
}'
| Field | Type | Required | Description |
|---|
transaction_id | string | Yes | The original transaction ID |
amount | integer | No | Partial refund amount in minor units. Omit for full refund. |
reason | string | No | Reason 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
| Gateway | Processing Time |
|---|
| Stripe | 5-10 business days |
| Paystack | 3-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.
