Changelog

Keep track of every change to the Monnify API

Account Validation API Moved to v2

Deprecated

July 2, 2026

The Account Validation (Name Enquiry) endpoint has moved from v1 to v2. The v1 endpoint is deprecated and will be removed soon, so please update your integration to use v2.

API Route:GET /api/v2/disbursements/account/validate
  • Updated documentation and code samples to use /api/v2/disbursements/account/validate
  • v1 endpoint is now deprecated and will be removed in a future release

New .NET SDK for Monnify APIs

Added

July 2, 2026

We added an official .NET SDK to our list of supported libraries, making it easier to integrate Monnify's collections, disbursements, bills payment, verification, and webhooks into .NET applications.

API Route:N/A
  • Added Monnify .NET SDK to the Integrations page
  • Added Monnify .NET SDK to the Plugins & Libraries page

New MCP Server for AI Assistants

Added

July 2, 2026

We launched @monnify/mcp-server, a Model Context Protocol server that lets AI assistants like Claude Desktop, Cursor, and VS Code accept payments, verify identities, manage virtual accounts, and query transactions using natural language instead of custom integration code.

API Route:N/A
  • Added new MCP Server documentation page
  • Exposed tools for collections, direct debit, verification, and utilities
  • Added support for restricting available tools with the --tools flag

Settlement Info Update & Minor doc fixes

Updated

June 29, 2026

Added sample response to Get Settlement Detail endpoint, corrected billers to biller on Bills Payment endpoint

API Route:GET /api/v1/settlement-detail
  • Added response example to get Settlement details endpoint
  • Changed billers to bill on get biller product api reference
  • Updated the path for bulk disburesment doc example
  • Added supported banks to Direct Debit docs

Rearrange Collection Docs based on Usage

Updated

June 29, 2026

Categorised collection related pages based on One Time or Recurring Payments and added other categories

  • Categorised pages into one-time and recurring payment
  • added quickstart, reconcillation and payment verification pages

Settlement Info Update & Minor doc fixes

Updated

June 29, 2026

Added sample response to Get Settlement Detail endpoint, corrected billers to biller on Bills Payment endpoint

API Route:GET /api/v1/settlement-detail
  • Added response example to get Settlement details endpoint
  • Changed billers to bill on get biller product api reference
  • Updated the path for bulk disburesment doc example

Disbursement,SubAccount and Go live Docs Update

Updated

Apr 8, 2026

We've revamped our disbursement API documentation for both single and bulk disbursement adding requirements and code examples.

  • Changed documentation of single disbursement
  • Changed documentation of bulk disbursements
  • Updated SubAccount page to show split amount and split percentage
  • Better document the Verification API functionalities
  • Created checklist for Go Live

Debit Mandate API Update

Updated

Apr 1, 2026

We've enhanced our debit mandate API to accept incomeSplit object to enable merchants set up settle funds directly to any of their subaccounts

API Route:POST /api/v1/direct-debit/mandate/debit
  • Added incomeSplit to request payload

Disbursement API Update

Updated

Mar 29, 2026

We've Beneficiary account name a required field for initiating disbursement. The flow is now Name Inquiry > Disbursment Request to increase accuracy.

API Route:POST /api/v2/disbursements/single
  • Added benefiary account name to request payload

Disbursement API Update

Updated

Oct 29, 2025

We enhanced the Disbursement API to accept a sender information object for cases where the identify of the sender of a payment is important to be known.

API Route:POST /api/v2/disbursements/single
  • Added sender object to request payload

Invoice Page Update

Updated

Sept 30, 2025

We enhanced the Invoice documentation to clearly explain the differences between Static and Dynamic Invoices and how to implement each.

API Route:POST /api/v1/invoice/create
  • Added detailed steps and examples for creating a Static Invoice (reusable account number for multiple invoices)
  • Added detailed steps and examples for creating a Dynamic Invoice (one-time use)
  • Included a comparison table highlighting the key differences between Static and Dynamic invoices

API Reference Revamp

Updated

Sept 24, 2025

We made major styling and functionality improvements to the API Reference page to make exploring and testing our APIs much easier.

API Route:Multiple
  • You can now test API endpoints directly from the documentation
  • View real-time request and response samples without leaving the page
  • Test credentials are provided for quick experiments, and you can swap them with your own credentials to fetch live data
  • Improved design and navigation for a smoother developer experience

New Supported Banks Page

Added

Sept 29, 2025

We added a 'Supported Banks' page to the documentation, allowing users to easily find all supported banks and related information for integrations.

API Route:N/A
  • View a list of all supported banks and their bank codes
  • Access USSD templates if available for each bank
  • Quickly reference bank-specific integration details

Webhook Page Restructure

Updated

Sept 22, 2025

We reorganized the Webhook documentation into a dedicated section with a dropdown for easier navigation and better clarity.

API Route:N/A
  • New 'Overview' page explaining how to configure your webhook and compute the hash
  • New 'Event Types' page listing all webhook events with their payload structure and sample data
  • Improved navigation and developer experience

New Error Codes Page

Added

Sept 20, 2025

We introduced a new 'Error Codes' page in the documentation to make troubleshooting easier and faster.

API Route:N/A
  • Search across all error responses returned by our APIs
  • View detailed information for each error including: Error Code, Error Message, Meaning, and Recommended Action
  • Quickly identify and resolve integration issues

Direct Debit Routing Update

Updated

Sept 15, 2025

We improved Direct Debit processing by introducing smart routing. Transactions will now automatically use TeamApt if the customer’s bank is supported. If not, the request will seamlessly fall back to NIBSS.

API Route:POST /api/v1/direct-debit/mandate/create
  • Primary route: TeamApt (for supported banks)
  • Fallback route: NIBSS (for unsupported banks)
  • Expected impact: Higher transaction success rates and faster processing for supported banks

Service Name Updates

Updated

Sept 15, 2025

We renamed some services to make them clearer and easier to understand.

API Route:N/A
  • 'Collections' is now 'Accept Payments'
  • 'Disbursements' is now 'Transfers/Payouts'

Low Balance Alert Webhook

Added

Sept 12, 2025

A new webhook event has been added to notify you when your wallet balance falls below a threshold.

API Route:N/A
  • New event: `low_balance_alert`

Checkout Page Overhaul

Added

Dec 1, 2024

We redesigned the checkout UI and added new lifecycle methods.

API Route:POST /api/v1/merchant/transactions/init-transaction
  • New modern UI with improved accessibility
  • Introduced onLoadStart() function

Payment Links

Added

May 21, 2024

Merchants can now generate customizable payment links from the dashboard.

API Route:N/A

Paycode API

Updated

Jan 3, 2024

Exposed the Paycode API for direct integration.

API Route:POST /api/v1/paycode

USSD API Stability Fixes

Fixed

June 1, 2023

Improved reliability of Pay with USSD API across all banks.

API Route:GET /api/v1/sdk/transactions/banks

Deprecated Beneficiary Name Parameter

Deprecated

May 4, 2023

The `destinationAccountName` parameter is now deprecated and will be removed in future versions.

API Route:POST /api/v2/disbursements/single

Rate this page

How helpful is the content on this page?

Copyright © 2026 Monnify
instagramfacebookicon