Direct debit mandate lifecycle

Learn about the lifecycle of a direct debit mandate in Mambu Payments (formerly Numeral)

Events are created as direct debit mandates 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
createdDirect debit mandate has been created.
pending_reviewDirect debit mandate is pending review.
activeDirect debit mandate is active.
disabledOutgoing direct debit mandate has been disabled.
blockedIncoming direct debit mandate has been blocked.
authorizedDirect debit mandate has been authorized.
rejectedDirect debit mandate has been rejected.
canceledDirect debit mandate has been canceled.
expiredDirect debit mandate expired.

Statuses

EventDescription
pending_reviewDirect debit mandate is pending review.
activeDirect debit mandate has been created or authorized. It can be used in a payment order, and incoming payments referring to this mandate can be received.
rejectedDirect debit mandate has been rejected.
canceledDirect debit mandate has been canceled.
disabledOutgoing direct debit mandate has been disabled and cannot be used for collections.
blockedIncoming direct debit mandate has been blocked. Incoming direct debit payments will be automatically returned.

State machine

Outgoing direct debit mandate

stateDiagram
	    classDef state fill:#E1F3F2, stroke:#2FA5A1
	    class active, pending_review, disabled, rejected, canceled, expired state
   
	    [*] --> pending_review: pending_review
	    [*] --> active: created
	    
	    pending_review --> active: active
	    pending_review --> rejected: rejected
	    pending_review --> canceled: canceled

	    active --> disabled: disabled
	    active --> canceled: canceled
	    active --> expired: expired

	    expired --> active: authorized

Incoming direct debit mandate

stateDiagram
	classDef state fill:#E1F3F2, stroke:#2FA5A1
	class active, blocked, expired state

	[*] --> active: created

  active --> blocked: blocked
  active --> expired: expired

  blocked --> expired: expired
  blocked --> active: authorized

  expired --> active: authorized