Перейти к основному содержанию
PATCH
curl

Что это делает

AML-скрининг возвращает список совпадений (hits): потенциальных соответствий санкционным спискам, базам PEP, спискам наблюдения и негативным публикациям в СМИ. У каждого совпадения есть review_status (его решение), который при создании получает значение Unreviewed или False Positive в зависимости от оценки совпадения. Этот эндпоинт позволяет вашей команде (или вашей автоматизации) зафиксировать решение по каждому совпадению без изменения общего решения по сессии. Совпадения и их ID находятся в решении по сессии: в массиве hits проверки AML, где id каждого совпадения — это hit_id, который вы передаёте в этот запрос. id совпадения имеет вид hit_ и 24 шестнадцатеричных символа и не меняется при повторном скрининге субъекта. ID совпадения в прежнем формате по-прежнему принимается, но в ответе совпадение всегда указывается по его текущему id.

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

Решения проверяющих сохраняются при повторных проверках в рамках постоянного мониторинга: совпадение, которому вы присвоили статус False Positive, сохраняет этот статус, когда провайдер повторно проверяет субъекта.

Обновление одного совпадения

PATCH /v3/session/{sessionId}/update-aml-hit-status/
Для сессии с несколькими проверками AML (сценарии на основе графа) добавьте ?node_id=feature_aml_1 к URL или укажите "node_id" в теле запроса, чтобы выбрать конкретную проверку.

Обновление нескольких совпадений сразу

PATCH /v3/session/{sessionId}/bulk-update-aml-hit-status/ Передайте hit_updates: список пар { hit_id, review_status }. Операция выполняется все или ничего: если какой-либо hit_id не найден, запрос возвращает 404, и ни одно совпадение не изменяется.
Успешный массовый запрос отправляет одно событие webhook data.updated и создаёт одну запись активности, которая охватывает все изменения.

Что происходит после обновления

  • Вебхук: по сессии отправляется событие data.updated.
  • Журнал аудита: изменение записывается в журнал проверки сессии с указанием инициатора (API-ключ или пользователь). Его можно увидеть в хронологии активности консоли.
  • Общий статус шага AML не меняется: изменение решения по совпадению само по себе не меняет статус шага AML и решение по сессии. Чтобы изменить статус шага AML (Approved / Declined / In Review), используйте обновление статуса функции. Чтобы изменить решение по сессии, используйте обновление статуса сессии.

Поддержка KYC и KYB

Работает как для сессий Проверки пользователей (KYC), так и для сессий Верификации бизнеса (KYB): Didit находит sessionId в обоих типах. Для KYB AML-скрининг проводится для компании и её ключевых лиц, и каждая проверка AML содержит свои совпадения.

Разрешение

Требуется привилегия write:sessions с клиентским API-ключом (x-api-key) или с заголовком авторизации пользователя.

Ошибки

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

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

sessionId
string<uuid>
обязательно

UUID сессии верификации. Принимает ID сессий как пользователей (KYC), так и компаний (KYB) — сервис сопоставляет ID для обоих типов сессий.

Пример:

"11111111-2222-3333-4444-555555555555"

Параметры запроса

node_id
string

ID узла графа сценария. Требуется, только если в сессии есть несколько AML-проверок (по одной на узел); опустите для сессий с одной AML-проверкой.

Пример:

"feature_aml_1"

Тело

application/json
hit_id
string
обязательно

Идентификатор id совпадения в массиве hits AML-проверки (hit_...). Идентификатор совпадения, возвращённый в прежнем формате, по-прежнему принимается.

Пример:

"hit_7c1e9a40b2d35f86e0a4c912"

review_status
enum<string>
обязательно

Новый статус проверки для совпадения.

Доступные опции:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
Пример:

"False Positive"

node_id
string

Необязательный ID узла графа. Используйте его (здесь или в качестве query-параметра), если в сессии есть несколько AML-проверок.

Пример:

"feature_aml_1"

Ответ

Статус проверки срабатывания обновлён.

message
string
обязательно

Всегда Hit status updated successfully.

hit_id
string
обязательно

id обновлённого совпадения в том виде, как его возвращает решение по сессии, в том числе когда в запросе совпадение было указано по id в прежнем формате.

review_status
enum<string>
обязательно

Статус проверки, сохранённый в срабатывании.

Доступные опции:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
Последнее изменение 7 ноября 2026 г.