File lifecycle

Learn about the lifecycle of a file in Mambu Payments

Events are created as files 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

EventDescription
processedThe file has been processed, either by the partner bank, CSM, or third-party connectivity provider in case of an outgoing file or by Mambu Payments in case of an incoming file.
receivedThe incoming file has been received from the partner bank, CSM, or third-party connectivity provider and its format is not supported by Mambu Payments.
scan_in_progressThe file is undergoing a malware scan before it is created. Only for outgoing files sent using the message forward feature,
createdThe outgoing file has been created by Mambu Payments.
approvedThe outgoing file has been approved.
canceledThe outgoing file has been canceled.
sentThe outgoing file has been sent to the partner bank, CSM, or third-party connectivity provider.
rejectedThe file has been rejected, either by the partner bank, CSM, or third-party connectivity provider in case of an outgoing file or by Numeral in case of an incoming file. The rejection reason is indicated in the status_details attribute.
retriedThe incoming file has been retried.

Statuses

StatusDescription
processedThe file has been processed, either by the partner bank, CSM, or third-party connectivity provider in case of an outgoing file or by Numeral in case of an incoming file.
receivedThe incoming file has been received from the partner bank, CSM, or third-party connectivity provider and its format is not supported by Mambu Payments.
scan_in_progressThe file is undergoing a malware scan before it is created. Only for outgoing files sent using the message forward feature,
createdThe outgoing file has been created by Mambu Payments.
approvedThe outgoing file has been approved.
canceledThe outgoing file has been canceled.
sentThe outgoing file has been sent to the partner bank, CSM, or third-party connectivity provider.
rejectedThe file has been rejected, either by the partner bank, CSM, or third-party connectivity provider in case of an outgoing file or by Numeral in case of an incoming file. The rejection reason is indicated in the status_details attribute.

State machine

Outgoing files

stateDiagram
    [*] --> created:::state: created
    [*] --> scan_in_progress:::state: scan_in_progress
    scan_in_progress --> created:::state: created
    scan_in_progress --> canceled:::state: canceled
    created --> canceled:::state: canceled
    created --> approved:::state: approved
    created --> approved:::state: auto_approved
    approved --> sent:::state: sent
    sent --> rejected:::state: rejected
    sent --> processed:::state: processed
    classDef state fill:#E1F3F2,stroke:#2FA5A1
    note right of scan_in_progress: only reached via the message forward feature

Incoming files

stateDiagram
    [*] --> received:::state: received
    [*] --> processed:::state: processed
    [*] --> rejected:::state: rejected
    processed --> received:::state: retried
    rejected --> processed:::state: retried
    received --> rejected:::state: retried
    classDef state fill:#E1F3F2,stroke:#2FA5A1