Skip to main content
POST
/
refund-reversal
Query Refund Reversal
curl --request POST \
  --url https://sandbox.waftpay.io/api/refund-reversal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_uuid": "A333RTYUT"
}
'
{
  "code": 102,
  "status": "SUCCESS",
  "description": "Transaction success",
  "data": {}
}

​
Overview

Use this endpoint to check the status of a refund or reversal request that was previously initiated in the platform.
Auth: Requires a Collection token (Authorization: Bearer <collection_token>).
Need to initiate a refund or reversal? See Initiate Refund/Reversal.

​
Endpoint

POST {BASE_URL}/refund-reversal

​
Request body

Provide the request_uuid you received when the refund/reversal was created. 
{
  "request_uuid": "A333RTYUT"
}

​
Example response

{
  "code": 102,
  "status": "SUCCESS",
  "description": "Transaction success",
  "results": {
    "result_code": "21",
    "result_description": "The service request is processed successfully",
    "amount": "1015.00",
    "total_charges": "0.00",
    "total_amount": "1015.00",
    "account": "254792452002",
    "original_payment_uuid": "882231418121042119",
    "original_transaction_reference": "TNC0009886898418",
    "original_external_reference": "1V1OPZZGHQ",
    "external_reference": "1V33UUE1IR",
    "time_processed": "2025-08-26T05:20:27Z"
  }
}

​
Notes

  • If the refund/reversal is not found, the response body will include a NOT FOUND status.
  • Errors follow the standard error shape. See Errors.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
request_uuid
string
required

Refund/reversal request UUID returned when the refund/reversal was created.

Example:

"A333RTYUT"

Response

Refund reversal status payload

​
code
integer
required

Application code for the query result (e.g., 102=SUCCESS, 103=FAILED, 401/404 represented in body where applicable).

​
status
string
required

Outcome label (e.g., SUCCESS, FAILED, FAILED AUTHORIZATION, NOT FOUND).

​
description
string
required

Human-readable description of the outcome.

​
results
object
required

Provider/platform response fields for a refund reversal query. Fields are optional and may vary by provider.