List Refunds

GET

/v2/refunds

Fetch a list of refunds

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/v2/refunds?status=&payment_id=&merchant_reference=&date_from&date_to&prev_cursor&next_cursor&limit' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "status": "success",
    "data": {
        "status": "successful",
        "message": "Refunds fetched successfully",
        "data": {
            "items": [
                {
                    "id": "01KET7A8HRRDK9S3HP5Q927PR7",
                    "merchant_reference": "d11bc434-91ca-4127-b2ff-75a2b6440ccb",
                    "payment_id": "01KDH46CNWCPF25GQVHSWRWMWV",
                    "amount": 5000,
                    "currency": "GBP",
                    "status": "completed",
                    "created": 1768259134008
                }
            ],
            "meta": {
                "pagination": {
                    "order": "desc",
                    "limit": 20,
                    "has_previous": false,
                    "previous_cursor": "01KET7A8HRRDK9S3HP5Q927PR7",
                    "has_next": false,
                    "next_cursor": null
                },
                "filters_applied": {
                    "merchant_id": "01KC9KZB6078W70PF20VF0DMHB",
                    "payment_id": "01KDH46CNWCPF25GQVHSWRWMWV",
                    "sort": {
                        "field": "_id",
                        "order": "desc"
                    }
                }
            }
        }
    }
}

Modified at 2026-01-13 12:30:46

Initiate Refund

Get Refund