mono-logo

Create a Mandate

Last updated March 10th, 2025

post api.withmono.com/v3/payments/mandates
v1.0

This resource allows you to create your own mandate authorisation experience. When you use this resource to setup a mandate, you have no need for the initiate a mandate endpoint.

callout-icon

A more detailed guide on using this resource can be found here.

Regarding the readiness for debiting the account:

  • Signed Mandate: Upon bank approval, signed mandate accounts are immediately available for debiting and balance inquiries.

  • E-mandate: With an e-mandate setup, a waiting period of 1 hour max should be observed following approval before debiting and balance inquiries can be conducted.

Re Debit Types & Amount

Re Debit Types & Amount

  • variable: When debit type is variable the amount is the total debit/money a business plans to collect from a customer over the set period. Debits can be varied

  • fixed: When debit type is fixed the amount is that which the business wants to collect per debit and then the total debit is automatically calculated based on that amount. Note that once the fixed amount is set on mandate authorisation, it is immutable.

Body- Variable Mandate
Body- Fixed Mandate
Headers

Request

12345678910111213141516171819
curl --request POST \
     --url https://api.withmono.com/v3/payments/mandates \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'mono-sec-key: string' \
     --data '
            {
              "debit_type": "variable",
              "customer": "string",
              "mandate_type": "string",
              "amount": "integer",
              "reference": "string",
              "account_number": "string",
              "bank_code": "string",
              "description": "string",
              "start_date": "string",
              "end_date": "string"
            }
      '

Response

Choose an option from the drop down or click one of these buttons to see an example:

Did this page help you?