Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Monnify Direct Debit comprises of two key of three main processes:

...

  1. Create

    a MandateAuthorize

    a Mandate

  2. Get

    Mandate Status
  3. Cancel Mandate

  4. Debiting Mandates

  5. Debit Mandate

  6. Get Debit Status

    Customer’s Authorization

  7. Debit a Mandate

Mandate Management Workflow

To create and manage a mandate, here is the workflow of every possible status a Monnify Mandate can be through its life cycle. Refer to Mandate Event Notification

Monnify (7).jpg

Mandate Status

Description

PENDING

Mandate creation is in progress.

PENDING AUTHORIZATION

Mandate is awaiting customer authorization

PENDING ACTIVATION

Mandate has been authorized by the customer and awaiting activation by the customers financial intuition.

ACTIVATED

Mandate has been activated and can now be debited.

AUTHORIZATION EXPIRED

Mandate authorization expired because the customer didn’t authorize it within the available timeframe.

EXPIRED

Mandate has reached its expiration time.

CANCELLED

Mandate was canceled by the merchant.

SUSPENDED

Mandate was suspended by the customer’s financial intuition.

...

Panel
panelIconId1f4b8
panelIcon:money_with_wings:
panelIconText💸
bgColor#FFBDAD

An insurance company offers a one-year health insurance plan with monthly premiums of N10000. The company can use a closed fixed mandate to debit N10000 from the customer’s account each month for 12 months. After 12 months, the mandate expires.

API Integration Workflow

...

  • Creating a Mandate:

    • The merchant requests to set up a direct debit using the customer's account details.

    • The Mandate Creation request is successful, and the mandate status will be "Pending"

    • Once Monnify creates mandate, the status will be changed to “Pending Authorization”

  • Authorizing a Mandate:

    • The customer authorizes the mandate. Authorization instructions can be received through:

      • An authorization email sent directly by Monnify to the customer's email address.

      • An authorization link returned from the status API response, which the merchant can present to their customer.

  • Debiting a Mandate:

    • Once authorized successfully, the mandate status will be ‘Activated’ and merchants can use the Debit APIs to debit the account linked to the mandate as per the agreed terms.

    • The APIs accommodate different use cases, whether fixed or flexible debits, open or closed mandates based on set up.

API Reference

Child pages (Children Display)
allChildrentrue

Using Monnify Account Direct Debit allows for efficient and secure management of recurring payments. Follow the steps outlined above to integrate and manage mandates effectively.