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.
For transfers that involve authorization before the transaction is completed, you will need to make a POST request to the Authorize Transfer (Single) API.
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.
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.
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.
You can get a list of all your disbursement transactions done on Monnify by making a GET request to the Search Disbursement Transactions API.
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.
You can get the available balance in your monnify wallet by making a GET request to the Wallet Balance API.
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. |
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 |