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. 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.
Events
| Event | Description |
|---|---|
| pending_approval | Payment order has been created and is pending approval. |
| warehoused | Payment order has been created with a requested execution date in the future. |
| 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 or CSM. |
| executed | Payment order has been executed by the bank or CSM. |
| canceled | Payment order has been canceled. |
| pending_cancelation | Payment order is being canceled. |
| cancelation_rejected | Payment order cancelation has been canceled - payment goes back to executed. |
| processing_canceled | Payment file including the payment order has been canceled. |
| pending | Payment order has been put on hold by the bank or CSM. |
| pending_retry | Payment file including the payment order has been rejected by the bank or CSM. 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 or CSM 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. |
| cbs_transaction_booked | A transaction has been successfully booked in Mambu Core in the context of the payment order. |
| cbs_transaction_booking_failed | Mambu Payments tried to book a transaction in Mambu Core but received an error. |
| cbs_authorization_reversed | An authorization has been reversed in Mambu Core in the context of the payment order. |
| cbs_authorization_reverse_failed | Mambu Payments tried to reversed an authorization in Mambu Core but received an error |
Statuses
| Status | Description |
|---|---|
| pending_approval | Payment order has been created and is pending approval. |
| warehoused | Payment order has been created with a requested execution date in the future |
| approved | Payment order has been approved. |
| canceled | Payment order has been canceled. |
| pending_cancelation | Payment order is being 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 or CSM. |
| executed | Payment order has been executed by the bank or CSM. |
| pending | Payment order has been put on hold by the bank or CSM. |
| rejected | Payment order has been rejected by the bank or CSM. |
| 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 or CSM. |
| retried | Payment order has been retried. |
State machine
