Events are created as incoming payments are created or updated in Mambu Payments (formerly Numeral). 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 (formerly Numeral).

Events

Event	Description
received	Incoming payment has been received.
pending_confirmation	Incoming payment has been created and is pending confirmation. It can be confirmed or rejected. Only applicable to incoming instant payments.
payment_validation_update	A payment validation has been updated.
confirmed	Incoming payment has been confirmed. Only applicable to incoming instant payments.
pending_return	A return has been created or a return request has been received.
returned	Incoming payment has been returned to the sending bank.
return_denied	A return request related has been denied.
rejected	Incoming payment has been rejected, either by the customer or by the partner bank in case of instant payment timing out.
pending_rejection	A rejection request has bee issued to the sending bank. Only applicable to incoming direct debit payments.
rejection_denied	A rejection request has been denied. Only applicable to incoming direct debit payments.
reconciled	Incoming payment has been reconciled with one or multiple transactions.
partially_reconciled	Incoming payment has been partially reconciled with one or multiple transactions.
unreconciled	Incoming payment has been unreconciled.

Statuses

Status	Description
received	Incoming payment has been received.
pending_approval	Incoming payment has been created and is being checked against payment validation rules.
pending_confirmation	Incoming payment has been created and is pending confirmation. It can be confirmed or rejected. Only applicable to incoming instant payments.
confirmed	Incoming payment has been confirmed. Only applicable to incoming instant payments.
pending_return	A return has been created or a return request has been received.
returned	Incoming payment has been returned to the sending bank.
pending_rejection	Incoming payment has been rejected by the customer but is subject to the partner bank decision. Only applicable to incoming direct debit payments before settlement date.
rejected	Incoming payment has been rejected, either by the customer or by the partner bank in case of instant payment timing out.

State machine

Non-instant credit transfers (SEPA, Swift, T2, etc.)

    stateDiagram
    [*] --> pending_approval:::state: pending_approval
    [*] --> received:::state: received
    pending_approval --> received:::state: received
    received --> pending_return:::state: pending_return
    pending_return --> returned:::state: returned
    pending_return --> received:::state: return_denied
    	classDef state fill:#E1F3F2,stroke:#2FA5A1

Instant payments (SEPA)

    stateDiagram
    [*] --> pending_confirmation:::state: pending_confirmation
    [*] --> pending_approval:::state: pending_approval
    pending_approval --> rejected:::state: rejected
    pending_confirmation --> confirmed:::state: confirmed
    pending_approval --> confirmed:::state: confirmed
    pending_approval --> pending_confirmation:::state: pending_confirmation
    pending_confirmation --> rejected:::state: confirmed
    confirmed --> rejected:::state: rejected
    confirmed --> received:::state: received
    received --> pending_return:::state: pending_return
    pending_return --> returned:::state: returned
    pending_return --> received:::state: return_denied
    classDef state fill:#E1F3F2,stroke:#2FA5A1

Direct debit payments (SEPA and Bacs)


stateDiagram
[*] --> pending_approval:::state: pending_approval
[*] --> rejected:::state: auto_rejected
pending_approval --> rejected:::state:rejected
received --> rejected:::state:rejected
[*] --> received:::state: received
pending_approval --> received:::state: received

received --> pending_rejection:::state: pending_rejection
pending_rejection --> rejected:::state: rejected
pending_rejection --> received:::state: rejection_denied

received --> pending_return:::state: pending_return
pending_return --> returned:::state: returned
pending_return --> received:::state: return_denied

received --> returned: returned

classDef state fill:#E1F3F2,stroke:#2FA5A1