List Refunds By Merchant

GET /collection-middleware/list/refunds

The List Refunds By Merchant endpoint retrieves a list of refunds associated with a merchant's account. A partner would call this endpoint to retrieve refund information for a specific merchant. The endpoint returns a list of refunds, including their reference, status, amount, and associated payer details.

Query parameters

Name	Type	Description
page	integer	—
size	integer	—

Request body (optional)

This endpoint accepts a body with no declared schema.

Response 200

Field	Type	Description
success	boolean	—
data	array	—
refundReference	string	—
referenceTransactionId	string	—
status	string	—
refundAmount	number	—
feeReversedAmount	number	—
currencyCode	string	—
payerAccountNumber	string	—
payerBankCode	string	—
payerName	string	—
settlementRoute	string	—
feePolicy	string	—
providerReference	string	—
providerResponse	string	—
reason	string	—
failureReason	string	—
initiatedAt	string	—
completedAt	string	—
error	object	—
code	string	—
message	string	—

Environment

Request

curl -X GET "https://api.dev.cslpay.io/collection-middleware/list/refunds" \
  -H "Authorization: Bearer <access-token>"

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
        .url("https://api.dev.cslpay.io/collection-middleware/list/refunds")
        .get()
        .addHeader("Authorization", "Bearer <access-token>")
        .build();

try (Response response = client.newCall(request).execute()) {
    if (!response.isSuccessful()) {
        throw new IOException("Unexpected status " + response.code());
    }
    System.out.println(response.body().string());
}

const response = await fetch("https://api.dev.cslpay.io/collection-middleware/list/refunds", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <access-token>"
  }
});

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://api.dev.cslpay.io/collection-middleware/list/refunds",
    headers={
        "Authorization": "Bearer <access-token>"
    },
)

response.raise_for_status()
print(response.json())

Response

200OK

{
  "success": true,
  "data": [
    {
      "refundReference": "string",
      "referenceTransactionId": "string",
      "status": "PENDING",
      "refundAmount": 0,
      "feeReversedAmount": 0,
      "currencyCode": "string",
      "payerAccountNumber": "string",
      "payerBankCode": "string",
      "payerName": "string",
      "settlementRoute": "EXTERNAL",
      "feePolicy": "REVERSE_FEE",
      "providerReference": "string",
      "providerResponse": "string",
      "reason": "string",
      "failureReason": "string",
      "initiatedAt": "2026-01-15T09:30:00Z",
      "completedAt": "2026-01-15T09:30:00Z"
    }
  ],
  "error": {
    "code": "string",
    "message": "string"
  }
}

Authorization

Authorization: Bearer <access-token>

Sent on every request. See Getting Started.