Initiating Single Transfers

To make transfers using the Monnify transfer APIs, you have to initiate a transfer. You can initiate single transfers by making a POST request to the Initiate Transfer (Single) API. Once, a response is gotten, there are two possible responses that can be gotten.

Response for when Two Factor Authentication (2FA) is enabled, and
Response for when Two Factor Authentication (2FA) is not enabled.

Authorizing Single Transfers

For transfers that involve authorization before the transaction is completed, you will need to make a POST request to the Authorize Transfer (Single) API.

Asynchronous Transfers

You can easily process transfer to your users asynchronously so that your server doesn’t have to wait for Monnify to get the final status of the transfer. This can be done by setting an “async” parameter to true in your request to the Asynchronous Transfer API.

Get Transfer Status

To get the transfer status for single transfers, you make a GET request to the Single Transfer Status and provide the transaction reference for the transaction for which you require the status.

Get a List of All Transfers

Monnify allows you to get a list of all single transfers made from your platform. You can provide the number of pages and page size you require. To get a list of all single transfers, you make a GET request to the Monnify Get All Single Transactions API.

Searching for Disbursement Transactions

You can get a list of all your disbursement transactions done on Monnify by making a GET request to the Search Disbursement Transactions API.

Resending OTP

You can resend OTPs to your customers in scenarios where they don’t get the previous ones sent or in cases of expiration. See the Resend OTP API for more details.

Getting Wallet Balance

You can get the available balance in your monnify wallet by making a GET request to the Wallet Balance API.

Transaction Status Description

Status	Description
PENDING, AWAITING_PROCESSING and IN_PROGRESS	This response is gotten when transaction is still pending.
PENDING_AUTHORIZATION	This response is gotten if the merchant has 2FA enabled and authorization is needed for the disbursement to be initiated.
OTP_EMAIL_DISPATCH_FAILED	This is very rare, but it happens when Monnify failed to send the OTP.
SUCCESS and COMPLETED	This response is gotten if the disbursement was successful.
REVERSED	This response is gotten if disbursement was reversed.
FAILED	This response is gotten when disbursement was not successful.
EXPIRED	A batch transaction has an expiry time. Once the transaction time has elapsed, you will get an EXPIRED response.

Sample Error Messages

Error Message	Meaning	Action
99	An unexpected error occurred while processing transaction	Re-query to ascertain transaction status
D01	Something went wrong and the transaction could not be processed. Actual error message will be displayed in 'responseMessage' field	Treat as Failed
D01	Something went wrong and transaction could not be processed. Actual error message will be displayed in 'responseMessage' field.	Treat as Failed
D02	Transaction does not exist.	Treat as Failed
D03	Invalid account details supplied.	Treat as Failed
D04	Insufficient wallet balance	Treat as Failed
D05	Supplied reference already exists.The reference you are using has already been used by you	Retry with unique reference
D06	Unauthorized Request.This would imply that only whitelisted IP addresses can initiate the request	KIndly send a mail to [email protected] to whitelist your server IP
D07	Duplicate Request. This response is gotten when a transfer request is made to the same destination account with the same transaction amount within a 2 minutes interval.	Retry after 2 minutes or send a mail to [email protected] to disable it for your integration
Invalid destination account number	Supplied account number did not pass name enquiry	Customer should provide valid account number
Dormant beneficiary account	Customer account is dormant	Customer should engage its bank
Beneficiary account name mismatch	Beneficiary account name mismatch	Customer should reconfirm supplied account details
Unknown destination bank code	Destination bank code does not exist on Monnify	Kindly reconfirm the destinationBankCode supplied in the request
Transaction timed out while waiting for destination bank	Timeout from customer’s bank	Kindly requery transaction
Invalid amount	Transaction amount is invalid	Kindly reconfirm the transaction amount
Delayed processing from NIP	Delay from NIP	Kindly requery
Post No Credit restriction on beneficiary account	Customer account has PND on it, so cannot be credited	Customer should engage his bank
Beneficiary bank not available	Customer's bank is unavailable	Kindly requery transaction
Invalid session ID	Invalid session ID	Kindly requery transaction
Rejected by destination institution	Credit was rejected by detsination bank	Customer should engage his bank to ascertain rejection reason
Suspected fraud	Customer's account under investigation for fraud	Customer should engage his bank
Invalid response code from beneficiary Instituition	Unknown response code from beneficiary bank	Kindly requery transaction
System malfunction by destination institution	System malfunction by destination institution	Kindly requery transaction
Beneficary account limit exceeded	Customer account is a low kyc account	Customer should engage his bank to upgrade his account
Sender not permitted to credit beneficiary	Customer's account cannot be credited due to account restriction	Customer should engage his bank to ascertain reason for restriction
Unable to complete the transaction at this time	Beneficiary bank or Provider service is currently unavailable	Kindly requery transaction
Transaction could not be processed at this time. Please try again	Provider service is currently unavailable	Kindly requery transaction
Transaction processing in progress	Transaction still processing	Kindly requery transaction
Account number could not be validated	Name enquiry failed on account number due to invalid account or destination bank unavailability	Kindly reconfirm the destination account details and bank availability
Transaction Failed	Transaction has failed due to system or provider related error	Kindly engage the Monnify support
System Malfunction - Internal service failure	Transaction has failed due to internal error	Kindly engage the Monnify support
System Malfunction - Transaction transmission unsuccessful	Transaction has failed due to system malfunction	Kindly engage the Monnify support
Processor Malfunction - Transaction transmission failed	This is an error in transaction processing with NIBBS	Kindly requery transaction