Transfer

Initiate a secure transfer of funds between bank accounts.

Create a new user

POST /v1/transfer

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
beneficiaryBankCode	number	Receivers Bank code
beneficiaryAccountNumber	number	Receivers Account number
narration	string	Transfer Description
amount	number	Amount
reference	string	Transaction reference (optional) Auto create if not provided

Response

200

{
    "success": true,
    "message": "Your transfer has been processed, Test Bank will receive your transfer in less than 5 minutes",
    "data": {
        "netAmount": 110,
        "details": {},
        "destinationAccountNumber": "",
        "virtualAccount": "",
        "createdAt": 1717094000706,
        "updatedAt": 1717094000706,
        "id": 8,
        "sourceAccountName": "Garo Enterprise",
        "sourceAccountNumber": "0001479098",
        "sourceBankCode": "000023",
        "sourceBankName": "BellMonie",
        "amount": 100,
        "charge": 10,
        "userId": 1,
        "businessId": 1,
        "completedAt": 1717094000705,
        "sessionId": "999999231115104838645541436147",
        "type": "debit",
        "description": "Transfer to Test Account",
        "transactionTypeName": "bank_transfer",
        "status": "pending",
        "reference": "123XY3Z900000000",
        "channel": "bellbank",
        "destinationAccountName": "Test Account",
        "destinationBankCode": "100004",
        "destinationBankName": "Test Bank",
        "category": "bank_transfer"
    },
    "beneficiary": {}
}

400

{
  "success": false,
  "message": "Request Unsuccessful",
  "data": null
}