Что видит пользователь¶

Этот раздел написан для интегратора и описывает интерфейс проверки глазами конечного пользователя: какие экраны он видит, что от него требуется на каждом шаге и что происходит при ошибке. Технические детали интеграции и формат результатов описаны в разделах Первые шаги и Интеграции.

Интерфейс одинаков для Remote, Widget и WebView: меняется только способ, которым пользователь попадает на первый экран.

Общий путь¶

flowchart TD
    A[Загрузка] --> B{Есть камера?}
    B -->|Нет, десктоп| Q[QR-код: продолжить на телефоне]
    B -->|Да| C[Согласие на обработку данных]
    Q --> C
    C --> E[Технологии по порядку Workflow]
    E -->|Ошибка, есть попытки| R[Экран повтора]
    R --> E
    E -->|Все пройдены| F[Финальный экран]
    E -->|Попытки исчерпаны или отказ| F

Порядок и состав технологий задаёт Workflow. Часть шагов включается и выключается настройками Workflow в личном кабинете: страница согласия, страница инструкций перед Liveness, QR-код, индикатор прогресса.

С какого устройства проходить¶

Проверку можно пройти с телефона или с компьютера. Интерфейс сам определяет тип устройства по браузеру (для WebView он передаётся параметром isMobile) и подстраивает путь.

Рекомендуемый сценарий — телефон: камера лучше, документ проще расположить в кадре, коды из СМС приходят на то же устройство. Компьютер подходит, когда у пользователя есть веб-камера и сценарий не требует сканирования документа.

Если доступ к камере запрещён¶

Браузер запоминает отказ, поэтому повторное открытие ссылки не поможет, пока пользователь не изменит разрешение вручную:

• iPhone, Safari: нажать «АA» в адресной строке → «Настройки веб-сайта» → «Камера» → «Разрешить». Либо «Настройки» → «Safari» → «Камера».
• Android, Chrome: нажать значок замка слева от адреса → «Разрешения» → «Камера» → «Разрешить».
• Компьютер, Chrome и Edge: значок замка или настроек слева от адреса → «Камера» → «Разрешить».
• Компьютер, Safari: меню «Safari» → «Настройки» → «Веб-сайты» → «Камера».

После изменения разрешения нужно нажать «перезагрузить» на экране отказа или открыть ссылку сессии заново. Если сессия уже завершилась отказом, потребуется новая сессия.

Переход с компьютера на телефон¶

Если на компьютере нет камеры, пользователь сканирует QR-код с экрана и продолжает ту же сессию на телефоне. Компьютер при этом остаётся на экране ожидания и по завершении показывает результат или выполняет перенаправление. Настройка Workflow «Принудительное мобильное прохождение» показывает QR-код на компьютере всегда, даже при наличии камеры. Если в Workflow выключена настройка QR, компьютер без камеры завершает проверку отказом.

Экраны, общие для всех технологий¶

Загрузка¶

Первое, что видит пользователь, — экран загрузки с текстом «Мы обрабатываем данные, пожалуйста не закрывайте вкладку…». Обычно он длится несколько секунд.

Если сессия недействительна, пользователь остаётся на этом экране. Возможные сообщения и причины перечислены в разделе Причины отказа.

QR-код¶

Экран появляется, когда пользователь открыл проверку на устройстве без камеры или в Workflow включён режим «только с телефона».

• Без камеры: «На вашем устройстве не найдена камера! Подключите веб-камеру и обновите страницу (F5). Или отсканируйте QR код и пройдите через мобильное устройство».

  Обновлять страницу только после подключения камеры

  Если обновить страницу на компьютере без камеры, сессия переходит в состояние прохождения и QR-код на экране перестаёт работать: телефон при сканировании увидит «Сессия не активна». Пользователь без веб-камеры должен сразу сканировать QR-код, не обновляя страницу.

  • Только с телефона: «Дальнейшее прохождение верификации возможно только с использованием телефона. Отсканируйте QR-код используя свое мобильное устройство».

После сканирования проверка продолжается на телефоне, а на исходном экране показывается ожидание: «Мы ожидаем, пока вы завершите верификацию на своем мобильном устройстве, не закрывайте вкладку…». Когда проверка на телефоне завершена, исходный экран сообщает об этом и выполняет перенаправление.

Согласие на обработку данных¶

Заголовок «Перед тем как начать». Пользователь читает условия (ссылка открывает документ прямо в интерфейсе) и нажимает «Принять и продолжить». Кнопка «Отказаться и выйти» завершает проверку с отказом.

Индикатор прогресса¶

Полоса прогресса с названиями шагов: «Документ», «Фото», «Адрес», «ГБДФЛ», «ГБДЮЛ», «Подписание», «Код», «Анкета». На экранах Liveness индикатор скрыт, чтобы не мешать камере.

Закрытие интерфейса¶

Кнопка закрытия доступна на большинстве экранов. Перед закрытием пользователь видит подтверждение «Вы уверены, что хотите завершить процесс?». Подтверждённое закрытие завершает сессию с отказом, причина фиксируется как действие пользователя (см. Причины отказа).

Срок действия сессии¶

Сессия действует ограниченное время, по умолчанию 30 минут с момента создания. Ожидание на любом экране входит в это время, в том числе ожидание СМС-кода в E-Document и E-Document Child, ответа на СМС 1414 и результата PPS. По истечении срока сессия завершается отказом с причиной EXPIRED, а пользователь при следующем действии видит «Сессия не активна».

Экран повтора¶

Появляется, когда технология с камерой не пройдена, но попытки ещё остались. Заголовок «Вы не прошли предыдущую проверку, попробуйте снова», ниже конкретная причина (например, «Не хватило освещения. Найдите место, где свет падает на лицо») и кнопка «Попробовать снова». Для Liveness дополнительно показан список советов «Проверьте перед новой попыткой».

Если причина в камере, заголовок другой: «Вы не прошли предыдущую проверку, так как не предоставили доступ к камере. Для завершения процесса разрешите использование камеры».

Число попыток задаётся в настройках каждой технологии в личном кабинете. Когда попытки исчерпаны, проверка завершается с отказом.

Финальный экран¶

Что видит пользователь в конце, зависит от настроек Workflow:

Результаты технологий на экране не показываются: их получает система клиента через API результата.

Технологии¶

• Совместимость и входные данные
• Liveness и Face2Face
• Документы: сканирование, MRZ, MX-Document
• E-Document
• Электронная подпись
• OTP и анкета
• Фоновые проверки и реестры
• Кастомизация

Язык интерфейса¶

Язык задаётся параметром locale в URL сессии. Передавайте его всегда: без параметра интерфейс берёт язык, сохранённый в браузере пользователя, а если его нет — язык по умолчанию для домена (русский для remote.biometric.kz и remote.biometric.vision, английский для остальных). Неизвестный код заменяется языком по умолчанию.

Переключатель языка на экране включается настройкой брендинга в личном кабинете, см. Кастомизация.