Предупреждения верификации бизнеса (KYB) и коды ошибок

Верификация бизнеса выводит предупреждения для элемента функции, который их сформировал. Каждое предупреждение имеет стандартную структуру, общую для всей платформы: feature, risk, log_type, short_description, long_description, необязательный additional_data и node_id. Это позволяет направлять задачи на проверку нужной команде.

Обзор

Сессии KYB генерируют предупреждения под тремя основными тегами функций, которые соответствуют отдельным массивам функций в ответе с решением V3:

Тег функции	Ключ ответа с решением	Что проверяется
`KYB_REGISTRY`	`registry_checks[].warnings[]`	Запросы к официальным реестрам компаний. Статус активности, ограничения по странам, вывод структуры владения, отсутствие данных о должностных лицах и бенефициарных владельцах.
`KYB_DOCUMENTS`	`document_verifications[].warnings[]`	Учредительные документы, документы о структуре владения, документы, подтверждающие адрес, и документы об акционерах, которые загружает пользователь. Согласованность между документами, OCR, метаданные, манипуляции, возраст и правила подтипов.
`KYB_KEY_PEOPLE`	`key_people_checks[].warnings[]`	Сигналы по отдельным лицам: директорам, должностным лицам, конечным бенефициарным владельцам или сторонам, указанным пользователем. Сюда входят результаты PEP и санкционных проверок, которые передаются из AML, а также повторное использование результатов предыдущего отказа.

Тот же сценарий KYB может также включать общие функции, перечисленные ниже. Они выводят предупреждения в собственных массивах:

Тег функции	Ключ ответа с решением
`AML`	`aml_screenings[].warnings[]`
`PHONE`	`phone_verifications[].warnings[]`
`EMAIL`	`email_verifications[].warnings[]`
`QUESTIONNAIRE`	`questionnaire_responses` (предупреждения находятся в журнале сессии)
`LOCATION`	`ip_analyses[].warnings[]`

Предупреждения реестра KYB

Предупреждения реестра используют feature: "KYB_REGISTRY" и находятся в registry_checks[].warnings[].

Тег	Описание
`KYB_COUNTRY_RESTRICTED`	Страна компании не входит в число разрешённых стран, настроенных для сценария.
`KYB_OFFICERS_DATA_NOT_FOUND`	Данные о должностных лицах недоступны в реестре.
`KYB_OWNERSHIP_DATA_NOT_FOUND`	Данные о структуре владения недоступны в реестре.
`KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE`	Не удалось установить конечное бенефициарное владение по данным реестра.
`KYB_COMPANY_NOT_ACTIVE`	Согласно реестру компания не имеет статуса активной.
`KYB_COMPANY_NOT_FROM_REGISTRY`	Компания была введена вручную и не могла быть проверена по реестру компаний.
`KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED`	Регистрационный номер компании, полученный из реестра, не совпадает с `expected_details.registration_number`, который вы передали при создании сессии.
`KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED`	Регистрационный номер, полученный из реестра, лишь частично совпадает с ожидаемым, например из-за суффикса филиала или дочерней компании.
`KYB_COMPANY_VAT_INVALID`	В официальном налоговом реестре нет активной регистрации для VAT-номера или налогового номера компании, либо VAT-номер не соответствует формату страны или правилам контрольной цифры. Применяется настроенное значение `kyb_vat_invalid_action` (по умолчанию: На проверке).
`KYB_COMPANY_VAT_COULD_NOT_VALIDATE`	VAT-номер или налоговый номер не удалось проверить, так как официальный реестр временно недоступен. Применяется настроенное значение `kyb_vat_unverified_action` (по умолчанию: без эффекта).
`KYB_COMPANY_VAT_NAME_MISMATCH`	Название, зарегистрированное в официальном реестре для этого номера, отличается от указанного названия компании. Информационное предупреждение. В `additional_data` передаются `registry_name`, `registry_source` и `submitted_name`, а также `vies_name`, если источником реестра является VIES.

Предупреждения VAT применяются везде, где можно проверить VAT-номер или налоговый номер компании. Страны и источники перечислены в разделе Проверка VAT и налогового номера.

Предупреждения по документам KYB

Предупреждения по документам используют feature: "KYB_DOCUMENTS" и появляются в document_verifications[].warnings[].

Тег	Описание
`KYB_DOCUMENT_MISSING_REQUIRED_FIELD`	Обязательное поле компании, например название компании или регистрационный номер, не найдено в документе.
`KYB_DOCUMENT_NAME_MISMATCH`	Название компании в документе не совпадает с данными реестра.
`KYB_DOCUMENT_REG_NUMBER_MISMATCH`	Регистрационный номер в документе не совпадает с данными реестра.
`KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH`	Дата регистрации компании в документе не совпадает с данными реестра.
`KYB_DOCUMENT_ADDRESS_MISMATCH`	Зарегистрированный адрес в документе не совпадает с данными реестра.
`KYB_CROSS_DOCUMENT_MISMATCH`	Данные компании различаются в разных загруженных корпоративных документах.
`KYB_DOCUMENT_METADATA_MISMATCH`	Подпись, метаданные или структура файла документа указывают на возможную проблему.
`KYB_ASSOCIATED_PARTY_MISMATCH`	Директора или акционеры, указанные в документе, не совпадают с данными реестра.
`KYB_DOCUMENT_GRAPHIC_EDITOR`	Похоже, что документ обрабатывался в графическом редакторе.
`KYB_DOCUMENT_SUSPECTED_MANIPULATION`	Система обнаружила признаки возможной манипуляции с корпоративным документом.
`KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT`	Текстовое поле корпоративного документа было стёрто и набрано заново другим шрифтом, при этом в файле нет доказательств того, изменилось ли его содержимое. Это предупреждение также появляется, если файл не удалось проверить полностью: тогда в `additional_data.detection_method` указано `analysis_incomplete`, поскольку непроверенная часть файла может содержать такое поле. Управляется параметром `kyb_document_unproven_text_replacement_action` (по умолчанию Review). Сценарий, который никогда не отправляет документы на проверку, использует собственный `kyb_document_tampering_action`, если тот равен Decline; в остальных случаях действие No action.
`KYB_ADDITIONAL_DATA_NOT_FOUND`	Поле документа не удалось проверить, так как соответствующие данные реестра недоступны.
`KYB_DOCUMENT_EXPIRED`	Возраст корпоративного документа превышает настроенное максимальное значение.
`KYB_DOCUMENT_UNSUPPORTED_SUBTYPE`	Загруженный подтип документа отключён для сценария.
`KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED`	Превышено максимальное количество попыток загрузки корпоративного документа.

Для манипуляций с текстовым наложением в PDF KYB_DOCUMENT_SUSPECTED_MANIPULATION может содержать additional_data.manipulated_regions. Текстовое поле, которое стёрли и набрали заново другим шрифтом, вызывает KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT с той же структурой manipulated_regions, но никогда не вызывает KYB_DOCUMENT_SUSPECTED_MANIPULATION само по себе: онлайн-редакторы также перенабирают нетронутый текст, поэтому это предупреждение не означает, что содержимое изменилось. Если на том же документе другой сигнал вызывает KYB_DOCUMENT_SUSPECTED_MANIPULATION, решает более строгое из двух действий. Эти прямоугольники в координатах страницы указывают предположительно изменённые области и совпадают с прямоугольниками, которые возвращаются в document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions.

Предупреждения по ключевым лицам KYB

Предупреждения по ключевым лицам используют feature: "KYB_KEY_PEOPLE" и появляются в key_people_checks[].warnings[]. Они показывают проблемы на уровне отдельных лиц: директоров, должностных лиц, UBO и сторон, которые указал пользователь.

Тег	Описание
`KYB_PREVIOUSLY_DECLINED_INDIVIDUAL`	Лицо, связанное с компанией, ранее было отклонено в другой верификации бизнеса по той же заявке.
`KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS`	Директора или акционеры, указанные на экране ключевых лиц, не совпадают с людьми, названными в загруженных корпоративных документах: человек из документов не был указан, имя почти совпадает, акционер, указанный в документах, был заявлен без роли в структуре владения, или заявленный процент владения противоречит документам. Применяется настроенный параметр `kyb_key_people_document_mismatch_action` (по умолчанию: На проверке).

Совпадения с PEP и санкционными списками у ключевых лиц передаются как стандартные AML-совпадения в соответствующем элементе aml_screenings[], а не как предупреждение KYB по ключевым лицам. Проверка ключевых лиц переносит полученный статус Declined или In Review на каждую затронутую сторону, поэтому общий итог проверки ключевых лиц отражает результат AML.

Предупреждения общих функций

Перечисленные ниже функции могут работать внутри сценария KYB. Они используют тот же каталог предупреждений, что и Верификация пользователей. Полный справочник находится на странице предупреждений каждой функции.

AML

feature: "AML" в aml_screenings[].warnings[].

Тег	Описание
`POSSIBLE_MATCH_FOUND`	AML-скрининг обнаружил возможное совпадение, требующее проверки.
`COULD_NOT_PERFORM_AML_SCREENING`	Didit не смог выполнить AML-скрининг, так как необходимые данные для скрининга отсутствовали или были недоступны.

Телефон

feature: "PHONE" в phone_verifications[].warnings[].

Тег	Описание
`DISPOSABLE_NUMBER_DETECTED`	Номер телефона одноразовый.
`VERIFICATION_CODE_ATTEMPTS_EXCEEDED`	Превышено максимальное количество попыток ввода кода подтверждения.
`VOIP_NUMBER_DETECTED`	Номер телефона является VoIP-номером.
`DUPLICATED_PHONE_NUMBER`	Номер телефона был использован в другом процессе верификации.
`HIGH_RISK_PHONE_NUMBER`	Номер телефона имеет высокий уровень риска.
`PHONE_NUMBER_IN_BLOCKLIST`	Номер телефона совпадает с записью в вашем списке блокировки.

Электронная почта

feature: "EMAIL" в email_verifications[].warnings[].

Тег	Описание
`BREACHED_EMAIL_DETECTED`	Адрес электронной почты фигурирует в известных утечках данных.
`DISPOSABLE_EMAIL_DETECTED`	Адрес электронной почты одноразовый.
`UNDELIVERABLE_EMAIL_DETECTED`	Доставка на адрес электронной почты невозможна.
`DUPLICATED_EMAIL`	Адрес электронной почты был использован в другом процессе верификации.
`EMAIL_IN_BLOCKLIST`	Адрес электронной почты совпадает с записью в вашем списке блокировки.
`EMAIL_CODE_ATTEMPTS_EXCEEDED`	Превышено максимальное количество попыток ввода кода подтверждения из электронного письма.

Анкета

feature: "QUESTIONNAIRE".

Тег	Описание
`CUSTOM_STATUS_RULE_TRIGGERED`	Правило статуса в сценарии оценило ответ в анкете и изменило статус функции.

Анализ устройства и IP

feature: "LOCATION" в ip_analyses[].warnings[].

Тег	Описание
`COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP`	Страна из документа не совпадает со страной по IP-адресу.
`PRIVATE_NETWORK_DETECTED`	Обнаружена частная сеть, VPN, прокси или сигнал Tor.
`EXPECTED_IP_ADDRESS_MISMATCH`	IP-адрес не совпадает с ожидаемым IP-адресом, указанным для сессии.
`IP_ADDRESS_IN_BLOCKLIST`	IP-адрес совпадает с записью в вашем списке блокировки.
`DEVICE_FINGERPRINT_IN_BLOCKLIST`	Отпечаток устройства совпадает с записью в вашем списке блокировки.
`DUPLICATED_IP_ADDRESS`	Тот же IP-адрес был использован в другой верификации с другим `vendor_data`.
`DUPLICATED_DEVICE_FINGERPRINT`	Тот же отпечаток устройства был использован в другой верификации с другим `vendor_data`.

Примеры

Реестр: компания не активна

{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}

Документы: подозрение на манипуляцию наложением

{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}

Ключевые лица: ранее отклонённое физическое лицо

{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}

Связанные материалы

Схема ответа

Посмотрите, где предупреждения появляются в массиве каждой функции KYB.

Статусы

Узнайте, как серьёзность предупреждения соотносится со статусом верификации.

Документы

Изучите группы документов, OCR и порядок выполнения перекрёстных проверок.

Ключевые лица

Процесс верификации должностного лица, UBO и представленной стороны.

Отчёт AML

Структура результатов на уровне совпадений для AML-скрининга компаний и физических лиц.

Справочные модели данных

Канонические структуры для предупреждений и массивов функций.

Начало работы

Функции

Профили компаний

Справочник

Консоль

Предупреждения верификации бизнеса (KYB) и коды ошибок

Обзор

Предупреждения реестра KYB

Предупреждения по документам KYB

Предупреждения по ключевым лицам KYB

Предупреждения общих функций

AML

Телефон

Электронная почта

Анкета

Анализ устройства и IP

Примеры

Реестр: компания не активна

Документы: подозрение на манипуляцию наложением

Ключевые лица: ранее отклонённое физическое лицо

Связанные материалы

Схема ответа

Статусы

Документы

Ключевые лица

Отчёт AML

Справочные модели данных

​Обзор

​Предупреждения реестра KYB

​Предупреждения по документам KYB

​Предупреждения по ключевым лицам KYB

​Предупреждения общих функций

​AML

​Телефон

​Электронная почта

​Анкета

​Анализ устройства и IP

​Примеры

​Реестр: компания не активна

​Документы: подозрение на манипуляцию наложением

​Ключевые лица: ранее отклонённое физическое лицо

​Связанные материалы

Схема ответа

Статусы

Документы

Ключевые лица

Отчёт AML

Справочные модели данных

Обзор

Предупреждения реестра KYB

Предупреждения по документам KYB

Предупреждения по ключевым лицам KYB

Предупреждения общих функций

AML

Телефон

Электронная почта

Анкета

Анализ устройства и IP

Примеры

Реестр: компания не активна

Документы: подозрение на манипуляцию наложением

Ключевые лица: ранее отклонённое физическое лицо

Связанные материалы