---
title: 새 기능 추가 방법 (API)
description: 이미 API(POST /v1/process)를 통해 사기 위험 분류(Trust Network)로 연동되어 있으며, 계약에 신원 확인을 추가하려는 고객을 위한 가이드입니다.
canonical: https://developer.unico.io/ko/dual-api/developers/api-reference/api/upgrade-guide
locale: ko
generated_by: markdown-export
---

:::info
이 가이드는 이미 **API**(`POST /processes/v1`)를 통해 사기 위험 분류(Trust Network)로 연동되어 있으며, 계약에 신원 확인을 추가하려는 고객을 위한 것입니다.
:::

## 신원 확인 추가하기

이 가이드는 신원 검증 프로세스를 강화하기 위한 의사결정 엔진의 발전 내용을 설명합니다.

:::warning[기술 요구 사항]
다른 연동과 달리, 이 기능을 활성화하려면 **API 키 업데이트가 필요합니다**. 이 변경 없이는 새로운 신원 검증 응답을 받을 수 없습니다 — Unico 담당자가 해당 정보를 안내해 드립니다.
:::

### 주요 변경 사항: 신원 확인

주요 개선 사항은 (사기 응답 외에도) 명의자의 신원을 검증할 수 있는 기능입니다. 이제 시스템은 프로세스를 수행하는 사람이 실제로 제공된 문서의 명의자인지 확인합니다.

기능이 활성화되기 전에 팀이 새로운 응답 해석을 정확히 이해하고 매핑하여 운영에 영향을 미치지 않도록 하는 것이 매우 중요합니다.

### 결과 비교표

| 결과 (Trust만) | 결과 (Trust + IDUnico) | 의미 및 권장 조치 |
|---|---|---|
| N/A | `APPROVED` | **신규 (이상적인 상태).** 사용자가 신분증 명의자이며 사기 징후가 없습니다. |
| `INCONCLUSIVE` | `INCONCLUSIVE` | **의미 변경.** 사용자는 실존 인물이며 사기 징후가 없지만, 신분증 명의자인지에 대한 확실성은 없습니다. |
| `REPROVED` | `REPROVED` | **거부 권장.** 사기 징후가 있거나, 시스템이 사용자가 신분증 명의자가 아님을 확인했습니다. |
| `HIGH_RISK` | `HIGH_RISK` | 강력한 사기 증거가 최소 1건 있습니다. 조치는 고객사가 결정합니다. |
| `CRITICAL_RISK` | `CRITICAL_RISK` | 치명적인 사기 증거가 최소 2건 있습니다. 거부를 권장합니다. |

### 명칭의 주요 변경 사항

승인 플로우에서 다음 세 가지 근본적인 변경 사항을 매핑할 준비가 되어 있는지 확인하세요.

1. **`APPROVED`의 등장** — 이제 이 상태가 "이상적인" 상태입니다. 이 코드를 받으면 프로세스의 신원과 안전성에 대해 완전한 확신을 가질 수 있습니다.
2. **`INCONCLUSIVE`의 새로운 의미** — 이전에는 주요 승인 신호였습니다. 이제는 해당 인물이 "실존"하며 명백한 사기가 없다는 것을 의미하지만, 시스템이 신분증의 신원과 완전히 확실하게 연결하지 못했음을 의미합니다.
3. **`REPROVED`의 심각성** — 다중 요인 사기 징후 외에도, 이제 이 상태에는 사용자가 신분증 명의자를 사칭하는 경우도 포함됩니다.