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
| Event | Description |
|---|---|
| processed | The 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. |
| received | The 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_progress | The file is undergoing a malware scan before it is created. Only for outgoing files sent using the message forward feature, |
| created | The outgoing file has been created by Mambu Payments. |
| approved | The outgoing file has been approved. |
| canceled | The outgoing file has been canceled. |
| sent | The outgoing file has been sent to the partner bank, CSM, or third-party connectivity provider. |
| rejected | The 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. |
| retried | The incoming file has been retried. |
Statuses
| Status | Description |
|---|---|
| processed | The 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. |
| received | The 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_progress | The file is undergoing a malware scan before it is created. Only for outgoing files sent using the message forward feature, |
| created | The outgoing file has been created by Mambu Payments. |
| approved | The outgoing file has been approved. |
| canceled | The outgoing file has been canceled. |
| sent | The outgoing file has been sent to the partner bank, CSM, or third-party connectivity provider. |
| rejected | The 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