Search..

API Reference

Learn how to integrate Monnify APIs into your applications.


Introduction

The Monnify API provides extensive access to the features available on our dashboard, enabling you to leverage them for your own application. To get started, you must first create a Monnify account on www.monnify.com and obtain the required API keys for all Monnify integrations. Please note that the Monnify API is secured through Basic Authentication or OAuth (Bearer Tokens).

Authentication

Monnify's core security protocol is OAuth 2.0, which authenticates API requests via associated API keys that can be managed directly from the dashboard. Monnify provides an API key, that is used together with a secret key to generate a basic token and a secret key that should be kept confidential and stored exclusively on...Read more


Webhooks

Webhooks is an API concept that enables applications to automatically communicate with each other without constant polling. Monnify integration sends ...Read more

Monnify Webhook Events and Structure

As part of the Monnify integration, notifications are automatically sent to your system when certain actions are completed. These notifications trigger corresponding activities on your system, and you can specify URLs for certain activities on your integration. The notifications include an event-type property that indicates what action has taken place, as well as event data containing details of the event.

Supported notification event types on Monnify include

  1. Successful Collection (for successful payments made on your account)
    ...Read more
  2. Successful Disbursement (for disbursement transactions with a successful definite status)
    ...Read more
  3. Failed Disbursement (for failed disbursement transactions)
    ...Read more
  4. Reversed Disbursement (for reversed disbursement transactions)
    ...Read more
  5. Successful Refund (for successfully processed initiated refunds)
    ...Read more
  6. Failed Refund (for failed initiated refunds)
    ...Read more
  7. Settlement Completion (for successfully processed settlements to your bank account or wallet)
    ...Read more
  8. Completed Oflline Payments
    ...Read more
  9. Notification for Rejected Payments
    ...Read more
  10. Mandate Status Change
    ...Read more


Structure and Sample

A typical event notification structure is of the format:

Sample event notification structure
Copy button
{ 
        "eventType": "type_of_event",
        "eventData": {
          "prop1": "value1",
          "prop2": "value2"
        }
      }

Transaction Hash Computation

As a security measure, Monnify computes a hash of the request body whenever it sends a notification and includes it in the request header with the key...Read more


Javascript, PHP, Java Sample Codes:

Expand to see Sample codes on how to compute Transaction Hash in Javascript, PHP, Java etc....Read more


Going Live

After successfully uploading necessary documents and meeting compliance requirements, your Monnify account will be activated, and you will be ready to go live. However, before doing so, it is important to check that certain components are properly set up to ensure smooth payment collection, communication between Monnify and your business, and communication between your customers and your business.

Seamless Payment Collection And Notification

This guide will outline the necessary steps for setting up seamless payment collection and notification through the use of webhook URLs on your Monnify dashboard...Read more


Disabling OTP API Disbursement And IP Whitelisting

If your application is planning to integrate our disbursement API, it is advisable to disable the sending of OTP to your business email when customers initiate a withdraw...Read more

Switching From Monnify Sandbox To Live Mode

It's recommended that you change all your Monnify sandbox credentials to their respective live credentials when going live. This includes the Monnify Sandbox base_url, API Key and Secret, and Contract Code.



Authentication

Generate Access Token

POST
{{base_url}}/api/v1/auth/login

Headers

Authorization
basic
Authorize this API call by including Authorization header that contains the word 'Basic' followed by a space and a base64-encoded string 'apiKey:clientSecret' i.e. 'Basic base64(ApiKey:SecretKey)', include the Token in the request header.

Body Params

REQUEST
Copy button
curl --header "Content-Type: application/json" 
 --request POST 
 --data '{}' 
 {{sandbox_url}}/api/v1/auth/login
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOlsibW9ubmlmeS12YWx1ZS1hZGRlZC1zZXJ2aWNlIiwibW9ubmlmeS1wYXltZW50LWVuZ2luZSIsIm1vbm5pZnktZGlzYnVyc2VtZW50LXNlcnZpY2UiLCJtb25uaWZ5LW9mZmxpbmUtcGF5bWVudC1zZXJ2aWNlIl0sInNjb3BlIjpbInByb2ZpbGUiXSwiZXhwIjoxNjU4MjIwNTk1LCJhdXRob3JpdGllcyI6WyJNUEVfTUFOQUdFX0xJTUlUX1BST0ZJTEUiLCJNUEVfVVBEQVRFX1JFU0VSVkVEX0FDQ09VTlQiLCJNUEVfSU5JVElBTElaRV9QQVlNRU5UIiwiTVBFX1JFU0VSVkVfQUNDT1VOVCIsIk1QRV9DQU5fUkVUUklFVkVfVFJBTlNBQ1RJT04iLCJNUEVfUkVUUklFVkVfUkVTRVJWRURfQUNDT1VOVCIsIk1QRV9ERUxFVEVfUkVTRVJWRURfQUNDT1VOVCIsIk1QRV9SRVRSSUVWRV9SRVNFUlZFRF9BQ0NPVU5UX1RSQU5TQUNUSU9OUyJdLCJqdGkiOiJhZmYwMTMyMi1kMmNmLTQzOGYtYWVkMC0wOGY0NTBhNmVhZWYiLCJjbGllbnRfaWQiOiJNS19URVNUX0pSUUFaUkZEMlcifQ.KOkMyFJIMKc6aZViDB3ekoiCPU2647eW_1RpySy9t_OXzfDSER2nn2QzXZsGPn8GlPJ4ZdhtuhevHQCLnEKQYIScgB9EQTPHTldiBG7uf9ta3NQK6Sxzq2pkM8heuO1v87tqtPLbBF7LlmI21liUPAPrxJVnw5PhCAOKbInIG-sj0BWbwMXJ2E8Cgz6yUeQ46-C0bmkyc0U6-FqENPSNl7oNXNY-nWaQfXd7tw2ybE4YoEzoRXcLTy0KLjlf3sxA5PizyT3nh9YqjVIRli-3sggnpvdjmIzw8784g_knNYmA8rj1Of7ROa_enDYmH6dWHbB1luchU9Y67FMhlBDWLg",
        "expiresIn": 3567
    }
}

Transactions

Initialize Transaction

This endpoint initialises the transaction that would be used for card payments and dynamic transfers.
POST
{{base_url}}/api/v1/merchant/transactions/init-transaction

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

amount
Float

The amount(in Naira) to be paid, minimum is N20
customerName
String

The name of the customer
customerEmail
String

The customer email
paymentReference
String

A unique string of characters that identifies each transaction
paymentDescription
String

A description of the payment
currencyCode
String

The currency code
contractCode
String

The merchant contract code
redirectUrl
String

A url to redirect to after payment completion
paymentMethods
String

The method of payment collection
incomeSplitConfig
Object

A way to split payments among subAccounts.
metadata
Object

This field can be used to pass extra information from customers
REQUEST
Copy button
{
  "amount": 100.00,
  "customerName": "Stephen Ikhane",
  "customerEmail": "[email protected]",
  "paymentReference": "123031klsadkad",
  "paymentDescription": "Trial transaction",
  "currencyCode": "NGN",
  "contractCode":"32904822812",
  "redirectUrl": "https://my-merchants-page.com/transaction/confirm",
  "paymentMethods":["CARD","ACCOUNT_TRANSFER"]
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "transactionReference": "MNFY|20190915200044|000090",
        "paymentReference": "1568577644707",
        "merchantName": "Test Limited",
        "apiKey": "MK_TEST_VR7J3UAACH",
        "enabledPaymentMethod": [
            "ACCOUNT_TRANSFER",
            "CARD"
        ],
        "checkoutUrl": "https://sandbox.sdk.monnify.com/checkout/MNFY|20190915200044|000090"
    }
}

Pay With Bank Transfer

This endpoint generates a dynamic account number and its associated bank for one time payment.
POST
{{base_url}}/api/v1/merchant/bank-transfer/init-payment

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

A unique Monnify reference returned as part of the response from the initialise transaction endpoint
bankCode
String

A valid bank code to enable the creation of USSD string associated with such bank
REQUEST
Copy button
{
  "transactionReference": "MNFY|24|20220721134824|000081",
  "bankCode": "058"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "accountNumber": "5000610089",
        "accountName": "Test01-Tri",
        "bankName": "Wema bank",
        "bankCode": "035",
        "accountDurationSeconds": 2309,
        "ussdPayment": "*737*2*100.00*5000610089#",
        "requestTime": "2022-07-21T13:52:31",
        "expiresOn": "2022-07-21T14:32:31",
        "transactionReference": "MNFY|24|20220721134824|000081",
        "paymentReference": "123---03--1klsa--dkad",
        "amount": 100,
        "fee": 10,
        "totalPayable": 100,
        "collectionChannel": "API_NOTIFICATION",
        "productInformation": null
    }
}

Charge Card

This endpoint allows you to initiate charge on a card.
POST
{{base_url}}/api/v1/merchant/cards/charge

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

The transaction reference gotten as part of the response from the initialise transaction endpoint.
collectionChannel
String

This field basically describes the channel of collection.
card
Object

An object containing the card information.
number
String

The card pan or number on the card.
pin
String

The pin associated with the card.
expiryMonth
String

The card expiry month.
expiryYear
String

The card expiry year
cvv
String

The card cvv number.
REQUEST
Copy button
{
    "transactionReference": "MNFY|99|20220725110839|000256",
    "collectionChannel": "API_NOTIFICATION",
    "card": {
        "number": "4111111111111111",
        "expiryMonth": "10",
        "expiryYear": "2022",
        "pin": "1234",
        "cvv": "123"
    }
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "status": "SUCCESS",
        "message": "Transaction Successful",
        "transactionReference": "MNFY|99|20220725110839|000256",
        "paymentReference": "12-3---03--1klsa--dkad",
        "authorizedAmount": 100
    }
}

Authorize OTP

The endpoint authorizes an OTP to complete a charge on a card.
POST
{{base_url}}/api/v1/merchant/cards/otp/authorize

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

The transaction reference gotten from the initialise transaction endpoint.
collectionChannel
String

This is the channel of collection and should always be "API_NOTIFICATION" in this endpoint.
tokenId
String

This is an id of the token issued and is always part of the response from the charge card endpoint.
token
String

This is the token(OTP) sent to the user device by his bank
REQUEST
Copy button
{
    "transactionReference": "MNFY|20190512185357|000002",
    "collectionChannel": "API_NOTIFICATION",
    "tokenId": "1234567890",
    "token": "123456"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "status": "SUCCESS",
        "message": "Transaction Successful",
        "transactionReference": "MNFY|54|20210429142945|000208",
        "paymentReference": "1619702984105",
        "authorizedAmount": 2000
    }
}

Authorize 3DS Card

This endpoint authorizes charge on a card that uses 3DS Secure Authentication.
POST
{{base_url}}/api/v1/sdk/cards/secure-3d/authorize

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

The transaction reference gotten from the initialise transaction endpoint.
collectionChannel
String

This is the channel of collection and should always be "API_NOTIFICATION" in this endpoint.
card
Object

An object containing the card information.
number
String

The card pan or number on the card.
pin
String

The pin associated with the card.
expiryMonth
String

The card expiry month.
expiryYear
String

The card expiry year
cvv
String

The card cvv number.
apiKey
String

The merchant API key
REQUEST
Copy button
{
    "transactionReference": "MNFY|19|20210430115705|000243",
    "collectionChannel": "API_NOTIFICATION",
    "card": {
        "cvv": "123",
        "expiryMonth": "12",
        "expiryYear": "2022",
        "number": "4000000000000002",
        "pin": "1234"
    }
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "status": "BANK_AUTHORIZATION_REQUIRED",
        "message": "3D Secure Authorization required",
        "secure3dData": {
            "id": "2000.00-59077a3e5157fae7ca9dd260d911ccbb",
            "redirectUrl": "http://localhost:10001"
        },
        "transactionReference": "MNFY|19|20210430115705|000243",
        "paymentReference": "1619780224192",
        "authorizedAmount": 1000
    }
}

Get All Transactions

This endpoint returns a list of transactions carried out on your integration.
GET
{{base_url}}/api/v1/transactions/search

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

page
Integer

The number of page of to be retrieved. It starts from 0.
size
Integer

The Size of transactions to be returned per page.
paymentReference
String

Unique reference generated by merchant for each transaction.
transactionReference
String

Unique transaction reference generated by Monnify for each transaction
fromAmount
Float

A number indicating minimum amount for the transactions to be returned
toAmount
Float

A number indicating maximum amount for the transactions to be returned
amount
Float

A number indicating exact amount for the transactions to be returned
customerName
String

Name of customer for the transactions to be returned
customerEmail
String

Email of customer for the transactions be returned.
paymentStatus
String

Transaction status for transactions to be returned
from
Timestamp

Time for transactions to be retrieved.
to
Timestamp

The maximum time for transactions to be retrieved.
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/transactions/search?
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "createdOn": "2022-07-25T11:53:52.000+0000",
                "amount": 100,
                "flagged": false,
                "currencyCode": "NGN",
                "completedOn": "2022-07-25T12:30:42.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "EXPIRED",
                "transactionReference": "MNFY|99|20220725125351|000271",
                "paymentReference": "12__0-3-031k^^ls0a--dk--ad",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "paymentMethod": "CARD",
                "createdOn": "2022-07-25T11:26:29.000+0000",
                "amount": 100,
                "flagged": false,
                "currencyCode": "NGN",
                "completedOn": "2022-07-25T12:00:42.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "EXPIRED",
                "transactionReference": "MNFY|65|20220725122629|000296",
                "paymentReference": "12__0-3-031kls0a--dk--ad",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "paymentMethod": "CARD",
                "createdOn": "2022-07-25T11:14:09.000+0000",
                "amount": 100,
                "flagged": false,
                "currencyCode": "NGN",
                "completedOn": "2022-07-25T11:50:42.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "EXPIRED",
                "transactionReference": "MNFY|65|20220725121408|000291",
                "paymentReference": "12__0-3-031kls0a--dkad",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "paymentMethod": "CARD",
                "createdOn": "2022-07-25T10:48:27.000+0000",
                "amount": 100,
                "flagged": false,
                "currencyCode": "NGN",
                "completedOn": "2022-07-25T11:20:42.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "EXPIRED",
                "transactionReference": "MNFY|67|20220725114827|000285",
                "paymentReference": "120-3-031kls0a--dkad",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "paymentMethod": "CARD",
                "createdOn": "2022-07-25T10:43:51.000+0000",
                "amount": 100,
                "flagged": false,
                "currencyCode": "NGN",
                "completedOn": "2022-07-25T11:20:42.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "EXPIRED",
                "transactionReference": "MNFY|65|20220725114351|000289",
                "paymentReference": "12-3-031kls0a--dkad",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "paymentMethod": "CARD",
                "createdOn": "2022-07-25T10:41:50.000+0000",
                "amount": 100,
                "flagged": false,
                "currencyCode": "NGN",
                "completedOn": "2022-07-25T11:20:42.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "EXPIRED",
                "transactionReference": "MNFY|67|20220725114150|000284",
                "paymentReference": "12-3---031kls0a--dkad",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "paymentMethod": "CARD",
                "createdOn": "2022-07-25T10:19:58.000+0000",
                "amount": 100,
                "flagged": false,
                "fee": 10,
                "currencyCode": "NGN",
                "completedOn": "2022-07-25T10:20:20.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "PAID",
                "transactionReference": "MNFY|67|20220725111957|000283",
                "paymentReference": "12-3---03--1kls0a--dkad",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "payableAmount": 100,
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "paymentMethod": "CARD",
                "createdOn": "2022-07-25T10:08:39.000+0000",
                "amount": 100,
                "flagged": false,
                "fee": 10,
                "currencyCode": "NGN",
                "completedOn": "2022-07-25T10:09:23.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "PAID",
                "transactionReference": "MNFY|99|20220725110839|000256",
                "paymentReference": "12-3---03--1klsa--dkad",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "payableAmount": 100,
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "paymentMethod": "ACCOUNT_TRANSFER",
                "createdOn": "2022-07-22T13:23:39.000+0000",
                "amount": 20,
                "flagged": false,
                "fee": 10,
                "currencyCode": "NGN",
                "completedOn": "2022-07-22T13:29:13.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "PAID",
                "transactionReference": "MNFY|24|20220722142339|000144",
                "paymentReference": "13i--0-00--lfuik93j",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "payableAmount": 20,
                "completed": true,
                "paymentMethodList": [
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Stephen Ikhane",
                    "merchantCode": "1X1SDUSYRD47"
                },
                "createdOn": "2022-07-22T13:22:57.000+0000",
                "amount": 20,
                "flagged": false,
                "currencyCode": "NGN",
                "completedOn": "2022-07-22T14:00:42.000+0000",
                "paymentDescription": "Trial transaction",
                "paymentStatus": "EXPIRED",
                "transactionReference": "MNFY|69|20220722142257|000170",
                "paymentReference": "13i--000--lfuik93j",
                "merchantCode": "1X1SDUSYRD47",
                "merchantName": "Test01",
                "metaData": {},
                "completed": true,
                "paymentMethodList": [
                    "CARD",
                    "ACCOUNT_TRANSFER"
                ],
                "collectionChannel": "WEB_SDK"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": false,
        "totalElements": 115,
        "totalPages": 12,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 10,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Get Transaction Status

This endpoint returns the status of a transaction
GET
{{base_url}}/api/v2/transactions/MNFY%7C67%7C20220725111957%7C000283

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

Urlencoding of the said transaction reference
REQUEST
Copy button
curl -H "Accept: application/json" 
https://sandbox.monnify.com/api/v2/transactions/MNFY%7C67%7C20220725111957%7C000283
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "transactionReference": "MNFY|67|20220725111957|000283",
        "paymentReference": "12-3---03--1kls0a--dkad",
        "amountPaid": "100.00",
        "totalPayable": "100.00",
        "settlementAmount": "90.00",
        "paidOn": "25/07/2022 11:20:20 AM",
        "paymentStatus": "PAID",
        "paymentDescription": "Trial transaction",
        "currency": "NGN",
        "paymentMethod": "CARD",
        "product": {
            "type": "WEB_SDK",
            "reference": "12-3---03--1kls0a--dkad"
        },
        "cardDetails": {
            "cardType": "Sandbox Card Scheme",
            "last4": "1111",
            "expMonth": "10",
            "expYear": "22",
            "bin": "411111",
            "bankCode": null,
            "bankName": null,
            "reusable": false,
            "countryCode": null,
            "cardToken": null,
            "supportsTokenization": false,
            "maskedPan": "411111******1111"
        },
        "accountDetails": null,
        "accountPayments": [],
        "customer": {
            "email": "[email protected]",
            "name": "Stephen Ikhane"
        },
        "metaData": {}
    }
}

Get Status By Reference

This endpoint returns the status of a transaction using either the Monnify transaction reference or the merchant's payment reference
GET
{{base_url}}/api/v2/merchant/transactions/query

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

The Monnify generated reference
paymentReference
String

The merchant generated reference
REQUEST
Copy button
curl -H "Accept: application/json" 
https://sandbox.monnify.com/api/v2/transactions/MNFY%7C67%7C20220725111957%7C000283
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "transactionReference": "MNFY|67|20220725111957|000283",
        "paymentReference": "12-3---03--1kls0a--dkad",
        "amountPaid": "100.00",
        "totalPayable": "100.00",
        "settlementAmount": "90.00",
        "paidOn": "25/07/2022 11:20:20 AM",
        "paymentStatus": "PAID",
        "paymentDescription": "Trial transaction",
        "currency": "NGN",
        "paymentMethod": "CARD",
        "product": {
            "type": "WEB_SDK",
            "reference": "12-3---03--1kls0a--dkad"
        },
        "cardDetails": {
            "cardType": "Sandbox Card Scheme",
            "last4": "1111",
            "expMonth": "10",
            "expYear": "22",
            "bin": "411111",
            "bankCode": null,
            "bankName": null,
            "reusable": false,
            "countryCode": null,
            "cardToken": null,
            "supportsTokenization": false,
            "maskedPan": "411111******1111"
        },
        "accountDetails": null,
        "accountPayments": [],
        "customer": {
            "email": "[email protected]",
            "name": "Stephen Ikhane"
        },
        "metaData": {}
    }
}

Customer Reserved Account

Create Reserved Account(General)

This endpoint allows the creation of dedicated virtual accounts for your customers.
POST
{{base_url}}/api/v2/bank-transfer/reserved-accounts

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

accountReference
String

A unique reference generated by merchants.
accountName
String

The name to be displayed during name enquiry
currencyCode
String

The currency allowed,"NGN.
contractCode
String

The merchant contract code
customerEmail
String

The customer's email
bvn
String

The bvn attached to a reserve account
getAllAvailableBanks
Boolean

This decides wether account numbers be generated to all allowable banks.
preferredBanks
Array

This field helps to choose certain banks for virtual account creation. This field is needed if getAvailableBanks is false
incomeSplitConfig
Object

A configuration on how payments are to be split among subaccounts
restrictPaymentSource
Boolean

Decides if payment should be restricted to some reserved accounts
allowedPaymentSource
Object

This captures bvns or account numbers or account names that are permitted to fund a reserved account. This is mandatory if restrictPaymentSource is set to true
nin
String

The customer’s NIN
REQUEST
Copy button
{ "accountReference": "abc123d380",
    "accountName": "ysbbs hsbsb nxnznq",
    "currencyCode": "NGN",
    "contractCode": "7059707855",
    "customerEmail": "[email protected]",
    "customerName": "ysbbs hsbsb nxnznq",
    "bvn": "54848484888",
    "nin":"34848484058",
    "getAllAvailableBanks": true
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "7059707855",
        "accountReference": "abc123d380",
        "accountName": "ysb",
        "currencyCode": "NGN",
        "customerEmail": "[email protected]",
        "customerName": "ysbbs hsbsb nxnznq",
        "accounts": [
            {
                "bankCode": "035",
                "bankName": "Wema bank",
                "accountNumber": "5000606570",
                "accountName": "ysb"
            },
            {
                "bankCode": "232",
                "bankName": "Sterling bank",
                "accountNumber": "6001363048",
                "accountName": "ysb"
            }
        ],
        "collectionChannel": "RESERVED_ACCOUNT",
        "reservationReference": "DQD6S0N4U20FN8MF2EE1",
        "reservedAccountType": "GENERAL",
        "status": "ACTIVE",
        "createdOn": "2022-07-27 15:29:40.131",
        "incomeSplitConfig": [],
        "bvn": "54848484888",
        "restrictPaymentSource": false
    }
}

Create Reserved Account(Invoice)

This endpoint allows the creation of an invoiced reserved account.
POST
{{base_url}}/api/v1/bank-transfer/reserved-accounts

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

contractCode
String

The merchant's contract code.
accountName
String

The name to be displayed during name enquiry.
currencyCode
String

The currency allowed,"NGN.
accountReference
String

A unique reference generated by the merchant
customerName
String

Full name of the customer
customerEmail
String

Email address of the customer.
reservedAccountType
String

This should be "INVOICE".
bvn
String

The customer's BVN
nin
String

The customer's NIN
REQUEST
Copy button
{
    "contractCode":"7059707855",
    "accountName":"Jane Doe",
    "currencyCode":"NGN",
    "accountReference": "janedoe1223--3",
    "customerEmail": "[email protected]",
    "customerName": "Jane Doe",
    "reservedAccountType": "INVOICE"
}
RESPONSE
Copy button
{
    "requestSuccessful": false,
    "responseMessage": "You can not reserve two accounts with the same reference",
    "responseCode": "99"
}

Get Reserved Account Details

This endpoint returns details of an account reserved for a customer
GET
{{base_url}}/api/v2/bank-transfer/reserved-accounts/{accountReference}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

accountReerence
String

The unique reference used in creating the reserved account.
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v2/bank-transfer/reserved-accounts/abc1niui--23
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "7059707855",
        "accountReference": "abc1niui--23",
        "accountName": "Test01-Tes",
        "currencyCode": "NGN",
        "customerEmail": "[email protected]",
        "customerName": "mao  Zhang",
        "accounts": [
            {
                "bankCode": "035",
                "bankName": "Wema bank",
                "accountNumber": "5000588053",
                "accountName": "Tes"
            },
            {
                "bankCode": "232",
                "bankName": "Sterling bank",
                "accountNumber": "6001363175",
                "accountName": "Tes"
            }
        ],
        "collectionChannel": "RESERVED_ACCOUNT",
        "reservationReference": "8MD1E79P4LD94N6E2VNJ",
        "reservedAccountType": "GENERAL",
        "status": "ACTIVE",
        "createdOn": "2022-07-31 10:08:41.0",
        "contract": {
            "name": "Default Contract",
            "code": "7059707855",
            "description": null
        },
        "transactionCount": 0,
        "incomeSplitConfig": [
            {
                "subAccountCode": "MFY_SUB_762212281785",
                "feePercentage": 10.5,
                "feeBearer": true,
                "splitPercentage": 20,
                "reservedAccountConfigCode": "HRCNXDSAYX"
            }
        ],
        "bvn": "21212121212",
        "restrictPaymentSource": true
    }
}

Add Linked Accounts

This endpoint links accounts with another partner bank to an existing customer.
PUT
{{base_url}}/api/v1/bank-transfer/reserved-accounts/add-linked-accounts/{accountReference}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

getAllAvailableBanks
Boolean

Determine if all necessary banks should be used
preferredBanks
Array

Contains bank codes of desired banks
accountReference
String

The unique reference used in creating the reserved account.
REQUEST
Copy button
{
	"getAllAvailableBanks": false,
    "preferredBanks": ["232"]
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "7059707855",
        "accountReference": "abc1niui--23",
        "accountName": "Tes",
        "currencyCode": "NGN",
        "customerEmail": "[email protected]",
        "customerName": "mao  Zhang",
        "accounts": [
            {
                "bankCode": "035",
                "bankName": "Wema bank",
                "accountNumber": "5000588053",
                "accountName": "Tes"
            },
            {
                "bankCode": "232",
                "bankName": "Sterling bank",
                "accountNumber": "6001363175",
                "accountName": "Tes"
            }
        ],
        "collectionChannel": "RESERVED_ACCOUNT",
        "reservationReference": "8MD1E79P4LD94N6E2VNJ",
        "reservedAccountType": "GENERAL",
        "status": "ACTIVE",
        "createdOn": "2022-07-31 10:08:41.0",
        "incomeSplitConfig": [
            {
                "subAccountCode": "MFY_SUB_762212281785",
                "feePercentage": 10.5,
                "feeBearer": true,
                "splitPercentage": 20,
                "reservedAccountConfigCode": "HRCNXDSAYX"
            }
        ],
        "bvn": "21212121212",
        "restrictPaymentSource": true
    }
}

Update BVN for a Reserve Account

This endpoint updates BVN of customers reserved account
PUT
{{base_url}}/api/v1/bank-transfer/reserved-accounts/update-customer-bvn/{reservedAccountReference}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

bvn
String

The BVN used in creating the reserved account
REQUEST
Copy button
{
"bvn": "21212121212"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "915483727511",
        "accountReference": "121612212051585",
        "currencyCode": "NGN",
        "customerEmail": "[email protected]",
        "customerName": "Pascool Oj",
        "accountNumber": "4290733572",
        "bankName": "Providus Bank",
        "bankCode": "101",
        "collectionChannel": "RESERVED_ACCOUNT",
        "reservationReference": "R8J4LCW3P82WN4X6LQCW",
        "reservedAccountType": "GENERAL",
        "status": "ACTIVE",
        "createdOn": "2021-02-01 21:40:55.0",
        "bvn": "21212121212",
        "restrictPaymentSource": false
    }
}

Allowed Payment Source(s)

This endpoint manages accounts that can fund a reserved account using either BVNs, Account Name or Account Number.
PUT
{{base_url}}/api/v1/bank-transfer/reserved-accounts/update-payment-source-filter/{accountReference}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

restrictPaymentSource
Boolean

This field activate or de-activate restricting of payment sources for a reserved account.
allowedPaymentSource
Object

A collection of possible payment sources.
bvns
Array

List of BVNs that should be validated
bankAccounts
Array

List of account numbers that can fund the reserved account.
accountNumbers
String

An account number from which reserved account can be funded.
bankCode
String

A 3 digit CBN code for the account
accountNames
Array

List of account names for accounts from which reserved accounts can be funded.
accountReference
String

The unique reference used in creating the reserved account.
REQUEST
Copy button
{
    "restrictPaymentSource": true,
    "allowedPaymentSources": {
        "bvns": [
            "21212121212",
            "20202020202"
        ]
    }
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "restrictPaymentSource": true,
        "allowedPaymentSources": {
            "bvns": [
                "21212121212",
                "20202020202"
            ],
            "bankAccounts": [
                {
                    "accountNumber": "0068687503",
                    "bankCode": "232"
                },
                {
                    "accountNumber": "2048714015",
                    "bankCode": "057"
                }
            ],
            "accountNames": [
                "DAMILARE OGUNNAIKE SAMUEL"
            ]
        }
    }
}

Updating Split Config for Reserved Account

This endpoint updates the split config of a customer reserved account.
PUT
{{base_url}}/api/v1/bank-transfer/reserved-accounts/update-income-split-config/{accountReference}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

subAccountCode
String

The unique reference for the sub account that should receive the split
feeBearer
Boolean

This field determine if the sub account should bear transaction fees or not
feePercentage
Float

The percentage of the transaction fee to be borne by the sub account
splitPercentage
Float

The percentage of the amount paid to be split into the sub account.
accountReference
String

The unique reference used in creating the reserved account.
REQUEST
Copy button
[
    {
        "subAccountCode": "MFY_SUB_762212281785",
        "feePercentage": 10.50
    },
       {
        "subAccountCode": "MFY_SUB_322165393053",
        "splitPercentage": 30
    }
]
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "code": "HRCNXDSAYX",
        "reservedAccountCode": "HRCNXDSAYX",
        "feeBearer": "MERCHANT_ONLY",
        "configDetails": [
            {
                "subAccountCode": "MFY_SUB_762212281785",
                "feePercentage": 10.5,
                "feeBearer": false,
                "splitPercentage": 0,
                "reservedAccountConfigCode": "HRCNXDSAYX"
            },
            {
                "subAccountCode": "MFY_SUB_322165393053",
                "feePercentage": 0,
                "feeBearer": false,
                "splitPercentage": 30,
                "reservedAccountConfigCode": "HRCNXDSAYX"
            }
        ]
    }
}

Deallocating a reserved account

This endpoint allows you to deallocate/delete already created a reserved account.
DELETE
{{base_url}}/api/v1/bank-transfer/reserved-accounts/reference/{accountReference}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

accountReference
String

The unique reference used to identify this reserved account
REQUEST
Copy button
curl --header "Content-Type: application/json" 
 --request POST 
 --data '{}' 
 {{base_url}}/api/v1/bank-transfer/reserved-accounts/5000588053
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "7059707855",
        "accountReference": "abc1niui--23",
        "accountName": "Tes",
        "currencyCode": "NGN",
        "customerEmail": "[email protected]",
        "customerName": "mao  Zhang",
        "accountNumber": "5000588053",
        "bankName": "Wema bank",
        "bankCode": "035",
        "collectionChannel": "RESERVED_ACCOUNT",
        "reservationReference": "8MD1E79P4LD94N6E2VNJ",
        "reservedAccountType": "GENERAL",
        "status": "ACTIVE",
        "createdOn": "2022-07-31 10:08:41.0",
        "incomeSplitConfig": [
            {
                "subAccountCode": "MFY_SUB_762212281785",
                "feePercentage": 10.5,
                "feeBearer": false,
                "splitPercentage": 0,
                "reservedAccountConfigCode": "HRCNXDSAYX"
            },
            {
                "subAccountCode": "MFY_SUB_322165393053",
                "feePercentage": 0,
                "feeBearer": false,
                "splitPercentage": 30,
                "reservedAccountConfigCode": "HRCNXDSAYX"
            }
        ],
        "bvn": "22342115371",
        "restrictPaymentSource": true
    }
}

Get Reserved Account Transactions

This endpoint returns the list of all transactions done on a reserved account.
GET
{{base_url}}/api/v1/bank-transfer/reserved-accounts/transactions

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

accountReference
String

The unique reference used in creating the reserved account.
page
Integer

The page of data you want returned by Monnify (Starts from 0).
size
Integer

The number of records you want returned in a page.
REQUEST
Copy button
curl -H "Accept: application/json" 
https://sandbox.monnify.com/api/v1/bank-transfer/reserved-accounts/transactions
?accountReference={accountReference}&page=0&size=10
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Test Reserved Account",
                    "merchantCode": "ALJKHDALASD"
                },
                "providerAmount": 0.21,
                "paymentMethod": "ACCOUNT_TRANSFER",
                "createdOn": "2019-07-24T14:12:27.000+0000",
                "amount": 100.00,
                "flagged": false,
                "providerCode": "98271",
                "fee": 0.79,
                "currencyCode": "NGN",
                "completedOn": "2019-07-24T14:12:28.000+0000",
                "paymentDescription": "Test Reserved Account",
                "paymentStatus": "PAID",
                "transactionReference": "MNFY|20190724141227|003374",
                "paymentReference": "MNFY|20190724141227|003374",
                "merchantCode": "ALJKHDALASD",
                "merchantName": "Test Limited"
                "payableAmount": 100.00,
                "amountPaid": 100.00,
                "completed": true
            },
            {
                "customerDTO": {
                    "email": "[email protected]",
                    "name": "Test Reserved Account",
                    "merchantCode": "ALJKHDALASD"
                },
                "providerAmount": 0.11,
                "paymentMethod": "ACCOUNT_TRANSFER",
                "createdOn": "2019-07-24T11:14:45.000+0000",
                "amount": 50.00,
                "flagged": false,
                "providerCode": "98271",
                "fee": 0.79,
                "currencyCode": "NGN",
                "completedOn": "2019-07-24T11:14:45.000+0000",
                "paymentDescription": "Test Reserved Account",
                "paymentStatus": "PAID",
                "transactionReference": "MNFY|20190724111444|003259",
                "paymentReference": "MNFY|20190724111444|003259",
                "merchantCode": "ALJKHDALASD",
                "merchantName": "Test Limited",
                "settleInstantly": true,
                "payableAmount": 50.00,
                "amountPaid": 50.00,
                "completed": true
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "unpaged": false,
            "paged": true
        },
        "totalElements": 2,
        "totalPages": 1,
        "last": true,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 2,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Update KYC Info

This endpoint links customers' BVN/NIN to their respective reserved accounts.
PUT
{{base_url}}/api/v1/bank-transfer/reserved-accounts/{accountReference}/kyc-info

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

bvn
String

The customer's BVN
nin
String

The customer’s NIN
accountReference
String

The account reference linked to the reserved account being updated.
REQUEST
Copy button
{
    "bvn":{{bvn}}
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "accountReference": "a1fe1c73c6f985eb43e8ef35ec0d6a398698cdea",
        "accountName": "CHUKS BENJI WILS",
        "customerEmail": "[email protected]",
        "customerName": "mao  Zhang",
        "bvn": "22222222222"
    }
}

Invoice

Create an Invoice

This endpoint creates invoice for payments on your integration.
POST
{{base_url}}/api/v1/invoice/create

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

amount
Float

The amount to be paid by the customer
currencyCode
String

The currency of the transaction being initialized. "NGN"
invoiceReference
String

Merchant's Unique reference for the invoice
customerName
String

Full name of the customer
customerEmail
String

Email of the customer
contractCode
String

Merchant's contract code
description
String

Description of the transaction. Will be used as the account name for bank transfer payments
expiryDate
String

The expiry date for the invoice. The format is:YYYY-MM-DD HH:MM:SS
incomeSplitConfig
Object

This field contains specifications on how payments to this reserve account should be split.
redirectUrl
String

A URL which customer will be redirected to when payment is successfully completed
REQUEST
Copy button
{
    "amount": "999",
    "invoiceReference": "183891300182",
    "description": "test invoice",
    "currencyCode": "NGN",
    "contractCode": "7059707855",
    "customerEmail": "[email protected]",
    "customerName": "John Snow",
    "expiryDate": "2022-10-30 12:00:00",
    "paymentMethods": [],
	"incomeSplitConfig": [
        {
            "subAccountCode": "MFY_SUB_322165393053",
            "feePercentage": 10.5,
            "splitAmount": 20,
            "feeBearer": true
        }
    ],
	"redirectUrl": "http://app.monnify.com"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "amount": 999,
        "invoiceReference": "183891300182",
        "invoiceStatus": "PENDING",
        "description": "test invoice",
        "contractCode": "7059707855",
        "customerEmail": "[email protected]",
        "customerName": "John Snow",
        "expiryDate": "2022-10-30 12:00:00",
        "createdBy": "MK_TEST_JRQAZRFD2W",
        "createdOn": "2022-07-31 12:14:14",
        "checkoutUrl": "https://sandbox.sdk.monnify.com/checkout/MNFY|99|20220731121414|000867",
        "accountNumber": "5000588061",
        "accountName": "tes",
        "bankName": "Wema bank",
        "bankCode": "035",
        "redirectUrl": "http://app.monnify.com",
        "transactionReference": "MNFY|99|20220731121414|000867",
        "incomeSplitConfig": [
            {
                "subAccountCode": "MFY_SUB_322165393053",
                "splitAmount": 20,
                "feePercentage": 10.5,
                "feeBearer": true,
                "splitPercentage": null
            }
        ]
    }
}

View Invoice Details

This endpoint returns details of an invoice on your integration.
GET
{{base_url}}/api/v1/invoice/{invoiceReference}/details

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

invoiceReference
String

The unique reference used in creating the invoice.
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/invoice/18389130010082/details
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "amount": 999,
        "invoiceReference": "18389130010082",
        "invoiceStatus": "PENDING",
        "description": "test invoice",
        "contractCode": "7059707855",
        "customerEmail": "[email protected]",
        "customerName": "John Snow",
        "expiryDate": "2022-10-30 12:00:00",
        "createdBy": "MK_TEST_JRQAZRFD2W",
        "createdOn": "2022-07-31 12:29:26",
        "checkoutUrl": "https://sandbox.sdk.monnify.com/checkout/MNFY|99|20220731122925|000868",
        "accountNumber": "5000588060",
        "accountName": "tes",
        "bankName": "Wema bank",
        "bankCode": "035",
        "transactionReference": "MNFY|99|20220731122925|000868",
        "incomeSplitConfig": [
            {
                "subAccountCode": "MFY_SUB_322165393053",
                "splitAmount": 20,
                "feePercentage": 10.5,
                "feeBearer": true,
                "splitPercentage": 0
            }
        ]
    }
}

Get All Invoices

This endpoint returns the list of all the invoice available on your integration.
GET
{{base_url}}/api/v1/invoice/all

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/invoice/all
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "amount": 999,
                "invoiceReference": "18389130010082",
                "invoiceStatus": "PENDING",
                "description": "test invoice",
                "contractCode": "7059707855",
                "customerEmail": "[email protected]",
                "customerName": "John Snow",
                "expiryDate": "2022-10-30 12:00:00",
                "createdBy": "MK_TEST_JRQAZRFD2W",
                "createdOn": "2022-07-31 12:29:26",
                "accountNumber": "5000588060",
                "bankName": "Wema bank",
                "bankCode": "035"
            },
            {
                "amount": 999,
                "invoiceReference": "183891300182",
                "invoiceStatus": "PENDING",
                "description": "test invoice",
                "contractCode": "7059707855",
                "customerEmail": "[email protected]",
                "customerName": "John Snow",
                "expiryDate": "2022-10-30 12:00:00",
                "createdBy": "MK_TEST_JRQAZRFD2W",
                "createdOn": "2022-07-31 12:14:15",
                "accountNumber": "5000588061",
                "bankName": "Wema bank",
                "bankCode": "035"
            },
            {
                "amount": 900,
                "invoiceReference": "183891182",
                "invoiceStatus": "PAID",
                "description": "test invoice",
                "contractCode": "7059707855",
                "customerEmail": "[email protected]",
                "customerName": "John Snow",
                "expiryDate": "2022-05-30 12:00:00",
                "createdBy": "MK_TEST_JRQAZRFD2W",
                "createdOn": "2022-05-20 10:07:52"
            },
            {
                "amount": 999,
                "invoiceReference": "1838913189",
                "invoiceStatus": "EXPIRED",
                "description": "test invoice",
                "contractCode": "7059707855",
                "customerEmail": "[email protected]",
                "customerName": "John Snow",
                "expiryDate": "2022-03-30 12:00:00",
                "createdBy": "MK_TEST_JRQAZRFD2W",
                "createdOn": "2022-03-09 12:18:58",
                "accountNumber": "5000654355",
                "bankName": "Wema bank",
                "bankCode": "035"
            },
            {
                "amount": 999,
                "invoiceReference": "1838913187",
                "invoiceStatus": "EXPIRED",
                "description": "test invoice",
                "contractCode": "7059707855",
                "customerEmail": "[email protected]",
                "customerName": "John Snow",
                "expiryDate": "2022-03-30 12:00:00",
                "createdBy": "MK_TEST_JRQAZRFD2W",
                "createdOn": "2022-03-09 12:18:40",
                "accountNumber": "5000654354",
                "bankName": "Wema bank",
                "bankCode": "035"
            },
            {
                "amount": 999,
                "invoiceReference": "1838913182",
                "invoiceStatus": "EXPIRED",
                "description": "test invoice",
                "contractCode": "7059707855",
                "customerEmail": "[email protected]",
                "customerName": "John Snow",
                "expiryDate": "2022-03-30 12:00:00",
                "createdBy": "MK_TEST_JRQAZRFD2W",
                "createdOn": "2022-03-09 11:55:45",
                "accountNumber": "5000654351",
                "bankName": "Wema bank",
                "bankCode": "035"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "unpaged": false,
            "paged": true
        },
        "last": true,
        "totalElements": 6,
        "totalPages": 1,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 6,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Cancel an Invoice

This endpoint cancels an Invoice on your integration.
DELETE
{{base_url}}/api/v1/invoice/{invoiceReference}/cancel

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

invoiceReference
String

The unique reference used in creating the invoice.
REQUEST
Copy button
curl --header "Content-Type: application/json" 
 --request POST 
 --data '{}' 
 {{base_url}}/api/v1/invoice/18389130010082/cancel
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "amount": 999,
        "invoiceReference": "18389130010082",
        "invoiceStatus": "CANCELLED",
        "description": "test invoice",
        "contractCode": "7059707855",
        "customerEmail": "[email protected]",
        "customerName": "John Snow",
        "expiryDate": "2022-10-30 12:00:00",
        "createdBy": "MK_TEST_JRQAZRFD2W",
        "createdOn": "2022-07-31 12:29:26",
        "accountNumber": "5000588060",
        "bankName": "Wema bank",
        "bankCode": "035"
    }
}

Attaching a Reserved Account to an Invoice

This endpoint attaches a Reserved Account to an Invoice.
POST
{{base_url}}/api/v1/invoice/create

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

amount
Float

Amount to be paid
currencyCode
String

The currency of the transaction being initialized. "NGN"
invoiceReference
String

Merchant's Unique reference for the invoice.
customerName
String

Full name of the customer
customerEmail
String

Email address of the customer
contractCode
String

Merchant's contract code
description
String

Description for the transaction.
expiryDate
String

Expiry date for the invoice
incomeSplitConfig
Object

This field contains specifications on how payments to this reserve account should be split.
accountReference
String

Your unique reference used to identify this reserved account
REQUEST
Copy button
{
    "amount": "999",
    "invoiceReference": "1838913182",
    "accountReference": "janedoe12233",
    "description": "test invoice",
    "currencyCode": "NGN",
    "contractCode": "38238193818",
    "customerEmail": "[email protected]",
    "customerName": "Jane Doe",
    "expiryDate": "2019-10-30 12:00:00"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "amount": 999,
        "invoiceReference": "1838913182",
        "invoiceStatus": "PENDING",
        "description": "test invoice",
        "contractCode": "4876165459",
        "customerEmail": "[email protected]",
        "customerName": "Jane Doe",
        "expiryDate": "2019-10-18 14:48:00",
        "createdBy": "MK_TEST_VR7J3UAACH",
        "createdOn": "2019-08-27 23:14:29",
        "checkoutUrl": "https://sandbox.sdk.monnify.com/checkout/MNFY|20190827231429|000340",
        "accountNumber": "1122334455",
        "accountName": "Jane Doe",
        "bankName": "GTBank",
        "bankCode": "058"
    }
}

Recurring Payment

Charge Card Token

This endpoint allows you to charge an already tokenized card with it’s card token. **NOTE**: The customer email address used in the first successful charge should be stored along with the card token.
POST
{{base_url}}/api/v1/merchant/cards/charge-card-token

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

REQUEST
Copy button
{


    "cardToken": "MNFY_64355FBB44534A3E8B484985436BE1BD",
    "amount": 20,
    "customerName": "Marvelous Benji",
    "customerEmail": "[email protected]",
    "paymentReference": "16427769909682937",
    "paymentDescription": "Paying for Product A",
    "currencyCode": "NGN",
    "contractCode": "100693167467",
    "apiKey": "MK_PROD_WTZLS10MX6",
    "metaData": {
        "ipAddress": "127.0.0.1",
        "deviceType": "mobile"


    }


}
RESPONSE
Copy button
{
    "requestSuccessful": false,
    "responseMessage": "Invalid card token",
    "responseCode": "99"
}

Direct Debit

Create Mandate

This endpoint initiates the creation of a mandate
POST
{{base_url}}/api/v1/direct-debit/mandate/create

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

contractCode
String

The merchant’s Monnify contract code
mandateReference
String

Merchants generated reference to identify a mandate
autoRenew
Boolean

This informs Monnify wether the mandate will be renewed once it reaches end date. Set this parameter to true for Open Fixed and Open Flexible mandates and false otherwise.
customerName
String

The customer's name
customerEmailAddress
String

The customer's address
customerPhoneNumber
String

The customer's phone number
customerAddress
String

The customer's address
customerAccountNumber
String

The customer's bank account number
customerAccountBankCode
String

The bank code of the customer’s bank account
mandateDescription
String

The description of the payment the mandate is associated to
mandateStartDate
String

The start date for the mandate. The date format is: YYYY-MM-DD HH:MM:SS
mandateEndDate
String

The end date for the mandate. The date format is: YYYY-MM-DD HH:MM:SS
mandateAmount
Float

Total lifetime amount debitable on the mandate.
debitAmount
Float

The amount to be debited periodically. Set this field for Open Fixed and Closed Fixed mandates to specify the amount to be charged periodically. Ignore for other mandate types
REQUEST
Copy button
{
    "contractCode": "4934121686",
    "mandateReference": "unique_ref3_02s600972",
    "autoRenew": false,
    "customerName": "Ankit Kushwaha",
    "customerPhoneNumber": "1234567890",
    "customerEmailAddress": "[email protected]",
    "customerAddress": "123 Example Street, City, Country",
    "customerAccountNumber": "0051762787",
    "customerAccountBankCode": "998",
    "mandateDescription": "Subscription Fee",
    "mandateStartDate": "2024-05-22T10:15:30",
    "mandateEndDate": "2025-05-22T10:15:30"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "responseMessage": "Your request for creating a mandate is submitted. An authorization instruction will be sent to the customer email.",
        "mandateReference": "unique_ref3_02s600972",
        "mandateCode": "MTDD|01HY8W3FBKHTFBZP9DQ9KNHR1G",
        "mandateStatus": "INITIATED"
    }
}

Get Mandate Status

This endpoint retrieves the details of a created mandate
GET
{{base_url}}/api/v1/direct-debit/mandate/

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

mandateReferences
String

Merchants generated reference to identify a mandate
REQUEST
Copy button
curl -H "Accept: application/json" 
https://sandbox.monnify.com/api/v1/direct-debit/mandate/?mandateReferences=unique_ref3_02gs600s972
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": [
        {
            "mandateCode": "MTDD|01HY8WMN8JYKDRJC67QPQVS1N0",
            "externalMandateReference": "unique_ref3_02gs600s972",
            "startDate": "2024-05-19T09:15:30.000+0000",
            "endDate": "2024-09-22T09:15:30.000+0000",
            "mandateStatus": "ACTIVE",
            "mandateAmount": 50000,
            "contractCode": "4934121686",
            "autoRenew": false,
            "customerPhoneNumber": "1234567890",
            "customerEmailAddress": "[email protected]",
            "customerAddress": "123 Example Street, City, Country",
            "customerName": "Ankit Kushwaha",
            "customerAccountName": "Ankit Kushwaha",
            "customerAccountNumber": "0051762787",
            "customerAccountBankCode": "998",
            "mandateDescription": "Subscription Fee",
            "debitAmount": null,
            "authorizationMessage": null,
            "authorizationLink": null
        }
    ]
}

Debit Mandate

This endpoint debits an active mandate
POST
{{base_url}}/api/v1/direct-debit/mandate/debit

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

paymentReference
String

Merchants unique reference to identify a single direct debit payment
mandateCode
String

Monnify generated mandate identifier
debitAmount
String

Payment amount to be debited from a single debit transaction
narration
String

Description of the single debit
customerEmail
String

The customer's email address
REQUEST
Copy button
{
  "paymentReference": "PR1234567991002",
  "mandateCode": "MTDD|01HY8WMN8JYKDRJC67QPQVS1N0",
  "debitAmount": 1000.00,
  "narration": "Payment for Services",
  "customerEmail":"[email protected]"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "transactionStatus": "PENDING",
        "responseMessage": "Debit mandate request accepted for processing",
        "transactionReference": "MNFY|20240519180055|000001",
        "paymentReference": "PR1234567991002",
        "debitAmount": 1000,
        "narration": "Payment for Services",
        "mandateCode": "MTDD|01HY8WMN8JYKDRJC67QPQVS1N0"
    }
}

Get Debit Status

This endpoint gets the status of a debited mandate
GET
{{base_url}}/api/v1/direct-debit/mandate/debit-status

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

paymentReference
String

The payment reference used in debiting a mandate
REQUEST
Copy button
curl -H "Accept: application/json" 
{{monnify_base_url}}/api/v1/direct-debit/mandate/debit-status?paymentReference=String
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "transactionStatus": "PAID",
        "responseMessage": null,
        "transactionReference": "MNFY|20240519180055|000001",
        "paymentReference": "PR1234567991002",
        "debitAmount": 1000,
        "narration": "Payment for Services",
        "mandateCode": "MTDD|01HY8WMN8JYKDRJC67QPQVS1N0"
    }
}

Update Mandate

This endpoint cancels/deactivate a mandate
PATCH
{{base_url}}/api/v1/direct-debit/mandate/cancel-mandate/{{mandateCode}}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

mandateCode
String

Monnify generated mandate identifier
REQUEST
Copy button
curl --header "Content-Type: application/json" 
 --request POST 
 --data '{}' 
 https://sandbox.monnify.com/api/v1/direct-debit/mandate/cancel-mandate/MTDD%7C01HY8W3FBKHTFBZP9DQ9KNHR1G
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "responseMessage": "Mandate has been requested to be cancelled.",
        "mandateReference": "unique_ref3_02s600972",
        "mandateCode": "MTDD|01HY8W3FBKHTFBZP9DQ9KNHR1G",
        "mandateStatus": "ACTIVE"
    }
}

Sub Accounts

Create Sub Account(s)

This endpoint allows you to create a sub account to enable the spliting of payments between different accounts.
POST
{{base_url}}/api/v1/sub-accounts

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

currencyCode
String

Settlement currency. "NGN"
accountNumber
String

The account number that should be created as a sub account.
bankCode
String

The 3 digit bank code of the bank where the account number is domiciled
email
String

The email tied to the sub account
defaultSplitPercentage
Float

The default percentage to be split into the sub account on any transaction.
REQUEST
Copy button
[
	{
		"currencyCode": "NGN",
		"bankCode": "058",
		"accountNumber": "0211319282",
		"email": "[email protected]",
		"defaultSplitPercentage": 20.87
	}
]
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": [
        {
            "subAccountCode": "MFY_SUB_811397375865",
            "accountNumber": "0211319282",
            "accountName": "ALEMOH DANIEL MOSES",
            "currencyCode": "NGN",
            "email": "[email protected]",
            "bankCode": "058",
            "bankName": "GTBank",
            "defaultSplitPercentage": 20.87,
            "settlementProfileCode": "8717495899",
            "settlementReportEmails": []
        }
    ]
}

Delete Sub Account

This endpoint deletes a sub account on your integration.
DELETE
{{base_url}}/api/v1/sub-accounts/{subAccountCode}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

subAccountCode
String

The subAccountCode of the sub account you want to delete.
REQUEST
Copy button
curl --header "Content-Type: application/json" 
 --request POST 
 --data '{}' 
 {{base_url}}/api/v1/sub-accounts/MFY_SUB_811397375865
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0"
}

Get Sub Accounts

This endpoint returns the list of sub accounts that have been created on your integration.
GET
{{base_url}}/api/v1/sub-accounts

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/sub-accounts
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": [
        {
            "subAccountCode": "MFY_SUB_811397375865",
            "accountNumber": "0211319282",
            "accountName": "ALEMOH DANIEL MOSES",
            "currencyCode": "NGN",
            "email": "[email protected]",
            "bankCode": "058",
            "bankName": "GTBank",
            "defaultSplitPercentage": 20.87,
            "settlementProfileCode": "8717495899",
            "settlementReportEmails": []
        },
        {
            "subAccountCode": "MFY_SUB_322165393053",
            "accountNumber": "2085886393",
            "accountName": "BENJAMIN CHUKWUEMEKA ONONOGBU",
            "currencyCode": "NGN",
            "email": "[email protected]",
            "bankCode": "057",
            "bankName": "Zenith bank",
            "defaultSplitPercentage": 20,
            "settlementProfileCode": "8717495899",
            "settlementReportEmails": []
        },
        {
            "subAccountCode": "MFY_SUB_687043136486",
            "accountNumber": "8569214283",
            "accountName": "MFY / 9jaCash-jaCash-ABODUNRIN OYELEKE MAICHEAL",
            "currencyCode": "NGN",
            "email": "[email protected]",
            "bankCode": "035",
            "bankName": "Wema bank",
            "defaultSplitPercentage": 20.87,
            "settlementProfileCode": "8717495899",
            "settlementReportEmails": []
        }
    ]
}

Update Sub Account

This endpoint updates the details of an existing sub account.
PUT
{{base_url}}/api/v1/sub-accounts

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

currencyCode
String

Settlement currency. "NGN"
accountNumber
String

The account number that should be created as a sub account.
bankCode
String

The 3 digit bank code of the bank where the account number is domiciled
email
String

The email tied to the sub account
defaultSplitPercentage
Float

The default percentage to be split into the sub account on any transaction.
subAccountCode
String

The sub account code of the account to be updated.
REQUEST
Copy button
{
	"subAccountCode": "MFY_SUB_811397375865",
	"currencyCode": "NGN",
	"bankCode": "058",
	"accountNumber": "0211319282",
	"email": "[email protected]",
	"defaultSplitPercentage": "25"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "subAccountCode": "MFY_SUB_811397375865",
        "accountNumber": "0211319282",
        "accountName": "ALEMOH DANIEL MOSES",
        "currencyCode": "NGN",
        "email": "[email protected]",
        "bankCode": "058",
        "bankName": "GTBank",
        "defaultSplitPercentage": 25,
        "settlementProfileCode": "8717495899",
        "settlementReportEmails": []
    }
}

Transfers (Disbursement)

Initiate Transfer (Single)

This endpoint helps to initiate transfer to desired bank account.
POST
{{base_url}}/api/v2/disbursements/single

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

amount
Float

Amount to disburse
reference
String

The unique reference for the transaction
narration
String

The Narration for the transactions being processed
destinationBankCode
String

The 3 digit bank code representing the destination bank
destinationAccountNumber
String

The beneficiary account number
currency
String

The currency of the transaction being initialised - "NGN"
sourceAccountNumber
String

Unique identifier of your wallet
REQUEST
Copy button
{
    "amount": 200,
    "reference":"referen00ce---1290034",
    "narration":"911 Transaction",
    "destinationBankCode": "057",
    "destinationAccountNumber": "2085886393",
    "currency": "NGN",
    "sourceAccountNumber": "3934178936"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "amount": 200,
        "reference": "referen00ce---1290034",
        "status": "SUCCESS",
        "dateCreated": "2022-07-31T14:31:33.759+0000",
        "totalFee": 35,
        "destinationAccountName": "BENJAMIN CHUKWUEMEKA ONONOGBU",
        "destinationBankName": "Zenith bank",
        "destinationAccountNumber": "2085886393",
        "destinationBankCode": "057"
    }
}

Initiate Transfer (Async)

This endpoint helps initiate transfer asynchronously to desired bank account.
POST
{{base_url}}/api/v2/disbursements/single

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

amount
Float

Amount to disburse
reference
String

The unique reference for the transaction
narration
String

The Narration for the transactions being processed
destinationBankCode
String

The 3 digit bank code representing the destination bank
destinationAccountNumber
String

The beneficiary account number
currency
String

The currency of the transaction being initialised - "NGN"
sourceAccountNumber
String

Unique identifier of your wallet
async
Boolean

An option to process disbursment asynchronously
REQUEST
Copy button
{
    "amount": 200,
    "reference":"reference-0x1290034",
    "narration":"911 Transaction",
    "destinationBankCode": "057",
    "destinationAccountNumber": "2085886393",
    "currency": "NGN",
    "sourceAccountNumber": "3934178936",
    "async":true
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "amount": 200,
        "reference": "reference-0x1290034",
        "status": "PENDING",
        "dateCreated": "2023-09-22T15:38:38.443+0000",
        "totalFee": 35,
        "destinationBankName": "Zenith bank",
        "destinationAccountNumber": "2085886393",
        "destinationBankCode": "057"
    }
}

Initiate Transfer (Bulk)

This endpoint helps in Initiating Bulk Transfer transactions on your integration.
POST
{{base_url}}/api/v2/disbursements/batch

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

title
String

The title of the batch disbursement
batchReference
String

A unique reference identifying the batch disbursement
narration
String

A narration for the disbursement
sourceAccountNumber
String

The merchant WALLET ACCOUNT NUMBER.
onValidationFailure
Enum

Decision to be taken if any of the disbursement batches fail. Either BREAK or CONTINUE.
notificationInterval
Integer

This determines how often Monnify should notify the merchant of its progress when processing a batch transfer
transactionList
Array

A list of transactions to be processed
REQUEST
Copy button
{
	"title" : "Game of Batches",
    "batchReference":"batchreference--12934",
    "narration":"911 Transaction",
    "sourceAccountNumber": "3934178936",
    "onValidationFailure" : "CONTINUE",
    "notificationInterval": 25,
    "transactionList" : [
    	{
	    	"amount": 1300,
	    	"reference":"Final-Refere-nce-1a",
	    	"narration":"911 Transaction",
	    	"destinationBankCode": "058",
	    	"destinationAccountNumber": "0111946768",
	    	"currency": "NGN"
    	},
		{
    		"amount": 570,
	    	"reference":"Final-Ref-erence-2a",
	    	"narration":"911 Transaction",
	    	"destinationBankCode": "058",
	    	"destinationAccountNumber": "0111946768",
	    	"currency": "NGN"
    	},
		{
    		"amount": 230,
	    	"reference":"Final-Refer-ence-3a",
	    	"narration":"911 Transaction",
	    	"destinationBankCode": "058",
	    	"destinationAccountNumber": "0111946768",
	    	"currency": "NGN"
    	}


   	]
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "totalAmount": 2100,
        "totalFee": 105,
        "batchReference": "batchreference--12934",
        "batchStatus": "AWAITING_PROCESSING",
        "totalTransactionsCount": 3,
        "dateCreated": "2022-07-31T14:41:19.588+0000"
    }
}

Authorize Single Transfers

This endpoint authorizes single transfers on your integration.
POST
{{base_url}}/api/v2/disbursements/single/validate-otp

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

reference
String

The unique reference for the transfer
authorizationCode
String

The OTP sent to merchant's email address
REQUEST
Copy button
{
    "reference":"refere--n00ce---1290034",
    "authorizationCode":"491763"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "amount": 200,
        "reference": "refere--n00ce---1290034",
        "status": "SUCCESS",
        "dateCreated": "2022-07-31T15:36:16.000+0000",
        "totalFee": 35,
        "destinationAccountName": "BENJAMIN CHUKWUEMEKA ONONOGBU",
        "destinationBankName": "Zenith bank",
        "destinationAccountNumber": "2085886393",
        "destinationBankCode": "057"
    }
}

Authorize Bulk Transfers

This endpoint authorizes bulk transfers on your integration.
POST
{{base_url}}/api/v2/disbursements/batch/validate-otp

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

reference
String

The batch reference used in the transfer
authorizationCode
String

The OTP sent to the merchant's email
REQUEST
Copy button
{
    "reference":"batchre-ference--12934",
    "authorizationCode":"122080"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "totalAmount": 2100,
        "totalFee": 105,
        "batchReference": "batchre-ference--12934",
        "batchStatus": "AWAITING_PROCESSING",
        "totalTransactionsCount": 3,
        "dateCreated": "2022-07-31T15:49:03.000+0000"
    }
}

Resend OTP

This endpoint generates a new OTP in the event that there were challenges with the former OTP sent.
POST
{{base_url}}/api/v2/disbursements/single/resend-otp

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

reference
String

The reference used for the transfer
REQUEST
Copy button
{
    "reference" : "{{reference}}"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "message": "Authorization code will be processed and sent to predefined email addresses(s)"
    }
}

Single Transfer Status

This endpoint verifies the status of a single transfer on your integration.
GET
{{base_url}}/api/v2/disbursements/single/summary

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

reference
String

The reference used for the transfer
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v2/disbursements/single/summary?reference=referen00ce---1290034
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "amount": 200,
        "reference": "referen00ce---1290034",
        "narration": "911 Transaction",
        "currency": "NGN",
        "fee": 35,
        "twoFaEnabled": false,
        "status": "SUCCESS",
        "transactionDescription": "Transaction successful",
        "transactionReference": "MFDS20220731033133AABQGN",
        "createdOn": "2022-07-31T14:31:34.000+0000",
        "sourceAccountNumber": "3934178936",
        "destinationAccountNumber": "2085886393",
        "destinationAccountName": "BENJAMIN CHUKWUEMEKA ONONOGBU",
        "destinationBankCode": "057",
        "destinationBankName": "Zenith bank"
    }
}

List All Single Transfers

This endpoint returns the list of all single transfers made on your integration.
GET
{{base_url}}/api/v2/disbursements/single/transactions

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

pageSize
Integer

The number of transfer records to return
pageNo
Integer

A number specifying what page of transfers to be retrieved
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v2/disbursements/single/transactions?pageSize=20&pageNo=1
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "amount": 10,
                "reference": "hjkdd0odood0pl",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220516012053AAAYYN",
                "createdOn": "2022-05-16T12:20:54.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "hjkddodood0pl",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220422013417AAAXSP",
                "createdOn": "2022-04-22T12:34:18.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "hjkddodood0p9",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220422103648AAAXSG",
                "createdOn": "2022-04-22T09:36:48.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "hjkddodood0p",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220422103636AAAXSF",
                "createdOn": "2022-04-22T09:36:36.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "hjkddodood0",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220422103623AAAXSE",
                "createdOn": "2022-04-22T09:36:23.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "hjkddodood",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220422090109AAAXRK",
                "createdOn": "2022-04-22T08:01:10.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "reference234hh",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220420120659AAAXNY",
                "createdOn": "2022-04-20T11:06:59.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "reference29034hh",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220420120252AAAXNX",
                "createdOn": "2022-04-20T11:02:53.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "referene2934hh",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220326055912AAAWGE",
                "createdOn": "2022-03-26T16:59:12.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "reference2934hh",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220322053101AAAVTO",
                "createdOn": "2022-03-22T16:31:02.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 10,
                "reference": "reference2934",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220317100514AAAVMO",
                "createdOn": "2022-03-17T09:05:14.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 230,
                "reference": "Final-Reference-",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220315094149AAAVDV",
                "createdOn": "2022-03-15T08:41:49.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 230,
                "reference": "Final-Reference-3c",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "FAILED",
                "transactionDescription": "Account number could not be validated",
                "transactionReference": "MFDS20220315094149AAAVDW",
                "createdOn": "2022-03-15T08:41:49.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946788",
                "destinationBankCode": "058"
            },
            {
                "amount": 230,
                "reference": "Final-Reference-3b",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "FAILED",
                "transactionDescription": "Account number could not be validated",
                "transactionReference": "MFDS20220315094149AAAVDX",
                "createdOn": "2022-03-15T08:41:49.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111940768",
                "destinationBankCode": "058"
            },
            {
                "amount": 1300,
                "reference": "Final-Reference-v",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220315094148AAAVDT",
                "createdOn": "2022-03-15T08:41:49.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 570,
                "reference": "Final-Reference-m",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220315094148AAAVDU",
                "createdOn": "2022-03-15T08:41:49.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 570,
                "reference": "Final-Reference-2",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220315093929AAAVDR",
                "createdOn": "2022-03-15T08:39:30.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 230,
                "reference": "Final-Reference-3",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220315093929AAAVDS",
                "createdOn": "2022-03-15T08:39:30.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 1300,
                "reference": "Final-Reference-1",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220315093929AAAVDQ",
                "createdOn": "2022-03-15T08:39:29.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 1300,
                "reference": "Final-Reference-1a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220315093339AAAVDN",
                "createdOn": "2022-03-15T08:33:39.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 20,
            "pageNumber": 1,
            "offset": 20,
            "paged": true,
            "unpaged": false
        },
        "last": false,
        "totalPages": 3,
        "totalElements": 54,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": false,
        "numberOfElements": 20,
        "size": 20,
        "number": 1,
        "empty": false
    }
}

List All Bulk Transfers

This endpoint returns the list of all bulk transfers made on your integration.
GET
{{base_url}}/api/v2/disbursements/bulk/transactions

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

pageSize
Integer

The number of transfer records to return
pageNo
Integer

A number specifying what page of transfers to be retrieved
REQUEST
Copy button
curl -H "Accept: application/json" 
https://sandbox.monnify.com/api/v2/disbursements/single/transactions?pageSize=5
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "totalAmount": 45,
                "totalFee": 80,
                "batchReference": "Batch-1596666798811",
                "batchStatus": "COMPLETED",
                "totalTransactionsCount": 4,
                "dateCreated": "2020-08-05T22:33:21.000+0000"
            },
            {
                "totalAmount": 50,
                "totalFee": 20,
                "batchReference": "Batch-1593606495053",
                "batchStatus": "COMPLETED",
                "totalTransactionsCount": 1,
                "dateCreated": "2020-07-01T12:28:16.000+0000"
            },
            {
                "totalAmount": 50,
                "totalFee": 20,
                "batchReference": "Batch-1593606391931",
                "batchStatus": "COMPLETED",
                "totalTransactionsCount": 1,
                "dateCreated": "2020-07-01T12:26:33.000+0000"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 3,
            "pageNumber": 0,
            "offset": 0,
            "unpaged": false,
            "paged": true
        },
        "totalPages": 3,
        "last": false,
        "totalElements": 7,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 3,
        "size": 3,
        "number": 0,
        "empty": false
    }
}

Get Bulk Transfer Transactions

This endpoint returns the list of all transactions in a bulk transfer batch and their status.
GET
{{base_url}}/api/v2/disbursements/bulk/batchreference--12934/transactions

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

pageSize
Integer

The number of transfer record to be returned per page
pageNo
Integer

A number specifying what page of transfers to be retrieved
batchReference
String

A unique reference identifying the batch disbursement
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v2/disbursements/bulk/batchreference--12934/transactions
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "amount": 230,
                "reference": "Final-Refer-ence-3a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034121AABQGQ",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 570,
                "reference": "Final-Ref-erence-2a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034121AABQGP",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 1300,
                "reference": "Final-Refere-nce-1a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034120AABQGO",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": true,
        "totalPages": 1,
        "totalElements": 3,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 3,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Bulk Transfer Status

This endpoint verifies the status of a bulk transfer on your integration.
GET
{{base_url}}/api/v2/disbursements/bulk/batchreference--12934/transactions

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

batchReference
String

A unique reference identifying the batch disbursement
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v2/disbursements/bulk/batchreference--12934/transactions
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "amount": 230,
                "reference": "Final-Refer-ence-3a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034121AABQGQ",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 570,
                "reference": "Final-Ref-erence-2a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034121AABQGP",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 1300,
                "reference": "Final-Refere-nce-1a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034120AABQGO",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": true,
        "totalPages": 1,
        "totalElements": 3,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 3,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Search Disbursement Transactions

This endpoint returns the list of all disbursement transactions.
GET
{{base_url}}/api/v2/disbursements/search-transactions

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

sourceAccountNumber
String

The merchant's WALLET ACCOUNT NUMBER, this parameter is mandatory
pageSize
Integer

The number of records to return
pageNo
Integer

The current page from the total
startDate
String

A timestamp value specifying the date to start filtering disbursement transactions by the createdAt field
endDate
String

A timestamp value specifying the date to stop filtering disbursement transactions by the createdAt field
amountFrom
String

A number specifying the lower bound for filtering the transactions by the amount field
amountTo
String

A number specifying the upper bound for filtering the transactions by the amount field.
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v2/disbursements/search-transactions?sourceAccountNumber=3934178936
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "amount": 200,
                "reference": "refere--n00ce---1290--034",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": true,
                "status": "EXPIRED",
                "transactionDescription": "Transaction has expired",
                "transactionReference": "MFDS20220731044951AABQGV",
                "createdOn": "2022-07-31T15:49:51.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "2085886393",
                "destinationAccountName": "BENJAMIN CHUKWUEMEKA ONONOGBU",
                "destinationBankCode": "057",
                "destinationBankName": "Zenith bank"
            },
            {
                "amount": 230,
                "reference": "Final-Ref--er-ence-3a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": true,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731044903AABQGU",
                "createdOn": "2022-07-31T15:49:04.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 570,
                "reference": "Final-Ref-e--rence-2a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": true,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731044903AABQGT",
                "createdOn": "2022-07-31T15:49:04.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 1300,
                "reference": "Final-Ref--ere-nce-1a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": true,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731044903AABQGS",
                "createdOn": "2022-07-31T15:49:04.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 200,
                "reference": "refere--n00ce---1290034",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": true,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731043616AABQGR",
                "createdOn": "2022-07-31T15:36:16.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "2085886393",
                "destinationAccountName": "BENJAMIN CHUKWUEMEKA ONONOGBU",
                "destinationBankCode": "057",
                "destinationBankName": "Zenith bank"
            },
            {
                "amount": 230,
                "reference": "Final-Refer-ence-3a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034121AABQGQ",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 570,
                "reference": "Final-Ref-erence-2a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034121AABQGP",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 1300,
                "reference": "Final-Refere-nce-1a",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731034120AABQGO",
                "createdOn": "2022-07-31T14:41:21.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "0111946768",
                "destinationAccountName": "MEKILIUWA SMART CHINONSO",
                "destinationBankCode": "058",
                "destinationBankName": "GTBank"
            },
            {
                "amount": 200,
                "reference": "referen00ce---1290034",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "SUCCESS",
                "transactionDescription": "Transaction successful",
                "transactionReference": "MFDS20220731033133AABQGN",
                "createdOn": "2022-07-31T14:31:34.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "2085886393",
                "destinationAccountName": "BENJAMIN CHUKWUEMEKA ONONOGBU",
                "destinationBankCode": "057",
                "destinationBankName": "Zenith bank"
            },
            {
                "amount": 200,
                "reference": "reference---12934",
                "narration": "911 Transaction",
                "currency": "NGN",
                "fee": 35,
                "twoFaEnabled": false,
                "status": "FAILED",
                "transactionDescription": "Name enquiry failed",
                "transactionReference": "MFDS20220731031032AABQGM",
                "createdOn": "2022-07-31T14:10:33.000+0000",
                "sourceAccountNumber": "3934178936",
                "destinationAccountNumber": "5000143115",
                "destinationBankCode": "035",
                "destinationBankName": "Wema bank"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": false,
        "totalPages": 6,
        "totalElements": 54,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 10,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Get Wallet Balance

This endpoint returns the available balance in your monnify wallet.
GET
{{base_url}}/api/v2/disbursements/wallet-balance

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

accountNumber
String

The merchant's WALLET ACCOUNT NUMBER.
REQUEST
Copy button
curl -H "Accept: application/json" 
https://sandbox.monnify.com/api/v2/disbursements/wallet-balance?accountNumber=String
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "availableBalance": 378.93,
        "ledgerBalance": 378.93
    }
}

Wallet

Create Wallet

This endpoint creates wallets for merchants' customers
POST
{{base_url}}/api/v1/disbursements/wallet

Headers

Authorization
basic
Authorize this API call by including Authorization header that contains the word 'Basic' followed by a space and a base64-encoded string 'apiKey:clientSecret' i.e. 'Basic base64(ApiKey:SecretKey)', include the Token in the request header.

Body Params

walletReference
String

A unique identifier for the wallet
walletName
String

The desired wallet name
customerName
String

The customer's name
customerEmail
String

The customer's email
bvn
String

The customer's bvn
bvnDateOfBirth
String

The date of birth associated with the bvn in the format yyyy-mm-dd
REQUEST
Copy button
{
    "walletReference":"ref16842048425966",
    "walletName":"Staging Wallet - ref16804248425966",
    "customerName": "John Doe",
    "bvnDetails": {
    "bvn": "{{bvn}}",
    "bvnDateOfBirth": "1997-04-08" 
    },
    "customerEmail": "[email protected]"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "walletName": "Staging Wallet - ref16804248425966",
        "walletReference": "ref16842048425966",
        "customerName": "Test01-John Doe",
        "customerEmail": "[email protected]",
        "feeBearer": "SELF",
        "bvnDetails": {
            "bvn": "22222222222",
            "bvnDateOfBirth": "1990-06-08"
        },
        "accountNumber": "1345947817",
        "accountName": "Test01-John Doe"
    }
}

Wallet Balance

This endpoint returns the balance associated with a wallet
GET
{{base_url}}/api/v1/disbursements/wallet/balance

Headers

Authorization
basic
Authorize this API call by including Authorization header that contains the word 'Basic' followed by a space and a base64-encoded string 'apiKey:clientSecret' i.e. 'Basic base64(ApiKey:SecretKey)', include the Token in the request header.

Body Params

walletReference
String

The unique identifier of the wallet
REQUEST
Copy button
curl -H "Accept: application/json" 
{{monnify_base_url}}/api/v1/disbursements/wallet/balance?accountNumber=9318673649
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "availableBalance": 5000000000,
        "ledgerBalance": 5000000000
    }
}

Get Wallets

This endpoint returns all the wallets created by a merchant
GET
{{base_url}}/api/v1/disbursements/wallet

Headers

Authorization
basic
Authorize this API call by including Authorization header that contains the word 'Basic' followed by a space and a base64-encoded string 'apiKey:clientSecret' i.e. 'Basic base64(ApiKey:SecretKey)', include the Token in the request header.

Body Params

customerEmail
[email protected]

pageSize
Integer

The amount of records to be returned
pageNo
Integer

The page number of the requested records
REQUEST
Copy button
curl -H "Accept: application/json" 
{{monnify_base_url}}/api/v1/disbursements/wallet?pageSize=10&pageNo=0
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "walletName": "Smart Wallet - 123",
                "walletReference": "sgsjsjshsishs",
                "customerName": "Test01-Smart Mek",
                "customerEmail": "[email protected]",
                "feeBearer": "SELF",
                "bvnDetails": {
                    "bvn": "22222222222",
                    "bvnDateOfBirth": "1990-06-08"
                },
                "accountNumber": "2611645927",
                "accountName": "Test01-Smart Mek",
                "topUpAccountDetails": {
                    "accountNumber": "4999857145",
                    "accountName": "Test01-Smart Mek",
                    "bankCode": "001",
                    "bankName": "Monnify Test Bank"
                }
            },
            {
                "walletName": "Benj-Wallet-123",
                "walletReference": "Wal232323",
                "customerName": "Test01-Benji",
                "customerEmail": "[email protected]",
                "feeBearer": "SELF",
                "bvnDetails": {
                    "bvn": "22222222222",
                    "bvnDateOfBirth": "1990-06-08"
                },
                "accountNumber": "4445668698",
                "accountName": "Test01-Benji",
                "topUpAccountDetails": {
                    "accountNumber": "2349242677",
                    "accountName": "Test01-Benji",
                    "bankCode": "001",
                    "bankName": "Monnify Test Bank"
                }
            },
            {
                "walletName": "Staging Wallet - ref1684248425966",
                "walletReference": "ref1684248425966",
                "customerName": "Test01-John Doe",
                "customerEmail": "[email protected]",
                "feeBearer": "SELF",
                "bvnDetails": {
                    "bvn": "22222222222",
                    "bvnDateOfBirth": "1990-06-08"
                },
                "accountNumber": "9318673649",
                "accountName": "Test01-John Doe",
                "topUpAccountDetails": {
                    "accountNumber": "9373335565",
                    "accountName": "Test01-John Doe",
                    "bankCode": "001",
                    "bankName": "Monnify Test Bank"
                }
            },
            {
                "walletName": "Staging Wallet - ref1684248425966",
                "walletReference": "ref16842x48425966",
                "customerName": "Test01-John Doe",
                "customerEmail": "[email protected]",
                "feeBearer": "SELF",
                "bvnDetails": {
                    "bvn": "22222222222",
                    "bvnDateOfBirth": "1990-06-08"
                },
                "accountNumber": "6389487462",
                "accountName": "Test01-John Doe",
                "topUpAccountDetails": {
                    "accountNumber": "3141756258",
                    "accountName": "Test01-John Doe",
                    "bankCode": "001",
                    "bankName": "Monnify Test Bank"
                }
            },
            {
                "walletName": "Staging Wallet - ref1703147389707",
                "walletReference": "ref1703147389707",
                "customerName": "Test01-John Doe",
                "customerEmail": "[email protected]",
                "feeBearer": "SELF",
                "bvnDetails": {
                    "bvn": "22222222222",
                    "bvnDateOfBirth": "1990-06-08"
                },
                "accountNumber": "7728149563",
                "accountName": "Test01-John Doe",
                "topUpAccountDetails": {
                    "accountNumber": "5365119912",
                    "accountName": "Test01-John Doe",
                    "bankCode": "001",
                    "bankName": "Monnify Test Bank"
                }
            },
            {
                "walletName": "Staging Wallet - ref1703147486611",
                "walletReference": "ref1703147486611",
                "customerName": "Test01-John Doe",
                "customerEmail": "[email protected]",
                "feeBearer": "SELF",
                "bvnDetails": {
                    "bvn": "22222222222",
                    "bvnDateOfBirth": "1990-06-08"
                },
                "accountNumber": "3892823488",
                "accountName": "Test01-John Doe",
                "topUpAccountDetails": {
                    "accountNumber": "6427372829",
                    "accountName": "Test01-John Doe",
                    "bankCode": "001",
                    "bankName": "Monnify Test Bank"
                }
            },
            {
                "walletName": "Staging Wallet - ref1703147617449",
                "walletReference": "ref1703147617449",
                "customerName": "Test01-John Doe",
                "customerEmail": "[email protected]",
                "feeBearer": "SELF",
                "bvnDetails": {
                    "bvn": "22445912580",
                    "bvnDateOfBirth": "2001-10-06"
                },
                "accountNumber": "4823894483",
                "accountName": "Test01-John Doe",
                "topUpAccountDetails": {
                    "accountNumber": "3346545623",
                    "accountName": "Test01-John Doe",
                    "bankCode": "001",
                    "bankName": "Monnify Test Bank"
                }
            },
            {
                "walletName": "Staging Wallet - ref16804248425966",
                "walletReference": "ref16842048425966",
                "customerName": "Test01-John Doe",
                "customerEmail": "[email protected]",
                "feeBearer": "SELF",
                "bvnDetails": {
                    "bvn": "22222222222",
                    "bvnDateOfBirth": "1990-06-08"
                },
                "accountNumber": "1345947817",
                "accountName": "Test01-John Doe",
                "topUpAccountDetails": {
                    "accountNumber": "6356312549",
                    "accountName": "Test01-John Doe",
                    "bankCode": "001",
                    "bankName": "Monnify Test Bank"
                }
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": true,
        "totalElements": 8,
        "totalPages": 1,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 8,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Wallet Transactions

This endpoint returns all the transactions performed by a wallet
GET
{{base_url}}/api/v1/disbursements/wallet/transactions

Headers

Authorization
basic
Authorize this API call by including Authorization header that contains the word 'Basic' followed by a space and a base64-encoded string 'apiKey:clientSecret' i.e. 'Basic base64(ApiKey:SecretKey)', include the Token in the request header.

Body Params

accountNumber
String

The wallet account number
REQUEST
Copy button
curl -H "Accept: application/json" 
{{monnify_base_url}}/api/v1/disbursements/wallet/transactions?accountNumber=9318673649
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [],
        "pageable": {
            "sort": {
                "sorted": false,
                "unsorted": true,
                "empty": true
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": true,
        "totalPages": 0,
        "totalElements": 0,
        "sort": {
            "sorted": false,
            "unsorted": true,
            "empty": true
        },
        "first": true,
        "numberOfElements": 0,
        "size": 10,
        "number": 0,
        "empty": true
    }
}

Limit Profile

Create Limit Profile(s)

This endpoint creates limit profiles on a customer's account.
POST
{{base_url}}/api/v1/limit-profile/

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

limitProfileName
String

The name of the Limit Profile
singleTransactionValue
Float

The maximum amount that can be allowed per transaction on the reserved accounts.
dailyTransactionValue
Float

The maximum amount per day in all transactions that can be allowed on the reserved accounts
dailyTransactionVolume
Float

The maximum number of transaction count per day allowed on the reserved accounts
REQUEST
Copy button
{
    "limitProfileName":"Profile0001",
    "singleTransactionValue":2000,
    "dailyTransactionVolume":500,
    "dailyTransactionValue": 150000
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "limitProfileCode": "FSYVVWU8UPBD",
        "limitProfileName": "Profile0001",
        "singleTransactionValue": 2000,
        "dailyTransactionVolume": 500,
        "dailyTransactionValue": 150000,
        "dateCreated": "02/08/2022 02:27:43 AM",
        "lastModified": "02/08/2022 02:27:43 AM"
    }
}

Get Limit Profiles

This endpoint returns the list of all Limit Profiles that have been created for your customers.
GET
{{base_url}}/api/v1/limit-profile/

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/limit-profile/
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "limitProfileCode": "3YXDEFS7ZWB4",
                "limitProfileName": "Benji profile",
                "singleTransactionValue": 2000,
                "dailyTransactionVolume": 500,
                "dailyTransactionValue": 150000,
                "dateCreated": "13/07/2022 10:08:00 PM",
                "lastModified": "13/07/2022 10:08:00 PM"
            },
            {
                "limitProfileCode": "HW5YMHPFPS86",
                "limitProfileName": "Profile001",
                "singleTransactionValue": 2000,
                "dailyTransactionVolume": 500,
                "dailyTransactionValue": 150000,
                "dateCreated": "02/08/2022 12:43:56 AM",
                "lastModified": "02/08/2022 12:43:56 AM"
            },
            {
                "limitProfileCode": "FSYVVWU8UPBD",
                "limitProfileName": "prof991",
                "singleTransactionValue": 70000,
                "dailyTransactionVolume": 4000,
                "dailyTransactionValue": 100000000,
                "dateCreated": "02/08/2022 02:27:44 AM",
                "lastModified": "02/08/2022 02:45:26 AM"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": false,
                "unsorted": true,
                "empty": true
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": true,
        "totalElements": 3,
        "totalPages": 1,
        "sort": {
            "sorted": false,
            "unsorted": true,
            "empty": true
        },
        "first": true,
        "numberOfElements": 3,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Update Limit Profile

This endpoint updates the information on an existing Limit Profile.
PUT
{{base_url}}/api/v1/limit-profile/FSYVVWU8UPBD

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

limitProfileName
String

The name of the Limit Profile
singleTransactionValue
Float

The maximum amount that can be allowed per transaction on the reserved accounts.
dailyTransactionValue
Float

The maximum amount per day in all transactions that can be allowed on the reserved accounts
dailyTransactionVolume
Float

The maximum number of transaction count per day allowed on the reserved accounts
limitProfileCode
String

The generated limit profile code passed as path parameter
REQUEST
Copy button
{
    "limitProfileName":"prof991",
    "singleTransactionValue":70000,
    "dailyTransactionVolume":4000,
    "dailyTransactionValue": 100000000
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "limitProfileCode": "FSYVVWU8UPBD",
        "limitProfileName": "prof991",
        "singleTransactionValue": 70000,
        "dailyTransactionVolume": 4000,
        "dailyTransactionValue": 100000000,
        "dateCreated": "02/08/2022 02:27:44 AM",
        "lastModified": "02/08/2022 02:45:25 AM"
    }
}

Reserve Account with Limit

This endpoint reserves an account for your customers with a transaction limit profile on it.
POST
{{base_url}}/api/v1/bank-transfer/reserved-accounts/limit

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

accountReference
String

A unique reference generated by merchants.
accountName
String

The name to be displayed during name enquiry
currencyCode
String

The currency payments will be received with
contractCode
String

The merchant contract code
customerEmail
String

The customer's email
incomeSplitConfig
Object

A configuration on how payments are to be split among subaccounts
limitProfileCode
String

The unique identifier that references the limit profile to associate with the reserved account
String

REQUEST
Copy button
{
    "contractCode":"7059707855",
    "accountName":"Kan Yo' Reserved with Limit ",
    "currencyCode":"NGN",
    "accountReference": "ref-00--7",
    "customerEmail": "[email protected]",
    "customerName": "Kan Yo",
    "limitProfileCode": "FSYVVWU8UPBD"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "7059707855",
        "accountReference": "ref-00--7",
        "accountName": "Kan",
        "currencyCode": "NGN",
        "customerEmail": "[email protected]",
        "customerName": "Kan Yo",
        "accountNumber": "5000578928",
        "bankName": "Wema bank",
        "bankCode": "035",
        "collectionChannel": "RESERVED_ACCOUNT",
        "reservationReference": "0B70FP4CNC61U334XFG1",
        "reservedAccountType": "GENERAL",
        "status": "ACTIVE",
        "createdOn": "2022-08-02 02:53:25.617",
        "incomeSplitConfig": [],
        "restrictPaymentSource": false,
        "limitProfileConfig": {
            "limitProfileCode": "FSYVVWU8UPBD",
            "singleTransactionValue": 70000,
            "dailyTransactionVolume": 4000,
            "dailyTransactionValue": 100000000
        }
    }
}

Update Reserve Account Limit

This endpoint updates the information on an existing Limit Profile for a Reserved Account.
PUT
{{base_url}}/api/v1/bank-transfer/reserved-accounts/limit

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

accountReference
String

A unique reference generated by merchants.
limitProfileCode
String

The unique identifier that references the limit profile to associate with the reserved accounts.
REQUEST
Copy button
{
    "accountReference": "ref-00--7",
    "limitProfileCode": "FSYVVWU8UPBD"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "7059707855",
        "accountReference": "ref-00--7",
        "currencyCode": "NGN",
        "customerEmail": "[email protected]",
        "customerName": "Kan Yo",
        "accountNumber": "5000578928",
        "bankName": "Wema bank",
        "bankCode": "035",
        "collectionChannel": "RESERVED_ACCOUNT",
        "reservationReference": "0B70FP4CNC61U334XFG1",
        "reservedAccountType": "GENERAL",
        "status": "ACTIVE",
        "createdOn": "2022-08-02 02:53:26.0",
        "restrictPaymentSource": false,
        "limitProfileConfig": {
            "limitProfileCode": "FSYVVWU8UPBD",
            "singleTransactionValue": 70000,
            "dailyTransactionVolume": 4000,
            "dailyTransactionValue": 100000000
        }
    }
}

Refund

Initiate Refund

This endpoint allows you to Initiate a refund.
POST
{{base_url}}/api/v1/refunds/initiate-refund

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

Unique identifier for the transaction generated by Monnify.
refundAmount
Float

Amount to refund.
refundReference
String

Unique identifier for the transaction refund generated by the merchant.
refundReason
String

A note describing reason why this transaction is being refunded.
customerNote
String

This field serves as a narration in credit to the customer's bank account.
destinationAccountNumber
String

The account number to be refunded
destinationBankCode
String

The bank code for the destinationAccountNumber.
REQUEST
Copy button
{
    "transactionReference": "MNFY|65|20220727094724|000477",
    "refundReference":"202100op3456",
    "refundAmount": 100,
    "refundReason": "Order cancelled!",
    "customerNote": "An optional note",
    "destinationAccountNumber": "3270005594",
    "destinationAccountBankCode": "050"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "refundReference": "202100op3456",
        "transactionReference": "MNFY|65|20220727094724|000477",
        "refundReason": "Order cancelled!",
        "customerNote": "An optional note",
        "refundAmount": 100,
        "refundType": "PARTIAL_REFUND",
        "refundStatus": "COMPLETED",
        "refundStrategy": "MERCHANT_WALLET",
        "comment": "Transaction refund is in progress.",
        "completedOn": "02/08/2022 03:35:22 AM",
        "createdOn": "02/08/2022 03:35:21 AM"
    }
}

Get Refund Status

This endpoint returns the status of an initiated refund.
GET
{{base_url}}/api/v1/refunds/202100op3456

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

refundReference
String

The refund reference used for the refund.
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/refunds/202100op3456
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "refundReference": "202100op3456",
        "transactionReference": "MNFY|65|20220727094724|000477",
        "refundReason": "Order cancelled!",
        "customerNote": "An optional note",
        "refundAmount": 100,
        "refundType": "PARTIAL_REFUND",
        "refundStatus": "COMPLETED",
        "refundStrategy": "MERCHANT_WALLET",
        "comment": "Refund processed successfully.",
        "completedOn": "02/08/2022 03:35:22 AM",
        "createdOn": "02/08/2022 03:35:22 AM"
    }
}

Get All Refunds

This endpoint returns the list of all refunds available on your integration.
GET
{{base_url}}/api/v1/refunds

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

page
Integer

An integer specifying the page of transactions to be retrieved. Page number starts from 0.
size
Integer

An integer specifying the size of transactions to be returned per page.
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/refunds
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "refundReference": "202100op3456",
                "transactionReference": "MNFY|65|20220727094724|000477",
                "refundReason": "Order cancelled!",
                "customerNote": "An optional note",
                "refundAmount": 100,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "COMPLETED",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "Refund processed successfully.",
                "completedOn": "02/08/2022 03:35:22 AM",
                "createdOn": "02/08/2022 03:35:22 AM"
            },
            {
                "refundReference": "1237hdid--jdj0p99p",
                "transactionReference": "MNFY|33|20220525090254|000848",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 900,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "COMPLETED",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "Refund processed successfully.",
                "completedOn": "05/07/2022 01:18:16 PM",
                "createdOn": "05/07/2022 01:18:15 PM"
            },
            {
                "refundReference": "1237j890---9d-jdj0p99p",
                "transactionReference": "MNFY|33|20220525110449|000855",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 1000,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "COMPLETED",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "Refund processed successfully.",
                "completedOn": "05/07/2022 12:46:55 PM",
                "createdOn": "05/07/2022 12:46:51 PM"
            },
            {
                "refundReference": "1237j890-9d-jdj0p99p",
                "transactionReference": "MNFY|33|20220525110449|000855",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 1000,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "COMPLETED",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "Refund processed successfully.",
                "completedOn": "04/07/2022 08:22:30 AM",
                "createdOn": "04/07/2022 08:22:26 AM"
            },
            {
                "refundReference": "1237j89--9d-jdj0p99p",
                "transactionReference": "MNFY|33|20220525110449|000855",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 1000,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "COMPLETED",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "Refund processed successfully.",
                "completedOn": "29/06/2022 12:50:11 PM",
                "createdOn": "29/06/2022 12:50:10 PM"
            },
            {
                "refundReference": "1237j89--9d--jdj0p99p",
                "transactionReference": "MNFY|33|20220525110449|000855",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 1000,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "COMPLETED",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "Refund processed successfully.",
                "completedOn": "29/06/2022 12:16:02 PM",
                "createdOn": "29/06/2022 12:16:01 PM"
            },
            {
                "refundReference": "1237j899d--jdj0p99p",
                "transactionReference": "MNFY|33|20220525090450|000849",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 1000,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "PENDING",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "",
                "completedOn": "",
                "createdOn": "29/06/2022 12:13:34 PM"
            },
            {
                "refundReference": "1237j899djdj0p99p",
                "transactionReference": "MNFY|33|20220525090450|000849",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 100,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "PENDING",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "",
                "completedOn": "",
                "createdOn": "29/06/2022 11:44:18 AM"
            },
            {
                "refundReference": "1237jdjdj0p99p",
                "transactionReference": "MNFY|23|20220526072803|000006",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 100.56,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "PENDING",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "",
                "completedOn": "",
                "createdOn": "29/06/2022 11:42:56 AM"
            },
            {
                "refundReference": "1234567jdjdj0p99p",
                "transactionReference": "MNFY|23|20220526072803|000006",
                "refundReason": "Order cancelled! (limited to 64 characters)",
                "customerNote": "A note",
                "refundAmount": 100.56,
                "refundType": "PARTIAL_REFUND",
                "refundStatus": "PENDING",
                "refundStrategy": "MERCHANT_WALLET",
                "comment": "",
                "completedOn": "",
                "createdOn": "29/06/2022 11:31:46 AM"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 10,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": false,
        "totalElements": 17,
        "totalPages": 2,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 10,
        "size": 10,
        "number": 0,
        "empty": false
    }
}

Settlements

Get Transactions By Settlement Reference

This endpoint returns all transactions that made up a settlement.
GET
{{base_url}}/api/v1/transactions/find-by-settlement-reference

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

reference
String

The settlement reference
page
Integer

The current page of the record
size
Integer

The number of transactions per page
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/transactions/find-by-settlement-reference?reference=XUY3FHWRJP3CEM4N17BA&page=0&size=20
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "content": [
            {
                "transactionReference": "MNFY|28|20220718162222|066201",
                "paymentReference": "1658157741945",
                "amountPaid": "20.32",
                "totalPayable": "20.32",
                "settlementAmount": "20.00",
                "paidOn": "18/07/2022 04:23:55 PM",
                "paymentStatus": "PAID",
                "paymentDescription": "lets pay",
                "transactionHash": "218523babb5416ed29477d618c315f458d6a7e881edf9d7a7cfb5fa7a61a16857f80cb1a795ee07cdfd92f9502970cb71d59c4b21017952feacff99f17cbdb92",
                "currency": "NGN",
                "paymentMethod": "CARD",
                "product": {
                    "type": "WEB_SDK",
                    "reference": "1658157741945"
                },
                "cardDetails": {
                    "cardType": "MasterCard",
                    "last4": "9098",
                    "expMonth": "07",
                    "expYear": "23",
                    "bin": "539941",
                    "bankCode": "057",
                    "bankName": "Zenith bank",
                    "reusable": true,
                    "countryCode": null,
                    "cardToken": "MNFY_1B4B8224C4A847DE847B094AB7B979F9",
                    "supportsTokenization": true,
                    "maskedPan": "539941******9098"
                },
                "accountDetails": null,
                "accountPayments": [],
                "customer": {
                    "email": "[email protected]",
                    "name": "Marvelous Benji"
                },
                "metaData": {
                    "name": "Damilare",
                    "age": "45"
                }
            },
            {
                "transactionReference": "MNFY|49|20220719101559|009531",
                "paymentReference": "1658222158122",
                "amountPaid": "20.32",
                "totalPayable": "20.32",
                "settlementAmount": "20.00",
                "paidOn": "19/07/2022 10:17:40 AM",
                "paymentStatus": "PAID",
                "paymentDescription": "lets pay",
                "transactionHash": "59cd9d38a82faacc5a44690236348d296d1b19c2a91786186b4b044f51d1feac0104fae1141ac5549ad74b5a4b93715a77088629e5ad3f64d36d1d9c963c92ec",
                "currency": "NGN",
                "paymentMethod": "CARD",
                "product": {
                    "type": "WEB_SDK",
                    "reference": "1658222158122"
                },
                "cardDetails": {
                    "cardType": "MasterCard",
                    "last4": "9098",
                    "expMonth": "07",
                    "expYear": "23",
                    "bin": "539941",
                    "bankCode": "057",
                    "bankName": "Zenith bank",
                    "reusable": true,
                    "countryCode": null,
                    "cardToken": "MNFY_7FEB76238A0C4A5EA96FC448330C63A9",
                    "supportsTokenization": true,
                    "maskedPan": "539941******9098"
                },
                "accountDetails": null,
                "accountPayments": [],
                "customer": {
                    "email": "[email protected]",
                    "name": "Marvelous Benji"
                },
                "metaData": {}
            },
            {
                "transactionReference": "MNFY|48|20220719101906|009342",
                "paymentReference": "1658222346512",
                "amountPaid": "20.32",
                "totalPayable": "20.32",
                "settlementAmount": "20.00",
                "paidOn": "19/07/2022 10:20:22 AM",
                "paymentStatus": "PAID",
                "paymentDescription": "lets pay",
                "transactionHash": "66a96618cb73aab85a09b875a34a5295007857b04705e990e26f1e97be3eea8cb4f6b377ffa01e9e4a0418ebb5a9e5ea919f68755e4b18387f5920cb9f1a8fea",
                "currency": "NGN",
                "paymentMethod": "CARD",
                "product": {
                    "type": "WEB_SDK",
                    "reference": "1658222346512"
                },
                "cardDetails": {
                    "cardType": "MasterCard",
                    "last4": "9098",
                    "expMonth": "07",
                    "expYear": "23",
                    "bin": "539941",
                    "bankCode": "057",
                    "bankName": "Zenith bank",
                    "reusable": true,
                    "countryCode": null,
                    "cardToken": "MNFY_64355FBB44534A3E8B484985436BE1BD",
                    "supportsTokenization": true,
                    "maskedPan": "539941******9098"
                },
                "accountDetails": null,
                "accountPayments": [],
                "customer": {
                    "email": "[email protected]",
                    "name": "Marvelous Benji"
                },
                "metaData": {
                    "name": "Damilare",
                    "age": "45"
                }
            },
            {
                "transactionReference": "MNFY|39|20220719103424|010787",
                "paymentReference": "16427--76682--937",
                "amountPaid": "20.00",
                "totalPayable": "20.32",
                "settlementAmount": "19.68",
                "paidOn": "19/07/2022 10:34:34 AM",
                "paymentStatus": "PARTIALLY_PAID",
                "paymentDescription": "Paying for Product A",
                "transactionHash": "339a4383b8755d6ddf0d7b2f363e4fd820248d2a88caa22d1cf922fda82e7fb45d4eec71a90d7a212b68efed4a5df2bc63767e62e63bdb97ace7686f64d46896",
                "currency": "NGN",
                "paymentMethod": "CARD",
                "product": {
                    "type": "API_NOTIFICATION",
                    "reference": "16427--76682--937"
                },
                "cardDetails": {
                    "cardType": "MasterCard",
                    "last4": "9098",
                    "expMonth": "07",
                    "expYear": "23",
                    "bin": "539941",
                    "bankCode": "057",
                    "bankName": "Zenith bank",
                    "reusable": true,
                    "countryCode": null,
                    "cardToken": "MNFY_64355FBB44534A3E8B484985436BE1BD",
                    "supportsTokenization": false,
                    "maskedPan": "539941******9098"
                },
                "accountDetails": null,
                "accountPayments": [],
                "customer": {
                    "email": "[email protected]",
                    "name": "Marvelous Benji"
                },
                "metaData": {
                    "deviceType": "mobile",
                    "ipAddress": "127.0.0.1"
                }
            }
        ],
        "pageable": {
            "sort": {
                "sorted": false,
                "unsorted": true,
                "empty": true
            },
            "pageSize": 20,
            "pageNumber": 0,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "last": true,
        "totalElements": 4,
        "totalPages": 1,
        "sort": {
            "sorted": false,
            "unsorted": true,
            "empty": true
        },
        "first": true,
        "numberOfElements": 4,
        "size": 20,
        "number": 0,
        "empty": false
    }
}

Get Settlement Information for Transaction

This endpoint returns settlement information on transactions made to your settlement account.
GET
{{base_url}}/api/v1/settlement-detail

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

The Monnify transaction reference of the desired transaction
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/settlement-detail?transactionReference=MNFY%7C28%7C20220718162222%7C066201
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "transaction": {
            "transactionReference": "MNFY|28|20220718162222|066201",
            "paymentReference": "1658157741945",
            "amountPaid": "20.32",
            "totalPayable": "20.32",
            "settlementAmount": "20.00",
            "paidOn": "18/07/2022 04:23:55 PM",
            "paymentStatus": "PAID",
            "paymentDescription": "lets pay",
            "currency": "NGN",
            "paymentMethod": "CARD",
            "product": {
                "type": "WEB_SDK",
                "reference": "1658157741945"
            },
            "cardDetails": {
                "cardType": "MasterCard",
                "last4": "9098",
                "expMonth": "07",
                "expYear": "23",
                "bin": "539941",
                "bankCode": "057",
                "bankName": "Zenith bank",
                "reusable": true,
                "countryCode": null,
                "cardToken": "MNFY_1B4B8224C4A847DE847B094AB7B979F9",
                "supportsTokenization": true,
                "maskedPan": "539941******9098"
            },
            "accountDetails": null,
            "accountPayments": [],
            "customer": {
                "email": "[email protected]",
                "name": "Marvelous Benji"
            },
            "metaData": {
                "name": "Damilare",
                "age": "45"
            }
        },
        "beneficiaries": [
            {
                "beneficiaryType": "MERCHANT_CONTRACT",
                "beneficiaryCode": "100693167467",
                "beneficiaryIncome": 20,
                "incurredFee": 0.32,
                "settlementStatus": "SUCCESS",
                "settlementInformation": {
                    "settledDate": "2022-07-20T21:01:06.000+0000",
                    "settlementReference": "XUY3FHWRJP3CEM4N17BA",
                    "settlementAmount": 79.68,
                    "settlementFee": 0,
                    "destinationAccountNumber": "2085886393",
                    "destinationAccountName": "BENJAMIN CHUKWUEMEKA ONONOGBU",
                    "destinationBankName": "Zenith bank",
                    "destinationBankCode": "057"
                }
            }
        ]
    }
}

Verification APIs

Validate Bank Account

This endpoint validates a Customer's NUBAN Account.
GET
{{base_url}}/api/v1/disbursements/account/validate

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

accountNumber
String

The account number to be validated
bankCode
String

The bank code of the required account number
REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/disbursements/account/validate?accountNumber=2085886393&bankCode=057
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "accountNumber": "0123456789",
        "accountName": "Damilare Ogunnaike",
        "bankCode": "057"
    }
}

BVN Information Verification

This endpoint verifies the BVN information of your customers.
POST
{{base_url}}/api/v1/vas/bvn-details-match

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

bvn
String

The user's bvn
name
String

The user’s name
dateOfBirth
String

The user’s date of birth
mobileNo
String

The user's mobile number
REQUEST
Copy button
{
	"bvn":"22222222226",
    "name": "Benjamin Ranae RT",
    "dateOfBirth": "03-Oct-1993",
    "mobileNo": "08016857829"
}
RESPONSE
Copy button
{
    "requestSuccessful": false,
    "responseMessage": "Unable to process request. Invalid BVN provided",
    "responseCode": "99"
}

BVN and Account Name Match

This endpoint verifies that the Bank verification number and the account number supplied by a user match the BVN and account number linked to that account.
POST
{{base_url}}/api/v1/vas/bvn-account-match

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

bankCode
String

The user’s bank code
accountNumber
String

The user's account number
bvn
String

The user’s bvn
REQUEST
Copy button
{
	"bankCode":"044",
	"accountNumber":"0105284275",
	"bvn":"22222222226"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "bvn": "22222222226",
        "accountNumber": "0103284175",
        "accountName": "OLATUNDE JOSIAH OGUNBOYEJO",
        "matchStatus": "FULL_MATCH",
        "matchPercentage": 100
    }
}

NIN Verification

This endpoint verifies the supplied NIN of the customer
POST
{{base_url}}/api/v1/vas/nin-details

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

nin
String

The customer’s NIN number
REQUEST
Copy button
{
    "nin":"99999999999"
}
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "nin": "99999999999",
        "lastName": "Wilson",
        "firstName": "BENJI",
        "middleName": "CHUKS",
        "dateOfBirth": "1997-04-08",
        "gender": "OTHER",
        "mobileNumber": "2348106244850"
    }
}

Others

Get Banks

This endpoint returns a list of all banks supported by Monnify for collections and disbursements.
GET
{{base_url}}/api/v1/banks

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/banks
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": [
        {
            "name": "9 PAYMENT SOLUTIONS BANK",
            "code": "120001",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "AB MICROFINANCE BANK ",
            "code": "090270",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ABBEY MORTGAGE BANK",
            "code": "070010",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ABOVE ONLY MICROFINANCE BANK ",
            "code": "090260",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ABU MICROFINANCE BANK ",
            "code": "090197",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Access bank",
            "code": "044",
            "ussdTemplate": "*901*Amount*AccountNumber#",
            "baseUssdCode": "*901#",
            "transferUssdTemplate": "*901*AccountNumber#"
        },
        {
            "name": "ACCESS MONEY",
            "code": "927",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ACCESS YELLO & BETA",
            "code": "100052",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ACCION MICROFINANCE BANK",
            "code": "090134",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ADDOSSER MICROFINANCE BANK",
            "code": "090160",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ADEYEMI COLLEGE STAFF MICROFINANCE BANK",
            "code": "090268",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "AFEKHAFE MICROFINANCE BANK",
            "code": "090292",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "AG MORTGAGE BANK",
            "code": "100028",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "AL-BARAKAH MICROFINANCE BANK",
            "code": "090133",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ALEKUN MICROFINANCE BANK",
            "code": "090259",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ALERT MICROFINANCE BANK",
            "code": "090297",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ALLWORKERS MICROFINANCE BANK",
            "code": "090131",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ALPHA KAPITAL MICROFINANCE BANK ",
            "code": "090169",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "AMML MICROFINANCE BANK ",
            "code": "914",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "APEKS MICROFINANCE BANK",
            "code": "090143",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ARISE MICROFINANCE BANK",
            "code": "090282",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ASO SAVINGS",
            "code": "905",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ASSETMATRIX MICROFINANCE BANK",
            "code": "090287",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ASTRAPOLARIS MICROFINANCE BANK",
            "code": "090172",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "AUCHI MICROFINANCE BANK ",
            "code": "090264",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "BAINES CREDIT MICROFINANCE BANK",
            "code": "090188",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "BALOGUN GAMBARI MICROFINANCE BANK",
            "code": "090326",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "BC KASH MICROFINANCE BANK",
            "code": "090127",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "BIPC MICROFINANCE BANK",
            "code": "090336",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "BOCTRUST MICROFINANCE BANK LIMITED",
            "code": "952",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "BOSAK MICROFINANCE BANK",
            "code": "090176",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Bowen Microfinance Bank",
            "code": "50931",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "BRENT MORTGAGE BANK",
            "code": "070015",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "BRIGHTWAY MICROFINANCE BANK",
            "code": "090308",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CASHCONNECT MICROFINANCE BANK",
            "code": "090360",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CELLULANT",
            "code": "919",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CEMCS Microfinance Bank",
            "code": "50823",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CHAMS MOBILE",
            "code": "929",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CHIKUM MICROFINANCE BANK",
            "code": "090141",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CIT MICROFINANCE BANK",
            "code": "090144",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Citibank Nigeria",
            "code": "023",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "COASTLINE MICROFINANCE BANK",
            "code": "090374",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CONPRO MICROFINANCE BANK",
            "code": "090380",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CONSUMER MICROFINANCE BANK",
            "code": "090130",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CONTEC GLOBAL INFOTECH LIMITED(NOWNOW)",
            "code": "100032",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CORESTEP MICROFINANCE BANK",
            "code": "090365",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Coronation Bank",
            "code": "559",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "COVENANT MFB",
            "code": "949",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "CREDIT AFRIQUE MICROFINANCE BANK",
            "code": "090159",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "DAVODANI  MICROFINANCE BANK",
            "code": "090391",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "DAYLIGHT MICROFINANCE BANK",
            "code": "090167",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Diamond bank",
            "code": "063",
            "ussdTemplate": "*710*777*AccountNumber*Amount#",
            "baseUssdCode": "*710#",
            "transferUssdTemplate": "*710*AccountNumber#"
        },
        {
            "name": "E-BARCS MICROFINANCE BANK",
            "code": "090156",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "EAGLE FLIGHT MICROFINANCE BANK",
            "code": "090294",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "EARTHOLEUM",
            "code": "935",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Ecobank Nigeria Plc",
            "code": "050",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ECOBANK XPRESS ACCOUNT",
            "code": "922",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ECOMOBILE",
            "code": "307",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "EK-RELIABLE MICROFINANCE BANK",
            "code": "090389",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "EKONDO MICROFINANCE BANK",
            "code": "090097",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "EMERALD MICROFINANCE BANK",
            "code": "090273",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "EMPIRE TRUST MICROFINANCE BANK",
            "code": "913",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ENTERPRISE BANK",
            "code": "084",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ESO-E MICROFINANCE BANK",
            "code": "090166",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "eTRANZACT",
            "code": "920",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "EVANGEL MICROFINANCE BANK ",
            "code": "090304",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "EVERGREEN MICROFINANCE BANK",
            "code": "090332",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Eyowo",
            "code": "50126",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FAST MICROFINANCE BANK",
            "code": "090179",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FBNQUEST MERCHANT BANK",
            "code": "911",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FCMB MOBILE",
            "code": "100031",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FCT MICROFINANCE BANK",
            "code": "090290",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FEDPOLY NASARAWA MICROFINANCE BANK",
            "code": "090298",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FETS",
            "code": "915",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FFS MICROFINANCE BANK",
            "code": "090153",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Fidelity bank",
            "code": "070",
            "ussdTemplate": "*770*AccountNumber*Amount#",
            "baseUssdCode": "*770#",
            "transferUssdTemplate": "*770*AccountNumber#"
        },
        {
            "name": "FIDELITY MOBILE",
            "code": "933",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FIDFUND MICROFINANCE Bank",
            "code": "090126",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FINATRUST MICROFINANCE BANK",
            "code": "090111",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FINCA MICROFINANCE BANK",
            "code": "090400",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FIRMUS MICROFINANCE BANK",
            "code": "090366",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "First bank",
            "code": "011",
            "ussdTemplate": "*894*Amount*AccountNumber#",
            "baseUssdCode": "*894#",
            "transferUssdTemplate": "*894*AccountNumber#"
        },
        {
            "name": "First City Monument Bank Plc",
            "code": "214",
            "ussdTemplate": "*329*Amount*AccountNumber#",
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FIRST GENERATION MORTGAGE BANK",
            "code": "070014",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FIRST OPTION MICROFINANCE BANK",
            "code": "090285",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FIRST TRUST MORTGAGE BANK PLC",
            "code": "910",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FIRSTMONIE WALLET",
            "code": "928",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FLUTTERWAVE TECHNOLOGY SOLUTIONS LIMITED",
            "code": "110002",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FORTIS MICROFINANCE BANK",
            "code": "948",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FORTIS MOBILE",
            "code": "930",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FSDH",
            "code": "400001",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FULLRANGE MICROFINANCE BANK",
            "code": "090145",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "FUTO MICROFINANCE BANK",
            "code": "090158",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "GATEWAY MORTGAGE BANK",
            "code": "070009",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Globus Bank",
            "code": "00103",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "GLORY MICROFINANCE BANK",
            "code": "090278",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "GOWANS MICROFINANCE BANK",
            "code": "090122",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "GREENBANK MICROFINANCE BANK",
            "code": "090178",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "GROOMING MICROFINANCE BANK",
            "code": "090195",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "GT MOBILE",
            "code": "923",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "GTBank",
            "code": "058",
            "ussdTemplate": "*737*2*Amount*AccountNumber#",
            "baseUssdCode": "*737#",
            "transferUssdTemplate": "*737*AccountNumber#"
        },
        {
            "name": "GTI MICROFINANCE BANK",
            "code": "090385",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Hackman Microfinance Bank",
            "code": "51251",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "HAGGAI MORTGAGE BANK LIMITED",
            "code": "070017",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Hasal Microfinance Bank",
            "code": "50383",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "HEADWAY MICROFINANCE BANK",
            "code": "090363",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "HEDONMARK",
            "code": "931",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Heritage bank",
            "code": "030",
            "ussdTemplate": "*322*030*AccountNumber*Amount#",
            "baseUssdCode": "*322#",
            "transferUssdTemplate": "*322*AccountNumber#"
        },
        {
            "name": "Ibile Microfinance Bank",
            "code": "51244",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "IKENNE MICROFINANCE BANK",
            "code": "090324",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "IKIRE MICROFINANCE BANK",
            "code": "090275",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "IKIRE MICROFINANCE BANK",
            "code": "090279",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ILISAN MICROFINANCE BANK",
            "code": "090370",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "IMO STATE MICROFINANCE BANK",
            "code": "090258",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "IMPERIAL HOMES MORTGAGE BANK",
            "code": "938",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Infinity MFB",
            "code": "50457",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "INFINITY TRUST MORTGAGE BANK",
            "code": "070016",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "INNOVECTIVES KESH",
            "code": "100029",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "INTELLFIN",
            "code": "941",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "INTERLAND MICROFINANCE BANK",
            "code": "090386",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "IRL MICROFINANCE BANK",
            "code": "090149",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ISALEOYO MICROFINANCE BANK",
            "code": "090377",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "JAIZ BANK",
            "code": "301",
            "ussdTemplate": "*389*301*AccountNumber*Amount#",
            "baseUssdCode": "*389#",
            "transferUssdTemplate": "*389*AccountNumber#"
        },
        {
            "name": "JUBILEE LIFE",
            "code": "906",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Keystone bank",
            "code": "082",
            "ussdTemplate": "*7111*Amount*AccountNumber#",
            "baseUssdCode": "*7111#",
            "transferUssdTemplate": "*7111*AccountNumber#"
        },
        {
            "name": "KONTAGORA MICROFINANCE BANK",
            "code": "090299",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Kuda Microfinance Bank",
            "code": "50211",
            "ussdTemplate": null,
            "baseUssdCode": "*5573#",
            "transferUssdTemplate": "*5573*AccountNumber#"
        },
        {
            "name": "LAGOS BUILDING AND INVESTMENT COMPANY",
            "code": "070012",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Lagos Building Investment Company Plc.",
            "code": "90052",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "LAPO MICROFINANCE BANK",
            "code": "090177",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "LAVENDER MICROFINANCE BANK",
            "code": "090271",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "LEGEND MICROFINANCE BANK",
            "code": "090372",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MAINSTREET MICROFINANCE BANK",
            "code": "090171",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MANNY MICROFINANCE BANK",
            "code": "090383",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MAYFAIR MICROFINANCE BANK",
            "code": "090321",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MAYFRESH MORTGAGE BANK",
            "code": "070019",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MEGAPRAISE MICROFINANCE BANK",
            "code": "090280",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MICROCRED MICROFINANCE BANK",
            "code": "090136",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MICROVIS MICROFINANCE BANK ",
            "code": "090113",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MINT-FINEX MFB",
            "code": "090281",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MOLUSI MICROFINANCE BANK",
            "code": "090362",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MONEY BOX",
            "code": "934",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MONEY TRUST MICROFINANCE BANK",
            "code": "963",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MOZFIN MICROFINANCE BANK",
            "code": "090392",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "MUTUAL TRUST MICROFINANCE BANK",
            "code": "090151",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NDIORAH MICROFINANCE BANK",
            "code": "090128",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NEPTUNE MICROFINANCE BANK",
            "code": "090329",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NEW DAWN MICROFINANCE BANK",
            "code": "090205",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NEW GOLDEN PASTURES MICROFINANCE BANK",
            "code": "090378",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NIGERIAN NAVY MICROFINANCE BANK ",
            "code": "090263",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NIRSAL NATIONAL MICROFINANCE BANK",
            "code": "090194",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NNEW WOMEN MICROFINANCE BANK",
            "code": "090283",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NOVA MERCHANT BANK",
            "code": "637",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NPF MICROFINANCE BANK",
            "code": "947",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NUTURE MICROFINANCE BANK",
            "code": "090364",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "NWANNEGADI MICROFINANCE BANK",
            "code": "090399",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "OCHE MICROFINANCE BANK",
            "code": "090333",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "OHAFIA MICROFINANCE BANK",
            "code": "090119",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "OKPOGA MICROFINANCE BANK",
            "code": "090161",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "OLABISI ONABANJO UNIVERSITY MICROFINANCE ",
            "code": "090272",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "OMIYE MICROFINANCE BANK",
            "code": "090295",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "OMOLUABI",
            "code": "950",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ONE FINANCE",
            "code": "940",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "OPAY",
            "code": "304",
            "ussdTemplate": null,
            "baseUssdCode": "",
            "transferUssdTemplate": null
        },
        {
            "name": "OPAY 2",
            "code": "305",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PAGA",
            "code": "100002",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PAGE MFBank",
            "code": "951",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PALMPAY",
            "code": "100033",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PARALLEX",
            "code": "907",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PARKWAY-READYCASH",
            "code": "917",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PATRICKGOLD MICROFINANCE BANK",
            "code": "090317",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PAYATTITUDE ONLINE",
            "code": "943",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PAYSTACK PAYMENTS LIMITED",
            "code": "110006",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PECANTRUST MICROFINANCE BANK",
            "code": "090137",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PENNYWISE MICROFINANCE BANK ",
            "code": "090196",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PERSONAL TRUST MICROFINANCE BANK",
            "code": "090135",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Petra Mircofinance Bank Plc",
            "code": "50746",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PILLAR MICROFINANCE BANK",
            "code": "090289",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PLATINUM MORTGAGE BANK",
            "code": "070013",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Polaris Bank",
            "code": "076",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "POLYUNWANA MICROFINANCE BANK",
            "code": "090296",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PRESTIGE MICROFINANCE BANK",
            "code": "090274",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Providus Bank",
            "code": "101",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "PURPLEMONEY MICROFINANCE BANK",
            "code": "090303",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "QUICKFUND MICROFINANCE BANK",
            "code": "090261",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "RAND MERCHANT BANK",
            "code": "502",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "REFUGE MORTGAGE BANK",
            "code": "070011",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "REGENT MICROFINANCE BANK",
            "code": "955",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "RENMONEY MICROFINANCE BANK ",
            "code": "090198",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "REPHIDIM MICROFINANCE BANK",
            "code": "090322",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "RICHWAY MICROFINANCE BANK",
            "code": "090132",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Rolez Microfinance Bank",
            "code": "50515",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ROYAL EXCHANGE MICROFINANCE BANK",
            "code": "090138",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Rubies Micro-finance Bank",
            "code": "125",
            "ussdTemplate": "090175",
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "RUBIES MICROFINANCE BANK",
            "code": "090175",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "SAFE HAVEN MICROFINANCE BANK",
            "code": "090286",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "SAFETRUST",
            "code": "909",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "SAGAMU MICROFINANCE BANK",
            "code": "966",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "SEED CAPITAL MICROFINANCE BANK",
            "code": "609",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "SEEDVEST MICROFINANCE BANK",
            "code": "090369",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Sparkle Microfinance Bank",
            "code": "51310",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "STANBIC IBTC @Ease WALLET",
            "code": "921",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Stanbic IBTC Bank Ltd.",
            "code": "221",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Standard Chartered Bank Nigeria Ltd.",
            "code": "068",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "STELLAS MICROFINANCE BANK ",
            "code": "090262",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Sterling bank",
            "code": "232",
            "ussdTemplate": "*822*5*Amount*AccountNumber#",
            "baseUssdCode": "*822#",
            "transferUssdTemplate": "*822*AccountNumber#"
        },
        {
            "name": "STERLING MOBILE",
            "code": "936",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "SULSPAP MICROFINANCE BANK",
            "code": "090305",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Suntrust Bank Nigeria Limited",
            "code": "100",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "TAGPAY",
            "code": "937",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Taj Bank",
            "code": "302",
            "ussdTemplate": null,
            "baseUssdCode": "*898#",
            "transferUssdTemplate": "*898*AccountNumber#"
        },
        {
            "name": "TCF MFB",
            "code": "51211",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "TEASY MOBILE",
            "code": "924",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "THINK FINANCE MICROFINANCE BANK",
            "code": "090373",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Titan Bank",
            "code": "102",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "TRIDENT MICROFINANCE BANK",
            "code": "090146",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "TRUST MICROFINANCE BANK",
            "code": "090327",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "TRUSTBANC J6 MICROFINANCE BANK LIMITED",
            "code": "090123",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "TRUSTFUND MICROFINANCE BANK ",
            "code": "090276",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "U & C MICROFINANCE BANK",
            "code": "090315",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "UNAAB MICROFINANCE BANK",
            "code": "090331",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Unical Microfinance Bank",
            "code": "50871",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Union bank",
            "code": "032",
            "ussdTemplate": "*826*2*Amount*AccountNumber#",
            "baseUssdCode": "*826#",
            "transferUssdTemplate": "*826*AccountNumber#"
        },
        {
            "name": "United Bank For Africa Plc",
            "code": "033",
            "ussdTemplate": "*919*4*AccountNumber*Amount#",
            "baseUssdCode": "*919#",
            "transferUssdTemplate": "*919*AccountNumber#"
        },
        {
            "name": "Unity Bank Plc",
            "code": "215",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "UNIVERSITY OF NIGERIA, NSUKKA MICROFINANCE BANK",
            "code": "090251",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "VENTURE GARDEN NIGERIA LIMITED",
            "code": "110009",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "VFD microfinance bank",
            "code": "566",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "VIRTUE MICROFINANCE BANK",
            "code": "090150",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "VISA MICROFINANCE BANK",
            "code": "090139",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "VT NETWORKS",
            "code": "926",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Wema bank",
            "code": "035",
            "ussdTemplate": "*945*AccountNumber*Amount#",
            "baseUssdCode": "*945#",
            "transferUssdTemplate": "*945*AccountNumber#"
        },
        {
            "name": "WETLAND  MICROFINANCE BANK",
            "code": "954",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "XSLNCE MICROFINANCE BANK",
            "code": "090124",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "YES MICROFINANCE BANK",
            "code": "090142",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "YOBE MICROFINANCE  BANK",
            "code": "090252",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Zenith bank",
            "code": "057",
            "ussdTemplate": "*966*Amount*AccountNumber#",
            "baseUssdCode": "*966#",
            "transferUssdTemplate": "*966*AccountNumber#"
        },
        {
            "name": "ZENITH MOBILE",
            "code": "932",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "ZINTERNET - KONGAPAY",
            "code": "939",
            "ussdTemplate": null,
            "baseUssdCode": null,
            "transferUssdTemplate": null
        }
    ]
}

Get Banks With USSD Short Code

This endpoint returns the list of all supported banks with their valid USSD short code.
GET
{{base_url}}/api/v1/sdk/transactions/banks

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

REQUEST
Copy button
curl -H "Accept: application/json" 
{{base_url}}/api/v1/sdk/transactions/banks
RESPONSE
Copy button
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": [
        {
            "name": "Access bank",
            "code": "044",
            "ussdTemplate": "*901*Amount*AccountNumber#",
            "baseUssdCode": "*901#",
            "transferUssdTemplate": "*901*AccountNumber#"
        },
        {
            "name": "Diamond bank",
            "code": "063",
            "ussdTemplate": "*710*777*AccountNumber*Amount#",
            "baseUssdCode": "*710#",
            "transferUssdTemplate": "*710*AccountNumber#"
        },
        {
            "name": "Fidelity bank",
            "code": "070",
            "ussdTemplate": "*770*AccountNumber*Amount#",
            "baseUssdCode": "*770#",
            "transferUssdTemplate": "*770*AccountNumber#"
        },
        {
            "name": "First bank",
            "code": "011",
            "ussdTemplate": "*894*Amount*AccountNumber#",
            "baseUssdCode": "*894#",
            "transferUssdTemplate": "*894*AccountNumber#"
        },
        {
            "name": "First City Monument Bank Plc",
            "code": "214",
            "ussdTemplate": "*329*Amount*AccountNumber#",
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "GTBank",
            "code": "058",
            "ussdTemplate": "*737*2*Amount*AccountNumber#",
            "baseUssdCode": "*737#",
            "transferUssdTemplate": "*737*AccountNumber#"
        },
        {
            "name": "Heritage bank",
            "code": "030",
            "ussdTemplate": "*322*030*AccountNumber*Amount#",
            "baseUssdCode": "*322#",
            "transferUssdTemplate": "*322*AccountNumber#"
        },
        {
            "name": "JAIZ BANK",
            "code": "301",
            "ussdTemplate": "*389*301*AccountNumber*Amount#",
            "baseUssdCode": "*389#",
            "transferUssdTemplate": "*389*AccountNumber#"
        },
        {
            "name": "Keystone bank",
            "code": "082",
            "ussdTemplate": "*7111*Amount*AccountNumber#",
            "baseUssdCode": "*7111#",
            "transferUssdTemplate": "*7111*AccountNumber#"
        },
        {
            "name": "Rubies Micro-finance Bank",
            "code": "125",
            "ussdTemplate": "090175",
            "baseUssdCode": null,
            "transferUssdTemplate": null
        },
        {
            "name": "Sterling bank",
            "code": "232",
            "ussdTemplate": "*822*5*Amount*AccountNumber#",
            "baseUssdCode": "*822#",
            "transferUssdTemplate": "*822*AccountNumber#"
        },
        {
            "name": "Union bank",
            "code": "032",
            "ussdTemplate": "*826*2*Amount*AccountNumber#",
            "baseUssdCode": "*826#",
            "transferUssdTemplate": "*826*AccountNumber#"
        },
        {
            "name": "United Bank For Africa Plc",
            "code": "033",
            "ussdTemplate": "*919*4*AccountNumber*Amount#",
            "baseUssdCode": "*919#",
            "transferUssdTemplate": "*919*AccountNumber#"
        },
        {
            "name": "Wema bank",
            "code": "035",
            "ussdTemplate": "*945*AccountNumber*Amount#",
            "baseUssdCode": "*945#",
            "transferUssdTemplate": "*945*AccountNumber#"
        },
        {
            "name": "Zenith bank",
            "code": "057",
            "ussdTemplate": "*966*Amount*AccountNumber#",
            "baseUssdCode": "*966#",
            "transferUssdTemplate": "*966*AccountNumber#"
        }
    ]
}

PayCode APIs

Create Paycode

The endpoint allows merchant create paycodes via API
POST
{{base_url}}/api/v1/paycode

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

beneficiaryName
String

The customer's name
amount
Float

The amount to be withdrawn
paycodeReference
String

A unique reference generated by the merchant
expiryDate
String

The expiry date for the paycode. The format is:YYYY-MM-DD HH:MM:SS
clientId
String

The merchant's APIKey
REQUEST
Copy button
{
    "beneficiaryName": "Marvelous Benji",
    "amount": 50,
    "paycodeReference": "ghehdekdkefkefjekjfejj",
    "expiryDate": "2023-02-19 11:00:26",
    "clientId":"MK_PROD_WTZLS10MX6"
}
RESPONSE
Copy button
{
    "responseMessage": "success",
    "responseCode": "M00",
    "responseBody": {
        "paycode": "11467409",
        "transactionReference": "MFY-39A78F78E6C341759ACA344297A8CF70",
        "paycodeReference": "ghehdekdkefkefjekjfejj",
        "beneficiaryName": "Marvelous Benji",
        "amount": 50,
        "fee": 100,
        "transactionStatus": "PENDING",
        "expiryDate": "2023-02-19 11:00:26",
        "createdOn": "2023-02-16T12:32:01.591+0000",
        "createdBy": "MK_PROD_WTZLS10MX6",
        "modifiedBy": "MK_PROD_WTZLS10MX6"
    }
}

Get Paycode

This endpoint returns paycode information for a given paycode reference
GET
{{base_url}}/api/v1/paycode/{{paycodeReference}}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

paycodeReference
String

The unique reference for the paycode
REQUEST
Copy button
curl -H "Accept: application/json" 
https://api.monnify.com/api/v1/paycode/ghehdekdkefkefjekjfejj
RESPONSE
Copy button
{
    "responseMessage": "success",
    "responseCode": "M00",
    "responseBody": {
        "paycode": "******09",
        "transactionReference": "MFY-39A78F78E6C341759ACA344297A8CF70",
        "paycodeReference": "ghehdekdkefkefjekjfejj",
        "beneficiaryName": "Marvelous Benji",
        "amount": 50,
        "fee": 100,
        "transactionStatus": "PENDING",
        "expiryDate": "2023-02-19 11:00:26",
        "createdOn": "2023-02-16T12:32:02.000+0000",
        "createdBy": "MK_PROD_WTZLS10MX6",
        "modifiedBy": "MK_PROD_WTZLS10MX6"
    }
}

Get Clear Paycode

This endpoint is necessary when the you want the paycode information returned unmasked
GET
{{base_url}}/api/v1/paycode/{{paycodeReference}}/authorize

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

paycodeReference
String

The unique reference for the paycode
REQUEST
Copy button
curl -H "Accept: application/json" 
https://api.monnify.com/api/v1/paycode/ghehdekdkefkefjekjfejj/authorize
RESPONSE
Copy button
{
    "responseMessage": "success",
    "responseCode": "M00",
    "responseBody": {
        "paycode": "11467409",
        "transactionReference": "MFY-39A78F78E6C341759ACA344297A8CF70",
        "paycodeReference": "ghehdekdkefkefjekjfejj",
        "beneficiaryName": "Marvelous Benji",
        "amount": 50,
        "fee": 100,
        "transactionStatus": "EXPIRED",
        "expiryDate": "2023-02-19 11:00:26",
        "createdOn": "2023-02-16T12:32:02.000+0000",
        "createdBy": "MK_PROD_WTZLS10MX6",
        "modifiedBy": "SYSTEM"
    }
}

Fetch Paycodes

This endpoint returns a history of generated Paycodes over a period of time using some search criteria.
GET
{{base_url}}/api/v1/paycode

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

transactionReference
String

The Monnify transactionReference
beneficiaryName
String

The customer name
transactionStatus
String

The status of the paycode
from
Integer

A unix timestamp for the start date being considered
to
Integer

A unix timestamp for the end date being considered
REQUEST
Copy button
curl -H "Accept: application/json" 
https://api.monnify.com/api/v1/paycode?transactionReference=&beneficiaryName=Marvelous Benji&transactionStatus=EXPIRED&from=1676131853000&to=1676823053000
RESPONSE
Copy button
{
    "responseMessage": "success",
    "responseCode": "M00",
    "responseBody": {
        "content": [
            {
                "paycode": "******09",
                "transactionReference": "MFY-39A78F78E6C341759ACA344297A8CF70",
                "paycodeReference": "ghehdekdkefkefjekjfejj",
                "beneficiaryName": "Marvelous Benji",
                "amount": 50,
                "fee": 100,
                "transactionStatus": "EXPIRED",
                "expiryDate": "2023-02-19 11:00:26",
                "createdOn": "2023-02-16T12:32:02.000+0000",
                "createdBy": "MK_PROD_WTZLS10MX6",
                "modifiedBy": "SYSTEM"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageSize": 50,
            "pageNumber": 0,
            "offset": 0,
            "unpaged": false,
            "paged": true
        },
        "last": true,
        "totalPages": 1,
        "totalElements": 1,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "first": true,
        "numberOfElements": 1,
        "size": 50,
        "number": 0,
        "empty": false
    }
}

Delete Paycode

This endpoint cancels or invalidates a generated Paycode.
DELETE
{{base_url}}/api/v1/paycode/{{paycodeReference}}

Headers

Authorization
bearer
Authorize this API call by generating a token here , include the Token in the request header.

Body Params

paycodeReference
String

The unique reference for the paycode
REQUEST
Copy button
curl --header "Content-Type: application/json" 
 --request POST 
 --data '{}' 
 https://api.monnify.com/api/v1/paycode/ur74904jhke993u93o
RESPONSE
Copy button
{
    "responseMessage": "success",
    "responseCode": "M00",
    "responseBody": {
        "paycode": "******22",
        "transactionReference": "MFY-1695D2BF32A34227ABDF77466D8C45A0",
        "paycodeReference": "ur74904jhke993u93o",
        "beneficiaryName": "Marvelous Benji",
        "amount": 30,
        "fee": 100,
        "transactionStatus": "CANCELLED",
        "expiryDate": "2023-02-28 11:00:26",
        "createdOn": "2023-02-19T16:05:42.000+0000",
        "cancelDate": "2023-02-20T11:28:56.365+0000",
        "createdBy": "MK_PROD_WTZLS10MX6",
        "modifiedBy": "MK_PROD_WTZLS10MX6"
    }
}
Was this page helpful? Tell us what you think..

Got Questions

Reach out to us at [email protected] if you have any questions as regards integrating with the Monnify API.

Monnify Tutorial Videos

Check out Our Youtube channel for tutorials on how to integrate the Monnify API.

Join Our Slack Community

Click here to join the Monnify Slack community.
Copyright © 2024 Monnify
Terms of Service Privacy Policy