Learn about the lifecycle of a return in Mambu Payments
Events are created as returns 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 | Return has been created and is pending approval. |
| approved | Return has been approved. |
| auto_approved | Return has been automatically approved. |
| canceled | Return has been canceled. |
| processing | Return is being processed and has been added to a file. |
| sent | Return has been sent to the bank. |
| executed | Return has been executed by the bank. |
| received | Return has been received from the bank. |
| rejected | Return has been rejected. |
| pending_retry | Return file file has been rejected by the bank. The return will be sent in a new file. |
| retried | Return has been sent in a new file. |
| reconciled | Return has been reconciled with a transaction. |
| partially_reconciled | Return has been partially reconciled with a transaction. |
| unreconciled | Return has been unreconciled. |
| cbs_transaction_booked | A transaction has been successfully booked in Mambu Core in the context of the return. |
| 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 return. |
| cbs_authorization_reverse_failed | Mambu Payments tried to reversed an authorization in Mambu Core but received an error |
Statuses
| Status | Description |
|---|---|
| pending_approval | Return has been created and is pending approval. |
| approved | Return has been approved. |
| auto_approved | Return has been automatically approved. |
| canceled | Return has been canceled. |
| processing | Return is being processed and has been added to a file. |
| sent | Return has been sent to the bank. |
| executed | Return has been executed by the bank. |
| received | Return has been received from the bank. This is the initial status for a return linked to a payment order. |
| rejected | Return has been rejected. |
State machine

