Learn about the lifecycle of a payment order in Mambu Payments (formerly Numeral)
Events are created as payment orders are created or updated in Mambu Payments (formerly 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 Mambu Payments (formerly Numeral).
Events
| Event | Description |
|---|---|
| pending_approval | Payment order has been created and is pending approval. |
| payment_validation_updated | A payment validation has been updated. |
| approved | Payment order has been approved. |
| auto_approved | Payment order has been automatically approved. |
| processing | Payment order is being processed and added to a payment file. |
| sent | Payment file including the payment order has been sent to the bank. |
| executed | Payment order has been executed by the bank. |
| canceled | Payment order has been canceled. |
| processing_canceled | Payment file including the payment order has been canceled. |
| pending | Payment order has been put on hold by the bank. |
| pending_retry | Payment file including the payment order has been rejected by the bank. The payment order will be sent in a new file. |
| retried | Payment order has been retried. |
| rejected | Payment order has been rejected by the bank due to incorrect information. |
| pending_return | Return request has been sent on the payment order. It is thus in pending return. |
| return_denied | Return request has been denied. |
| returned | Payment order has been reconciled with a return. |
| reconciled | Payment order has been reconciled with one or multiple transactions. |
| partially_reconciled | Payment order has been partially reconciled with one or multiple transactions. |
| unreconciled | Payment order has been unreconciled. |
Statuses
| Status | Description |
|---|---|
| pending_approval | Payment order has been created and is pending approval. |
| approved | Payment order has been approved. |
| canceled | Payment order has been canceled. |
| processing | Payment order is being processed and added to a payment file. The payment file is pending approval. In case a payment file is not validated, corresponding payment orders go back to the approved status. |
| sent | Payment order has been sent to the bank. |
| executed | Payment order has been executed by the bank. |
| pending | Payment order has been put on hold by the bank. |
| rejected | Payment order has been rejected by the bank. |
| pending_return | Return request has been sent on the payment order. It is thus in pending return. |
| returned | Payment order has been returned after having been executed by the bank. |
| retried | Payment order has been retried. |
State machine
