Saltar al contenido principal
Las listas de bloqueo impiden que los usuarios que no superaron tus controles de cumplimiento creen nuevas sesiones o realicen nuevas transacciones. Didit admite listas de bloqueo por tipo de identificador, para que puedas bloquear al mismo actor malicioso en varios puntos de datos (rostro, documento, correo electrónico, teléfono, vendor_data del usuario).

​
Tipos de identificador admitidos para usuarios

Cada tipo de identificador se aplica en su punto de contacto natural:
  • Rostro y documento: se aplican durante una nueva sesión.
  • Correo electrónico y teléfono: se aplican durante un paso de la sesión que los recopila o en el payload de una transacción.
  • IP y dispositivo: se aplican durante el Análisis de dispositivo e IP en una sesión.
  • vendor_data del usuario: se aplica durante la creación de la sesión o de la transacción.

​
Cómo se produce el bloqueo

1

Automático: al rechazarse una sesión

Cuando se rechaza una sesión y la configuración de bloqueo automático de tu flujo de verificación (workflow) está activada, Didit añade automáticamente los identificadores relevantes (rostro, documento, correo electrónico, teléfono) a las listas de bloqueo del sistema correspondientes y cambia el estado del usuario a BLOCKED.
2

Automático: al coincidir con la lista de bloqueo

Cuando una sesión entrante coincide con una entrada existente de la lista de bloqueo, la sesión se rechaza automáticamente con un código de motivo como blocked_face, blocked_document, blocked_email, etc.
3

Manual: desde la consola

Un analista añade un usuario a la lista de bloqueo desde Users → [usuario] → Actions → Add to blocklist y elige uno o varios identificadores que registrar.
4

Programático: mediante la API de listas

Usa la API de listas para añadir entradas de forma programática. Es la misma API que usa la consola internamente.

​
Listas del sistema y listas personalizadas

Cada aplicación tiene listas de bloqueo del sistema, una por tipo de identificador, que Didit gestiona automáticamente. No puedes cambiarles el nombre ni eliminarlas. Las listas personalizadas las creas, nombras y delimitas tú.

​
Añadir un usuario a la lista de bloqueo mediante la API

Usa la API de listas para añadir una entrada a la lista de bloqueo. Para bloquear a un usuario por vendor_data, añade una entrada de tipo USER a la lista de bloqueo correspondiente:
  1. Enumera todas las listas filtrando por entry_type=user e is_system=true para encontrar la lista de bloqueo de usuarios del sistema.
  2. Crea una entrada en esa lista con value establecido en el vendor_data del usuario.
Para bloquear a un usuario por rostro, consulta Rostros y biometría. Para bloquear por correo electrónico, teléfono, documento o IP, usa la lista de bloqueo del sistema correspondiente con el identificador adecuado en value.

​
Flujo de aplicación

En las listas de bloqueo de rostros y documentos, la comprobación se realiza en el paso de verificación:

​
Eliminar de la lista de bloqueo

  • Console: Blocklist → [tipo] → acciones de la fila → Remove.
  • API: usa el endpoint Eliminar entrada con el UUID de la lista y el UUID de la entrada.
Eliminar la entrada no devuelve automáticamente al usuario al estado ACTIVE: usa PATCH /v3/users/{vendor_data}/update-status/ para cambiar el estado si quieres permitir nuevas sesiones.

​
Registro de auditoría de la lista de bloqueo

Cada alta o baja en una lista de bloqueo queda registrada en el registro de auditoría:
  • Quién añadió la entrada (correo electrónico del usuario o 'system', 'api').
  • Cuándo.
  • Un comment opcional que explica el motivo.
  • La sesión o transacción vinculada, si la entrada se generó automáticamente.

​
Próximos pasos

API de listas

Referencia completa de la API de listas de bloqueo y de permitidos.

Lista de bloqueo en la consola

Gestiona las listas de bloqueo desde la interfaz.

Rostros y biometría

Cómo funcionan las listas de bloqueo de rostros.
Última modificación el 1 de noviembre de 2026