POST
Create Fixed Deposit
Lock a specific amount of funds for a specified duration to earn interest.
POST/v2/fixed-deposits/create
Use this endpoint to book a fixed deposit investment. The specified principal amount will be immediately debited from the customer's source account and locked in a high-yield deposit account for the chosen tenor.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | YES | Bearer token containing your secret API key. |
Content-Type | YES | Must be set to application/json. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_number | string | YES | The 10-digit source account from which the principal will be debited. |
amount | number | YES | The principal investment amount. |
tenor | integer | YES | The duration of the investment in days (e.g., 30, 60, 90, 365). |
interest_rate | number | YES | The agreed annual interest rate percentage (e.g., 10.5). |
auto_rollover | boolean | NO | Whether to automatically reinvest the principal and interest upon maturity. Defaults to false. |
Example Request
cURL
curl -X POST "https://sandbox.hexcore.io/v2/fixed-deposits/create" \-H "Authorization: Bearer sk_test_your_secret_key" \-H "Content-Type: application/json" \-d '{ "account_number": "1234567890", "amount": 1000000, "tenor": 90, "interest_rate": 12.0, "auto_rollover": true }'Example Response
JSON (201 Created)
{"status": true,"message": "Fixed deposit booked successfully","data": {"deposit_id": "fd_p2q3r4s5t6","status": "ACTIVE","principal": 1000000.00,"expected_interest": 29589.04,"maturity_date": "2026-07-31T00:00:00Z","auto_rollover": true,"created_at": "2026-05-02T12:00:00Z"} }