Skip to main content

Lockloantransactionswrapper

Represents a wrapper over a list of loan transactions, to be used when locking and unlocking an account.

loanTransactions object[]

The list of loan transactions

  • Array [
  • accountBalances object

    The balances changed within a transaction.

    advancePositionnumber

    Captures the advance (prepaid) amount.

    arrearsPositionnumber

    Captures the arrears position amount for the account in arrears.

    expectedPrincipalRedrawnumber

    The difference between principal balance and redraw balance after each transaction performed on the loan account.

    principalBalancenumber

    The account redraw balance captured after the transaction update.

    redrawBalancenumber

    The account redraw balance captured after the transaction update.

    totalBalancenumber

    The running balance still owed for the loan.

    adjustmentTransactionKeystring

    The key of the loan transaction where the adjustment for the transaction was made (if any adjustment was involved).

    affectedAmounts object

    The amounts affected after completing the loan transaction

    creditBalanceChangeAmountnumber

    How much credit balance was added/removed in account, within this transaction.

    deferredInterestAmountnumber

    How much interest pre-paid was added/removed in account, within this transaction (including taxes).

    feesAmountnumber

    How much fees was added/removed in account, within this transaction.

    fundersInterestAmountnumber

    How much interest is given to the investors, within this transaction (only for p2p products)

    interestAmountnumber

    How much interest was added/removed in account, within this transaction (including taxes). If there is any deferred interest amount set in this transaction, that amount should be included in this field.

    interestFromArrearsAmountnumber

    How much interest from arrears was added/removed in account, within this transaction (including taxes).

    organizationCommissionAmountnumber

    How much interest is given to the organization, within this transaction (only for p2p products)

    paymentHolidaysInterestAmountnumber

    How much Payment Holidays interest was added/removed in account, within this transaction (including taxes).

    penaltyAmountnumber

    How much penalties was added/removed in account, within this transaction.

    principalAmountnumber

    How much principal was added/removed in account, within this transaction.

    amountnumber

    The amount that was added or removed on the loan account.

    bookingDatestring<date-time>

    The date when the corresponding journal entry is booked.

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

    The branch where the transaction was performed.

    cardTransaction object

    A card transaction entry which will have a corresponding a financial transaction performed.

    advicebooleanrequired

    Whether the given request should be accepted without balance validations.

    amountnumberrequired

    The amount of money to be withdrawn in the financial transaction.

    cardAcceptor object

    The details of the card acceptor (merchant) in a transaction hold.

    citystring

    The city in which the card acceptor has the business.

    countrystring

    The country in which the card acceptor has the business.

    mccinteger<int32>

    The Merchant Category Code of the card acceptor.

    namestring

    The name of the card acceptor.

    statestring

    The state in which the card acceptor has the business.

    streetstring

    The street in which the card acceptor has the business.

    zipstring

    The ZIP code of the location in which the card acceptor has the business.

    cardTokenstring

    The reference token of the card.

    currencyCodestring

    The ISO currency code in which the card reversal transaction is posted. The amounts are stored in the base currency, but the transaction can be created with a foreign currency.

    encodedKeystring

    The encoded key of the entity, generated, globally unique

    externalAuthorizationReferenceIdstring

    The external authorization hold reference ID, which relates this card transaction to a previous authorization hold.

    externalReferenceIdstringrequired

    The external reference ID to be used to reference the card transaction in subsequent requests.

    userTransactionTimestring

    The formatted time at which the user made this card transaction.

    centreKeystring

    The center where the transaction was performed.

    creationDatestring<date-time>

    The date when this loan transaction was created.

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

    Represents a currency eg. USD, EUR.

    codestring

    Fiat(ISO-4217) currency code or NON_FIAT for non fiat currencies.

    Possible values: [AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYR, BYN, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MRU, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SLE, SOS, SRD, STD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USN, UYI, UYU, UYW, UZS, VED, VEF, VES, VND, VUV, WST, XAG, XAU, XAF, XBA, XBB, XBC, XBD, XCD, XCG, XDR, XOF, XPD, XPF, XPT, XSU, XTS, XUA, XXX, YER, ZAR, ZIG, ZWG, ZMK, ZWL, ZMW, SSP, NON_FIAT]

    currencyCodestring

    Currency code for NON_FIAT currency.

    customPaymentAmounts object[]

    The list of custom amounts which the user has paid as part of this transaction.

  • Array [
  • amountnumberrequired

    The amount of the payment paid in the transaction for the given type.

    customPaymentAmountTypestringrequired

    The type of the custom payment

    Possible values: [PRINCIPAL, INTEREST, MANUAL_FEE, UPFRONT_DISBURSEMENT_FEE, LATE_REPAYMENT_FEE, PAYMENT_DUE_FEE, PENALTY, INTEREST_FROM_ARREARS, NON_SCHEDULED_FEE, INTEREST_BEARING_FEE, INTEREST_BEARING_FEE_INTEREST, CF_PRINCIPAL_IN_ARREARS, CF_INTEREST, CF_INTEREST_FROM_ARREARS, FEE_INCLUDED_IN_PMT]

    predefinedFeeKeystring

    The encodedKey of the predefined fee to be paid.

    taxOnAmountnumber

    The amount of the taxes paid in the transaction for the given type.

  • ]
  • encodedKeystring

    The encoded key of the loan transaction, which is auto generated, and must be unique.

    externalIdstring

    The external ID of the loan transaction, it is customizable, and must be unique.

    feeIncludedInPmtboolean
    fees object[]

    The amounts that have been applied or paid as part of this transaction and involved predefined fees.

  • Array [
  • amountnumber

    The amount of the fee that was applied/paid in the transaction for the given predefined fee.

    namestring

    The name of the predefined fee

    predefinedFeeKeystringrequired

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

    taxAmountnumber

    The amount of the taxes on fee that was applied/paid in the transaction.

    triggerstring

    Shows the event that will trigger a fee

    Possible values: [MANUAL, MANUAL_PLANNED, DISBURSEMENT, CAPITALIZED_DISBURSEMENT, UPFRONT_DISBURSEMENT, LATE_REPAYMENT, PAYMENT_DUE, PAYMENT_DUE_APPLIED_ON_DUE_DATES, ARBITRARY, IOF, EARLY_REPAYMENT_CHARGE, FEE_INCLUDED_IN_PMT]

  • ]
  • idstring

    The ID of the loan transaction, can be generated and customized, and must be unique.

    installmentEncodedKeystring

    The specific installment encoded key associated to the loan transaction.

    lateFeeIncludedInPmtboolean
    lateFeePerInstallment object

    The late fees associated per installment for the loan transaction.

    property name*number

    The late fees associated per installment for the loan transaction.

    linkedPrincipalOverpaymentTransactionKeystring

    The specific principal overpayment transaction key associated to the loan transaction.

    migrationEventKeystring

    The migration event encoded key associated with the loan account. If the account was imported, track which 'migration event' it came from.

    notesstring

    The notes or description for the loan transaction.

    originalAmountnumber

    The amount that was posted in a foreign currency. This amount was converted using the exchange rate available at entry date and set into the amount field.

    originalCurrencyCodestring

    The currency in which this transaction was posted. The amounts are stored in the base currency, but the user may enter it in a foreign currency.

    originalTransactionKeystring

    The encoded key of the transaction that was adjusted as part of this one. Available only for adjustment transactions.

    parentAccountKeystring

    The key of the parent loan account.

    parentLoanTransactionKeystring

    The key of the parent loan transaction.

    prepaymentRecalculationMethodstring

    The prepayment recalculation method types.

    Possible values: [NO_RECALCULATION, RESCHEDULE_REMAINING_REPAYMENTS, RECALCULATE_SCHEDULE_KEEP_SAME_NUMBER_OF_TERMS, RECALCULATE_SCHEDULE_KEEP_SAME_PRINCIPAL_AMOUNT, RECALCULATE_SCHEDULE_KEEP_SAME_TOTAL_REPAYMENT_AMOUNT, REDUCE_AMOUNT_PER_INSTALLMENT, REDUCE_NUMBER_OF_INSTALLMENTS, REDUCE_NUMBER_OF_INSTALLMENTS_NEW]

    taxes object

    The taxes applied within a transaction.

    deferredTaxOnInterestAmountnumber

    How much taxes on the interest that was pre-paid were added/removed in account, within this transaction. If there is any deferred tax on interest amount set in this transaction, that amount should be included in this field.

    taxOnFeesAmountnumber

    How much taxes on the fees that were paid in this transaction were added/removed in account, within this transaction.

    taxOnInterestAmountnumber

    How much taxes on the interest that was paid in this transaction were added/removed in account, within this transaction.

    taxOnInterestFromArrearsAmountnumber

    The amount of taxes on the interest from arrears that were applied/paid in account, within this transaction.

    taxOnPaymentHolidaysInterestnumber

    The amount of taxes on the Payment Holidays interest that were added/removed in account, within this transaction.

    taxOnPenaltyAmountnumber

    How much taxes on the penalties that were paid in this transaction were added/removed in account, within this transaction.

    taxRatenumber

    The tax rate that was set or changed in this transaction.

    terms object

    The loan transaction terms

    interestSettings object

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

    indexInterestRatenumber

    The value of the index interest rate

    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.

    periodicPaymentnumber

    The periodic payment value logged when changing it for a Balloon Payments account

    principalPaymentAmountnumber

    The principal payment flat amount logged when changing it for a Revolving Credit account

    principalPaymentPercentagenumber

    The principal payment percentage value logged when changing it for a Revolving Credit account

    tillKeystring

    The till key associated with the transaction.

    transactionDetails object

    Contains the details about transaction including fields like transaction channel key and channel id

    transactionChannelIdstring

    The id of the transaction channel associated with the transaction details.

    transactionChannelKeystring

    The encoded key of the transaction channel associated with the transaction details.

    transferDetails object

    Represents the transfer details, such as the linked transaction key

    linkedDepositTransactionKeystring

    The key of the related deposit transaction

    linkedLoanTransactionKeystring

    The key of the related loan transaction

    typestring

    The type of loan transaction.

    Possible values: [IMPORT, DISBURSEMENT, DISBURSEMENT_ADJUSTMENT, WRITE_OFF, WRITE_OFF_ADJUSTMENT, REPAYMENT, ADVANCE_REPAYMENT, PAYMENT_MADE, WITHDRAWAL_REDRAW, WITHDRAWAL_REDRAW_ADJUSTMENT, FEE_APPLIED, FEE_CHARGED, FEE_CAPITALISED, SCHEDULE_FIX_APPLIED, FEES_DUE_REDUCED, FEE_REFUND, FEE_REFUND_ADJUSTMENT, FEE_ADJUSTMENT, PENALTY_APPLIED, PENALTY_ADJUSTMENT, PENALTIES_DUE_REDUCED, REPAYMENT_ADJUSTMENT, ADVANCE_REPAYMENT_ADJUSTMENT, FEE_CAPITALISED_ADJUSTMENT, PAYMENT_MADE_ADJUSTMENT, INTEREST_RATE_CHANGED, FEE_RATE_CHANGED, TAX_RATE_CHANGED, PENALTY_RATE_CHANGED, INTEREST_APPLIED, IBF_INTEREST_APPLIED, IBF_INTEREST_APPLIED_ADJUSTMENT, INTEREST_APPLIED_ADJUSTMENT, INTEREST_DUE_REDUCED, PENALTY_REDUCTION_ADJUSTMENT, FEE_REDUCTION_ADJUSTMENT, INTEREST_REDUCTION_ADJUSTMENT, DEFERRED_INTEREST_APPLIED, DEFERRED_INTEREST_APPLIED_ADJUSTMENT, DEFERRED_INTEREST_PAID, DEFERRED_INTEREST_PAID_ADJUSTMENT, INTEREST_LOCKED, FEE_LOCKED, PENALTY_LOCKED, INTEREST_UNLOCKED, FEE_UNLOCKED, PENALTY_UNLOCKED, REDRAW_TRANSFER, REDRAW_REPAYMENT, REDRAW_TRANSFER_ADJUSTMENT, REDRAW_REPAYMENT_ADJUSTMENT, TRANSFER, TRANSFER_ADJUSTMENT, BRANCH_CHANGED, TERMS_CHANGED, CARD_TRANSACTION_REVERSAL, CARD_TRANSACTION_REVERSAL_ADJUSTMENT, DUE_DATE_CHANGED, DUE_DATE_CHANGED_ADJUSTMENT, ACCOUNT_TERMINATED, ACCOUNT_TERMINATED_ADJUSTMENT, REFUND, REFUND_ADJUSTMENT, REDUCE_BALANCE, REDUCE_BALANCE_ADJUSTMENT, PRINCIPAL_OVERPAYMENT, PRINCIPAL_OVERPAYMENT_ADJUSTMENT, CREDIT_BALANCE_DEPOSIT, CREDIT_BALANCE_DEPOSIT_ADJUSTMENT, CREDIT_BALANCE_WITHDRAWAL, CREDIT_BALANCE_WITHDRAWAL_ADJUSTMENT, PAYMENT_HOLIDAYS_INTEREST_CAPITALISED, PAYMENT_HOLIDAYS_INTEREST_CAPITALISED_ADJUSTMENT]

    userKeystring

    The user that performed the transaction.

    valueDatestring<date-time>

    The date of the entry in the organization time format and timezone.

    Example: 2016-09-06T13:37:50+03:00
  • ]
  • Lockloantransactionswrapper
    {
    "loanTransactions": [
    {
    "accountBalances": {
    "advancePosition": 0,
    "arrearsPosition": 0,
    "expectedPrincipalRedraw": 0,
    "principalBalance": 0,
    "redrawBalance": 0,
    "totalBalance": 0
    },
    "adjustmentTransactionKey": "string",
    "affectedAmounts": {
    "creditBalanceChangeAmount": 0,
    "deferredInterestAmount": 0,
    "feesAmount": 0,
    "fundersInterestAmount": 0,
    "interestAmount": 0,
    "interestFromArrearsAmount": 0,
    "organizationCommissionAmount": 0,
    "paymentHolidaysInterestAmount": 0,
    "penaltyAmount": 0,
    "principalAmount": 0
    },
    "amount": 0,
    "bookingDate": "2016-09-06T13:37:50+03:00",
    "branchKey": "string",
    "cardTransaction": {
    "advice": true,
    "amount": 0,
    "cardAcceptor": {
    "city": "string",
    "country": "string",
    "mcc": 0,
    "name": "string",
    "state": "string",
    "street": "string",
    "zip": "string"
    },
    "cardToken": "string",
    "currencyCode": "string",
    "encodedKey": "string",
    "externalAuthorizationReferenceId": "string",
    "externalReferenceId": "string",
    "userTransactionTime": "string"
    },
    "centreKey": "string",
    "creationDate": "2016-09-06T13:37:50+03:00",
    "currency": {
    "code": "AED",
    "currencyCode": "string"
    },
    "customPaymentAmounts": [
    {
    "amount": 0,
    "customPaymentAmountType": "PRINCIPAL",
    "predefinedFeeKey": "string",
    "taxOnAmount": 0
    }
    ],
    "encodedKey": "string",
    "externalId": "string",
    "feeIncludedInPmt": true,
    "fees": [
    {
    "amount": 0,
    "name": "string",
    "predefinedFeeKey": "string",
    "taxAmount": 0,
    "trigger": "MANUAL"
    }
    ],
    "id": "string",
    "installmentEncodedKey": "string",
    "lateFeeIncludedInPmt": true,
    "lateFeePerInstallment": {},
    "linkedPrincipalOverpaymentTransactionKey": "string",
    "migrationEventKey": "string",
    "notes": "string",
    "originalAmount": 0,
    "originalCurrencyCode": "string",
    "originalTransactionKey": "string",
    "parentAccountKey": "string",
    "parentLoanTransactionKey": "string",
    "prepaymentRecalculationMethod": "NO_RECALCULATION",
    "taxes": {
    "deferredTaxOnInterestAmount": 0,
    "taxOnFeesAmount": 0,
    "taxOnInterestAmount": 0,
    "taxOnInterestFromArrearsAmount": 0,
    "taxOnPaymentHolidaysInterest": 0,
    "taxOnPenaltyAmount": 0,
    "taxRate": 0
    },
    "terms": {
    "interestSettings": {
    "indexInterestRate": 0,
    "interestRate": 0
    },
    "periodicPayment": 0,
    "principalPaymentAmount": 0,
    "principalPaymentPercentage": 0
    },
    "tillKey": "string",
    "transactionDetails": {
    "transactionChannelId": "string",
    "transactionChannelKey": "string"
    },
    "transferDetails": {
    "linkedDepositTransactionKey": "string",
    "linkedLoanTransactionKey": "string"
    },
    "type": "IMPORT",
    "userKey": "string",
    "valueDate": "2016-09-06T13:37:50+03:00"
    }
    ]
    }