Расчёт досрочного погашения

Расчет параметров досрочного погашения кредита. Позволяет рассчитать экономию на процентах и новый график платежей при частичном или полном досрочном погашении.

URL

Метод: POST

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

Параметры запроса

Название	Тип данных	Обязательно	Описание
`principal`	number	Да	Первоначальная сумма кредита
`annualRate`	number	Да	Годовая процентная ставка (%)
`termMonths`	integer	Да	Срок кредита в месяцах
`startDate`	date	Да	Дата выдачи кредита в формате YYYY-MM-DD
`earlyRepaymentDate`	date	Да	Дата досрочного погашения в формате YYYY-MM-DD
`earlyRepaymentAmount`	number	Да	Сумма досрочного платежа
`reducePayment`	boolean	Да	true = уменьшаем ежемесячный платёж, false = сокращаем срок

Пример запроса

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

Заголовки запроса

Название	Тип данных	Обязательно	Описание
`X-Api-Key`	string	Да	Уникальный идентификатор (UUID)

Ответ запроса

Пример ответа

200: OK

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

Параметры ответа

Название	Тип данных	Описание
`monthlyPayment`	number	Исходный ежемесячный платёж
`accruedInterest`	number	Начисленные проценты до даты досрочного погашения
`remainingPrincipalBeforePayment`	number	Остаток долга до досрочного платежа
`remainingPrincipalAfterPayment`	number	Остаток после досрочного платежа
`newMonthlyPayment`	number	Новый платёж (если уменьшали платёж)
`newRemainingTermMonths`	integer	Новый срок (если сокращали срок)