Bank haqida

Общая информация API микрозаймов API заказа карт Привязка карт История изменений API

История изменений 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`	Удалено

↑