Предупреждения и коды оповещений AML-скрининга

Обзор

AML-скрининг формирует небольшой набор тегов предупреждений в массиве warnings[] каждого элемента в aml_screenings[]. Приведенные ниже два тега — это единственные предупреждения AML, которые генерирует Didit; все остальные данные о совпадении закодированы в собственных полях совпадения (risk_view, match_score, risk_score, sanction_matches[], …), а не передаются в виде предупреждений. Как сессии сценариев, так и отдельный AML API генерируют POSSIBLE_MATCH_FOUND одинаковым образом. Статус, возвращаемый в записи AML (Approved, In Review, Declined), вычисляется на основе совокупного значения score и настроенных вами порогов; предупреждения отмечают те же условия, позволяя реагировать на них программно. См. раздел Оценка риска AML, где описано, как пороги влияют на статус.

Формируемые предупреждения

Риск	Причина	`log_type`	Влияние на статус	Рекомендуемые действия
`POSSIBLE_MATCH_FOUND`	Совокупный `score` не равен нулю и превышает `aml_score_approve_threshold` (по умолчанию `80`) — по меньшей мере одно потенциальное совпадение превысило ваш диапазон риска. (Отдельный AML API также генерирует его, если оценка в точности равна порогу.)	`warning`; повышается до `error`, когда оценка также превышает `aml_score_review_threshold` (по умолчанию `100`).	`In Review`, если оценка выше порога одобрения; `Declined`, если она выше порога проверки.	Проверьте каждое совпадение в `hits[]`. Используйте endpoint статуса совпадений AML, чтобы пометить совпадения как `Confirmed Match`, `False Positive` или `Inconclusive`. Обновление совпадений отправляет webhook `data.updated`, но не пересчитывает статус AML — установите итоговый статус через endpoint статуса AML или при ручной проверке в панели управления.
`COULD_NOT_PERFORM_AML_SCREENING`	В KYC-записи отсутствует одно или несколько полей: `full_name`, `date_of_birth` или `issuing_state`. Тарифицируемый запрос скрининга не выполняется.	`warning`	Принудительно устанавливает статус `In Review`.	Заполните недостающие поля в KYC-записи. AML-скрининг перезапустится автоматически, как только появятся все три поля — устаревшая запись журнала предупреждений будет удалена, и ручной перезапуск не потребуется.

Предупреждения сохраняются со значением feature: "AML" и соответствуют стандартной структуре объекта предупреждения.

Настраиваемые параметры

Параметры управления AML на уровне узла сценария (также принимаются в качестве параметров отдельного AML API):

aml_score_approve_threshold — по умолчанию 80. Ненулевая оценка выше этого значения приводит к генерации POSSIBLE_MATCH_FOUND и переводит AML-проверку в статус In Review. Оценки на уровне порога или ниже не генерируют предупреждение в сессиях сценариев независимо от числа совпадений.
aml_score_review_threshold — по умолчанию 100. Оценка выше этого значения приводит к автоматическому отклонению AML-проверки (со значением по умолчанию 100 это условие не сработает, пока вы его не снизите).
aml_match_score_threshold — по умолчанию 93. Классификация отдельных совпадений: совпадения со значением match_score ниже этого порога получают начальный статус False Positive и исключаются из совокупной оценки; со значением на уровне порога или выше — получают начальный статус Unreviewed.
Весовые коэффициенты оценки совпадения — aml_name_weight / aml_dob_weight / aml_country_weight, по умолчанию 60 / 25 / 15 (в сумме должны давать 100). См. раздел Оценка совпадения AML.
Постоянный AML-мониторинг — если функция включена, AML выполняет повторный скрининг субъекта при изменении наборов данных и повторно формирует отчёт, а также отправляет webhook status.updated (при изменении статуса) или data.updated (при изменении совпадений).

При срабатывании предупреждения COULD_NOT_PERFORM_AML_SCREENING проверка AML остается в статусе In Review до тех пор, пока не будут переданы недостающие идентификационные поля. Как только Didit получит полное имя, дату рождения и штат выдачи, AML перезапустится автоматически, а предупреждение снимется — ручной перезапуск не требуется.

Примеры

`POSSIBLE_MATCH_FOUND` (оценка выше порога одобрения)

{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}

`COULD_NOT_PERFORM_AML_SCREENING` (отсутствуют поля KYC)

{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}

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

Отчёт AML — полная структура ответа, поля совпадений, семантика статусов
Оценка риска AML — как рассчитывается совокупная оценка
Оценка совпадения AML — степень уверенности для каждого совпадения
Постоянный AML-мониторинг — жизненный цикл мониторинга
Модели данных — AML-скрининг — каноническая схема, включая объект предупреждения

Аутентификация

Верификация

Мониторинг

Платформа

Предупреждения и коды оповещений AML-скрининга

Обзор

Формируемые предупреждения

Настраиваемые параметры

Примеры

`POSSIBLE_MATCH_FOUND` (оценка выше порога одобрения)

`COULD_NOT_PERFORM_AML_SCREENING` (отсутствуют поля KYC)

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

Типы предупреждений

​Обзор

​Формируемые предупреждения

​Настраиваемые параметры

​Примеры

​POSSIBLE_MATCH_FOUND (оценка выше порога одобрения)

​COULD_NOT_PERFORM_AML_SCREENING (отсутствуют поля KYC)

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

​Типы предупреждений

Обзор

Формируемые предупреждения

Настраиваемые параметры

Примеры

`POSSIBLE_MATCH_FOUND` (оценка выше порога одобрения)

`COULD_NOT_PERFORM_AML_SCREENING` (отсутствуют поля KYC)

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

Типы предупреждений