> ## 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

> Process refunds through Khaime.

# Refunds

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

## Creating a Refund

```bash theme={null}
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

```json theme={null}
{
  "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  |

<Note>
  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.
</Note>