Serpro 相似度返回专用于工资贷款（INSS）及需要与 Serpro 数据库进行比对的业务能力。返回 采集的自拍与 Serpro 存档照片之间的相似度分数。
功能说明
该能力将本次会话的自拍与提供的 CPF 所关联的 Serpro 照片进行比对。当比对可以完成时，返回 0 到 100 的分数；当 Serpro 无法找到人脸或与 Serpro 的集成失败时，返回特殊代码（-1、-2）。
输入项
- 通过
POST /v1/process创建的包含 Serpro 相似度的采集会话。 - 用户的 CPF。
- 租户已预先开通 Serpro 能力（需与 Unico Onboarding 团队协商）。
可能的响应
| 响应 | 含义 |
|---|---|
| 分数 0–100 | Serpro 找到人脸时返回。分数越高，相似度越高。 |
| 分数 -1 | Serpro 未能找到与该 CPF 关联的人脸。 |
| 分数 -2 | 与 Serpro 的集成错误 — 无法获取分数。 |
分数 -1 和 -2 并非低分
它们是不同场景的信号代码。将其视为零分将导致错误决策。
可用性
| 接入方式 | 是否支持 |
|---|---|
| SDK（Android、iOS、Flutter） | ✅ |
| Web（iFrame、重定向） | ✅ |
| API（无 SDK 的无头模式） | ✅ |
需要开通权限
即使在支持的接入方式上，租户也需要开通 Serpro 能力。如果您的业务尚未获得访问权限，请联系 Unico 的 Onboarding 团队。
有效组合
Serpro 相似度出现在包含 serpro 或专用于工资贷款的流程中：
idcheckserpro、idcheckserprodocs、idcheckserprodocssign、idunicoserprodocssign、creditoconsignado。
完整矩阵请参阅可用流程。
使用此能力的用例
creditoconsignado 中的行为
creditoconsignado 流程会根据 Serpro 的返回结果分支用户旅程：
- Serpro 正向 → 直接进入电子签名。
- Serpro 负向（-1 或相似度低） → 要求提供文件进行人脸匹配。
- 人脸匹配正向 → 继续进入签名。
- 人脸匹配负向 → 旅程不签名结束。
这一条件行为是流程的一部分 — 无需在您的后端进行额外编排。