A return
represents a rejection of a single payment order or paper item. This can occur for a variety of reasons and often results in your originating bank returning your funds as well as issuing a notification with additional details. These additional details result in a return
being generated in the Modern Treasury system.
You can also create a return against a simulated incoming payment detail to mimic the return flow inside of sandbox.
Note that sometimes, banks will process a return
prior to recording a transaction. This is why both transaction_id
and transaction_line_item_id
below may be null.
Related Guides:
Attribute | Description |
---|---|
id string | Unique identifier for the return. |
amount int32 | Value in specified currency's smallest unit. e.g. $10 would be represented as 1000. |
currency string | Currency that this transaction is denominated in. |
type string | The type of return. Can be one of: ach , ach_noc , au_becs , bacs , eft , interac , manual , paper_item , wire . |
status string | The current status of the return. See the webhooks section for more on the different statuses. |
code string | The return code. For ach returns, see ACH Return Reason Codes. |
reason string | Often the bank will provide an explanation for the return, which is a short human readable string. |
role string | The role of the return, can be originating or receiving |
transaction_line_item_id string | The ID of the relevant Transaction Line Item or null . |
transaction_id string | The ID of the relevant Transaction or null . |
returnable_id string | The ID of the object being returned or null . |
returnable_type string | The type of object being returned or null . |
live_mode boolean | This field will be true if this object exists in the live environment or false if it exists in the test environment. |
additional_information string | Some returns may include additional information from the bank. In these cases, this string will be present. |
reference_numbers array | An array of Payment Reference objects. |
internal_account_id string | The ID of the relevant Internal Account. |
date_of_death date | If the return code is R14 or R15 this is the date the deceased counterparty passed away. |
{
"id": "08c251e1-4cba-4706-8faa-9c2df2682aa3",
"object": "return",
"returnable_id": "641f5b0d-c92b-4952-82b2-097c00217d05",
"returnable_type": "payment_order",
"transaction_line_item_id": "c3e5412c-6e70-4df6-8c90-a7c9dad7dc72",
"transaction_id": "4f898a70-6aeb-41f8-9b98-82e42f54cad8",
"type": "ach",
"status": "pending",
"amount": 20000,
"currency": "USD",
"code": "R01",
"reason": "Insufficient Funds",
"role": "receiving",
"additional_information": null,
"live_mode": true,
"created_at": "2019-11-09T00:11:07Z",
"updated_at": "2019-11-09T00:11:07Z"
}