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

amountnumberoptional

Example: 30

referencestringoptional

Example: RHTY234591

narrationstringoptional

Example: Rootshive Withdrawal

destinationBankCodestringoptional

Example: 058

destinationAccountNumberstringoptional

Example: 0449368915

UserTeirAstringoptional

UserTeirBstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '{{baseUrl}}/disbursements/single' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 30,
    "reference": "RHTY234591",
    "narration": "Rootshive Withdrawal",
    "destinationBankCode": "058",
    "destinationAccountNumber": "0449368915",
    "UserTeirA": "",
    "UserTeirB": ""
  }'

200

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

Successful Response