На этой странице собраны коды ошибок, которые возвращают методы /kyc/process и /kyc/session/status. Код [legal] database check failed появляется позже, когда завершатся проверки сессии по базам данных: он приходит в статусе сессии и в вебхуке SESSION_COMPLETE. Для каждого кода указано, что он означает и что сделать пользователю. Тексты из колонки «Что делать» можно показывать пользователю как подсказку.
Код состоит из категории в квадратных скобках и названия ошибки, например [document] cropped.
Общие ошибки изображения — [general]
| Код | Что означает | Что делать |
|---|---|---|
[general] bad image | Переданный файл не является изображением | Отправьте фотографию в формате JPEG или PNG |
[general] too small image | Изображение слишком маленькое для распознавания | Сделайте фотографию в более высоком разрешении |
[general] no documents on image | На изображении не найден документ | Убедитесь, что фотографируете требуемый документ |
[general] not a selfie | За пределами документа не найдено лицо | Протрите камеру и сделайте новую фотографию; лицо должно быть в фокусе и хорошо видно |
[general] low light | Изображение слишком тёмное | Включите дополнительный свет или перейдите в более освещённое место |
[general] black and white image | Изображение чёрно-белое | Не используйте фильтры: фотография должна быть цветной |
[general] too many faces | На изображении документа найдено больше лиц, чем должно быть | Фотографируйте только документ; на заднем плане не должно быть других людей |
[general] age requirement mismatch | Возраст не соответствует требованиям сценария | Пройти проверку сейчас нельзя |
[general] too many tries | Превышено допустимое число попыток загрузить изображение этого типа | Попытки в этой сессии исчерпаны; для новой проверки нужна новая сессия |
[general] data mismatch | ФИО или дата рождения расходятся между шагами сессии или с данными анкеты; шаг не пройден | Используйте документы одного человека и проверьте данные анкеты |
Ошибки документа — [document]
| Код | Что означает | Что делать |
|---|---|---|
[document] unknown document type | Тип документа на изображении не распознан | Убедитесь, что фотографируете требуемый документ |
[document] bad document type | Документ распознан, но не подходит для этого шага сценария | Сфотографируйте документ того типа, который запрашивается |
[document] bad pages | Сфотографирована не та страница документа | Сфотографируйте требуемый разворот, например главный разворот паспорта |
[document] too small image | Документ занимает слишком малую часть кадра | Поднесите камеру ближе к документу |
[document] cropped | Документ виден не полностью | Держите камеру дальше: документ должен целиком помещаться в кадр |
[document] bad quality | Качество изображения недостаточно для распознавания | Протрите камеру и сделайте новую фотографию в фокусе |
[document] text fields not visible | Поля документа не видны | Протрите камеру и сделайте новую фотографию; поля не должны быть закрыты пальцами или бликами |
[document] text field has low confidence | Поле распознано недостаточно уверенно | Протрите камеру и сделайте новую фотографию в фокусе |
[document] bad mrz checksum | Данные машиночитаемой зоны (MRZ) не прошли проверку контрольных сумм | Сделайте новую фотографию: строки MRZ должны быть полностью видны и чёткими |
[document] no face | На документе не найдена фотография владельца | Убедитесь, что фотография в документе хорошо видна |
[document] no signature | В документе нет подписи | Документ недействителен, используйте другой |
[document] no stamp | В документе нет печати | Документ недействителен, используйте другой |
[document] no required objects | В документе нет обязательных элементов, например защитных | Документ недействителен, используйте другой |
[document] no required fields | В документе нет обязательных полей | Документ недействителен, используйте другой |
[document] expired | Срок действия документа истёк | Используйте действующий документ |
[document] other error | Документ не соответствует требованиям | Предъявите другой документ |
Признаки подделки — [fraud]
| Код | Что означает | Что делать |
|---|---|---|
[fraud] display or screen | Сфотографирован экран | Сфотографируйте оригинал документа, а не его изображение на экране |
[fraud] mobile device | В кадре экран мобильного устройства | Сфотографируйте оригинал документа, а не его изображение на экране |
[fraud] image printed | Изображение похоже на ксерокопию или распечатку | Сфотографируйте оригинал документа |
[fraud] image edited | Изображение обработано в графическом редакторе | Сфотографируйте оригинал документа и отправьте снимок без обработки |
[fraud] document modified | Документ физически изменён: исправления, вклеенные элементы | Используйте документ без исправлений и вклеек |
[fraud] bad document photo | Фотография в документе вызывает подозрения | Не закрывайте фотографию и область вокруг неё пальцами или предметами |
[fraud] document damaged | Документ повреждён | Документ недействителен, используйте другой |
[fraud] logical mismatch | В данных документа найдены логические несоответствия | Проверка не пройдена |
[fraud] manipulation detected | В сессии загружены разные документы или документы разных людей | Повторите съёмку по требованиям сценария, используя один и тот же документ |
[fraud] multiple documents | В сессии загружены разные документы одного типа | Проверка не пройдена |
[fraud] black list | Пользователь найден в чёрном списке | Проверка не пройдена |
Ошибки проверки лица — [face]
| Код | Что означает | Что делать |
|---|---|---|
[face] bad face matching | Лицо на селфи не совпадает с фотографией в документе | Сделайте селфи с документом в руке: лицо и документ должны быть видны полностью |
[face] not all faces found | Не все лица, нужные для проверки, найдены | Протрите камеру и сделайте новую фотографию в фокусе |
[face] face out of frame | Лицо обрезано краем кадра | Держите телефон так, чтобы лицо целиком помещалось в кадр |
[face] face occluded | Лицо закрыто документом | Держите документ рядом с лицом, не закрывая его |
[face] is deepfake | Лицо на изображении имеет признаки генерации или подмены | Используйте настоящую фотографию, без обработки |
[face] is not alive | Изображение не прошло проверку Liveness | Пройдите проверку сами, перед камерой, при хорошем освещении |
[face] reference session unusable | Лицо из ранее пройденной сессии, с которой сравнивается селфи, недоступно для сравнения | Сравнение с этой сессией невозможно; для проверки нужна новая сессия с документом |
Ошибки анкеты — [questionnaire]
| Код | Что означает | Что делать |
|---|---|---|
[questionnaire] bad name | ФИО короче двух слов или слишком длинное, либо не заполнено обязательное поле | Укажите полное ФИО и заполните обязательные поля |
[questionnaire] bad age | Дата рождения некорректна или возраст вне допустимого диапазона | Проверьте дату рождения |
[questionnaire] session not found | Запись анкеты не найдена | Заполните анкету заново |
[questionnaire] questionnaire not completed | Анкета не заполнена до конца | Завершите заполнение анкеты |
[questionnaire] wrong code | Введён неверный код подтверждения | Проверьте код и введите его снова |
[questionnaire] code expired | Срок действия кода истёк | Запросите новый код |
[questionnaire] code locked | Слишком много неверных попыток, ввод кода временно заблокирован | Подождите и запросите новый код |
[questionnaire] code resend cooldown | Новый код пока нельзя запросить | Подождите и запросите код позже |
[questionnaire] confirm required | Email или телефон не подтверждён кодом или изменён после подтверждения | Подтвердите контакт кодом |
Проверки по внешним базам — [legal]
| Код | Что означает | Что делать |
|---|---|---|
[legal] document not valid | Документ недействителен по данным внешней базы | Замените документ и пройдите проверку снова |
[legal] legal proceeding existence | У пользователя есть открытое исполнительное производство | Проверка не пройдена |
[legal] database check failed | Не пройдена проверка по внешней базе, которая в сценарии отмечена как блокирующая: например, документ недействителен, проверку не удалось выполнить из-за нехватки данных или база была недоступна. Сессия получает статус failed | Причину смотрите в результатах проверок по базам данных сессии (kyc/session/databases). Если документ недействителен — попросите пользователя пройти проверку с другим документом; если база была недоступна — повторите проверку |
Примечание. Проверка по внешней базе, не отмеченная в сценарии как блокирующая, кода ошибки не добавляет и статус сессии не меняет: её итог есть только в результатах проверок по базам данных — в методе kyc/session/databases и в вебхуке
DATABASE_CHECKS_COMPLETE.
Системные ошибки — [system]
| Код | Что означает | Что делать |
|---|---|---|
[system] balance too low | На балансе недостаточно средств | Пополните баланс учётной записи и повторите попытку |
[system] service timeout | Сервис не ответил вовремя | Отправьте изображение ещё раз |
[system] exception | Внутренняя ошибка сервиса | Отправьте изображение ещё раз; если ошибка повторяется, напишите в поддержку |
Примечание. Эти же коды возвращаются в ответах API KYC: по ним видно, на каком шаге проверки и по какой причине возникла ошибка.
