Retorno de Semelhança do Serpro

Capability específica para crédito consignado (INSS) e operações que exigem comparação com a base do Serpro. Retorna uma pontuação de semelhança entre a selfie capturada e a foto registrada no Serpro.

O que faz

A capability dispara uma comparação entre a selfie da sessão e a foto do Serpro associada ao CPF informado. Retorna uma pontuação de 0 a 100 quando a comparação é possível, ou códigos especiais (-1, -2) quando o Serpro não encontra o rosto ou ocorre uma falha na integração com o Serpro.

Entradas

• Uma sessão de captura aberta via POST /v1/process com um fluxo que inclui o Retorno de Semelhança do Serpro.
• O CPF do usuário.
• Habilitação prévia do tenant para a capability do Serpro (negociada com o time de Onboarding da Unico).

Respostas possíveis

Resposta	Significado
Pontuação 0–100	Quando o Serpro encontra o rosto. Quanto maior a pontuação, maior a semelhança.
Pontuação -1	O Serpro não encontrou um rosto associado ao CPF.
Pontuação -2	Erro de integração com o Serpro — não foi possível obter a pontuação.

Pontuação -1 e -2 não são pontuações baixas

São códigos de sinalização para cenários distintos. Tratá-los como se fossem pontuação zero leva a decisões incorretas.

Disponibilidade

Superfície	Suportado
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅
API (headless, sem SDK)	✅

Habilitação necessária

Mesmo nas superfícies suportadas, o tenant precisa estar habilitado para a capability do Serpro. Entre em contato com o time de Onboarding da Unico se a sua operação ainda não tiver acesso.

Combinações válidas

O Retorno de Semelhança do Serpro aparece em fluxos que incluem serpro ou são específicos para crédito consignado:

idcheckserpro, idcheckserprodocs, idcheckserprodocssign, idunicoserprodocssign, creditoconsignado.

Para a matriz completa, consulte Fluxos disponíveis.

Casos de uso que utilizam esta capability

Comportamento dentro do creditoconsignado

O fluxo creditoconsignado ramifica a jornada com base no retorno do Serpro:

• Serpro positivo → segue diretamente para a assinatura eletrônica.
• Serpro negativo (-1 ou baixa semelhança) → solicita documentos para facematch.
  • Facematch positivo → prossegue para a assinatura.
  • Facematch negativo → a jornada é encerrada sem assinatura.

Esse comportamento condicional faz parte do fluxo — não requer orquestração no seu back-end.