Initiate Transfer (Single) API

The Transfers API allows you automate sending money to your customers.

Good to know: Authorize this API call by generating a token here , include the Token in the request header.

Initiate Transfers

send money to your customers

Single Transfer

POST{{baseUrl}}/disbursements/single

Body

application/json

amountnumber

Example: 30

referencestring

Example: "RHTY234591"

narrationstring

Example: "Rootshive Withdrawal"

destinationBankCodestring

Example: "058"

destinationAccountNumberstring

Example: "0449368915"

UserTeirAstring

Example: ""

UserTeirBstring

Example: ""

Response

200

Successful Response

Body

application/json

statusstring

Example: "200"

servicestring

Example: "disbursement"

loggedboolean

Example: true

requestSuccessfulboolean

Example: true

responseMessagestring

Example: "success"

dataobject

Request

JavaScriptCurlPython

const response = await fetch('{{baseUrl}}/disbursements/single', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "status": "200",
  "service": "disbursement",
  "logged": true,
  "requestSuccessful": true,
  "responseMessage": "success",
  "data": {
    "message": "Funds Processed to",
    "amount": 30,
    "reference": "RHTY234591",
    "status": "SUCCESS",
    "dateCreated": "2024-03-13T00:04:20.264+0000",
    "totalFee": "30",
    "destinationAccountName": "",
    "destinationBankName": "GTBank",
    "destinationAccountNumber": "0449368915",
    "destinationBankCode": "058"
  }
}