MAmasspay
Payout Reversal

Get history of payout reversals

Changed on

This GET endpoint is used to retrieve the payout reversal history for a specific user and payout transaction. <br> You can use this endpoint to view all reversal transactions applied to a particular payout, including each payout_reversal_token, the reversed amount, and status. <br> To use this endpoint, you need to provide both the user_token and the original payout_token in the URL Path. <br> The response will include a JSON object containing an array of reversal transactions associated with the specified payout, with each entry including details such as the reversal token, amount, currency, status, and the date and time of the reversal.

get/payout/{user_token}/{payout_token}/reversal

Request

Path parameters

user_tokenstring required

Token representing the user to pay out

payout_tokenstring required

Token representing the trsanaction. Retrieved from /payout/{user_token}

Headers

Idempotency-Keystring

Unique key to prevent duplicate processing

Response

successful operation

payout_reversal_tokenstring required

Payout Reversal Token

source_amountnumber required

The amount that was reversed in this transaction. This can be a full or partial reversal of the original payout, depending on the requested reversal amount. The value is expressed in the same currency as the original payout.

source_currency_codestring required

Currency code for the amount that will be loaded onto the source_token

exchange_ratenumber required

Exchange rate between the source and destination amounts

destination_amountnumber required

The amount that will be debited from the attr_set_token

destination_currency_codestring required

The currency in which the funds were received and will be debited from the attr_set_token associated with the original payout_token

status'PENDING' | 'EXPIRED' | 'PROCESSING' | 'COMPLETED' | 'CANCELLED' | 'SCHEDULED' | 'READY_FOR_PICKUP' | 'HOLD' | 'ERROR' required

Status of Payout Reversal

status_reasonstring

When available, contains the reason code for the reversal status

payout_tokenstring required

Token of the Payout the reversal is applied to

metadataobject required

Optional JSON object with attributes that are attached to the payout reversal transaction

feenumber required

Fee associated with the payout reversal

client_transfer_idstring

A client defined transfer identifier. This is the unique ID assigned to the transfer on your system. Max 50 characters. A value another payout of yours already carries is rejected with 400 Bad request and Duplicate client id. Existing payout token: payout_<uuid> in error.details. By default a value becomes reusable once the earlier payout is ERROR or EXPIRED (or is a PENDING quote past its expiration); any other status, including CANCELLED, keeps it reserved. Accounts configured for strict uniqueness never allow reuse, whatever the earlier payout's status.

original_destination_amountnumber required

The original destination amount that was deposited in the payout

total_reversed_amountnumber required

The total amount that was reversed against the original payout so far

createdstring date-time required

Datetime of when the reversal was created. Provided in UTC

completedstring date-time

Datetime of when the payout reversal was completed and credited to the source_token of the original payout. Provided in UTC

Example response

[
  {
    "status_reason": "R01 - Insufficient Funds",
    "original_destination_amount": 1000.34,
    "total_reversed_amount": 10.2
  }
]

Changes