Initiate Transfer

Initiate transfer

POST /transfer/initiate

This endpoint is used to initiate the transfer of funds

Headers

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

Body

Name	Type	Description
amount	number	Amout to be sent
bank_code	string	Receiver's bank code
account_number	string	Receiver's bank account number
reference	string	Randomly generated string

Response

200

{
  "message": "Transaction initiated successfully",
  "data": {
    "reference": "23437f26-8f83-4e2e-bd26-e0136c050251",
    "merchant_reference": "09q7184e-e28e-492d-b0bc-218148626aa8",
    "type": "debit",
    "amount": 1000,
    "status": "pending",
    "fee": "102",
    "created_at": "2025-03-02T10:22:31.000000Z"
  }
}

400

{
    "error": "Invalid request"
}