...
| Code Block | ||
|---|---|---|
| ||
{
"requestSuccessful": true,
"responseMessage": "success",
"responseCode": "0",
"responseBody": {
"amount": 10020,
"reference": "ben900gg00-hhooooji",
"status": "FAILED",
"dateCreated": "2023-02-28T09:39:03.936+0000",
"totalFee": 0.00,
"destinationAccountName": "Marvelous Benji",
"destinationBankName": "Zenith bank",
"destinationAccountNumber": "2085886393",
"destinationBankCode": "057",
"comment": "You do not have sufficient balance to process this request. Please fund your account and try again."
}
} |
...
Processing Transfers Asynchronously
You can easily process transfer to your users asynchronously (by simply setting the “async” parameter to true in your request body) so that your server doesn’t have to wait for Monnify to get the final status of the transfer. When transfers are processed asynchronously, a pending status is returned in the response body, so we recommend that you have a disbursement webhook setup on your end(see here for setup; Webhooks) to receive the final status of the transfer. However you can also requery the transfer to check its status(Transfer Status).
Sample Request
| Code Block |
|---|
{
"amount": 20,
"reference":"a78c632b93",
"narration":"Test01",
"destinationBankCode": "057",
"destinationAccountNumber": "2085096393",
"currency": "NGN",
"sourceAccountNumber": "8016472829",
"destinationAccountName": "Marvelous Benji",
"async":true
} |
Sample Response
| Code Block |
|---|
{
"requestSuccessful": true,
"responseMessage": "success",
"responseCode": "0",
"responseBody": {
"amount": 20,
"reference": "a78c632b93",
"status": "PENDING",
"dateCreated": "2023-03-17T14: 16: 45.499+0000",
"totalFee": 0.00,
"destinationAccountName": "Marvelous Benji",
"destinationBankName": "Zenith bank",
"destinationAccountNumber": "2085886393",
"destinationBankCode": "057"
}
} |
Bulk Transfers
To initiate a bulk transfer, you will need to send a request to the endpoint below:
...