Calculating Early Repayment

Calculates loan early repayment parameters. Lets you calculate interest savings and the new payment schedule for a partial or full early repayment.

URL

Method: POST

• Production: https://registry.wallet.kvell.group/reg2/billing/loans/early/repayment

Request parameters

Name	Type	Required	Description
principal	number	Yes	Original loan amount
annualRate	number	Yes	Annual interest rate (%)
termMonths	integer	Yes	Loan term in months
startDate	date	Yes	Loan issue date in YYYY-MM-DD format
earlyRepaymentDate	date	Yes	Early repayment date in YYYY-MM-DD format
earlyRepaymentAmount	number	Yes	Early repayment amount
reducePayment	boolean	Yes	true = reduce the monthly payment, false = shorten the term

Example request

{
  "principal": 500000,
  "annualRate": 12,
  "termMonths": 24,
  "startDate": "2025-01-01",
  "earlyRepaymentDate": "2025-07-01",
  "earlyRepaymentAmount": 100000,
  "reducePayment": true
}

Request headers

Name	Type	Required	Description
X-Api-Key	string	Yes	Unique identifier (UUID)

Response

Example response

200: OK

{
  "monthlyPayment": 23536.74,
  "accruedInterest": 27182.14,
  "remainingPrincipalBeforePayment": 385961.70,
  "remainingPrincipalAfterPayment": 285961.70,
  "newMonthlyPayment": 17438.53,
  "newRemainingTermMonths": 18
}

Response parameters

Name	Type	Description
monthlyPayment	number	Original monthly payment
accruedInterest	number	Interest accrued up to the early repayment date
remainingPrincipalBeforePayment	number	Remaining principal before the early payment
remainingPrincipalAfterPayment	number	Remaining principal after the early payment
newMonthlyPayment	number	New payment (if the payment was reduced)
newRemainingTermMonths	integer	New term (if the term was shortened)