Initiating Bulk Transfers
On Monnify, you can initiate bulk transfers by making a POST request to the Initiate Transfer (Bulk) API. Alternatively, you can perform a bulk transfer directly from your Monnify dashboard. Simply click on Bulk Transfer, download the provided template, and fill in the necessary details. 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 Bulk Transfers
For bulk transfers that involve authorization before the transaction is completed, you will need to make a POST request to the Authorize Transfer (Bulk) API.
Get Bulk Transfer Status
To get the transaction status for bulk transfers, you make a GET request to the Get Transaction Status for Bulk Transactions API and provide the batch transaction reference for the batch transaction for which you require the status.
Get Bulk Transfer Transactions
Monnify allows you to get a paginated list of all transactions in a bulk transfer batch and their statuses. To get details of a bulk transaction, you make a GET request to the Get Bulk Transfers Transactions API.
Get a List of All Transfers
Monnify allows you to get a list of all bulk transfers made from your platform. You can provide the number of pages and page size you require. To get a list of all bulk transfers, make a GET request to the Get All Bulk 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.
Field Reference
| Field | Description |
|---|---|
| pageNo | A number specifying what page of transfers to be retrieved. Minimum value is 0, and defaults to 0 if not specified. |
| pageSize | A number specifying size of each transfer page. Minimum value is 1, and defaults to 10 if not specified. |
| amount | The amount to be disbursed to the beneficiary |
| reference | The unique reference for a transaction. Also to be specified for each transaction in a bulk transaction request. |
| batchReference | The unique reference for the entire batch of transactions being sent. |
| narration | The Narration for the transactions being processed. |
| destinationBankCode | The 3 digit bank code representing the destination bank |
| destinationBankName | The name of the destination bank |
| destinationAccountNumber | The beneficiary account number. |
| destinationAccountName | The name tied to the account in the destination bank |
| currency | The currency of the transaction being initialized. "NGN" |
| status | The status of a single transfer request. (SUCCESS, FAILED, PENDING, OTP_EMAIL_DISPATCH_FAILED, PENDING_AUTHORIZATION) |
| batchStatus | The status of the processing of the entire Batch. (FAILED_ON_ACCOUNTS_VALIDATION, OTP_EMAIL_DISPATCH_FAILED, PENDING, PENDING_AUTHORIZATION, AWAITING_PROCESSING, IN_PROGRESS ,COMPLETED) |
| totalTransactions | The total number of transactions in the batch. |
| totalAmount | The total amount deducted for all the transactions in the batch |
| fee | The total transaction fees deducted for a single transaction |
| totalFee | The total transaction fees deducted for all the transactions in the batch. |
| failedCount | Total number of failed transactions in the batch |
| successfulCount | Total number of successful transactions in the batch |
| pendingCount | Total number of pending transactions in the batch |
Got Questions
Monnify Tutorial Videos
