Return lifecycle

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_approvalReturn has been created and is pending approval.
approvedReturn has been approved.
auto_approvedReturn has been automatically approved.
canceledReturn has been canceled.
processingReturn is being processed and has been added to a file.
sentReturn has been sent to the bank.
executedReturn has been executed by the bank.
receivedReturn has been received from the bank.
rejectedReturn has been rejected.
pending_retryReturn file file has been rejected by the bank. The return will be sent in a new file.
retriedReturn has been sent in a new file.
reconciledReturn has been reconciled with a transaction.
partially_reconciledReturn has been partially reconciled with a transaction.
unreconciledReturn has been unreconciled.
cbs_transaction_bookedA transaction has been successfully booked in Mambu Core in the context of the return.
cbs_transaction_booking_failedMambu Payments tried to book a transaction in Mambu Core but received an error.
cbs_authorization_reversedAn authorization has been reversed in Mambu Core in the context of the return.
cbs_authorization_reverse_failedMambu Payments tried to reversed an authorization in Mambu Core but received an error

Statuses

Status Description
pending_approvalReturn has been created and is pending approval.
approvedReturn has been approved.
auto_approvedReturn has been automatically approved.
canceledReturn has been canceled.
processingReturn is being processed and has been added to a file.
sentReturn has been sent to the bank.
executedReturn has been executed by the bank.
receivedReturn has been received from the bank. This is the initial status for a return linked to a payment order.
rejectedReturn has been rejected.

State machine