В таблице ниже приведены основные коды ошибок и проверки, которые могут возникать при прохождении KYC‑процедур на платформе NeuroVision. Для удобства включены лаконичное описание, пользовательский комментарий и краткое объяснение технологии, срабатывающей за каждой проверкой. Справочник согласован с внутренним разделом «Ошибки» и примерами ответов методов /kyc/process и /kyc/session/status.
| № | Код проверки | Описание | Комментарий | Описание технологии |
|---|---|---|---|---|
| 1 | [general] bad image | Переданный файл не является изображением | Вы отправили файл, не являющийся изображением | При загрузке изображения система проверяет его тип. Поддерживаются только JPEG и PNG. Если файл не соответствует этим форматам, возвращается ошибка с указанием, что переданный файл не является изображением. |
| 2 | [general] too small image | Изображение слишком маленькое для успешного распознавания | Изображение имеет слишком низкое разрешение для успешной обработки, сделайте более качественную фотографию | Система проверяет разрешение загруженного изображения в пикселах. Для успешной обработки большее из измерений (ширина или высота) должно быть не менее 300 пикселей. Если это условие не выполняется, возвращается ошибка с рекомендацией загрузить фотографию более высокого качества. |
| 3 | [general] no documents on image | На изображении не найдены документы | Убедитесь, что вы фотографируете требуемый документ | Система использует нейронную сеть (детектор) для анализа изображения. Если на изображении не обнаруживаются объекты, которые можно идентифицировать как документы, возвращается ошибка с рекомендацией убедиться, что на фото присутствует требуемый документ. |
| 4 | [general] not a selfie | За пределами документа не обнаружено лиц | Протрите камеру и попробуйте сделать новую фотографию, убедитесь что изображение в фокусе | Система анализирует изображение, проверяя наличие лица за пределами документа. Используется детектор лиц, который определяет лицо определенного размера. Если лицо за пределами документа не обнаружено, возвращается ошибка с рекомендацией убедиться, что изображение в фокусе и лицо четко видно. |
| 5 | [general] low light | Недостаточное освещение (слишком темное изображение) | Используйте дополнительные источники света или выберите более освещенное место для съемки | Система применяет алгоритм для анализа уровня освещенности изображения. Если уровень освещенности ниже установленного порога, возвращается ошибка с рекомендацией использовать дополнительные источники света или выбрать более освещенное место для съемки. |
| 6 | [general] age requirement mismatch | Возраст не соответствует требованиям | Ваш возраст не соответствует требованиям, возвращайтесь позднее | Система использует нейронную сеть для определения возраста человека по изображению лица. Возраст определяется с погрешностью ±4 года. Если вычисленный возраст оказывается ниже установленного порога или отличается на ±4 года от возраста персоны в документе — возвращается ошибка с указанием, что возраст не соответствует требованиям. |
| 7 | [general] black and white image | Черно-белое изображение | Не используйте фильтры при фотографировании, изображение должно быть цветным | Система анализирует цветовые каналы изображения. Если изображение содержит только один канал (черно-белое), возвращается ошибка с рекомендацией использовать цветное изображение без фильтров. |
| 8 | [general] too many faces | На изображении документа найдено более одного лица | Убедитесь, что вы фотографируете только документ, и на заднем плане отсутствуют другие лица | Система использует детектор лиц для анализа изображения. Для документа проверяется, что на фото присутствует не более соответствующего для этого типа документа лиц. Если на изображении документа обнаруживаются дополнительные лица, возвращается ошибка. |
| 9 | [document] unknown document type | На изображении неизвестный тип документа | Убедитесь, что вы фотографируете требуемый документ | Система использует детектор документов для анализа изображения. Если на фото обнаруживается документ, тип которого не может быть идентифицирован (отсутствует в базе известных типов документов), возвращается ошибка с рекомендацией убедиться, что фотографируется требуемый документ. |
| 10 | [document] bad document type | Некорректный тип документа | Убедитесь, что вы фотографируете требуемый документ | Система использует детектор документов для анализа изображения. Если документ успешно классифицирован, но не соответствует требованиям текущего сценария на данном шаге, возвращается ошибка с рекомендацией убедиться, что фотографируется требуемый документ. |
| 11 | [document] too small image | Документ слишком мал | Документ на изображении слишком маленький, поднесите камеру ближе | Система проверяет размер документа на изображении, распознанного детектором. Если большая сторона документа (ширина или высота) составляет менее 200 пикселей, это считается недостаточным для успешного распознавания текста. Возвращается ошибка с рекомендацией поднести камеру ближе. |
| 12 | [document] bad pages | Проблема со страницами | Убедитесь, что вы фотографируете требуемые страницы документа | Система классифицирует распознанный документ и проверяет соответствие разворота требованиям сценария. Если вместо требуемого разворота (например, главного разворота паспорта) загружена другая страница документа, возвращается ошибка с рекомендацией сфотографировать нужные страницы документа. |
| 13 | [document] no face | Не найдено лиц на изображении документа | Убедитесь, что фотография в документе видна | Система использует детектор лиц для анализа изображения документа. Если на изображении документа не обнаруживается лицо (фотография владельца паспорта) или оно недостаточно хорошо видно для успешного распознавания, возвращается ошибка с рекомендацией убедиться, что фотография в документе четко видна. |
| 14 | [document] text fields not visible | Поля не видны | Протрите камеру и попробуйте сделать новую фотографию, убедитесь что изображение в фокусе | Система использует детектор полей для анализа изображения документа. Если необходимое поле не обнаруживается (например, из-за размытия, перекрытия рукой или других факторов), возвращается ошибка с рекомендацией сделать новую фотографию, убедившись, что изображение в фокусе и поля документа видны. |
| 15 | [document] bad mrz checksum | Ошибка MRZ | Протрите камеру и попробуйте сделать новую фотографию, убедитесь что изображение в фокусе | Система использует технологию OCR (распознавание текста) для извлечения данных из всех полей документа, включая строки машиночитаемой зоны (MRZ). На основе извлечённых данных рассчитываются контрольные суммы в соответствии с установленным законодательством алгоритмом. Если контрольные суммы не совпадают с указанными в MRZ или строки MRZ не полностью видны, возвращается ошибка с рекомендацией сделать новую фотографию, убедившись, что изображение в фокусе. |
| 16 | [fraud] display or screen | Фото экрана/дисплея | Экранную копию использовать нельзя, сделайте фото оригинала документа | Система применяет нейронную сеть-классификатор для анализа изображения. Нейронная сеть вычисляет вероятность того, что фотография содержит признаки изображения с экрана. Если вероятность высокая, возвращается ошибка с рекомендацией сделать фото оригинального документа. |
| 17 | [fraud] image edited | Изображение документа имеет признаки вмешательства графического редактора | Отредактированную фотографию использовать нельзя, сделайте фото оригинала документа | Система анализирует метаданные загруженного изображения. Если в метаданных обнаруживаются сведения, указывающие на то, что файл был открыт или изменён в графическом редакторе, возвращается ошибка с рекомендацией сделать фото оригинального документа без редактирования. |
| 18 | [fraud] image printed | Изображение документа имеет признаки ксерокопии | Фотографию с распечатки использовать нельзя, сделайте фото оригинала документа | Система применяет нейронную сеть-классификатор для анализа изображения. Классификатор определяет вероятность того, что изображение является фотографией распечатанного на принтере документа, основываясь на признаках черно-белой или цветной распечатки. Если вероятность превышает установленный порог, возвращается ошибка с рекомендацией сделать фото оригинального документа. |
| 19 | [face] bad face matching | Лица в документе и изображении селфи не совпадают | Сделайте селфи с документом в руке, лицо и документ должны быть полностью видны | Производится сравнение лиц на документах и селфи с документом, попарно. Если количество лиц N, то количество совпадающих пар должно быть N−1. Если хотя бы одна пара не совпадает, возвращается ошибка. |
| 20 | [face] not all faces found | Не все лица, необходимые для проверки, найдены | Протрите камеру и попробуйте сделать новую фотографию, убедитесь что изображение в фокусе | При выполнении процедуры Liveness делается 5 фотографий для проверки. Если хотя бы на одной фотографии лицо не обнаружено, возвращается ошибка с рекомендацией убедиться, что камера в фокусе. |
| 21 | [fraud] black list | Пользователь в черном списке | Вы не прошли проверку | Производится поиск лица пользователя в черном списке. При совпадении, возвращается ошибка с указанием, что пользователь находится в черном списке. |
| 22 | [legal] legal proceeding existence | У пользователя есть открытый судебный процесс | Вы не прошли проверку | Система выполняет запрос в базу данных Федеральной Службы Судебных Приставов (ФССП РФ). Если у пользователя найден открытый судебный процесс, возвращается ошибка с указанием, что проверка не пройдена. |
| 23 | [legal] document not valid | Документ не действителен | Ваш документ не действителен, замените его и попробуйте еще раз | Система выполняет запрос в базу данных МВД для проверки статуса документа. Если документ оказывается недействительным, возвращается ошибка с рекомендацией заменить его на актуальный и повторить проверку. |
| 24 | [system] balance too low | Недостаточно средств на балансе | Пополните баланс и попробуйте еще раз | Система проверяет текущий баланс счета пользователя. Если средств недостаточно для выполнения запроса или операции, возвращается ошибка с рекомендацией пополнить баланс и повторить попытку. |
| 25 | [system] exception | Внутренняя ошибка сервиса | Попробуйте отправить изображение еще раз | Ошибка возвращается, если в процессе обработки данных система сталкивается с непредвиденной внутренней ошибкой. Пользователю предлагается повторить отправку изображения. |
| 26 | [document] bad quality | Плохое качество изображения | Протрите камеру и попробуйте сделать новую фотографию, убедитесь что изображение в фокусе | Система применяет алгоритм оценки качества изображения. Если изображение имеет низкое качество, недостаточное для успешного распознавания, возвращается ошибка с рекомендацией протереть камеру и сделать новую фотографию. |
| 27 | [general] too many tries | Превышено максимальное количество попыток | Вы исчерпали допустимое количество попыток загрузки ожидаемого типа изображения | Система ограничивает количество попыток загрузки для каждого типа документа до 6 в рамках одной сессии. Если пользователь исчерпывает допустимое количество попыток для любого из поддерживаемых типов документов, сессия блокируется, и дальнейшая загрузка становится невозможной. |
| 28 | [fraud] manipulation detected | Обнаружена попытка манипуляции данными | Повторите фотографирование в соответствии с требованиями | Система отслеживает последовательность загружаемых документов в рамках одной сессии. Если обнаруживается использование различных документов (например, документов разных людей) или документов одного пользователя, но разных типов (например, паспорт и водительские права), возвращается ошибка с рекомендацией повторить фотографирование в соответствии с требованиями. |
| 29 | [fraud] document modified | Документ физически изменен | Документ не должен иметь физических модификаций или вклеенных элементов | Система анализирует изображение документа на наличие признаков физических изменений. Проверяются исправления ручкой, а также вклеенные элементы, например напечатанные и приклеенные поля. Если обнаруживаются такие модификации, возвращается ошибка с рекомендацией использовать оригинальный и неизменённый документ. |
| 30 | [fraud] logical mismatch | Обнаружены логические несоответствия | Вы не прошли проверку | Система выполняет проверку данных документа на наличие логических несоответствий. Анализируются даты, серии и номера документа. Если обнаруживаются явные ошибки, такие как несуществующие даты или серийные номера, возвращается ошибка с указанием, что проверка не пройдена. |
| 31 | [fraud] bad document photo | Фото в документе вызывает подозрения | Не закрывайте фотографию и зону вокруг нее пальцами или посторонними предметами | Система анализирует фотографию в документе на наличие признаков подделки. При подозрении, что фотография приклеена поверх оригинальной или нарисована в графическом редакторе, возвращается ошибка. |
| 32 | [fraud] mobile device | Фото произведено с экрана мобильного устройства | Экранную копию использовать нельзя, сделайте фото оригинала документа | Система использует нейронную сеть (детектор) для анализа изображения. Детектор ищет признаки устройств с экранами (смартфоны, мониторы, телевизоры и т.п.), на которых может быть отображён документ или селфи. Если обнаруживается такое устройство, возвращается ошибка с рекомендацией не фотографировать такие устройства. |
| 33 | [fraud] document damaged | Документ поврежден | Документ не действителен, необходимо произвести замену | Система применяет нейронную сеть для анализа изображения документа на наличие повреждений. Если документ имеет явные повреждения (порванные или оторванные страницы, следы краски или другие дефекты), возвращается ошибка с рекомендацией заменить повреждённый документ. |
| 34 | [document] cropped | Документ виден не полностью | Документ должен быть виден полностью, держите камеру дальше от документа | Система проверяет, полностью ли виден документ на фотографии после его детектирования. Если часть документа выходит за пределы изображения и не попадает в кадр, возвращается ошибка с рекомендацией сделать новый снимок, чтобы документ был полностью видим. |
| 35 | [document] no signature | В документе отсутствует подпись | Документ не действителен, необходимо произвести замену | Система использует нейронную сеть (детектор) для поиска подписей в документе. Если подписи владельца документа или лица, выдавшего документ, не обнаружены, возвращается ошибка с рекомендацией заменить документ на действительный. |
| 36 | [document] no stamp | В документе отсутствует печать | Документ не действителен, необходимо произвести замену | Система применяет нейронную сеть (детектор) для анализа изображения документа. Если необходимая печать не обнаруживается, возвращается ошибка с рекомендацией заменить документ на действительный. |
| 37 | [document] no required objects | В документе отсутствуют необходимые элементы | Документ не действителен, необходимо произвести замену | Система анализирует документ на наличие всех обязательных элементов (наклейки, голограммы и другие защитные элементы). Если какой-либо из этих элементов отсутствует, возвращается ошибка с рекомендацией заменить документ на действительный. |
| 38 | [document] text field has low confidence | Поле распознано с низкой уверенностью | Протрите камеру и попробуйте сделать новую фотографию, убедитесь что изображение в фокусе | Система использует детектор полей для анализа изображения документа. Если необходимое поле не обнаруживается (например, из-за размытия, перекрытия рукой или других факторов), возвращается ошибка с рекомендацией сделать новую фотографию, убедившись, что изображение в фокусе и поля документа видны. |
| 39 | [fraud] multiple documents | Разные документы одного типа | Вы не прошли проверку | Система анализирует загружаемые документы и отслеживает изменения в них в рамках одной сессии. Если пользователь отправляет один и тот же тип документа, но с разными данными (например, сначала загружает один паспорт, а затем другой, или изменяет информацию в документе), система фиксирует попытку манипуляции. Возвращается соответствующая ошибка с отказом в проверке. |
| 40 | [document] expired | Время действия документа истекло | Документ не действителен, необходимо произвести замену | Система проверяет срок действия загружаемого документа. Если документ просрочен и не является действительным согласно установленным требованиям (например, истёк срок действия паспорта или водительского удостоверения), возвращается соответствующая ошибка. Пользователю рекомендуется загрузить актуальный документ. |
| 41 | [system] service timeout | Превышено время ответа сервиса | Попробуйте отправить изображение еще раз | Ошибка возвращается, если в процессе обработки данных система сталкивается с превышением времени ответа микро сервиса. Пользователю предлагается повторить отправку изображения. |
| 42 | [document] other error | Документ не соответствует требованиям | Предъявите другой документ | Ошибка создана специально для режимов, когда мы хотим заблокировать документ, но не давать подробной подсказки что именно нас не устраивает. Применяется для предотвращения сложного фрода, в основном как временное решение |
| 43 | [face] is deepfake | Лицо на изображении имеет признаки генерации или подмены | Используйте оригинальное фото с настоящим лицом | Система анализирует лицо и выявляет признаки генерации. Если вероятность превышает допустимый порог, возвращается ошибка с рекомендацией загрузить неподдельное фото. |
| 44 | [face] is not alive | Изображение не прошло проверку на признаки «живого» лица | Предоставьте фото с живым человеком, сделанное при хорошем освещении | Система анализирует лицо на изображении и выявляет признаки отсутствия живости: статичность кожи, текстуру, резкость, отражения и другие параметры. Если совокупный скор указывает на высокую вероятность «неживого» лица (манекен, фото, экран), возвращается ошибка с требованием заменить изображение. |
| 45 | [document] no required fields | В документе отсутствуют необходимые поля | Документ не действителен, необходимо произвести замену | Система анализирует документ на наличие всех обязательных текстовых полей. Если какой-либо из этих полей отсутствует, возвращается ошибка с рекомендацией заменить документ на действительный. |
Примечание. Эти же коды встречаются в массивах
errorsответов API KYC (см. примеры в документации), что позволяет сопоставлять их с конкретными шагами проверки и источниками ошибок.