Retour de similarité Serpro

Capacité spécifique aux prêts sur salaire (INSS) et aux opérations nécessitant une comparaison avec la base de données Serpro. Retourne un score de similarité entre le selfie capturé et la photo enregistrée chez Serpro.

Ce que ça fait

La capacité déclenche une comparaison entre le selfie de la session et la photo Serpro associée au CPF fourni. Retourne un score de 0 à 100 lorsque la comparaison est possible, ou des codes spéciaux (-1, -2) lorsque Serpro ne trouve pas le visage ou que l'intégration avec Serpro échoue.

Entrées

• Une session de capture ouverte via POST /v1/process avec un flux incluant la similarité Serpro.
• Le CPF de l'utilisateur.
• L'activation préalable du tenant pour la capacité Serpro (négociée avec l'équipe Unico Onboarding).

Réponses possibles

Réponse	Signification
Score 0–100	Lorsque Serpro trouve le visage. Plus le score est élevé, plus la similarité est grande.
Score -1	Serpro n'a pas pu trouver un visage associé au CPF.
Score -2	Erreur d'intégration avec Serpro — le score n'a pas pu être obtenu.

Les scores -1 et -2 ne sont pas des scores faibles

Ce sont des codes de signal pour des scénarios distincts. Les traiter comme s'ils étaient un score nul entraîne de mauvaises décisions.

Disponibilité

Surface	Pris en charge
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅
API (headless, sans SDK)	✅

Activation requise

Même sur les surfaces prises en charge, le tenant doit être activé pour la capacité Serpro. Contactez l'équipe Onboarding d'Unico si votre opération n'y a pas encore accès.

Combinaisons valides

La similarité Serpro apparaît dans les flux incluant serpro ou spécifiques aux prêts sur salaire :

idcheckserpro, idcheckserprodocs, idcheckserprodocssign, idunicoserprodocssign, creditoconsignado.

Pour la matrice complète, voir Flux disponibles.

Cas d'usage utilisant cette capacité

Comportement dans creditoconsignado

Le flux creditoconsignado oriente le parcours en fonction du retour de Serpro :

• Serpro positif → passe directement à la signature électronique.
• Serpro négatif (-1, ou faible similarité) → demande des documents pour la comparaison faciale.
  • Comparaison faciale positive → procède à la signature.
  • Comparaison faciale négative → le parcours se termine sans signature.

Ce comportement conditionnel fait partie du flux — il ne nécessite pas d'orchestration côté back-end.