Причина отказа#
Введение#
На этой странице перечислены возможные причины отказа, которые могут возникнуть при прохождении флоу и входящих в него технологий.
- Флоу — это последовательность шагов, состоящая из нескольких технологий.
- Ошибка может произойти как на уровне всего флоу, так и на уровне отдельной технологии.
- В таблицах ниже приведены коды и описания ошибок, которые возвращаются при неудачном прохождении проверки.
Эти причины могут использоваться для отображения пользователю, отладки интеграций или построения аналитики отказов.
Liveness#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| SERVICE_ERROR | Could not send image to liveness service | Не удалось отправить изображение в сервис Liveness (ошибка сети или сервера) |
| REQUEST_ERROR | None | Ошибка в запросе (неверный формат или повреждённые данные) |
| CLIENT | Could not find face distance | Система не смогла определить расстояние до лица |
| CALC_RESULT | Closed eyes | Глаза закрыты, проверка невозможна |
| CALC_RESULT | Low prediction | Низкая вероятность успешного прохождения проверки |
| CALC_RESULT | Low overall prediction | Общий результат слишком низкий для подтверждения |
| OTHER | Incorrect image hash | непрошло проверку на целостность изобрадения |
| CLIENT | Liveness result for this session already exists | Для этой сессии результат Liveness уже существует |
| SERVICE_ERROR | None | Внутренняя ошибка сервиса |
| CLIENT | Operation aborted by user | Пользователь прервал процесс |
| OTHER | Operation aborted by user | Процесс остановлен по внешним причинам |
| CLIENT | No active or future subscription for technology | Нет действующей подписки на технологию |
| CLIENT | Subscription does not have access to technology | Подписка не даёт доступа к технологии |
| CLIENT | Could not send image to liveness service | Ошибка при отправке фото в сервис Liveness |
| NO_CAM | None | Камера не найдена или отключена |
| TIMEOUT | None | Превышено время ожидания |
| CLIENT | Medical mask check failed | Обнаружена медицинская маска, проверка не пройдена |
| CALC_RESULT | Mask Attack | Зафиксирована атака с использованием маски |
| CLIENT | Illumination check failed | Неподходящее освещение (слишком темно/ярко) |
| CLIENT | Glasses check failed | Система не смогла корректно обработать лицо в очках |
| SERVICE_ERROR | Can`t connect to liveness service | Нет соединения с сервисом Liveness |
| CLIENT | Maximum number of attempts has been used | Достигнуто максимальное количество попыток |
| DIFFERENT_FACES | Different faces in liveness detections | В разных кадрах обнаружены разные лица |
Face2Face#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| SERVICE_ERROR | Can`t connect to face2face service | Нет соединения с сервисом Face2Face |
| CALC_RESULT | Different faces | Лица на фото и в базе не совпадают |
| SERVICE_ERROR | No face found | Лицо не найдено на изображении |
Document Recognition#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| NO_CAM | None | Камера не найдена или отключена |
| CLIENT | Wrong document country | Документ из неподдерживаемой страны |
| OTHER | Wrong document country | Страна документа не поддерживается |
| OTHER | Wrong document side | Передана неверная сторона документа |
| CLIENT | Wrong document side | Пользователь загрузил неверную сторону документа |
| OTHER | Document type mismatch | Загружен документ неподходящего типа |
| TIMEOUT | None | Истекло время ожидания загрузки документа |
| CLIENT | Error while parsing document | Ошибка при распознавании документа |
| CLIENT | Document Recognition result for this session exists | Для этой сессии результат уже существует |
| CLIENT | Document type mismatch | Тип документа не соответствует ожидаемому |
| CLIENT | Operation aborted by user | Пользователь прервал процесс загрузки документа |
| OTHER | Operation aborted by user | Процесс распознавания остановлен внешне |
| SERVICE_ERROR | Error while parsing document | Внутренняя ошибка сервиса при распознавании |
| OTHER | Error while parsing document | Ошибка разбора документа |
E-Document#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| REQUEST_ERROR | None | Ошибка при формировании запроса |
| CLIENT | Subject not found in MCDB | Пользователь не найден в базе БМГ |
| CLIENT | Document type is not the same as requested type | Тип документа не совпадает с запрошенным |
| CLIENT | Profile is not found | Профиль пользователя не найден |
| CLIENT | Document does not exist | Документ не существует в базе |
| CLIENT | Operation aborted by user | Пользователь прервал процесс |
| SERVICE_ERROR | DL service not available now. | Сервис выдачи документов временно недоступен |
| SERVICE_ERROR | Government service error | Ошибка на стороне госуслуг |
| CLIENT | Too many requests to e-document service | Превышено количество запросов к сервису |
| SERVICE_ERROR | E-Document service is not available now | Сервис E-Document недоступен |
| SERVICE_ERROR | Could not send request to E-Document service | Не удалось отправить запрос в сервис E-Document |
| SERVICE_ERROR | Can`t connect to E-Document service | Нет соединения с сервисом E-Document |
| CLIENT | Access to document is not found or is not active | Нет доступа к документу или он недействителен |
Address v1 / v2#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| SERVICE_ERROR | Can`t connect to address service | Нет соединения с сервисом Address |
| CLIENT | TIMEOUT | Истекло время ожидания ответа |
| CLIENT | INVALID | Переданы некорректные данные |
| CLIENT | NOT_FOUND | Адрес не найден в базе |
| SERVICE_ERROR | Внутренняя ошибка сервиса |
GBDFL v1 / v2#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| CLIENT | Person not found, invalid IIN or IIN not found | Пользователь с таким ИИН не найден |
| SERVICE_ERROR | A server error occurred. | Внутренняя ошибка сервиса GBDFL |
| CLIENT | INVALID | Переданы некорректные данные |
| CLIENT | NOT_FOUND | Данные по ИИН не найдены |
| REQUEST_ERROR | None | Ошибка в запросе |
| CLIENT | GBDFL token already received | Токен GBDFL уже был получен ранее |
| OTHER | Service error | Прочая ошибка сервиса |
| REQUEST_ERROR | Unexpected error | Непредвиденная ошибка |
Face2Face (NPCK)#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| CLIENT | Credentials not provided | Не переданы учетные данные |
| SERVICE_ERROR | F2F NPCK service unavailable | Сервис Face2Face (NPCK) недоступен |
Kz-Info#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| SERVICE_ERROR | Exec proc info request failed | Ошибка выполнения запроса в сервис Kz-Info |
DS Identifier / DS Signer#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| CLIENT | Digital Signature invalid input | Неверные данные для ЭЦП (ошибка ввода или формат не соответствует требованиям) |
| CLIENT | Digital Signature Identity card does not exist | Удостоверение личности не найдено в базе для ЭЦП |
| CLIENT | Digital Signature Organization Client does not exist | Клиент организации для ЭЦП не найден |
| CLIENT | Digital Signature Client does not exist | Клиент для ЭЦП не найден |
| CLIENT | Digital Signature Organization does not exist | Организация для ЭЦП не найдена |
| CLIENT | Digital Signature Identifier result for this session does not exist | Результат DS Identifier для этой сессии отсутствует |
| CLIENT | Digital Signature Identifier result for this session already exists | Результат DS Identifier для этой сессии уже существует |
| CLIENT | Failure reason for this Digital Signature Identifier result already exists | Причина ошибки для DS Identifier по этой сессии уже зафиксирована |
| CLIENT | Client does not have access to Digital Signature Identifier technology | У клиента нет доступа к технологии DS Identifier |
| SERVICE_ERROR | Cannot connect to Digital Signature service | Нет соединения с сервисом Digital Signature |
| SERVICE_ERROR | Digital Signature service is not available now | Сервис Digital Signature временно недоступен |
Flow#
| Failure Type | Failure Detail | Описание |
|---|---|---|
| EXPIRED | Flow session was expired | Сессия проверки истекла (пользователь слишком долго не завершил процесс KYC) |
| OTHER | Any | Непредвиденная ошибка |