Biometría de usuarios: búsqueda facial y lista de bloqueo

​

Cómo se vinculan los rostros a un usuario

​

Búsqueda facial (1:N)

• Detección de duplicados durante el onboarding: evita que la misma persona cree dos cuentas.
• Búsqueda inversa: identifica al usuario que aparece en un fotograma de CCTV o en una imagen de una investigación de fraude.
• Reconocimiento de clientes recurrentes: omite el KYC para un cliente que vuelve.

• POST /v3/face-search/: búsqueda facial independiente

​

Detección de duplicados

• Rechazar automáticamente las sesiones marcadas como duplicadas.
• Marcar para revisión: derivarlas a un analista humano.
• Solo advertir: permitirlas, pero añadir una etiqueta de riesgo.

​

Lista de bloqueo de rostros

​

Subir un rostro importado al perfil de un usuario

# 1. Create or retrieve the User keyed by your vendor_data
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "user-42",
    "display_name": "Jane Doe",
    "metadata": { "previous_provider": "legacy-kyc-vendor" }
  }'

# Response includes:
# { "didit_internal_id": "11111111-2222-3333-4444-555555555555", ... }

# 2. Upload the imported face to the User profile
curl -X POST https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/11111111-2222-3333-4444-555555555555/faces/upload/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<base64-encoded-jpg-or-png>",
    "comment": "Imported from previous KYC provider"
  }'

​

Cómo se añade un rostro a la lista de bloqueo

​

Subir un rostro a la lista de bloqueo

​

Eliminar un rostro de la lista de bloqueo

​

Plantillas biométricas conservadas tras eliminar una sesión

• Solo contiene la plantilla facial numérica y metadatos de retención. Nunca contiene la imagen del rostro, el video de la prueba de vida, los datos del documento, los campos de identidad extraídos, la decisión ni el id de la sesión eliminada.
• Participa en la detección de duplicados, la Búsqueda facial, la autenticación biométrica y tus listas de rostros exactamente igual que el rostro de una sesión activa. Las coincidencias se informan con source: "retained_template", el vendor_user_id y los vendor_data del usuario, y un biometric_template_id.
• Es un dato biométrico con un expires_at finito. Se purga cuando se elimina el usuario, cuando se elimina cualquier sesión de ese usuario con deletion_instruction: "privacy_erasure", cuando expira o cuando la purgas en Lists → Biometric templates o mediante la API de plantillas biométricas.
• Una sesión creada sin vendor_data no tiene un usuario al que vincular una plantilla; al eliminarla se informa ineligible_no_vendor_user y el embedding se elimina junto con la sesión.
• Las plantillas conservadas nunca se añaden a una lista de bloqueo. Una entrada de la lista de bloqueo de rostros creada a partir de la sesión eliminada mantiene su propia entrada biométrica independiente y su propio ciclo de vida.

​

Resumen del ciclo de vida de los rostros

​

Subir un rostro desde la consola

1. Ve a Users → [user] → Actions → Upload face.
2. Selecciona una imagen; Didit extrae el rostro más grande y guarda un nuevo registro de Face vinculado al usuario.
3. El rostro se registra como evidencia del perfil y para la detección de duplicados y la búsqueda facial. Usa la sección de lista de bloqueo cuando el objetivo sea rechazar futuras sesiones que coincidan.

• Tienes un retrato conocido de un cliente verificado mediante un canal offline.
• Quieres precargar una lista de bloqueo con actores maliciosos conocidos de tu base de datos de fraude.

​

Privacidad y retención

• Los embeddings faciales son vectores numéricos, no imágenes. Las imágenes se guardan en un almacenamiento de objetos cifrado, con acceso mediante URL firmadas. Un embedding facial es un dato biométrico.
• La retención sigue la política de retención de datos de tu aplicación. Las plantillas biométricas conservadas siguen el período de retención de plantillas biométricas, más estricto y finito.
• Al eliminar una sesión se eliminan la imagen y, de forma predeterminada, el embedding. Si tu aplicación ha activado la retención de plantillas biométricas, al eliminar una sesión se conserva una plantilla sin imagen hasta que expire o se purgue.
• Ante una solicitud para ejercer el derecho al olvido conforme al RGPD o la CCPA, elimina las sesiones de la persona con deletion_instruction: "privacy_erasure" o elimina el usuario: ambas opciones purgan también todas las plantillas conservadas. Las entradas de la lista de bloqueo de rostros que gestionas se mantienen hasta que las elimines.

​

Próximos pasos