API de listas: listas de bloqueo y listas de permitidos

La API de listas te permite gestionar listas con tipos para tu aplicación. Las listas de bloqueo del sistema se crean automáticamente y se comprueban durante la verificación y el análisis de transacciones. También puedes crear listas de permitidos y listas personalizadas para las condiciones de los flujos.

Conceptos

Tipo	Descripción
Lista de bloqueo	Creada por el sistema, una por tipo de entrada. Los elementos de una lista de bloqueo provocan el rechazo automático durante la verificación o el análisis de transacciones.
Lista de permitidos	Creada por el usuario. Se usa en las condiciones de los flujos y para suprimir las acciones duplicadas o de reutilización para elementos coincidentes de confianza.
Personalizado	Creada por el usuario. Listas flexibles para la ramificación de flujos, reglas de monitorización o revisión manual.

Tipos de entrada

Tipo de entrada	Se comprueba durante	Si hay coincidencia
`face`	Verificación de vitalidad	Sesión rechazada
`document`	Verificación de identidad (OCR)	Sesión rechazada
`phone`	Verificación de teléfono	Sesión rechazada
`email`	Verificación de correo electrónico	Sesión rechazada
`ip_address`	Análisis de dispositivo e IP (admite rangos CIDR)	Sesión rechazada
`device_fingerprint`	Análisis de dispositivo e IP	Sesión rechazada
`wallet_address`	Análisis de transacciones	Transacción rechazada
`bank_account`	Análisis de transacciones	Transacción rechazada
`user`	Análisis de transacciones	Usuario bloqueado
`business`	Análisis de transacciones	Empresa bloqueada
`country`	Condiciones de los flujos	Configurable
`key`	Uso personalizado	Configurable

Listas permitidas

Las listas permitidas no anulan las listas de bloqueo ni las comprobaciones de autenticidad. Solo suprimen las acciones de duplicado/reutilización para el mismo tipo de entrada. Por ejemplo, un rostro incluido en una lista permitida de rostros puede omitir la acción DUPLICATED_FACE, una IP incluida en una lista permitida de IP puede omitir la acción DUPLICATED_IP_ADDRESS y una huella de dispositivo incluida en una lista permitida de dispositivos puede omitir la acción DUPLICATED_DEVICE_FINGERPRINT. Didit sigue registrando una advertencia informativa de lista permitida para que puedas auditar por qué no se ejecutó la acción de duplicado.

Listas de bloqueo del sistema

Cada aplicación recibe automáticamente 10 listas de bloqueo del sistema (una por cada tipo de entrada admitido) y una lista del sistema High Risk Countries. No se pueden eliminar ni renombrar. Puedes añadirles entradas mediante la API o desde la consola.

Trazabilidad

Cada entrada de una lista de bloqueo puede vincularse a su entidad de origen para que puedas navegar desde la lista hasta el registro original:

Desde una sesión: envía reference_session_id al crear una entrada. Didit extrae automáticamente el valor (rostro, documento, teléfono, correo electrónico, IP o dispositivo), marca el modelo subyacente como incluido en la lista de bloqueo y vincula la entrada a la sesión. Didit lee el registro más reciente de ese tipo en la sesión; para incluir en la lista un valor de un registro anterior, añádelo mediante value sin reference_session_id.
Desde una transacción, un usuario o una empresa: envía reference_object_uuid con el UUID de la entidad e incluye metadata.reference_type ("transaction", "vendor_user" o "vendor_business") para que la consola pueda vincular la entrada al registro original.

Endpoints

Listar todas las listas

Obtén todas las listas de una aplicación.

Listar entradas

Obtén las entradas de una lista.

Crear entrada

Añade un valor a una lista de bloqueo: por valor, por referencia de sesión o por referencia de transacción.

Eliminar entrada

Elimina una entrada y desbloquea la entidad subyacente.

Subir rostro

Sube una imagen de un rostro directamente a una lista de bloqueo de rostros.

​Conceptos

​Tipos de entrada

​Listas permitidas

​Listas de bloqueo del sistema

​Trazabilidad

​Endpoints