POST
Liquidate Fixed Deposit
Withdraw funds from an active fixed deposit, either partially or fully.
POST/v2/fixed-deposits/{deposit_id}/liquidate
Use this endpoint to break a fixed deposit and return the funds to the customer's source account. Note that liquidating before the maturity date may result in a penal charge deducted from the accrued interest based on your configured banking rules.
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 |
|---|---|---|---|
deposit_id | string | YES | The unique ID of the fixed deposit investment. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
liquidation_type | string | YES | Either FULL or PARTIAL. |
amount | number | NO | Required only if liquidation_type is PARTIAL. The specific amount to withdraw. |
Example Request
cURL
curl -X POST "https://sandbox.hexcore.io/v2/fixed-deposits/fd_p2q3r4s5t6/liquidate" \-H "Authorization: Bearer sk_test_your_secret_key" \-H "Content-Type: application/json" \-d '{ "liquidation_type": "FULL" }'Example Response
JSON (200 OK)
{"status": true,"message": "Fixed deposit liquidated successfully","data": {"deposit_id": "fd_p2q3r4s5t6","status": "LIQUIDATED","principal_returned": 1000000.00,"interest_paid": 15243.50,"penal_charge": 5000.00,"total_credited": 1010243.50,"credited_account": "1234567890","liquidated_at": "2026-05-02T13:00:00Z"} }