POST
Loan Disbursement
Disburse the funds of an approved loan into a customer's account.
POST/v2/loans/{loan_id}/disburse
Once a loan is marked as APPROVED, use this endpoint to seamlessly move the principal funds from your core ledger to the borrower's target account. The loan status will change to ACTIVE.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | YES | Bearer token containing your secret API key. |
Content-Type | YES | Must be set to application/json. |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
loan_id | string | YES | The unique ID of the approved loan. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_number | string | YES | The destination account number where the loan funds will be credited. |
Example Request
cURL
curl -X POST "https://sandbox.hexcore.io/v2/loans/ln_a1b2c3d4e5f6/disburse" \-H "Authorization: Bearer sk_test_your_secret_key" \-H "Content-Type: application/json" \-d '{ "account_number": "1234567890" }'Example Response
JSON (200 OK)
{"status": true,"message": "Loan disbursed successfully","data": {"loan_id": "ln_a1b2c3d4e5f6","status": "ACTIVE","disbursed_amount": 500000.00,"destination_account": "1234567890","transaction_reference": "trx_09f3j2l12k3m"} }