Changelog · 2026-11-16 · Neurovision KYC

Backend API 1.82.1 · Личный кабинет 2.68.0

В этом выпуске вебхуки стали надёжнее: недоставленный вебхук теперь отправляется повторно, а каждая попытка помечается заголовками, по которым удобно отсеять повторы. Ниже — что изменилось и на что стоит обратить внимание, если ваша интеграция опирается на вебхуки, на список сессий с фильтрами или вызывает методы API не POST-запросом.

Вебхуки

Повторная доставка (новое). Если ваш сервер не ответил кодом 2xx, вебхук отправляется снова с нарастающей паузой: первая повторная попытка — через 30 секунд, всего до 15 попыток в течение примерно 4 ч 50 мин. Повтор выполняется при ошибке сети, превышении времени ожидания и ответах 5xx, 408 и 429. Любой другой ответ, в том числе 4xx и перенаправления 3xx, завершает доставку без повторов.

Заголовки доставки (новое). Каждый вебхук приходит с заголовками:

  • X-Webhook-Id — идентификатор доставки, одинаковый во всех её попытках;
  • X-Webhook-Attempt — номер попытки, начиная с 1.

Повтор возможен, если ваш сервер успел принять и обработать вебхук, но его ответ до нас не дошёл — например, из-за сбоя сети или потому, что ответ занял больше времени ожидания. В этом случае мы не можем знать, что вебхук уже получен, и для надёжности отправляем его ещё раз с тем же X-Webhook-Id. Поэтому, если вы уже обработали вебхук с таким X-Webhook-Id, повторную попытку можно просто подтвердить ответом 2xx, не обрабатывая её заново.

Порядок событий одной сессии. Вебхуки одной сессии доставляются в том порядке, в котором возникли: следующий отправляется после ответа на предыдущий. Вебхуки разных сессий друг друга не ждут.

Методы API

Передача сессии другой компании через API (новое). Завершённую сессию вашей компании теперь можно передать другим компаниям на просмотр не только из личного кабинета, но и методами API:

  • kyc/session/share — передаёт сессию компаниям пользователей, указанных по email (до 20 адресов за вызов), и возвращает список всех передач сессии;
  • kyc/session/shares — возвращает все передачи сессии, сделанные в кабинете и через API;
  • kyc/session/unshare — отзывает передачи по их идентификаторам.

Методы доступны, если у пользователя токена в роли отмечено право «Предоставление доступа к KYC-сессии»: «Управление пользователями» → «Роли».

На что стоит обратить внимание

Адрес вебхука с перенаправлением. Если адрес вебхука в сценарии отвечает перенаправлением (например, с http на https или на другой путь), укажите в сценарии конечный адрес: вебхук отправляется только на адрес, указанный в сценарии.

Методы API вызываются POST-запросом. Методы API принимают только POST. Если вы вызываете метод другим HTTP-методом, ответ будет 405 с заголовком Allow, в котором указан нужный метод.

Итоговый вебхук сессии с проверками по базам. Если в сценарии настроены проверки по базам, итоговый вебхук сессии (поле event в теле — SESSION_COMPLETE) новой сессии приходит после завершения проверок, и отдельный вебхук с результатами проверок (event — DATABASE_CHECKS_COMPLETE) для неё не отправляется. Если проверки не завершились за 10 минут, SESSION_COMPLETE приходит со статусом processing и checksStatus: "timeout"; итог проверок придёт позже в DATABASE_CHECKS_COMPLETE, а если он меняет статус сессии — ещё одним SESSION_COMPLETE. DATABASE_CHECKS_COMPLETE по-прежнему приходит и после повторного запуска проверки. Сессии нового формата отличаются полем version со значением 8.

Период в kyc/sessions/filter. Если вы запрашиваете список сессий без периода (range без start и end), теперь вернутся сессии за последние дни, доступные вашему аккаунту, по сегодняшний день включительно. Период считается целыми календарными днями по UTC и не бывает длиннее 365 дней; более длинный период сохраняет дату окончания и сокращается до допустимого числа дней.

Личный кабинет

Действия над сессией — в меню «⋮». Если вы работаете с сессиями в разделе «KYC Логи», все действия над сессией теперь находятся в меню «⋮» карточки сессии: «Получить данные пользователя», «Редактировать сценарий», «Копировать ссылку сессии», «Передать», «Отправить вебхук повторно» и последним — «Удалить сессию». У каждого пункта есть подпись и иконка, так что нужное действие легко найти по названию. Шапка блока документа теперь отдана вкладкам документов.

Кому и в какой сессии доступно каждое действие, не изменилось: в меню видны только доступные вам пункты. В сессии, которую вам передала другая компания, в меню есть пункт «Копировать ссылку сессии».

Передача сессии другой компании (новое). Если вам нужно показать сессию партнёру, который тоже работает в кабинете, откройте сессию в разделе «KYC Логи» и нажмите «Передать». В окне «Передать сессию» добавьте email пользователя другой компании кнопкой «Добавить». Список «Кому передана» показывает, у кого уже есть доступ, а кнопка «Отозвать» закрывает его. Сессию нельзя передать пользователю своей компании. Кнопка видна, если в роли пользователя отмечено право «Предоставление доступа к KYC-сессии»: «Управление пользователями» → «Роли».

Сессии, переданные вам (новое). Если другая компания передала вам сессию, она появится в разделе «KYC Логи» на вкладке «Делегированные мне», рядом с вкладкой «Мои». Такая сессия помечена «Передана» и открывается только для просмотра.

Исправления оператора в карточке сессии (новое). Если распознанное значение поля документа оказалось неверным, его можно исправить прямо в карточке сессии: окно «Исправление значения» (Enter — сохранить, Esc — отмена). Исправленное поле помечается «Исправлено оператором», рядом показано исходное значение. Неуспешную проверку шага можно подтвердить вручную: «Перевести в успех?» — после этого она помечается «Подтверждено оператором». Статус сессии пересчитывается сразу, кабинет показывает его в сообщении «Сохранено. Статус сессии: …». Исправления доступны пользователям с правом «Изменение результатов KYC-сессии»: «Управление пользователями» → «Роли».

Журнал доставки вебхуков (новое). В разделе KYC появилась вкладка «Журнал вебхуков» со списком всех отправок вебхуков: событие, сессия или анкета, адрес, «Итог», число попыток, время последней и следующей попытки. Отбор — по «Период», «Сценарий», событию и итогу, поиск — по sessionId, questionnaireId или clientKey. Строка раскрывается и показывает каждую попытку с её результатом и длительностью. Список можно выгрузить кнопкой «Экспорт CSV».

Повторная отправка вебхука (новое). Если ваш сервер не получил вебхук, его можно отправить ещё раз кнопкой «Отправить вебхук повторно» — в карточке сессии, в строке анкеты на вкладке «Анкеты» и в строке недоставленной отправки в «Журнал вебхуков».

Журнал действий (новое). В разделе «Управление пользователями» появилась вкладка «Журнал действий»: кто, когда и что сделал в аккаунте — входы, изменения пользователей и ролей, сценариев, сессий, токенов и другие действия. Отбор — по «Период» (до 92 дней), «Событие», «Тип объекта», «Результат» и ID пользователя; у каждой записи можно открыть «Показать подробности». Журнал выгружается кнопкой «Выгрузить CSV». Вкладка видна пользователям, у которых в роли отмечен «Пункт меню «Журнал действий»».

Удаление и восстановление пользователей (новое). Если вы владелец аккаунта, удалённого пользователя теперь можно вернуть: в разделе «Управление пользователями» → «Пользователи» включите «Показать удалённые» и нажмите «Восстановить». Пользователей можно отметить списком и удалить или восстановить сразу несколько — «Удалить выбранные», «Восстановить выбранные».

Пароль сотрудника (новое). Если вы владелец аккаунта, вы можете задать новый пароль пользователю своей компании: в его карточке нажмите «Изменить пароль».

Удаление сессий по выборке. Если вы удаляете сессии кнопкой «Удалить по выборке» в разделе «KYC Отчёты», кабинет показывает число сессий и ход удаления («Удалено … / …»), а остановить удаление можно в любой момент.

Закрытое лицо на селфи (новое). В «KYC Редактор» в шагах селфи и liveness появилась настройка «Отклонять, если лицо закрыто»: если лицо закрыто руками, документом или другими предметами, пользователь увидит подсказку «Уберите от лица руки, документ и другие предметы».

Подробное описание полей вы найдёте в документации API (/docs).