transactionRefunds

Retrieve the current refund state for a specific transaction.

Returns two arrays:

  • refunds — processed or pending reversal transactions. Shape matches a standard transaction object. Always present; empty when no refunds have been processed.
  • queuedRefunds — individually tracked refunds that have been requested but not yet processed (e.g. the original transaction has not yet cleared). Each item has id, referenceId, amount (with amount and currency), and status (queued or abandoned). Always present; empty when nothing is queued.

The id on a queued refund item is the uuid assigned at the time POST /v2/reverseTransaction was called (either supplied by the client or system-generated). That same uuid becomes the id of the resulting reversal transaction once processed.

Multiple reversals: A transaction can have more than one independent reversal. Each POST /v2/reverseTransaction call produces its own record. Both refunds and queuedRefunds may contain multiple entries.

Error Glossary (click to expand)
CodeHTTP StatusMessage
AP011401Unauthorized
AP101401No authenticated user
AP700400Missing or invalid required parameter
AP701400Improperly formatted parameter
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Transaction UUID (id returned from POST /v2/transaction)

Headers
string
required

A userForMerchant scoped token.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json