Learn about the lifecycle of an incoming payment in Numeral
Events are created as incoming payments are created or updated in Numeral. An update can be the update of any attribute, such as a status, a date, or any other data. Learn more about events and webhooks in Numeral.
Events
| Event | Description |
|---|---|
| received | Incoming payment has been received. |
| pending_confirmation | Incoming payment has been created and is pending confirmation. It can be confirmed or rejected. Only applicable to incoming instant payments. |
| confirmed | Incoming payment has been confirmed. Only applicable to incoming instant payments. |
| pending_return | A return has been created or a return request has been received. |
| returned | Incoming payment has been returned to the sending bank. |
| return_denied | A return request related has been denied. |
| rejected | Incoming payment has been rejected, either by the customer or by the partner bank in case of instant payment timing out. |
| reconciled | Incoming payment has been reconciled with one or multiple transactions. |
| partially_reconciled | Incoming payment has been partially reconciled with one or multiple transactions. |
| unreconciled | Incoming payment has been unreconciled. |
Statuses
| Status | Description |
|---|---|
| received | Incoming payment has been received. |
| pending_confirmation | Incoming payment has been created and is pending confirmation. It can be confirmed or rejected. Only applicable to incoming instant payments. |
| confirmed | Incoming payment has been confirmed. Only applicable to incoming instant payments. |
| pending_return | A return has been created or a return request has been received. |
| returned | Incoming payment has been returned to the sending bank. |
| rejected | Incoming payment has been rejected, either by the customer or by the partner bank in case of instant payment timing out. |
State machine
