Saltar al contenido principal
POST
curl

Descripción general

Activa o desactiva la monitorización AML continua para las entidades de usuario seleccionadas, exactamente igual que la acción Monitorización AML continua de la Business Console. La Console y este endpoint ejecutan la misma operación interna, por lo que las reglas, la facturación y los resultados son idénticos. Envía primero estimate_only: true para ver cuántos usuarios hay seleccionados, cuántos necesitan un nuevo análisis AML, el coste único del análisis y el coste anual de la monitorización. Una simulación no realiza ningún cambio.

Cuándo usarlo

  • Onboarding programático: activa la monitorización para los usuarios que importaste o creaste mediante la API sin tener que volver a analizarlos a mano.
  • Offboarding: detén la monitorización, y su renovación anual, para los usuarios que abandonaron tu plataforma.
  • Control de costes: consulta el impacto exacto en costes de una selección antes de confirmarla.

Cómo se procesa una selección

  • Un análisis monitorizado por usuario. Un usuario que se verificó varias veces se monitoriza y se factura una sola vez. Al desactivarla, la monitorización se desactiva en todos los análisis de ese usuario.
  • Los usuarios sin análisis AML se analizan primero. Didit crea para ellos una nueva verificación AML (visible en la pestaña Verificaciones del usuario), que se factura como un análisis AML normal, y activa la monitorización en ella. Esto requiere el nombre completo, la fecha de nacimiento y el país del usuario; si a un usuario le falta alguno de ellos, se informa como skipped_no_identity_data en lugar de descartarlo sin avisar.
  • Los usuarios bloqueados se omiten (skipped_blocked). Las aplicaciones de sandbox nunca crean análisis (skipped_sandbox).
  • El saldo se comprueba de antemano. La activación se rechaza con 403 cuando tu saldo no cubre la estimación, y la respuesta incluye la estimación para que sepas cuánto debes recargar.
  • Renovación anual. A un usuario recién monitorizado se le factura el precio anual de monitorización en su siguiente fecha de renovación, la misma fecha que muestra la Console en la columna Monitorización continua. Desactivar detiene la renovación; no reembolsa un periodo ya facturado.

Selección y tamaño del lote

Selecciona usuarios con vendor_data_list, didit_internal_id_list o ambos; las dos listas se combinan con OR. Una solicitud admite como máximo 1000 identificadores entre ambas listas. Los identificadores que no coinciden con ningún usuario de tu aplicación se devuelven en unmatched, exactamente como se enviaron, y nunca hacen fallar la solicitud: una selección que no coincide con nada finaliza como un trabajo vacío (total: 0) con todos los identificadores listados, la misma convención que siguen los endpoints de eliminación por lotes.

En línea o en segundo plano

Las selecciones de 20 usuarios o menos se procesan en línea y la llamada devuelve 200 con el trabajo terminado. Las selecciones más grandes devuelven 202 con un trabajo PENDING; consulta Obtener trabajo de monitorización AML hasta que status sea COMPLETED o FAILED. En ambos casos, el trabajo incluye una entrada en results por usuario con su outcome.

Webhooks

Activar o desactivar la monitorización no emite ningún webhook propio. Una vez activada la monitorización, los reanálisis siguen disparando los eventos habituales status.updated y data.updated descritos en Monitorización AML continua.

Permisos

Cualquier clave de API activa de la aplicación puede llamar a este endpoint. Las claves de API de Didit son específicas de la aplicación, no del rol: los roles y permisos de la Console deciden lo que una persona puede hacer en la Console y no se evalúan para el tráfico de la Management API.

Relacionado

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json

Selecciona usuarios con vendor_data_list, didit_internal_id_list o ambas (las dos listas se combinan con OR). Como máximo 1000 identificadores por solicitud entre ambas listas.

is_enabled
boolean
requerido

true para activar la monitorización, false para desactivarla.

estimate_only
boolean
predeterminado:false

Si es true, devuelve la estimación del costo y no realiza ninguna escritura: ni análisis, ni facturación, ni tarea.

vendor_data_list
string[]

Tus propios identificadores de los usuarios que se van a activar o desactivar, comparados exactamente como se enviaron.

didit_internal_id_list
string<uuid>[]

IDs internos de Didit de los usuarios que se van a activar o desactivar: el didit_internal_id que devuelven los endpoints de creación, obtención y listado.

Respuesta

La estimación (cuando estimate_only es true) o el trabajo completado para una selección procesada en línea.

Vista previa del coste. Se devuelve directamente cuando estimate_only es true (no se escribe nada).

users_total
integer
requerido

Perfiles que coinciden con la selección.

already_enabled
integer
requerido

Perfiles ya monitorizados (no hay nada que hacer al activar; son los que se desactivan al desactivar).

with_existing_aml
integer
requerido

Perfiles cuyo análisis AML existente pasará a estar monitorizado (sin un nuevo análisis).

needing_screening
integer
requerido

Perfiles sin ningún análisis AML que se analizarán primero (se factura como un análisis AML normal).

skipped_no_identity_data
integer
requerido

Perfiles que no se pueden analizar porque faltan datos de identidad.

skipped_blocked
integer
requerido

Usuarios bloqueados que se omitirán (siempre 0 para empresas).

estimated_screening_cost_usd
number
requerido

Costo único de los nuevos análisis.

Ejemplo:

0.2

estimated_annual_monitoring_cost_usd
number
requerido

Coste anual de monitorización de los perfiles que pasarán a estar monitorizados.

Ejemplo:

0.07

balance_sufficient
boolean
requerido

Si el saldo de la organización cubre el análisis más el primer año de monitorización.

unmatched
string[]
requerido

Identificadores de la solicitud que no coincidieron con ningún perfil de esta aplicación, exactamente como se enviaron.

Última modificación el 1 de noviembre de 2026