Guía de challenges
Combinaciones de validaciones (challenges) recomendadas según el caso de uso. El detalle de cada identificador está en el Catálogo de challenges; esta guía se enfoca en cómo combinarlos.
Todas las combinaciones incluyen liveness:selfie, validación que permite anular cualquier intento de suplantación de identidad.
1. Verificación con selfie
Para validar la identidad de una persona en un proceso puntual, sin registrar su rostro para usos futuros.
["liveness:selfie", "match:portrait:selfie", "match:ocr:id"]
Compara la selfie contra la foto de perfil del documento y valida los datos leídos del documento.
Comparación de nombres
Si al crear el proceso biométrico se envía personal_info, match:ocr:id también comparará los nombres y apellidos declarados contra los leídos del documento.
2. Onboarding con validaciones recurrentes
Para procesos donde la persona debe validarse más de una vez en el tiempo. La primera validación registra el rostro (register:face); las siguientes lo contrastan contra ese registro, sin volver a pedir el documento.
2.1 Primera validación (registro)
["liveness:selfie", "match:portrait:selfie", "match:ocr:id", "register:face"]
Es la combinación del caso 1 más el registro del rostro en la base de datos de rostros indexados del integrador.
Comparación de nombres
Si al crear el proceso biométrico se envía personal_info, match:ocr:id también comparará los nombres y apellidos declarados contra los leídos del documento.
2.2 Segunda validación en adelante
["liveness:selfie", "match:db:selfie"]
Requisito: la persona debe haber sido registrada antes con register:face, mediante la combinación 2.1.
Consideraciones al capturar el documento
Aplica a toda combinación que incluya match:ocr:id o match:portrait:selfie.
La cámara debe contar con autofoco
La lectura de un documento exige una cámara con autofoco para capturar la información con nitidez suficiente. La mayoría de los smartphones actuales lo tienen, pero conviene verificarlo si el proceso se resuelve desde equipos de escritorio, cámaras web o dispositivos de gama baja: sin autofoco, la extracción de datos falla o entrega resultados incorrectos.
Validación de autenticidad del documento y su impacto en la conversión
El integrador puede añadir liveness:doc:front y liveness:doc:back para verificar que el documento no sea fraudulento (foto de una pantalla, impresión, adulteración de la foto de perfil).
Al tratarse de validaciones que analizan el documento en detalle, son más exigentes con las condiciones de captura (luz, enfoque, ausencia de reflejos) y bajan la conversión del proceso. Se recomienda incluirlas solo si el flujo garantiza buenas condiciones de luz y cámara, o si el nivel de riesgo del caso de uso lo justifica.
Ejemplo: ["liveness:selfie", "match:portrait:selfie", "match:ocr:id", "liveness:doc:front", "liveness:doc:back"]
Fuentes de datos oficiales por país
En algunos países, los datos del proceso pueden contrastarse además contra una fuente de datos oficial, un registro ajeno al integrador con IDENTIA como intermediario de esa conexión. Estas validaciones requieren habilitación previa del integrador, gestionada por IDENTIA, y sólo aplican a documentos del país de la fuente.
Si el integrador no cuenta con esa habilitación, la creación del proceso responderá not found con código 404.
Perú
Las consultas se realizan con el número de documento nacional peruano (DNI), por lo que estas validaciones no aplican a documentos de otros países.
El Registro Nacional de Identificación y Estado Civil entrega la ficha de la persona, incluida su foto de perfil. Al comparar la selfie contra esa foto, la certeza deja de depender de la calidad de la foto del documento. Requiere que el integrador cuente con una trama en RENIEC.
Verificación con selfie, equivalente al caso 1:
-
Contra los datos declarados en el proceso:
["liveness:selfie", "match:selfie:reniec", "match:pinfo:reniec:gname", "match:pinfo:reniec:fname"]No requiere que la persona fotografíe su documento, por lo que es la opción de mayor conversión.
-
Contra los datos leídos del documento:
["liveness:selfie", "match:selfie:reniec", "match:ocr:reniec"]Exige que la persona tenga el documento en su poder, lo que agrega una evidencia adicional de tenencia.
Primera validación de un onboarding recurrente, equivalente al caso 2.1: las mismas combinaciones más register:face. Una vez registrado el rostro, la combinación 2.2 aplica sin cambios y no vuelve a consultar RENIEC.
Entrega los datos de identidad asociados al documento (nombres, apellidos, fecha de nacimiento y sexo), pero no entrega foto de perfil, por lo que no puede sustituir una comparación biométrica: se recomienda usarla como capa adicional sobre una combinación que ya valide el rostro.
["liveness:selfie", "match:portrait:selfie", "match:ocr:id", "match:pinfo:ctralriesgos:gname", "match:pinfo:ctralriesgos:fname"]
match:pinfo:ctralriesgos:fname compara el campo completo, por lo que el valor entregado debe incluir todos los apellidos registrados para ese documento.