Skip to main content

The reversal object

A reversal is automatically created to balance out funds that were incompletely processed for an unsuccessful payment.

Attributes


id

string
Unique identifier for the reversal.

pmt_id

string
The id of the payment to be reversed.

The id of the ach account to process the reversal.

trace_id

string,null
The underlying id for the bank transaction relating to this reversal.

The direction of the reversal
Possible enum values

debit

credit


The description of the reversal (maximum of 10 characters).

status

enum
Status of the reversal.
Possible enum values

pending_approval

The reversal is pending approval and will not be processed unless approved. See update reversal.

pending

The reversal has been approved and is waiting to be processed.

processing

The reversal is being processed.

sent

The reversal has been successfully processed and is now completed.

failed

An error occurred while either processing the reversal.

amount

number
The reversal amount in cents.

amount

number
The reversal amount in cents.

error

object,null
An object representing an error that occurred while processing this reversal. See reversal errors.

Timestamp of when the reversal was created.

Timestamp of when the reversal was last updated.

THE REVERSAL OBJECT
{
"id": "rvs_eaBAUJtetgMdR",
"pmt_id": "pmt_rPrDPEwyCVUcm",
"target_account": "acc_JMJZT6r7iHi8e",
"trace_id": null,
"direction": "debit",
"description": "PmtRvrsl",
"amount": 5000,
"status": "pending_approval",
"error": null,
"created_at": "2020-12-09T00:42:31.209Z",
"updated_at": "2020-12-09T00:43:30.996Z"
}