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

Body

amountnumberOptionalExample: 30

referencestringOptionalExample: RHTY234591

narrationstringOptionalExample: Rootshive Withdrawal

destinationBankCodestringOptionalExample: 058

destinationAccountNumberstringOptionalExample: 0449368915

UserTeirAstringOptional

UserTeirBstringOptional

Responses

200

Successful Response

application/json

post

HTTPcURLJavaScriptPython

POST /disbursements/single HTTP/1.1
Host: {{baseUrl}}
Content-Type: application/json
Accept: */*
Content-Length: 171

{
  "amount": 30,
  "reference": "RHTY234591",
  "narration": "Rootshive Withdrawal",
  "destinationBankCode": "058",
  "destinationAccountNumber": "0449368915",
  "UserTeirA": "",
  "UserTeirB": ""
}

200

Successful Response

{
  "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"
  }
}