---
title: Serpro 相似度返回
description: 专用于工资贷款（INSS）及需要与 Serpro 数据库进行比对的业务能力。返回采集的自拍与 Serpro 存档照片之间的相似度分数。
canonical: https://developer.unico.io/zh-CN/dual-api/capabilities/serpro-similarity-return
locale: zh-CN
generated_by: markdown-export
---

# Serpro 相似度返回

专用于工资贷款（INSS）及需要与 Serpro 数据库进行比对的业务能力。返回采集的自拍与 Serpro 存档照片之间的相似度分数。

### 功能说明

该能力将本次会话的自拍与提供的 CPF 所关联的 Serpro 照片进行比对。当比对可以完成时，返回 0 到 100 的分数；当 Serpro 无法找到人脸或与 Serpro 的集成失败时，返回特殊代码（-1、-2）。

### 输入项

- 通过 [`POST /v1/process`](/dual-api/developers/api-reference/web-sdk) 创建的包含 Serpro 相似度的采集会话。
- 用户的 CPF。
- 租户已预先开通 Serpro 能力（需与 Unico Onboarding 团队协商）。

### 可能的响应

| 响应 | 含义 |
|---|---|
| **分数 0–100** | Serpro 找到人脸时返回。分数越高，相似度越高。 |
| **分数 -1** | Serpro **未能找到**与该 CPF 关联的人脸。 |
| **分数 -2** | 与 Serpro 的**集成错误** — 无法获取分数。 |

:::warning[分数 -1 和 -2 并非低分]
它们是不同场景的信号代码。将其视为零分将导致错误决策。
:::

### 可用性

| 接入方式 | 是否支持 |
|---|:-:|
| **SDK**（Android、iOS、Flutter） | ✅ |
| **Web**（iFrame、重定向） | ✅ |
| **API**（无 SDK 的无头模式） | ✅ |

:::note[需要开通权限]
即使在支持的接入方式上，租户也需要**开通** Serpro 能力。如果您的业务尚未获得访问权限，请联系 Unico 的 Onboarding 团队。
:::

### 有效组合

Serpro 相似度出现在包含 `serpro` 或专用于工资贷款的流程中：

`idcheckserpro`、`idcheckserprodocs`、`idcheckserprodocssign`、`idunicoserprodocssign`、`creditoconsignado`。

完整矩阵请参阅[可用流程](/dual-api/capabilities/available-flows)。

### 使用此能力的产品

### `creditoconsignado` 中的行为

`creditoconsignado` 流程会根据 Serpro 的返回结果**分支用户旅程**：

- **Serpro 正向** → 直接进入电子签名。
- **Serpro 负向（-1 或相似度低）** → 要求提供文件进行人脸匹配。
  - 人脸匹配正向 → 继续进入签名。
  - 人脸匹配负向 → 旅程**不签名**结束。

这一条件行为是流程的一部分 — 无需在您的后端进行额外编排。