Moniepoint

Moniepoint Mandates API

Create and manage direct-debit mandates.

Documentation GitHub OpenAPI

Operations 4

POST /api/v1/direct-debit/mandate Monnify Create Direct Debit Mandate #

GET /api/v1/direct-debit/mandate/{mandateCode} Monnify Get Direct Debit Mandate #

DELETE /api/v1/direct-debit/mandate/{mandateCode} Monnify Cancel Direct Debit Mandate #

POST /api/v1/direct-debit/mandate/activation Monnify Activate Direct Debit Mandate #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/moniepoint-mandates-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Monnify Direct Debit Mandates API
  description: 'Create, activate, and debit recurring NIBSS direct-debit mandates against a customer''s bank account. Smart routing introduced in September 2025 uses TeamApt as the primary processor with NIBSS as fallback. As of April 2026 the debit endpoint accepts an incomeSplit object to settle a debited amount across multiple sub-accounts.

    '
  version: '1.0'
  contact:
    name: Monnify Developer Support
    url: https://developers.monnify.com
servers:
- url: https://api.monnify.com
  description: Production
- url: https://sandbox.monnify.com
  description: Sandbox
security:
- BearerAuth: []
tags:
- name: Mandates
  description: Create and manage direct-debit mandates.
paths:
  /api/v1/direct-debit/mandate:
    post:
      summary: Monnify Create Direct Debit Mandate
      operationId: createMandate
      tags:
      - Mandates
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateMandateRequest'
      responses:
        '200':
          description: Mandate created (pending activation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MandateEnvelope'
  /api/v1/direct-debit/mandate/{mandateCode}:
    get:
      summary: Monnify Get Direct Debit Mandate
      operationId: getMandate
      tags:
      - Mandates
      parameters:
      - name: mandateCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Mandate details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MandateEnvelope'
    delete:
      summary: Monnify Cancel Direct Debit Mandate
      operationId: cancelMandate
      tags:
      - Mandates
      parameters:
      - name: mandateCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Mandate cancelled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MandateEnvelope'
  /api/v1/direct-debit/mandate/activation:
    post:
      summary: Monnify Activate Direct Debit Mandate
      description: Submit the activation code to move a mandate from PENDING to ACTIVATED.
      operationId: activateMandate
      tags:
      - Mandates
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - mandateCode
              - activationCode
              properties:
                mandateCode:
                  type: string
                activationCode:
                  type: string
      responses:
        '200':
          description: Mandate activated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MandateEnvelope'
components:
  schemas:
    Mandate:
      type: object
      properties:
        mandateCode:
          type: string
        mandateDescription:
          type: string
        mandateAmount:
          type: number
        customerName:
          type: string
        customerAccountNumber:
          type: string
        customerBankCode:
          type: string
        status:
          type: string
          enum:
          - PENDING
          - FAILED
          - CANCELLED
          - ACTIVATED
          - EXPIRED
        frequency:
          type: string
        amountType:
          type: string
        startDate:
          type: string
          format: date
        endDate:
          type: string
          format: date
        dateCreated:
          type: string
          format: date-time
    MandateEnvelope:
      type: object
      properties:
        requestSuccessful:
          type: boolean
        responseMessage:
          type: string
        responseCode:
          type: string
        responseBody:
          $ref: '#/components/schemas/Mandate'
    CreateMandateRequest:
      type: object
      required:
      - mandateDescription
      - mandateAmount
      - customerName
      - customerAccountNumber
      - customerBankCode
      - startDate
      - endDate
      properties:
        mandateDescription:
          type: string
        mandateAmount:
          type: number
        customerName:
          type: string
        customerEmail:
          type: string
          format: email
        customerPhoneNumber:
          type: string
        customerAccountNumber:
          type: string
        customerBankCode:
          type: string
        startDate:
          type: string
          format: date
        endDate:
          type: string
          format: date
        frequency:
          type: string
          enum:
          - DAILY
          - WEEKLY
          - MONTHLY
          - QUARTERLY
          - YEARLY
          - AD_HOC
        amountType:
          type: string
          enum:
          - FIXED
          - VARIABLE
        debitReference:
          type: string
        contractCode:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

Moniepoint Mandates API

Operations 4

Documentation

Specifications

Schemas & Data

Other Resources