Правила проверок

Проверка паспорта РФ

В результате обработки входящего паспорта будет доступно поле verifications.verifications_passport,
в котором находятся следующие данные:

Название	Описание	Тип данных
status	статус проверки	integer
status_text	текстовое описание статуса	string
checks	Подробное описание произведенных проверок	dict
bad_fields	список полей полей имеющих несоответствия	list

Поле status может отражать следующие варианты кодов проверки:

Статусы по всем проверкам;

0 — проверки пройдены (или все проверки были пропущены '')
1 — хотябы одна не пройдена

Поле checks может отражать следующие данные проверок:

• fields_to_check_valid - проверка наличия обязательных полей

  0 — проверки пройдены
  1 — проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

• fio_series_number_mrz - проверка согласованности МЧЗ с полями документа

  0 — проверки пройдены
  1 — проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

• series_okato - проверка согласованности серии паспорта с кодом подразделения

  0 — проверки пройдены
  1 — проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

• region_valid - проверка согласованности места выдачи с кодом подразделения

  0 — проверки пройдены
  1 — проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

• issued_after_14 - проверка выдачи паспорта до 14 лет

  0 — проверки пройдены
  1 — проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

• issued_after_1997 - проверка выдачи паспорта до 1997 года

  0 — проверки пройдены
  1 — проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

• expiration_date - проверка действительности паспорта по дате истечения

  0 — проверки пройдены
  1 — проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

Проверка Водительского удостоверения

В результате обработки входящего водительского удостоверения будет доступно поле verifications.verifications_dlic,
в котором находятся следующие данные:

Поле status может отражать следующие варианты кодов проверки:

Статусы по всем проверкам;

0 — проверки пройдены (или все проверки были пропущены '')
1 — хотябы одна не пройдена

Поле checks может отражать следующие данные проверок:

• date_issue - Проверка Дата рождения < дата выдачи ВУ < дата окончания срока действия;

  0 — проверки пройдены
  1 — проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

  Условия проверки

  значение 1,
  если BirthDate > CategoryAStartDate > CategoryAEndDate
  или BirthDate > CategoryA1StartDate > CategoryA1EndDate
  или BirthDate > CategoryBStartDate > CategoryBEndDate
  или BirthDate > CategoryB1StartDate > CategoryB1EndDate
  или BirthDate > CategoryCStartDate > CategoryCEndDate
  или BirthDate > CategoryC1StartDate > CategoryC1EndDate
  или BirthDate > CategoryDStartDate > CategoryDEndDate
  или BirthDate > CategoryD1StartDate > CategoryD1EndDate
  или BirthDate > CategoryBEStartDate > CategoryBEEndDate
  или BirthDate > CategoryCEStartDate > CategoryCEEndDate
  или BirthDate > CategoryC1EStartDate > CategoryC1EEndDate
  или BirthDate > CategoryDEStartDate > CategoryDEEndDate
  или BirthDate > CategoryD1EStartDate > CategoryD1EEndDate
  или BirthDate > CategoryMStartDate > CategoryMEndDate
  или BirthDate > CategoryTmStartDate > CategoryTmEndDate
  или BirthDate > CategoryTbStartDate > CategoryTbEndDate
  

• certain_open_categories - Проверка Дата выдачи

  Дата рождения не менее 16 лет, 21 года для определенных открытых категорий M, BE

  Дата рождения > 16-летнего возраста для транспортных средств (далее также - ТС) категории "M" и подкатегории "A1" Дата рождения > 18-летнего возраста для ТС категорий "A", "B", "C" и подкатегорий "B1", "C1" Дата рождения > 21-летнего возраста для ТС категорий "D", "Tm", "Tb" и подкатегории "D1";

  0 - проверка пройдена
  1 - проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

  Условия проверки

  значение 1,
  если (CategoryAStartDate - BirthDate) < 18 лет
  или (CategoryC1StartDate - BirthDate) < 16 лет
  или (CategoryBEStartDate- BirthDate) < 21 года
  или (CategoryCEStartDate - BirthDate) < 16 лет
  или (CategoryDEStartDate - BirthDate) < 16 лет
  или (CategoryBStartDate - BirthDate) < 18 лет
  или (CategoryCStartDate - BirthDate) < 18 лет
  или (CategoryB1StartDate - BirthDate) < 18 лет
  или (CategoryC1EStartDate - BirthDate) < 18 лет
  или (CategoryMStartDate - BirthDate) < 16 года
  или (CategoryA1StartDate - BirthDate) < 16 лет
  или (CategoryDStartDate - BirthDate) < 21 года
  или (CategoryD1StartDate - BirthDate) < 21 года
  или (CategoryD1EStartDate - BirthDate) < 21 года
  или (CategoryTmStartDate - BirthDate) < 21 года
  или (CategoryTbStartDate - BirthDate) < 21 года
  

• driving_experience - стаж вождения более 12 месяцев;

  0 - проверка пройдена
  1 - проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

  Условия проверки

  значение 1,
  если (today - CategoryD1EStartDate) > 12 месяцев
  

• category_and_date_issue - проверка наличия у категории дат выдачи и окончания

  Если в поле Категории распознаны определенные значения, например B и B1, то в соответствующих полях Даты выдачи и Даты окончания по соответствующим категориям должны присутствовать значения дат;

  0 - проверка пройдена
  1 - проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

  Условия проверки

  значение 1,
  если Categories содержит значение A и (CategoryAStartDate = нет значения или CategoryAEndDate = нет значения)
  или Categories содержит значение B и (CategoryBStartDate = нет значения или CategoryBEndDate = нет значения)
  или Categories содержит значение B1 и (CategoryB1StartDate = нет значения или CategoryBEndDate = нет значения)
  или Categories содержит значение C и (CategoryCStartDate = нет значения или CategoryCEndDate = нет значения)
  или Categories содержит значение C1 и (CategoryC1StartDate = нет значения или CategoryC1EndDate = нет значения)
  или Categories содержит значение D и (CategoryDStartDate = нет значения или CategoryDEndDate = нет значения)
  или Categories содержит значение D1 и (CategoryD1StartDate = нет значения или CategoryD1EndDate = нет значения)
  или Categories содержит значение BE и (CategoryBEStartDate = нет значения или CategoryBEEndDate = нет значения)
  или Categories содержит значение CE и (CategoryCEStartDate = нет значения или CategoryCEEndDate = нет значения)
  или Categories содержит значение C1E и (CategoryC1EStartDate = нет значения или CategoryC1EEndDate = нет значения)
  или Categories содержит значение D1E и (CategoryD1EStartDate = нет значения или CategoryD1EEndDate = нет значения)
  или Categories содержит значение DE и (CategoryDEStartDate = нет значения или CategoryDEEndDate = нет значения)
  или Categories содержит значение M и (CategoryMStartDate = нет значения или CategoryMEndDate = нет значения)
  или Categories содержит значение Tm и (CategoryTmStartDate = нет значения или CategoryTmEndDate = нет значения)
  или Categories содержит значение Tb и (CategoryTbStartDate = нет значения или CategoryTbEndDate = нет значения)
  

• correct_formats - проверка на корректность форматов Дата в документе указана корректно;

  0 - проверка пройдена
  1 - проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

  Условия проверки

  значение 1,
  если BirthDate != формату ДД.ММ.ГГГ
  или CategoryAStartDate != формату ДД.ММ.ГГГ
  или CategoryA1StartDate != формату ДД.ММ.ГГГ
  или CategoryBStartDate != формату ДД.ММ.ГГГ
  или CategoryB1StartDate != формату ДД.ММ.ГГГ
  или CategoryCStartDate != формату ДД.ММ.ГГГ
  или CategoryC1StartDate != формату ДД.ММ.ГГГ
  или CategoryDStartDate != формату ДД.ММ.ГГГ
  или CategoryD1StartDate != формату ДД.ММ.ГГГ
  или CategoryBEStartDate != формату ДД.ММ.ГГГ
  или CategoryCEStartDate != формату ДД.ММ.ГГГ
  или CategoryC1EStartDate != формату ДД.ММ.ГГГ
  или CategoryDEStartDate != формату ДД.ММ.ГГГ
  или CategoryD1EStartDate != формату ДД.ММ.ГГГ
  или CategoryMStartDate != формату ДД.ММ.ГГГ
  или CategoryTmStartDate != формату ДД.ММ.ГГГ
  или CategoryTbStartDate != формату ДД.ММ.ГГГ
  

• matching_series_number - сверка по совпадению Серии и Номера на лицевой и оборотной стороне;

  0 - проверка пройдена
  1 - проверки не пройдены
  '' - проверки не было, из-за отсутствия набора значений в ключах проверки
  

  Условия проверки

  значение 1,
  если SeriesFront != SeriesBack
  или NumberFront != NumberBack
  

Проверки метаданных

Доступно на тарифе Биорг.KYC

В результате обработки входящего документа будет доступно поле verifications.metadata_check,
в котором находятся следующие данные:

    {
            'status': 0,                        // тип integer   -- проверка на наличие словаря metadata
            'checks': {
            'metadata': {
                    'source_check': 0,            // тип integer   -- проверка наличия следов производителя устройства
                    'create_date': '1730796861',  // тип timestamp -- дата создания файла
                    'make': '1',                  // тип string    -- производитель устройства
                    'model': 'T1'                 // тип string    -- модель устройства
            }
        }
    }

Условия проверки

• status - Фиксирует наличие метаданных

  0 — словарь metadata присутствует и не пустой
  1 — словарь metadata отсутствует или пустой
  

• source_check - Проверка наличия следов производителя устройства, на котором было получение изображение

  0 - если make и model присутствуют и непусты
  1 - в противном случае
  

• сreate_date - Фиксирует дату создания файла, значение из словаря metadata ключа CreateDate или DateTimeOriginal

• make - Фиксирует производителя устройства, значение из словаря metadata ключа Make или DeviceManufacturer,

  если ключи отсутствуют или пустые - передает пустое значение ''
  

• model - Фиксирует модель устройства, значение из словаря metadata ключа Model или DeviceModel

  если ключи отсутствуют или пустые - передает пустое значение ''
  

• not_standart_sizes - Проверяет несоответствие изображения типовым размерам

  0 - изображение соответствует типовым размерам
  1 - изображение не соответствует типовым размерам
  

⚠️ Важно: Может свидетельствовать о сгенерированном изображении

• incorrect_dpi - Проверяет несоответствие DPI изображения

  0 - DPI корректен
  1 - DPI некорректен
  

⚠️ Важно: Может свидетельствовать о сгенерированном изображении

• color_profile - Наличие информации о цветовом профиле

  0 - информация отсутствует
  1 - информация присутствует
  

⚠️ Важно: Может свидетельствовать о сгенерированном изображении

Проверка доумента на фрод

Доступно на тарифе Биорг.KYC

В результате обработки входящего документа будет доступно поле verifications.fraud_check,
в котором находятся следующие данные:

"fraud_check": {
        "fraud": 0, // тип integer   -- 0 - документ не поддельный 1 - документ поддельный
        "probability": 1,
        "error_code": 0,
        "comment": "Good"
},

Итоговый вердикт системы в соответствии с проверками

Доступно на тарифе Биорг.KYC

Блок check_result — итоговый вердикт системы по результатам всех проверок документа. Он имеет такую структуру:

"check_result": {
  "status": "Approved",
  "details": {
    "logic": { "status": "Approved" },
    "metadata": { "status": "Approved" },
    "fraud": { "status": "Approved" },
    "external_integrations": { "status": "Approved" }
  }
}

status (главный статус) - итоговый результат всей проверки.

• Формируется на основе статусов из раздела details. Если все подразделы имеют статус Approved, то и общий статус будет Approved. Если хотя бы один из них имеет статус Failed, общий статус тоже станет Failed.

details (детализация по типам проверок) Содержит разбивку по четырём ключевым направлениям проверки. Каждое направление независимо оценивает свою область.

• logic - проверяет логическую целостность данных внутри документа.
• metadata - оценивает технические параметры документа и процесса его подачи.
• fraud - признаки подделки с документа.
• external_integrations - сверяет данные с внешними базами данных.

Таблица статусов верификации

Статус (англ.)	Статус (рус.)	Приоритет	Описание
Approved	Одобрено	Базовый (низший)	Проверка выполнена успешно, нарушений не обнаружено
Failed	Не пройдено	Высокий (высший)	Проверка выявила критическую проблему, документ не может быть одобрен
Not executed	Не выполнено	Средний	Проверка не запускалась или не смогла завершиться по техническим причинам
Attention	Требуется внимание	Средний	Проверка выявила потенциальную проблему, требующую ручной проверки