Bank haqida - Ipoteka Bank
История изменений API
24.12.2025
Общее
- Добавлены описания ко всем запросам в Swagger
POST /microloans/applications/verify — Ответ
| Поле |
Было |
Стало |
phoneNumber |
Не может быть пустым |
Может быть пустым, если флаг phoneCallRequired false |
phoneCallRequired |
— |
Добавлено
|
04.11.2025
Общее
- Добавлены описания ко всем запросам в Swagger
PUT /cards/status — запрос
| Поле |
Было |
Стало |
cardId, status |
Без проверки |
Добавлена
not-null валидация |
POST /cards/status — запрос
| Поле |
Было |
Стало |
cardId |
Без проверки |
Добавлена
not-null валидация |
/microloans/cancel
| Объект |
Поле |
Изменение |
| Ответ |
applicationId |
Добавлено
|
| Запрос |
initiator |
Удалено значение SYSTEM из списка разрешённых |
/pre-scoring/register, /applications/issue,
/cards/order
- В
/cards/order параметр owner переименован в clientData
- Обновлён пример
clientData
- Добавлены проверки на поля
clientData (имена, коды, дата рождения, адрес, email, телефон,
документы и пр.)
/microloans/applications/pre-scoring/register — запрос
| Поле |
Было |
Стало |
phoneNumber |
Без валидации |
Добавлена проверка на узбекский префикс (998) и 9 цифр |
productId |
Передавалось в запросе |
Удалено
|
clientData |
— |
Добавлены валидации |
/microloans/application/verify — запрос
- Добавлены проверки для
amount, percent, monthPeriod,
backupPhone
/microloans/info — ответ
| Поле |
Было |
Стало |
clientId |
Возвращалось |
Удалено
|
totalFine |
— |
Добавлено
|
/cards/order — запрос
| Поле |
Было |
Стало |
owner |
Параметр назывался owner |
Переименован в clientData |
productId |
Передавалось |
Удалено
|
externalId, phoneNumber, privacyPolicyAccepted,
termsAndConditionsAccepted
|
Без проверки |
Добавлена
not-null валидация |
/cards/order/info — ответ
| Поле |
Было |
Стало |
cardHolderName, maskedPan, processingType |
Присутствовали в card |
Удалены
|
id, pan |
— |
Добавлены
|
orderId |
Без проверки |
Добавлена
not-null валидация |
/cards/attach — запрос
| Поле |
Было |
Стало |
topic |
Передавалось в запросе |
Удалено
|
pan |
Пример значения старый |
Изменено значение примера |
phoneNumber |
Без проверки |
Добавлена валидация на узбекский префикс (998) и 9 цифр |
/cards/attach/confirm — запрос
| Поле |
Было |
Стало |
topic |
Передавалось |
Удалено
|
/repayment/check
| Объект |
Поле |
Изменение |
| Запрос |
loanId |
Добавлена валидация (только цифры) |
| Ответ |
recommendedAmount |
Добавлено
|
/repayment/pay — запрос
| Поле |
Было |
Стало |
paymentType |
— |
Добавлено
|
loanId, requestId, debitId, amount,
processingType
|
Без проверки |
Добавлена
not-null валидация |
/repayment/status
| Объект |
Поле |
Изменение |
| Запрос |
externalId |
Удалено
|
| Ответ |
requestErrorMessage |
Добавлено
|
/transfer/account-to-card/create — запрос
| Поле |
Было |
Стало |
pan |
Без проверки |
Добавлена проверка (только 16 цифр) |
amount |
Без ограничения |
Добавлена проверка (минимум 0) |
08.10.2025
- Изменено
/microloans/applications/cancel, /microloans/applications/pre-scoring/register,
/transfers/account-to-card/create, /transfers/check-status,
/microloans/info, /microloans/schedule, /microloans/payments,
/repayment/loans/(check|pay|status)
/microloans/applications/pre-scoring/register — запрос
| Поле |
Было |
Стало |
productId |
- |
Удалён
|
/microloans/applications/cancel — запрос и ответ
| Поле |
Было |
Стало |
canceledBy |
canceledBy |
initiator |
applicationId |
— |
Добавлено
UUID, ID заявки на микрокредит |
/transfers/account-to-card/create — запрос
| Поле |
Было |
Стало |
processingTypes |
processingTypes |
receiverCardType, Enum |
amount |
String |
Long |
externalId |
— |
Добавлено
String, внешний id (в начало params) |
/transfers/check-status — ответ
| Поле |
Было |
Стало |
transactionDate |
Дата (Date) |
DateTime |
/microloans/info — ответ
| Изменение |
Описание |
| Удалено |
loanInfo (строка с объектом) |
| Перемещено |
amount, monthPeriod, rate, loanId — под
result
|
| Добавлено |
В result параметры totalResidue (long, общий остаток задолженности) и
totalFine (long, задолженность по просроченным платежам)
|
/microloans/schedule — ответ
| Поле |
Было |
Стало |
paymentDate |
Дата |
DateTime |
/microloans/payments — ответ
| Поле |
Было |
Стало |
paymentDate |
Дата |
DateTime |
TotalRepaymentAmount |
Первая буква заглавная |
totalRepaymentAmount (первая буква в нижнем регистре) |
/repayment/loans/check — ответ
| Поле |
Было |
Стало |
recommendedAmount |
-- |
Удалён
|
/repayment/loans/pay — запрос
| Поле |
Было |
Стало |
paymentType, processingType |
String |
Enum |
/repayment/loans/status — ответ
| Поле |
Было |
Стало |
requestStatus |
— |
Добавлено
String, статус запроса |
message |
— |
Добавлено
String, описание статуса |
22.09.2024
- Изменено
типы данных параметров в запросах и ответах на
long, double и int
Тип данных изменен на long
| Метод |
Параметр |
Описание |
POST /microloans/applications/info |
amountLimit |
В ответе |
POST /repayment/loans/check |
accountBalance, totalResidue, mainDebtAmount,
overdueDebtAmount, termInterestAmount, overdueInterestAmount,
interestFineAmount, recommendedAmount, maxAmount
|
В ответе |
POST /repayment/loans/pay |
amount |
В запросе |
POST /microloans/schedule |
totalResidue, totalRepaymentAmount, loanRepaymentAmount,
accruedInterestAmount, servicePercentageAmount
|
В ответе |
POST /microloans/payments |
totalRepaymentAmount, loanRepaymentAmount, accruedInterestAmount
|
В ответе |
Тип данных изменен на double
| Метод |
Параметр |
Описание |
POST /microloans/applications/info |
percent |
В ответе |
POST /microloans/info |
rate |
В ответе |
POST /microloans/applications/verify |
percent |
В запросе |
Тип данных изменен на int
| Метод |
Параметр |
Описание |
POST /microloans/applications/info |
monthPeriod |
В ответе |
POST /microloans/schedule |
periodDays |
В ответе |
19.09.2025
/microloans/applications/info — ответ
| Поле |
Было |
Стало |
clientId |
Возвращалось в объекте ответа |
Удалено |
/microloans/applications/issue — запрос
| Поле |
Было |
Стало |
clientId |
Передавалось в params |
Удалено |
clientData |
— |
Добавлено (заменяет clientId) |
Переводы — ответы
| Эндпоинт |
Поле |
Стало |
POST /repayment/loan/check |
recommendedAmount |
Удалено |
05.09.2025
- Переименовано
POST /microloans/loan-info → POST /microloans/info
- Добавлено
/microloans/schedule, /microloans/payments,
/repayment/loans/(check|pay|status)
/microloans/applications/info — ответ
| Поле |
Было |
Стало |
clientId |
Возвращалось в объекте ответа |
Удалено |
/microloans/applications/issue — запрос
| Поле |
Было |
Стало |
clientId |
Передавалось в params |
Удалено |
clientData |
— |
Добавлено (заменяет clientId) |
Переводы — ответы (error)
| Эндпоинт |
Поле |
Стало |
POST /transfers/check-status |
error.externalId |
Удалено |
POST /transfers/account-to-card/confirm |
error.externalId |
Удалено |
↑