> ## 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.

# 인증 링크: 호스팅 KYC URL 및 QR 코드

> Didit 콘솔이나 API에서 안전한 인증 링크와 QR 코드를 만드세요. 프론트엔드 개발 없이 몇 분 만에 호스팅 신분증 인증을 시작할 수 있습니다.

인증 링크는 최종 사용자를 Didit이 전적으로 호스팅하는 인증 흐름으로 안내하는 고유하고 안전한 URL입니다. Business Console에서 인증 단계와 로직을 설계하면 사용자 인터페이스, 데이터 수집, 보안은 Didit이 처리합니다. 이 방식으로 대개 코드 없이도 몇 분 안에 견고한 인증 프로세스를 시작할 수 있습니다.

이 방식은 **Orchestrated Workflows** 연동 경로의 일부로, 워크플로 엔진의 기능을 가장 간단한 형태로 제공합니다.

***

## 작동 방식

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

[Didit Business Console](https://business.didit.me)에서 노코드 편집기를 사용해 필요한 검사의 정확한 순서로 워크플로를 설계합니다(예: ID 문서 스캔 → 라이브니스 검사 → AML 스크리닝). 각 워크플로에는 고유한 `workflow_id`가 있습니다.

**2. 인증 링크 생성하기**

사용자를 위한 고유한 세션을 생성합니다. Business Console에서 **노코드**로 직접 생성하거나, [Create Session](https://docs.didit.me/ko/sessions-api/create-session.md) 엔드포인트에 단일 API 호출을 보내는 **로우코드** 방식으로 생성할 수 있습니다.

**3. 링크 공유하기**

생성된 URL을 이메일, SMS, 앱 내 메시지 등 원하는 채널로 사용자에게 보내거나 iframe에 삽입합니다.

**4. 실시간 결과 받기**

사용자가 진행하는 동안, 그리고 최종 인증 결과가 준비되면 Didit이 설정된 [webhook URL](https://docs.didit.me/ko/integration/webhooks.md)로 자동 업데이트를 보냅니다.

***

## 인증 링크 생성하기

### 방법 1: 노코드 생성(Business Console 사용)

즉시 시작하거나, 수동 프로세스를 진행하거나, 개발 리소스가 없는 팀에 가장 적합한 방법입니다.

1. [Didit Business Console](https://business.didit.me)에서 **인증** 섹션으로 이동합니다.
2. **+ Create Verification**을 클릭합니다.
3. 이 세션에 사용할 `workflow_id`를 선택합니다.
4. 선택 사항으로 `vendor_data`(시스템의 사용자 ID 등)를 입력하여 인증 결과를 사용자와 연결합니다.
5. **고유 URL과 QR 코드**가 즉시 생성됩니다.
6. 링크를 복사하거나, 사용자가 QR 코드를 스캔하도록 하거나, 사용자의 이메일로 링크를 직접 보냅니다.

### 방법 2: 로우코드 생성(API 사용)

이 방식은 완전한 자동화를 제공하며, 인증 링크를 애플리케이션 로직에 통합하는 표준 방법입니다.

API 키와 `workflow_id`를 포함하여 `/v3/session/` 엔드포인트에 단일 `POST` 요청을 보냅니다.

```bash theme={null}
curl --request POST \
     --url https://verification.didit.me/v3/session/ \
     --header 'x-api-key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
       "workflow_id": "550e8400-e29b-41d4-a716-446655440000",
       "vendor_data": "your_internal_user_id_123",
       "callback": "https://yourapp.com/didit/webhook/handler"
     }'
```

API는 `session_id`와 고유 인증 `url`을 포함하는 JSON 객체를 반환합니다.

```json theme={null}
{
  "session_id": "11111111-2222-3333-4444-555555555555",
  "session_number": 1234,
  "vendor_data": "your_internal_user_id_123",
  "status": "Not Started",
  "workflow_id": "550e8400-e29b-41d4-a716-446655440000",
  "callback": "https://yourapp.com/didit/webhook/handler",
  "url": "https://verify.didit.me/session/abcdef123456"
}
```

> [!NOTE]
>
> 전체 API 세부 정보는 [Create Session API 레퍼런스](https://docs.didit.me/ko/sessions-api/create-session.md)에서 확인할 수 있습니다.

***

## 인증 링크를 사용하는 경우

> [card] 빠른 출시
>
> 완전하고 안전하며 규정을 준수하는 인증 프로세스를 몇 주가 아니라 몇 시간 안에 시작하세요.

> [card] 프론트엔드 개발 불필요
>
> 문서 촬영, 라이브니스 검사, 사용자 안내를 포함한 전체 사용자 인터페이스를 Didit의 기본 제공 UI에 맡기세요.

> [card] 다중 채널 전송
>
> 이메일, SMS, 고객 지원 채팅 또는 그 밖의 커뮤니케이션 채널로 인증 요청을 보내세요.

> [card] 대면 온보딩
>
> 사용자가 자신의 기기에서 직접 인증을 완료해야 하는 대면 상황에서 QR 코드를 사용하세요.

***

## 다음 단계

* **첫 번째 워크플로 구성하기**: [Business Console](https://business.didit.me)에서 인증 과정을 설계하세요.
* **webhook 설정하기**: [Webhook 처리](https://docs.didit.me/ko/integration/webhooks.md) 가이드에서 실시간 상태 업데이트를 받는 방법을 확인하세요.
* **Unilinks 살펴보기**: 재사용 가능하고 백엔드가 필요 없는 대안은 [Unilinks](https://docs.didit.me/ko/console/uni-links.md)를 참고하세요.


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