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

Обзор

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

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

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

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

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

Синхронно или в фоне

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

Webhooks

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

Разрешения

Любой активный 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 г.