> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fype.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Refunds

# Refunds

fype allows you to issue full or partial refunds for any payment that has reached the `succeeded` status.

## Initiating a Refund

You can initiate a refund through the fype API or directly from the Dashboard.

### Via Dashboard

1. Go to the **Payments** section.
2. Click on the successful payment you want to refund.
3. Click the **Refund** button.
4. Enter the amount to refund (defaults to the full amount).
5. Confirm the refund.

### Via API

`POST /v1/payments/{payment_id}/refund`

```bash theme={null}
curl -X POST https://api.fype.dev/v1/payments/PAY_ID/refund \
 -H "Authorization: Bearer <API_KEY>" \
 -H "Content-Type: application/json" \
 -d '{
 "amount": 25000
 }'
```

## Refund Statuses

| Status      | Description                                        |
| :---------- | :------------------------------------------------- |
| `pending`   | The refund request has been sent to the gateway.   |
| `processed` | The gateway has successfully processed the refund. |
| `failed`    | The refund attempt was rejected by the gateway.    |

## Refund Notifications

fype will send webhooks for refund events:

* `refund.processed`: When the refund is successful.
* `refund.failed`: If the refund cannot be completed.

## Limits and Constraints

* **Amount**: You cannot refund more than the original `amount` of the payment.
* **Status**: Only payments with a status of `succeeded` can be refunded.
* **Gateway Support**: Refunds are processed by the underlying payment gateway. fype propagates the request and normalizes the response.
* **Processing Time**: While fype processes the request instantly, it may take 5-7 business days for the funds to appear in the customer's bank account, depending on the gateway and bank.