KYC ПЛАТФОРМА

Ошибки

Сервис OCR возвращает ошибки через HTTP-статус и тело ответа. Ошибки делятся на системные и бизнес-ошибки.

Бизнес-ошибка «Документ не распознан»

Если сервис не может извлечь данные из изображения, возвращается ответ:

{
  "title": "DocumentNotRecognized",
  "message": "Невозможно произвести извлечение данных из документа."
}

Такая ошибка возможна, если:

  • на фото нет документа;
  • документ не поддерживается;
  • изображение некорректное или низкого качества;
  • сервис не смог извлечь данные из документа.

Если на вход передана фотография, но документ не распознан, запрос тарифицируется.

Системные ошибки

HTTP Статус Описание
500 system_error Ошибка сервиса распознавания
500 internal_error Ошибка прокси-сервиса
500 empty_request_body Пустое тело запроса
500 not_found_mapping_querry Не удалось найти скрипт маппинга

Бизнес-ошибки

HTTP Статус Описание
400 photos_not_found Фотографии документов не были найдены
400 empy_mapped_document Полученный документ после маппинга является пустым
400 empty_or_correct_type_format Некорректный формат типа документа
400 document_type_not_found Тип документа не найден в системе
400 empty_photo_document На фото отсутствует документ, удостоверяющий личность
400 document_not_recognised Невозможно произвести извлечение данных из документа
400 unsupported_document_file_format Отправлен неподдерживаемый формат файла
400 tenant_id_not_provided Ошибка авторизации: не передан token / Dc Application Id

Рекомендации по обработке

  • Логируйте HTTP-код, статус ошибки и тело ответа.
  • Для системных ошибок настраивайте ретраи и алерты.
  • Для бизнес-ошибок показывайте пользователю понятное действие: перефотографировать документ, выбрать другой тип документа или обратиться в поддержку.
  • Не используйте DocumentNotRecognized как признак фрода: OCR не выполняет антифрод-проверку документа, а только сообщает, что данные не извлечены.