v1
latestOpenAPI 3.1.02026-07-24590534.0 KBGet a refund
Returns the refund connected to a merchant transaction. Use this endpoint to check whether a refund exists and see its current status, amount, currency, and refund reference.
get/refunds/{merchant_reference}
Path parameters
merchant_referencestring required
The merchant reference of the original transaction. The transaction must belong to the merchant making the request.
Response
200
Example response
{
"status": "ok",
"message": "Refund found",
"data": {
"public_id": "refund-public-id",
"refund_reference": "REFUND-123",
"status": "pending_refund_details",
"amount": "1000.0",
"currency": "NGN",
"merchant_reference": "MERCHANT-TXN-123",
"created_at": "2026-07-20T10:00:00.000Z",
"updated_at": "2026-07-20T10:00:00.000Z"
}
}