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

Обзор

Включает или выключает постоянный AML-мониторинг для выбранных объектов User так же, как действие Постоянный AML-мониторинг в Business Console. Консоль и этот эндпоинт выполняют одну и ту же базовую операцию, поэтому правила, биллинг и результаты совпадают. Сначала отправьте estimate_only: true, чтобы увидеть, сколько пользователей выбрано, сколько из них требуют нового AML-скрининга, стоимость разового скрининга и годовую стоимость мониторинга. Пробный запуск ничего не записывает.

Когда использовать

  • Программный онбординг: включите мониторинг для пользователей, которых вы импортировали или создали через API, без ручного повторного скрининга.
  • Оффбординг: выключите мониторинг и его годовое продление для пользователей, которые покинули вашу платформу.
  • Контроль расходов: заранее посмотрите точное влияние выбранной группы на стоимость, прежде чем подтверждать действие.

Как обрабатывается выборка

  • Один скрининг под мониторингом на пользователя. Пользователь, который проходил верификацию несколько раз, находится под мониторингом и тарифицируется один раз. Выключение мониторинга отключает его для всех скринингов этого пользователя.
  • Пользователи без AML-скрининга сначала проходят скрининг. Didit создает для них новую AML-верификацию (она видна на вкладке Верификации пользователя), тарифицируется как обычный AML-скрининг, и на ней включается мониторинг. Для этого нужны полное имя пользователя, дата рождения и страна. Если хотя бы одного из этих данных нет, пользователь возвращается со статусом skipped_no_identity_data, а не пропадает молча.
  • Заблокированные пользователи пропускаются (skipped_blocked). Приложения в песочнице никогда не создают скрининги (skipped_sandbox).
  • Баланс проверяется заранее. Включение отклоняется с кодом 403, если баланса недостаточно для покрытия расчетной стоимости. В ответе передается оценка, чтобы вы знали, на какую сумму нужно пополнить баланс.
  • Годовое продление. Для нового пользователя под мониторингом годовая стоимость мониторинга начисляется на следующую дату продления. Это та же дата, что показана в колонке Постоянный AML-мониторинг в Консоли. Выключение останавливает продление, но не возвращает средства за уже оплаченный период.

Выбор и размер пакета

Выбирайте пользователей через vendor_data_list, didit_internal_id_list или через оба параметра. Списки объединяются логическим ИЛИ. Один запрос принимает не более 1000 идентификаторов в сумме по обоим спискам. Идентификаторы, которые не совпадают ни с одним пользователем вашего приложения, возвращаются в unmatched в том виде, в котором были отправлены. Они никогда не приводят к ошибке запроса. Выборка без совпадений завершается пустой задачей (total: 0), где перечислены все идентификаторы. Это то же правило, что и у эндпоинтов пакетного удаления.

Синхронная или фоновая обработка

Выборки из 20 пользователей или меньше обрабатываются синхронно, и вызов возвращает 200 с завершенной задачей. Большие выборки возвращают 202 с задачей в статусе PENDING. Опрашивайте Get AML Monitoring Job, пока status не станет COMPLETED или FAILED. В любом случае задача содержит по одной записи results на каждого пользователя с его outcome.

Webhook

Переключение мониторинга не отправляет собственного webhook. Когда мониторинг включен, повторные проверки продолжают отправлять обычные события status.updated и data.updated, описанные в Continuous AML Monitoring.

Права доступа

Вызывать этот эндпоинт может любой активный API-ключ приложения. API-ключи Didit привязаны к приложению, а не к роли. Роли и разрешения в Консоли определяют, что может делать человек в Консоли, и для трафика Management API они не проверяются.

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

Авторизации

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.

Тело

application/json

Выберите пользователей с помощью vendor_data_list, didit_internal_id_list или обоих параметров (два списка объединяются через OR). Не более 1000 идентификаторов на запрос в сумме по обоим спискам.

is_enabled
boolean
обязательно

true для включения мониторинга, false для его отключения.

estimate_only
boolean
по умолчанию:false

Если true, возвращает предварительную оценку стоимости и не выполняет операций записи: без скрининга, без биллинга, без создания задачи.

vendor_data_list
string[]

Ваши собственные идентификаторы пользователей для переключения, сопоставляемые в точности с переданными.

didit_internal_id_list
string<uuid>[]

Внутренние идентификаторы пользователей в Didit для переключения: didit_internal_id, возвращаемый endpoints создания, получения и вывода списка.

Ответ

Предварительная оценка (когда estimate_only равно true) или завершённое задание для выборки, обработанной синхронно.

Предварительный расчёт стоимости. Возвращается напрямую, если estimate_only имеет значение true (ничего не записывается).

users_total
integer
обязательно

Профили, соответствующие выборке.

already_enabled
integer
обязательно

Профили, которые уже находятся на мониторинге (при включении действий не требуется; это профили, которые отключаются при деактивации).

with_existing_aml
integer
обязательно

Профили, для которых существующий AML-скрининг будет переведён в статус постоянного мониторинга (новый скрининг не проводится).

needing_screening
integer
обязательно

Профили без AML-скрининга, для которых скрининг будет проведён впервые (оплачивается как обычный AML-скрининг).

skipped_no_identity_data
integer
обязательно

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

skipped_blocked
integer
обязательно

Заблокированные пользователи, которые будут пропущены (всегда 0 для компаний).

estimated_screening_cost_usd
number
обязательно

Разовая стоимость новых проверок.

Пример:

0.2

estimated_annual_monitoring_cost_usd
number
обязательно

Ежегодная стоимость мониторинга профилей, которые будут отслеживаться.

Пример:

0.07

balance_sufficient
boolean
обязательно

Покрывает ли баланс организации скрининг плюс первый год мониторинга.

unmatched
string[]
обязательно

Идентификаторы из запроса, которым не подошёл ни один профиль в этом приложении, в точности так, как они были отправлены.

Последнее изменение 7 ноября 2026 г.