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

# Check Refund Status

> Retrieve the current status of a refund using the ref_id from the Initiate Refund response. Poll this endpoint to track refund progress until it completes.

After initiating a refund, use this endpoint to poll the current processing status. Pass the `ref_id` returned from the [Initiate Refund](/docs/refunds/initiate-refund.md) response as a path parameter to retrieve up-to-date status information for that specific refund.

## Headers

**x-api-key** `string` *required*

Your secret API key used to authenticate all requests.

## Path Parameters

**ref\_id** `string` *required*

Refund Reference ID received from the initiated payin refund response.

## Response

A successful request returns a `200 OK` with a JSON body containing the current refund status and associated details.

**ref\_id** `string`

The refund reference ID you queried.

**status** `string`

Current status of the refund (e.g. `PENDING`, `SUCCESS`, `FAILED`).

**amount** `number`

Amount that was refunded.

> [!TIP]
>
> If you need to check the status of multiple refunds at once, use the [List Refunds](/docs/refunds/list-refunds.md) endpoint to retrieve a filtered, paginated overview.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.