Update Fixed Deposit Account

put

https://api.cloud.mbanq.com/v1/fixeddepositaccounts/{fixedDepositAccountId}

Use this API to create a new Fixed Deposit Account for a customer. You need to specify the relevant account details and deposit parameters.

Behaviour: A successful response from this API indicates that the Fixed Deposit Account has been created successfully, with all specified terms and conditions applied.

Path Params

fixedDepositAccountId

integer

required

Defaults to 13400

The Id associated with the fixed deposit account
Example: 13400

Body Params

clientId

integer

The unique identifier of the client updating the fixed deposit account.
Example: 5162

productId

integer

The ID of the product associated with the fixed deposit account.
Example: 609

submittedOnDate

string

The date the update request was submitted.
Format: dd MMMM yyyy
Example: 22 October 2024

nominalAnnualInterestRate

float

The nominal annual interest rate for the fixed deposit account.
Example: 2

depositAmount

string

The amount to be deposited for the fixed deposit.
Example: 10001

depositPeriod

integer

The duration of the deposit period.
Example: 1

withHoldTax

boolean

A flag indicating whether to withhold tax on the deposit.
Example: false

interestCompoundingPeriodType

integer

The type of interest compounding period for the fixed deposit account.
Example: 4

interestPostingPeriodType

integer

The type of interest posting period for the fixed deposit account.
Example: 7

interestCalculationType

integer

The type of interest calculation method for the fixed deposit account.
Example: 2

interestCalculationDaysInYearType

integer

The number of days considered in a year for interest calculation.
Example: 365

depositPeriodFrequencyId

integer

The frequency identifier for the deposit period.
Example: 3

preClosurePenalApplicable

boolean

A flag indicating if a penalty applies for pre-closure of the fixed deposit.
Example: false

minDepositTerm

integer

The minimum deposit term required for the fixed deposit.
Example: 3

minDepositTermTypeId

integer

The identifier for the minimum deposit term type.
Example: 2

transferInterestToSavings

string

Indicates whether interest earned should be transferred to savings.
Example: false

locale

string

The locale setting for formatting dates and numbers.
Example: en

dateFormat

string

The date format used in the request.
Example: dd MMMM yyyy

monthDayFormat

string

The format for representing the month and day.
Example: dd MMM

charges

array of objects

A list of charges associated with the fixed deposit account.

charges

charts

array of objects

A list of interest rate charts associated with the fixed deposit account.

charts

Headers

tenantId

string

required

The ID of your banking instance visible in the MBANQ Console.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The fixed deposit account is updated successfully.

400The request failed validation. Common causes include missing required fields or invalid deposit terms.

401Authentication credentials were missing or incorrect.

403The authenticated user does not have permission to update fixed deposit accounts.

404The request fails if the specified account does not exist.