Disburse Funds

Disburse funds to a specific account.

NOTE: The amount is in KOBO, meaning to transfer NGN 1,000 you need to fill 100000.

POSThttp://localhost:3002/api/v1/banking/disburse

Authorization

bearer

Body

application/json

disbursements*array of DisburseFundsRequest (object)

Array of disbursement requests for bulk disbursement

Response

200400401

The request has been successful.

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('http://localhost:3002/api/v1/banking/disburse', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "disbursements": [
        {
          "amount": 100,
          "currency": "NGN",
          "recipientAccountNumber": "1234567890",
          "recipientBankCode": "123456",
          "description": "Description of the disbursement"
        }
      ]
    }),
});
const data = await response.json();

Response

200400401

{
  "success": false,
  "message": "The request has been successful.",
  "statusCode": 200,
  "code": "REQUEST_SUCCESSFUL",
  "data": {
    "batchId": "123456789",
    "entries": [
      {
        "entryId": "123456789",
        "reference": "123456789"
      }
    ],
    "message": "success"
  }
}