Disburse Funds

Disburse funds to a specific account.

POSThttps://api.sandbox.centiiv.com/api/v1/baas/disburse

Authorization

bearer

Body

application/json

amount*number

Amount to be disbursed in the currency specified (last two digits represent KOBO)

Example: 100

currency*string

Currency of the amount to be disbursed

Example: "NGN"

recipientAccountNumber*string

Account number of the recipient bank account

Example: "1234567890"

recipientBankCode*string

Bank code of the recipient bank account

Example: "123456"

description*string

Description of the disbursement

Example: "Description of the disbursement"

Response

200400401

The request has been successful.

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('https://api.sandbox.centiiv.com/api/v1/baas/disburse', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "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": {
    "transactionId": "123456789",
    "message": "success"
  }
}