Initiate Disbursement

Initiate disbursement

POST /initiate-disbursement

This endpoint is used to initiate the transfer of funds

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>
X-Biz-Number	<x-biz-number>

Body

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

Response

200

{
    "status": "success",
    "message": "Transaction initiated successfully",
    "data": {
        "reference": "58886c93-7fb3-413f-a5a8-9c2e16b2dec5",
        "type": "debit",
        "type_description": "Lending payout",
        "amount": 10200,
        "fee": "20.00",
        "status": "pending",
        "payload": null,
        "narration": "Lending payout",
        "initiated_at": null,
        "paid_at": null,
        "activities": [
            {
                "message": "Transaction Pending",
                "action": "pending",
                "meta": null,
                "user_agent": "GuzzleHttp/7",
                "device_os": "0",
                "device_name": "0"
            }
        ]
    },
    "errors": null
}

400

{
  "error": "Invalid request"
}