Skip to main content

Previewloanaccountschedule

Payload structure to preview loan account schedule.

disbursementDetails object

The the disbursement details it holds the information related to the disbursement details as disbursement date, first repayment date, disbursement fees.

expectedDisbursementDatestring<date-time>

The date of the expected disbursement.Stored as Organization Time.

Example: 2016-09-06T13:37:50+03:00
fees object[]

List of fees that should be applied at the disbursement time.

  • Array [
  • amountnumber

    The amount of the custom fee.

    encodedKeystring

    The encoded key of the custom predefined fee, auto generated, unique.

    percentagenumber

    The percentage of the custom fee.

    predefinedFeeEncodedKeystring

    The encoded key of the predefined fee

  • ]
  • firstRepaymentDatestring<date-time>

    The date of the expected first repayment. Stored as Organization Time.

    Example: 2016-09-06T13:37:50+03:00
    feeRateSettings object

    Defines fees settings for schedule preview.

    feeRatenumber

    The fee rate. Represents the fee rate for the loan account.

    interestCommissionnumber

    The value of the interest booked by the organization from the accounts funded by investors. Null if the funds are not enable

    interestSettings object

    The interest settings, holds all the properties regarding interests for the loan account.

    accountInterestRateSettings object[]

    The interest settings details for schedule preview.

  • Array [
  • encodedKeystring

    The encoded key of the interest rate settings, auto generated, unique

    indexSourceKeystring

    Index rate source key.

    interestRatenumber

    Interest rate value.

    interestRateCeilingValuenumber

    Maximum value allowed for index based interest rate. Valid only for index interest rate.

    interestRateFloorValuenumber

    Minimum value allowed for index based interest rate. Valid only for index interest rate.

    interestRateReviewCountinteger<int32>

    Interest rate review frequency unit count. Valid only for index interest rate.

    interestRateReviewUnitstring

    The interest rate review unit values. Shows how often is index interest rate reviewed.

    Possible values: [DAYS, WEEKS, MONTHS]

    interestRateSourcestringrequired

    The interest rate review unit values. Shows how often is index interest rate reviewed.

    Possible values: [FIXED_INTEREST_RATE, INDEX_INTEREST_RATE]

    interestSpreadnumber

    Interest spread value.

    validFromstring<date-time>required

    Date since an interest rate is valid

    Example: 2016-09-06T13:37:50+03:00
  • ]
  • interestRatenumber

    The interest rate. Represents the interest rate for the loan account. The interest on loans is accrued on a daily basis, which allows charging the clients only for the days they actually used the loan amount.

    interestSpreadnumber

    Interest to be added to active organization index interest rate in order to find out actual interest rate

    loanAmountnumberrequired

    The loan amount

    plannedInstallmentFees object[]

    A list with planned manual fees to be applied on the installments for schedule preview.

  • Array [
  • amountnumber

    The amount of the planned fee.

    applyOnDatestring<date-time>

    The date when a planned fee should be applied, overriding installment's due date. It should match the interval of the installment. If it belong to first installment, it should be between disbursement date and installment due date.

    Example: 2016-09-06T13:37:50+03:00
    encodedKeystring

    The encoded key of the planned installment fee, auto generated, unique.

    installmentKeystring

    The encoded key of the installment on which the predefined fee is planned.

    installmentNumberinteger<int32>

    The number of the installment on which the predefined fee is planned. It is used only in the case when fees are created at the same time with the loan account creation or during preview schedule, before account creation, otherwise this should be empty and installmentKey will be used to identify an installment.

    predefinedFeeKeystringrequired

    The encoded key of the predefined fee which is planned.

  • ]
  • productTypeKeystringrequired

    The key to the type of product that this account is based on.

    scheduleSettings object

    The schedule settings, holds all schedule properties needed for schedule preview request.

    amortizationPeriodinteger<int32>

    The PMT is calculated as the loan would have [amortizationPeriod] installments.

    fixedDaysOfMonthinteger<int32>[]

    Specifies the days of the month when the repayment due dates should be. Only available if the Repayment Methodology is FIXED_DAYS_OF_MONTH.

    gracePeriodinteger<int32>

    The grace period. Represents the grace period for loan repayment - in number of installments.

    paymentPlan object[]

    A list of periodic payments for the current loan account.

  • Array [
  • amountnumberrequired

    The PMT value used in periodic payment

    toInstallmentinteger<int32>required

    The installment's position up to which the PMT will be used

  • ]
  • periodicPaymentnumber

    The periodic payment amount for the accounts which have balloon payments or Reduce Number of Installments and Optimized Payments

    principalRepaymentIntervalinteger<int32>

    The principal repayment interval. Indicates the interval of repayments that the principal has to be paid.

    repaymentInstallmentsinteger<int32>

    The repayment installments. Represents how many installments are required to pay back the loan.

    repaymentPeriodCountinteger<int32>

    The repayment period count. Represents how often the loan is to be repaid: stored based on the type repayment option.

    repaymentPeriodUnitstring

    The frequency of the loan repayment.

    Possible values: [DAYS, WEEKS, MONTHS, YEARS]

    topUpAmountnumber

    The top up amount in case of a refinanced account

    tranches object[]

    List of tranches to be considered for schedule preview.

  • Array [
  • amountnumberrequired

    The amount this tranche has available for disburse

    disbursementDetails object

    The disbursement details regarding a loan tranche.

    disbursementTransactionKeystring

    The key of the disbursement transaction logged when this tranche was disbursed. This field will be null until the tranche disbursement

    expectedDisbursementDatestring<date-time>

    The date when this tranche is supposed to be disbursed (as Organization Time)

    Example: 2016-09-06T13:37:50+03:00
    encodedKeystring

    The encoded key of the transaction details , auto generated, unique.

    fees object[]

    Fees that are associated with this tranche

  • Array [
  • amountnumber

    The amount of the custom fee.

    encodedKeystring

    The encoded key of the custom predefined fee, auto generated, unique.

    percentagenumber

    The percentage of the custom fee.

    predefinedFeeEncodedKeystring

    The encoded key of the predefined fee

  • ]
  • trancheNumberinteger<int32>

    Index indicating the tranche number

  • ]
  • Previewloanaccountschedule
    {
    "disbursementDetails": {
    "expectedDisbursementDate": "2016-09-06T13:37:50+03:00",
    "fees": [
    {
    "amount": 0,
    "encodedKey": "string",
    "percentage": 0,
    "predefinedFeeEncodedKey": "string"
    }
    ],
    "firstRepaymentDate": "2016-09-06T13:37:50+03:00"
    },
    "feeRateSettings": {
    "feeRate": 0
    },
    "interestCommission": 0,
    "interestSettings": {
    "accountInterestRateSettings": [
    {
    "encodedKey": "string",
    "indexSourceKey": "string",
    "interestRate": 0,
    "interestRateCeilingValue": 0,
    "interestRateFloorValue": 0,
    "interestRateReviewCount": 0,
    "interestRateReviewUnit": "DAYS",
    "interestRateSource": "FIXED_INTEREST_RATE",
    "interestSpread": 0,
    "validFrom": "2016-09-06T13:37:50+03:00"
    }
    ],
    "interestRate": 0,
    "interestSpread": 0
    },
    "loanAmount": 0,
    "plannedInstallmentFees": [
    {
    "amount": 0,
    "applyOnDate": "2016-09-06T13:37:50+03:00",
    "encodedKey": "string",
    "installmentKey": "string",
    "installmentNumber": 0,
    "predefinedFeeKey": "string"
    }
    ],
    "productTypeKey": "string",
    "scheduleSettings": {
    "amortizationPeriod": 0,
    "fixedDaysOfMonth": [
    0
    ],
    "gracePeriod": 0,
    "paymentPlan": [
    {
    "amount": 0,
    "toInstallment": 0
    }
    ],
    "periodicPayment": 0,
    "principalRepaymentInterval": 0,
    "repaymentInstallments": 0,
    "repaymentPeriodCount": 0,
    "repaymentPeriodUnit": "DAYS"
    },
    "topUpAmount": 0,
    "tranches": [
    {
    "amount": 0,
    "disbursementDetails": {
    "disbursementTransactionKey": "string",
    "expectedDisbursementDate": "2016-09-06T13:37:50+03:00"
    },
    "encodedKey": "string",
    "fees": [
    {
    "amount": 0,
    "encodedKey": "string",
    "percentage": 0,
    "predefinedFeeEncodedKey": "string"
    }
    ],
    "trancheNumber": 0
    }
    ]
    }