Backend API 1.51.6 · Виджет 4.7.0 · Личный кабинет 2.33.2
Что изменилось для интеграций: stepIndex у каждого изображения пачки, определение селфи при посторонних лицах в кадре, все тексты виджета настраиваются в редакторе сценария. Ломающих изменений нет.
Загрузка кадров
stepIndex у каждого изображения пачки (новое)
В REST POST /v1/kyc/process поле multipart stepIndex можно повторить по одному разу на каждое изображение, в том же порядке, что поля images:
images=<паспорт> stepIndex=0
images=<селфи> stepIndex=1
images=<прописка> stepIndex=2- Номер указывается у каждого изображения пачки или ни у одного. Пачка без
stepIndexи запрос с одним изображением работают как раньше. - В одной пачке могут быть документ, селфи и адрес: вид каждого изображения берётся по его шагу.
- Каждый номер проверяется так же, как одиночный. Если хотя бы один не проходит, отказ на весь запрос: ни одно изображение не обрабатывается, попытки не списываются.
- Отклонённое изображение списывает попытку только у своего шага.
| Код | Было | Стало |
[rest.kycProcess]: invalid schema (HTTP 400) | stepIndex не строка из цифр или передан несколько раз | число номеров не равно числу изображений, пустой номер в пачке, два изображения с одним номером |
[request] invalid stepIndex: single image required (HTTP 400) | один stepIndex и несколько изображений | не отдаётся: этот случай теперь invalid schema |
Время попытки spent (изменено). Теперь это чистое время обработки попытки шага, без ожидания других частей запроса.
Селфи и посторонние лица
Кадр с документом и лицом на фоне (изменено). Мелкое лицо вне документа (человек вдалеке, экран, картина) больше не делает кадр селфи: такой кадр считается фото документа и идёт в шаг документа. Селфи — кадр, где лицо вне документа не меньше 15 % площади документа, или кадр без документа. Лицо селфи — самое крупное лицо в кадре.
Отказ из-за посторонних лиц — настройка шага (новое). В редакторе сценария у шагов «Селфи» и «Селфи с документом» есть настройка «Блокировать сессии с посторонними лицами в кадре». Она по умолчанию выключена, в том числе в существующих сценариях.
| Код | Когда отдаётся теперь |
| [general] too many faces | только при включённой настройке шага, когда на кадре два и больше крупных лица |
| [general] not a selfie | кадру, присланному в шаг селфи по stepIndex, если система считает его фото документа |
| [face] face out of frame | за краем кадра больше 20 % лица; раньше хватало касания края |
Виджет
- Тексты. В редакторе сценария, вкладка «Тексты», можно заменить любой текст экранов виджета, включая варианты экранов отказа, повтора и исчерпанных попыток. Не настраиваются подсказки во время съёмки и проверки живости, серверные ошибки, названия стран и типов документов.
- Истёкшая сессия на проверке живости. Виджет показывает экран истёкшей сессии вместо повторных попыток.
- Сценарий с анкетой. Если KYC-сессия с тем же ключом клиента уже завершена, при повторном открытии ссылки виджет показывает её итог (успех, отказ, истечение) и не открывает анкету заново.
- Условия использования и политика конфиденциальности показываются на языке виджета.
Статусы и ошибки
Кадр подтверждения адреса в сессию, в сценарии которой нет шага адреса, — ошибка [document] bad document type без списания попытки, вместо [system] exception.
Личный кабинет
- Новый тип документа: паспорт Абхазии, страница с адресом.
- Настройка шага селфи «Блокировать сессии с посторонними лицами в кадре» и полный список текстов виджета — в редакторе сценария.
Полное описание полей — в документации API.
