Learn about the lifecycle of a payment order in Mambu Payments
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
