# Решение проблем с загрузкой и распознаванием документов

Source: https://help.didit.me/ru/documents-coverage/document-upload-problems
Updated: 2026-09-15

Проверьте по порядку: разрешён ли подтип документа, снята ли оборотная сторона, достаточно ли качество снимка и оригинал ли это, а не копия.

Разбирайте проблему в таком порядке: разрешён ли этот **подтип** документа в вашем воркфлоу,
было ли снято фото **оборотной стороны**, было ли изображение **достаточно качественным** и было
ли это оригинальное фото, а не скриншот или скан. Эти четыре пункта покрывают почти все случаи.

[Video: Автоматический захват документа: снимок ID в момент появления в кадре - Didit Academy](https://www.youtube.com/watch?v=e1nmOvyHZnk)

Если документ не загружается или ключевые поля извлекаются некорректно, почти всегда причина - одна из немногих известных. Вот как их разобрать.

## Сначала: документ вообще разрешён?

Прежде чем разбираться с качеством изображения, убедитесь, что ваш воркфлоу принимает именно этот **подтип** документа для этой страны. Недопустимый подтип выглядит как проблема распознавания, но ею не является - и он не сработает для каждого пользователя с этим форматом документа, а не только для одного. См. [подтипы - обычная причина отклонения документа](https://help.didit.me/ru/documents-coverage/supported-documents-and-countries).

## Размытые, тёмные или пересвеченные изображения

Didit проверяет качество изображения перед обработкой документа и просит пользователя переснять фото, если оно слишком размытое, слишком тёмное или слишком яркое. Попросите пользователя:

- Использовать хорошее равномерное освещение без прямых бликов
- Держать камеру неподвижно и дать ей сфокусироваться перед съёмкой
- Держать все четыре угла документа в кадре
- Достать документ из пластикового чехла - отражение мешает автозахвату

У пользователей ограниченное число попыток переснять фото; на последней разрешённой попытке изображение принимается, чтобы пользователь никогда не оказался заблокирован навсегда, но некачественный снимок всё равно может оставить поля нераспознанными. Проверьте предупреждения сессии на `IMAGE_TOO_BLURRY`, `IMAGE_TOO_DARK` или `IMAGE_TOO_BRIGHT`, чтобы подтвердить эту причину.

**Если размытые документы проходят и даже одобряются**, планка для вашего аппетита к риску задана слишком низко. Это исправляют две настройки в шаге проверки документа рабочего процесса:

- **Минимальное качество изображения** (ползунок качества): каждое фото документа оценивается моделью качества в момент съёмки, и снимки ниже вашего минимума мгновенно отклоняются с просьбой переснять. Значение по умолчанию намеренно мягкое; поднимите его, и размытый оборот карты с оценкой 33 никогда не дойдёт до проверок.
- **Экран проверки снятого изображения** (в разделе Расширенный): показывает человеку только что сделанное фото и просит подтвердить его или отсканировать заново до загрузки. Применяется только к сканам камерой, поскольку загрузки уже показывают предпросмотр файла.

Сама оценка качества есть в отчёте сессии, так что вы можете посмотреть на встревожившие вас сессии и выбрать порог чуть выше них.

## Поле не обнаружено или прочитано неверно (имя, дата рождения, номер документа)

Когда OCR не может извлечь конкретное поле, само по себе это обычно **не** приводит к отклонению сессии - по умолчанию она направляется на ручную проверку, чтобы человек мог это проверить.

Если это происходит часто для одного типа документа или одного языка, проверьте настройку **Preferred character format** вашего воркфлоу: выберите, должны ли извлечённые имена нормализоваться в латиницу или сохраняться в оригинальной письменности документа. Несоответствие здесь - частая причина искажённых или отсутствующих полей с именем на документах с кириллицей, арабским, греческим или иероглифическим письмом.

Если извлечено неверное значение (фамилия с одной неправильной буквой, адрес в поле имени), см. [исправление неверно прочитанного имени или поля](https://help.didit.me/ru/verification-sessions/correct-extracted-data): поддержка не может отредактировать его за вас, но это могут шаг проверки данных пользователем, API update-data и повторная подача.

## Скриншоты, распечатки и фото экрана отклоняются

Didit требует оригинальное, снятое в реальном времени фото физического документа - а не скриншот, скан, распечатанную копию или фото документа с другого экрана. Проверки document liveness специально созданы для выявления именно таких случаев и пометят или отклонят сессию. Попросите пользователя сфотографировать физический документ напрямую.

Это сделано намеренно: принятие фото фотографии сводит на нет саму ценность проверки документа.

Детектор снимка экрана иногда может сработать на подлинном документе, сфотографированном на пёстром фоне - клавиатура, стол с узором, монитор позади карты. Если вы посмотрели изображения и документ явно настоящий, **одобрите сессию сами**: метка направляет на проверку именно для того, чтобы решение принял человек. У каждого сигнала liveness документа (снимок экрана, печатная копия, подмена портрета) в настройках подделки шага есть собственные пороги проверки и отклонения на случай, если какой-то из них слишком чувствителен для вашего трафика.

## Отсутствует фото оборотной стороны

Удостоверения личности и водительские удостоверения двусторонние - Didit нужно фото и лицевой, и оборотной стороны, чтобы завершить извлечение данных. Для паспортов нужна только страница с фото.

Если пользователи регулярно застревают на шаге съёмки оборотной стороны, проверьте, действительно ли документ, о котором идёт речь, содержит на обороте читаемые данные в этой стране. Требовать фото оборотной стороны, на которой ничего нет, значит заставлять пользователей проваливать шаг без всякой пользы.

## Камера вообще не открывается

Это выглядит как проблема с документом, но на самом деле это проблема среды:

- **Встроенные браузеры приложений.** Ссылка, открытая во встроенном браузере другого приложения (например, чата), часто не может получить доступ к камере. Открытие той же ссылки в обычном браузере телефона решает проблему.
- **Ранее отклонённое разрешение.** Как только человек отказал сайту в доступе к камере, браузер это запоминает. Разрешение нужно выдать заново в настройках сайта; поток не может запросить его снова.
- **Камера уже используется.** Другая вкладка или приложение, удерживающее камеру, блокирует к ней доступ. На некоторых устройствах предоставление доступа к микрофону тоже может занять камеру.

## Текст в потоке выглядит искажённым

Если пользователь сообщает о перепутанных или бессмысленных словах в интерфейсе (не на документе), обычная причина - расширение браузера для перевода страницы, переписывающее экран. Попросите отключить перевод для этой страницы - поток уже предлагает собственные языки. См. [настройка языка верификации](https://help.didit.me/ru/workflows/verification-languages).

## Сколько языков поддерживает OCR?

OCR Didit распознаёт документы на более чем 130 языках в рамках [покрытия по документам и странам](https://help.didit.me/ru/documents-coverage/supported-documents-and-countries). Это отдельно от языка самого экрана верификации, который браузер пользователя устанавливает автоматически, если вы не зададите его явно.

## Всё ещё не получается?

[Свяжитесь с поддержкой](mailto:support@didit.me) и укажите **ID сессии** проблемной верификации - это самый быстрый способ для команды разобраться в конкретном случае, потому что он позволяет увидеть именно те изображения и предупреждения, о которых вы говорите.