Single Transfers
To initiate a single transfer, you will need to send a request to the endpoint below:
...
| Code Block |
|---|
| language | js |
|---|
| theme | Midnight |
|---|
| title | Initiate Transfer (Single) Response 2FA Enabled |
|---|
|
{
"requestSuccessful": true,
"responseMessage": "success",
"responseCode": "0",
"responseBody": {
"amount": 10,
"reference": "reference12934",
"status": "PENDING_AUTHORIZATION",
"dateCreated": "13/11/2019 08:48:32 PM"
}
} |
Bulk Transfers
To initiate a bulk transfer, you will need to send a request to the endpoint below:
...
| Code Block |
|---|
| language | js |
|---|
| theme | Midnight |
|---|
| title | Initiate Transfer (Bulk) Response 2FA Enabled |
|---|
|
{
"requestSuccessful": true,
"responseMessage": "success",
"responseCode": "0",
"responseBody": {
"totalAmount": 2108.48,
"totalFee": 8.48,
"batchReference": "batch-1573684027157",
"batchStatus": "PENDING_AUTHORIZATION",
"totalTransactions": 3,
"dateCreated": "13/11/2019 10:27:25 PM"
}
} |
Field Reference
(M) indicates fields that are mandatory in the request body. (m) Indicates fields that are mandatory only if the parent object is not empty.
| Field | Description |
|---|
| amount (M) | The amount to be disbursed to the beneficiary |
| reference (M) | The unique reference for a transaction. Also to be specified for each transaction in a bulk transaction request. |
| batchReference (M) | The unique reference for the entire batch of transactions being sent. |
| narration (M) | The Narration for the transactions being processed |
| bankCode (M) | The 3 digit bank code representing the destination bank |
| accountNumber (M) | The beneficiary account number |
| currency (M) | The currency of the transaction being initialized. "NGN" |
| walletId (M) | Unique reference to identify the wallet to be debited |
| onValidationFailure | Used to determine how Monnify should handle failed transaction validations in a batch. The two options are BREAK & CONTINUE. Use Break to tell Monnify to reject the entire batch and use CONTINUE to tell Monnify to process the valid transactions. |
| notificationInterval | Used to determine how often Monnify should notify the merchant of progress when processing a batch transfer. The options are 10, 20, 50 and 100 and they represent percentages. i.e. 20 means notify me at intervals of 20% (20%, 40%, 60%, 80% ,100%). |
| 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 |
| totalFee | The total transaction fees deducted for all the transactions in the batch. |
Related Articles
| Filter by label (Content by label) |
|---|
| showLabels | false |
|---|
| showSpace | false |
|---|
| cql | label in ("authentication","disbursements") |
|---|
|
...