---
title: Serpro類似度返却
description: 給与担保ローン（INSS）およびSerproデータベースとの照合が必要な操作に特化したCapability。撮影されたセルフィーとSerproに登録された顔写真の類似度スコアを返します。
canonical: https://developer.unico.io/ja/dual-api/capabilities/serpro-similarity-return
locale: ja
generated_by: markdown-export
---

# Serpro類似度返却

給与担保ローン（INSS）およびSerproデータベースとの照合が必要な操作に特化したCapability。撮影されたセルフィーとSerproに登録された顔写真の類似度スコアを返します。

### 機能概要

このCapabilityは、セッションのセルフィーと提供されたCPFに紐付くSerproの顔写真を照合します。照合が可能な場合は0〜100のスコアを返し、Serproが顔を見つけられない場合やSerproとの連携に失敗した場合は特別なコード（-1、-2）を返します。

### 入力

- Serpro類似度を含むフローで [`POST /v1/process`](/dual-api/developers/api-reference/web-sdk) を通じて開かれたキャプチャセッション。
- ユーザーのCPF。
- Serpro Capabilityに対する事前のテナント有効化（Unicoオンボーディングチームとの協議が必要）。

### 返却される可能性のあるレスポンス

| レスポンス | 意味 |
|---|---|
| **スコア 0〜100** | Serproが顔を検出した場合。スコアが高いほど類似度が高い。 |
| **スコア -1** | Serproが当該CPFに紐付く顔を**見つけられなかった**場合。 |
| **スコア -2** | Serproとの**連携エラー** — スコアを取得できなかった場合。 |

:::warning[スコア -1 と -2 は低スコアではありません]
これらは異なるシナリオを示すシグナルコードです。ゼロスコアと同様に扱うと誤った判断につながります。
:::

### 対応状況

| サーフェス | 対応 |
|---|:-:|
| **SDK**（Android、iOS、Flutter） | ✅ |
| **Web**（iFrame、リダイレクト） | ✅ |
| **API**（ヘッドレス、SDK不使用） | ✅ |

:::note[有効化が必要]
対応サーフェスであっても、テナントがSerpro Capabilityに対して**有効化**されている必要があります。まだアクセスできない場合は、Unicoのオンボーディングチームにお問い合わせください。
:::

### 有効な組み合わせ

Serpro類似度は、`serpro` を含むフローまたは給与担保ローン専用のフローに表示されます：

`idcheckserpro`, `idcheckserprodocs`, `idcheckserprodocssign`, `idunicoserprodocssign`, `creditoconsignado`。

完全な対応マトリクスは[利用可能なフロー](/dual-api/capabilities/available-flows)を参照してください。

### このCapabilityを使用する製品

### `creditoconsignado` 内の動作

`creditoconsignado` フローはSerproの返却値に基づいて**ジャーニーを分岐**します：

- **Serpro 陽性** → 電子署名に直接進む。
- **Serpro 否定的（-1、または低類似度）** → 顔照合のためにドキュメントを要求。
  - 顔照合 陽性 → 署名に進む。
  - 顔照合 否定的 → ジャーニーは**署名なし**で終了。

この条件分岐は、バックエンドでのオーケストレーションを必要とせず、フローの一部として組み込まれています。