Initiate Mandate Authorisation

Last updated Mar 15th, 2024


This resource returns a link for your customers to authorise their mandate.

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 8 hours 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 retrieve 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 retrieve 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 Params - Variable Mandate
Body Params - Fixed Mandate


curl --request POST \
     --url \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'mono-sec-key: string' \
     --data {
    "amount": 9190030,
    "type": "recurring-debit",
    "method": "mandate",
    "mandate_type": "emandate", // or "signed"
    "debit_type": "variable", // or "fixed"
    "description": "Repayment for",
    "reference": "test-O2b9O9EF903-949493432",
    "redirect_url": "",
    "customer": {
    "start_date": "2024-03-29",
    "end_date": "2024-08-04",
    "meta": {}


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

Did this page help you?