Retorno de Similitud Serpro

Funcionalidad específica para préstamos de nómina (INSS) y operaciones que requieren comparación con la base de datos de Serpro. Devuelve una puntuación de similitud entre la selfie capturada y la foto registrada en Serpro.

Qué hace

La capacidad activa una comparación entre la selfie de la sesión y la foto de Serpro asociada al CPF proporcionado. Devuelve una puntuación de 0 a 100 cuando la comparación es posible, o códigos especiales (-1, -2) cuando Serpro no puede encontrar el rostro o la integración con Serpro falla.

Entradas

• Una sesión de captura abierta mediante POST /v1/process con un flujo que incluye Serpro Similarity.
• El CPF del usuario.
• Habilitación previa del tenant para la capacidad Serpro (negociada con el equipo de Onboarding de Unico).

Respuestas posibles

Respuesta	Significado
Puntuación 0–100	Cuando Serpro encuentra el rostro. A mayor puntuación, mayor similitud.
Puntuación -1	Serpro no pudo encontrar un rostro asociado al CPF.
Puntuación -2	Error de integración con Serpro — no se pudo obtener la puntuación.

Las puntuaciones -1 y -2 no son puntuaciones bajas

Son códigos de señal para escenarios distintos. Tratarlos como si fueran una puntuación de cero conduce a decisiones incorrectas.

Disponibilidad

Superficie	Compatible
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅
API (headless, sin SDK)	✅

Se requiere habilitación

Incluso en las superficies compatibles, el tenant debe estar habilitado para la capacidad Serpro. Contacta al equipo de Onboarding de Unico si tu operación aún no tiene acceso.

Combinaciones válidas

Serpro Similarity aparece en flujos que incluyen serpro o son específicos para préstamos sobre nómina:

idcheckserpro, idcheckserprodocs, idcheckserprodocssign, idunicoserprodocssign, creditoconsignado.

Para la matriz completa, consulta Flujos disponibles.

Casos de uso que utilizan esta capacidad

Comportamiento dentro de creditoconsignado

El flujo creditoconsignado ramifica el proceso según el retorno de Serpro:

• Serpro positivo → va directamente a la firma electrónica.
• Serpro negativo (-1, o baja similitud) → solicita documentos para facematch.
  • Facematch positivo → procede a la firma.
  • Facematch negativo → el proceso termina sin firma.

Este comportamiento condicional es parte del flujo — no requiere orquestación en tu back-end.