Перейти к содержанию

Расчёт процентов по вкладу

Расчет процентов по вкладу с учетом капитализации, пополнений и частичных снятий. Метод позволяет рассчитать доходность вклада с учетом различных параметров.

URL

Метод: POST

  • Production: https://registry.wallet.kvell.group/reg2/billing/deposit/interest

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

Название Тип данных Обязательно Описание
amount number Да Сумма вклада
rate number Да Процентная ставка
days integer Нет Количество дней
months integer Нет Количество месяцев
startDate date Нет Дата начала вклада в формате YYYY-MM-DD
endDate date Нет Дата окончания вклада в формате YYYY-MM-DD
topUps array Нет Пополнения (массив {date, amount})

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

{
  "amount": 100000,
  "rate": 2.5,
  "days": 180,
  "months": 12,
  "startDate": "2026-01-01",
  "endDate": "2027-01-01",
  "topUps": [
    {
      "date": "2026-03-01",
      "amount": 1000
    }
  ]
}

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

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

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

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

{
  "simpleInterest": 100,
  "compoundInterest": 100,
  "dailyInterest": 20,
  "topUpInterest": 20,
  "days": 180,
  "months": 12,
  "amount": 100000,
  "rate": 2.5
}

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

Название Тип данных Описание
simpleInterest number Простой процент (без капитализации)
compoundInterest number Сложные проценты (ежемесячная капитализация)
dailyInterest number Банковский вариант: ежедневное начисление
topUpInterest number Вклад с пополнениями (ежемесячно)
days integer Количество дней
months integer Количество месяцев
amount number Сумма вклада
rate number Процентная ставка