Skip to main content
POST
Query Refund Reversal

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


Request body

Provide the request_uuid you received when the refund/reversal was created.

Example response


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.