> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Unilinks: 재사용 가능한 KYC 링크 (노코드 신원 인증)

> Didit Unilinks로 코드 없이 신원 인증을 시작하세요. 워크플로당 재사용 가능한 URL 하나를 이메일, SMS, QR 코드, 버튼으로 공유해 즉시 KYC를 진행합니다.

**Unilink**은 워크플로당 하나로 재사용할 수 있는 링크로, 백엔드 없이도 Didit의 호스팅 인증 흐름을 시작합니다. 사이트의 버튼에 연결하거나, 사용자에게 보내거나, **QR 코드**로 인쇄할 수 있습니다. 방문할 때마다 해당 워크플로의 세션이 생성되며, 결과는 수동 검토를 위해 **비즈니스 콘솔**에서 확인할 수 있습니다.

***

## Unilink가 적합한 선택인 경우

**백엔드 연동이 전혀 필요 없고** **출시 속도를 최대한 높이고** 싶을 때 **Unilink**를 선택하세요. 특히 수동 또는 운영 검토가 필요한 상황에 적합합니다.

> [card] 로우코드 / 노코드 팀
>
> API 연동이나 백엔드 설정이 필요하지 않습니다.

> [card] MVP 및 파일럿
>
> 본격적인 연동에 투자하기 전에 인증 흐름을 검증해 보세요.

> [card] 대면 KYC
>
> 매장, 지점 또는 키오스크에서 QR 코드를 사용하세요.

> [card] 제휴 또는 추천 인증
>
> 이메일, SMS 또는 WhatsApp으로 링크를 공유하세요.

***

## Unilink를 사용하지 말아야 하는 경우

다음 중 하나라도 필요하다면 Unilink를 사용하지 말고 대신 [API(세션 생성)](https://docs.didit.me/ko/sessions-api/create-session.md)를 사용하세요.

* 세션과 수명 주기에 대한 **세밀한 백엔드 제어**
* **완전 자동화된** 사용자 여정(수동 단계 없음)
* **사용자에게 알리지 않는** 또는 백그라운드 검사
* 사용자 속성에 따라 달라지는 **동적 워크플로**
* **복잡한 조건부 로직**(국가, 위험도, 문서 유형에 따른 분기)
* **대용량이면서 고도로 맞춤화된** 엔터프라이즈 오케스트레이션

***

## Unilink vs API

| 사용 사례 | 권장 옵션 |
| - | - |
| 빠른 출시 / MVP | **Unilink** |
| 백엔드 없음 | **Unilink** |
| 사용자에게 링크 전송 | **Unilink** |
| QR 인증(키오스크 / 지점) | **Unilink** |
| 콘솔에서 운영자의 수동 검토 | **Unilink** |
| 완전히 맞춤화된 흐름 | **API** |
| 백엔드 자동화 | **API** |
| 조건부 위험 로직 | **API** |
| 사용자별 컨텍스트를 갖춘 대규모 처리 | **API** |

> [!NOTE]
>
> **간단한 판단 기준:** **속도와 단순함**을 원하면 Unilink를 선택하세요. **제어와 자동화**를 원하면 API 연동을 선택하세요.

***

## Unilink 사용 방법

**1. 워크플로 구성**

**비즈니스 콘솔**에서 인증 단계, 라이브니스 감지/AML 스크리닝, 브랜딩을 설정하세요.

**2. Unilink 복사**

각 워크플로에는 고유한 Unilink가 있습니다. 워크플로 설정에서 복사하세요.

**3. 배포**

다음 방법으로 링크를 공유하세요.

* 웹사이트의 버튼
* 이메일 / SMS / WhatsApp
* 인쇄본 또는 화면에 표시된 QR 코드

**4. 결과 검토**

운영자가 **콘솔**에서 결과를 검토하고 내부 기록과 대조합니다.

### 예시: 웹사이트 버튼

```html theme={null}
<a class="btn btn-primary"
   href="https://verify.didit.me/verify/UNILINK_TOKEN"
   rel="noopener"
   target="_blank">
  Verify your identity
</a>
```

***

## 모범 사례

1. 수동 운영과 MVP에는 **Unilink로 시작**하고, 자동화 요구가 커지면 [세션 생성](https://docs.didit.me/ko/sessions-api/create-session.md)으로 전환하세요.
2. **샌드박스 vs. 라이브**: 샌드박스 키와 링크로 테스트하고, 출시 시점에 프로덕션용으로 교체하세요.
3. **보안**: 링크를 공개적으로 노출한다면 호스트 페이지에 봇 차단 기능을 적용하는 것을 고려하세요.
4. **webhook**: 서명을 검증하고, 실패 시 재시도하며, 나중에 자동화하게 되면 이벤트 이력을 저장하세요. [webhook 가이드](https://docs.didit.me/ko/integration/webhooks.md)를 참고하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.