API de coincidencia facial 1:1: selfie frente a documento

La coincidencia facial de Didit compara dos rostros 1:1, normalmente el selfie de una comprobación de prueba de vida con el retrato del documento de identidad del usuario, y devuelve una puntuación de similitud de 0 a 100. Los umbrales que definas deciden si la comprobación se supera; la API independiente POST /v3/face-match/ rechaza por defecto una puntuación de 30 o menos. En la lección de Academy sobre cómo leer el resultado de una verificación, el capítulo del minuto 6:16 trata la comprobación de coincidencia facial dentro de una sesión real.

​

Reintentos y comentarios accionables

En una sesión de Didit, una coincidencia facial que falla por un motivo de captura corregible (el selfie es demasiado oscuro, está borroso o descentrado, o la similitud está en el límite) no se rechaza de inmediato. Se pide al usuario que reintente con indicaciones, hasta un número de intentos configurable, con el mismo modelo que la prueba de vida.

• Presupuesto de intentos: face_match_max_attempts controla el número total de envíos de coincidencia facial por sesión. El valor por defecto es 3 (un intento inicial más dos reintentos) y se puede configurar por nodo del flujo de verificación (rango 1-3).
• Comentarios de reintento: mientras queden intentos, un fallo reintentable mantiene al usuario en el paso y devuelve feedback_codes (los SDKs web y móviles los muestran automáticamente como mensajes de ayuda):
  {
    "detail": "Make sure your face matches your document photo, improve lighting and try again.",
    "error": "LOW_FACE_MATCH_SIMILARITY",
    "feedback_codes": ["LOW_FACE_MATCH_SIMILARITY"],
    "attempts_used": 1,
    "max_attempts": 3
  }
  
• Agotamiento: cuando se agota el presupuesto, se aplica el estado calculado (Declined o In Review).

​

Cómo funciona

---

​

Requisitos de los documentos

Para que la verificación tenga éxito, los documentos deben cumplir estos estándares:

​

Requisitos generales

• Emitido por un gobierno y vigente dentro del periodo de validez configurado
• Físicamente intacto (sin daños, arañazos ni manchas que oculten detalles)
• Toda la información crítica (nombre completo, fecha de nacimiento, MRZ, etc.) claramente legible
• Datos coherentes en todos los documentos enviados

​

Requisitos de la imagen

• Foto original y en tiempo real (sin capturas de pantalla, escaneos ni copias digitales)
• Formatos admitidos: JPG, JPEG, PNG, PDF
• Tamaño máximo de archivo: 5MB
• Imagen a todo color con todas las esquinas del documento visibles
• Sin reflejos, sombras, edición digital ni manipulación
• Se exigen documentos físicos (los documentos de identidad digitales solo se admiten en regiones concretas donde están reconocidos oficialmente)

​

Ajustes adicionales por país y tipo de documento

Configura reglas detalladas por país y tipo de documento directamente desde la consola. Estos controles te permiten adaptar los criterios de aceptación y las preferencias de transcripción a tus necesidades de cumplimiento.

• Modo de caducidad: elige cómo tratar los documentos con fecha de caducidad vencida.
  • Rechazar documentos vencidos: si la fecha de caducidad del documento es anterior a hoy, se marca como vencido y se rechaza.
  • Permitir documentos vencidos: no se marcan ni se bloquean los documentos con fecha de caducidad vencida.
• Formato de caracteres preferido: selecciona cómo deben normalizarse los nombres y campos extraídos.
  • Preferir caracteres latinos (A–Z): ejemplo: “Mohammed”
  • Preferir escritura original (no latina): ejemplo: “محمد”
• Compatibilidad regional y subtipos: activa documentos por región y especifica los subtipos aceptables cuando un tipo de documento tiene muchas variaciones.
  • Ejemplo: en los carnets de conducir de Estados Unidos, selecciona los subtipos exactos que aceptas (por ejemplo, Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License, etc.).
  • Usa el control Subtipos aceptados para incluir o excluir rápidamente muchas variantes (por ejemplo, “128 selected”).

Consejo: estos ajustes se aplican por país y tipo de documento, así que puedes ser estricto en unos mercados y más permisivo en otros.