Skip to main content

Status Reasons

If a transfer fails, Orum will send a transfer_updated webhook. The transfer object in the payload will have a status of failed and a status_reasons array that explains why the transfer failed. status_reasons will contain a source and/or destination item, depending on where the transfer failure occurred. The network_reason_code and network_reason_message fields are populated with what Deliver receives from the network. That network information is mapped to an Orum-created reason_code and reason_code_message, which give a higher-level and more human-readable explanation of the transfer failure.

Return Reason Codes

Notification of Change (NOC)

A Notification of Change (NOC) is an alert used to notify the sender of an ACH payment to update details related to a customer’s bank account that have changed or are incorrect. NOCs are created by the Receiving Depository Financial Institution (RDFI) and sent to the Originating Depository Financial Institution (ODFI). NOCs help ensure that future transactions are processed accurately without any disruptions. Orum automates the NOC process so you receive them directly via webhook. We relay the following information to you via the transfer response body:
  • The Nacha correction code
  • Detail of what needs to be changed
  • Detail of what the new value needs to be
When a NOC is received, the transfer_updated webhook event is sent.
There is no change in transfer status, as a NOC can exist on a transfer of any status and will not trigger the transfer to fail.
The Automated NOC will be conveyed via the existing parameters and corresponding details: If a NOC occurs on a transfer that has also incurred a return, Orum will notify you of both events. In this case, a separate transfer_updated webhook will be sent for each event, but the events will always look like this:

NOC Reason Codes

Unlike the reason codes above, NOCs can exist on a transfer of anystatus(i.e. it does not have to be failed). The status_reasons array will still explain why the NOC occurred.status_reasons will contain a source and/or destination item, depending on where the NOC occurred.

ACH Return Codes

RTP Error Codes

FedNow Error Codes

Visa Chargeback Reason Codes

Mastercard Chargeback Reason Codes