---
title: Retorno de Semelhança do Serpro
description: 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.
canonical: https://developer.unico.io/pt-BR/dual-api/capabilities/serpro-similarity-return
locale: pt-BR
generated_by: markdown-export
---

# 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`](/dual-api/developers/api-reference/web-sdk) 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. |

:::warning[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) | ✅ |

:::note[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](/dual-api/capabilities/available-flows).

### Produtos que utilizam esta capacidade

### 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.