---
title: Serpro 유사도 반환
description: 급여 담보 대출(INSS) 및 Serpro 데이터베이스와의 비교가 필요한 작업에 특화된 기능입니다. 촬영된 셀피와 Serpro에 등록된 사진 간의 유사도 점수를 반환합니다.
canonical: https://developer.unico.io/ko/dual-api/capabilities/serpro-similarity-return
locale: ko
generated_by: markdown-export
---

# Serpro Similarity Return

급여 담보 대출(INSS) 및 Serpro 데이터베이스와의 비교가 필요한 작업에 특화된 기능입니다. 촬영된 셀피와 Serpro에 등록된 사진 간의 유사도 점수를 반환합니다.

### 기능 설명

이 기능은 세션 셀피와 제공된 CPF에 연결된 Serpro 사진 간의 비교를 수행합니다. 비교가 가능한 경우 0~100 점수를 반환하며, Serpro가 얼굴을 찾지 못하거나 Serpro와의 연동이 실패하는 경우 특수 코드(-1, -2)를 반환합니다.

### 입력값

- Serpro Similarity가 포함된 플로우로 [`POST /v1/process`](/dual-api/developers/api-reference/web-sdk)를 통해 열린 캡처 세션.
- 사용자의 CPF.
- Serpro 기능에 대한 테넌트 사전 활성화 (Unico 온보딩 팀과 협의 필요).

### 가능한 응답

| 응답 | 의미 |
|---|---|
| **점수 0–100** | Serpro가 얼굴을 찾은 경우. 점수가 높을수록 유사도가 높습니다. |
| **점수 -1** | Serpro가 CPF에 연결된 **얼굴을 찾지 못함**. |
| **점수 -2** | Serpro와의 **연동 오류** — 점수를 가져올 수 없음. |

:::warning[점수 -1과 -2는 낮은 점수가 아닙니다]
이들은 서로 다른 시나리오에 대한 신호 코드입니다. 이를 0점으로 처리하면 잘못된 결정으로 이어집니다.
:::

### 가용성

| 인터페이스 | 지원 여부 |
|---|:-:|
| **SDK** (Android, iOS, Flutter) | ✅ |
| **Web** (iFrame, Redirect) | ✅ |
| **API** (헤드리스, SDK 없음) | ✅ |

:::note[활성화 필요]
지원되는 환경에서도 테넌트가 Serpro 기능에 대해 **활성화**되어 있어야 합니다. 해당 기능에 대한 접근 권한이 없는 경우 Unico 온보딩 팀에 문의하세요.
:::

### 유효한 조합

Serpro Similarity는 `serpro`를 포함하거나 급여 담보 대출에 특화된 플로우에 나타납니다:

`idcheckserpro`, `idcheckserprodocs`, `idcheckserprodocssign`, `idunicoserprodocssign`, `creditoconsignado`.

전체 매트릭스는 [사용 가능한 플로우](/dual-api/capabilities/available-flows)를 참조하세요.

### 이 기능을 사용하는 제품

### `creditoconsignado` 내 동작

`creditoconsignado` 플로우는 Serpro의 반환값에 따라 **여정을 분기**합니다:

- **Serpro 긍정** → 전자 서명으로 바로 진행합니다.
- **Serpro 부정(-1 또는 낮은 유사도)** → 얼굴 매칭을 위한 문서 요청.
  - 얼굴 매칭 긍정 → 서명으로 진행합니다.
  - 얼굴 매칭 부정 → 여정이 **서명 없이** 종료됩니다.

이 조건부 동작은 플로우의 일부입니다 — 백엔드에서의 오케스트레이션이 필요하지 않습니다.