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

# Zapier 신분증 인증 자동화

> Didit Zapier 앱으로 신분증 인증 워크플로를 자동화하세요. 6,000+개 앱에서 인증을 트리거하고 결과를 수신할 수 있습니다. 사용량 기반 요금.

Zapier를 통해 Didit을 **6,000+ 앱**과 연결하세요. 코드 작성은 필요하지 않습니다. 인증 세션을 자동으로 생성하고, 상태 변경에 반응하며, 결과를 CRM, 데이터베이스 또는 커뮤니케이션 도구와 동기화할 수 있습니다.

> [card] [Zapier에서 Didit 열기](https://zapier.com/apps/didit/integrations)
>
> Zapier 마켓플레이스에서 트리거, 액션, 바로 사용할 수 있는 템플릿을 살펴보세요.

[Didit Zapier 연동](https://www.youtube.com/embed/D7X4kNHxX0A?rel=0\&playsinline=1)

***

## 제공 기능

> [card] 세션 생성
>
> 양식 제출, CRM 이벤트 또는 Zapier에 연결된 모든 앱에서 인증 세션을 시작하세요.

> [card] 실시간 webhook
>
> 승인됨, 거부됨, 검토 중 등의 상태 업데이트를 Zapier 트리거로 즉시 받으세요.

> [card] 결과 조회
>
> ID 데이터, 라이브니스 점수, AML 적발 결과를 포함한 전체 세션 세부 정보를 필요할 때 가져오세요.

***

## 사전 준비 사항

| 요구 사항 | 준비 방법 |
| - | - |
| **Didit 계정** | [business.didit.me](https://business.didit.me)에서 가입하세요. 테스트에는 무료 KYC 요금제로 충분합니다. |
| **API 키** | 콘솔 → **API 및 webhook** → 프로덕션 키를 복사하세요. Zapier 앱은 모든 작업에서 이 키로 인증합니다. |
| **워크플로 ID** | 콘솔 → **워크플로** → 실행할 워크플로를 선택하세요([새로 만들기](https://docs.didit.me/ko/console/workflows.md)도 가능합니다). |
| **Zapier 계정** | 무료 또는 유료 요금제 ([zapier.com](https://zapier.com)). 무료 요금제는 월 100개 작업을 처리하므로 소규모 파일럿에 충분합니다. |

***

## 작동 방식

**1. Didit을 Zapier에 연결**

Zapier에서 앱 디렉터리로 **Didit**을 검색하거나([마켓플레이스 목록](https://zapier.com/apps/didit/integrations)을 직접 여세요), 콘솔 → **API 및 webhook**에서 확인한 **API 키**를 사용해 계정을 연결하세요.

> [!TIP]
>
> API 키는 Zapier의 모든 Didit 작업을 인증합니다. 한 번만 연결하면 되며, 모든 Zap이 같은 연결을 공유합니다. 콘솔에서 키를 교체하면 다시 연결하기 전까지 Zapier 연결이 무효화됩니다.

**2. 트리거 설정**

Zap을 시작할 항목을 선택하세요. **Didit 트리거** 또는 다른 앱이 될 수 있습니다:

| 트리거 소스 | 예시 |
| - | - |
| **Didit webhook** | 세션 상태가 "Approved"로 변경 |
| **Google Forms** | 새 양식 제출 → 인증 세션 생성 |
| **HubSpot** | 새 연락처 생성 → KYC 시작 |
| **Stripe** | 새 고객 → 지급 전에 신원 확인 |
| **Typeform** | 온보딩 양식 작성 완료 → 인증 시작 |

**3. Didit 작업 추가**

[Zapier 마켓플레이스 목록](https://zapier.com/apps/didit/integrations)에 있는 이름과 같은 Didit 작업 중 하나를 사용하세요:

**인증 세션 생성**: `POST /v3/session/`을 호출합니다.

* 실행할 인증 흐름의 **워크플로 ID**를 입력하세요.
* 선택 사항으로 인증 후 리디렉션을 위한 **콜백 URL**을 설정할 수 있습니다.
* 세션을 기존 기록에 연결하려면 **벤더 데이터**(예: 사용자 이메일 또는 내부 ID)를 전달하세요.
* 이 작업은 새 `session_id`, 사용자에게 표시되는 `url`, 초기 `status`를 반환합니다. `url`을 사용해 사용자를 인증 흐름으로 보내세요.

**인증 세션 조회**: `GET /v3/session/{sessionId}/decision/`을 호출합니다.

* `session_id`를 전달해 전체 인증 결과를 가져오세요.
* ID 데이터, 라이브니스 점수, AML 결과, 최종 `status`, 업로드된 미디어 URL에 접근하세요.

**4. 결과에 따른 후속 처리**

인증 결과에 따라 후속 작업을 추가하세요:

| 상태 | 권장 작업 |
| - | - |
| `"Approved"` | CRM 업데이트, 플랫폼 접근 권한 부여, 환영 이메일 발송 |
| `"Declined"` | 데이터베이스에 표시, 컴플라이언스 담당자에게 알림, 거부 이메일 발송 |
| `"In Review"` | 컴플라이언스 팀에 작업 생성, Slack 알림 전송 |
| `"Abandoned"` | 새 인증 링크가 포함된 리마인더 이메일 발송 |

![Zapier 작업 단계에서 Didit 신원 인증 세션을 생성하는 모습](https://mintcdn.com/didit-0f962782/DSfxHq_ggIpqiQSG/images/zapier-create-session.png?fit=max\&auto=format\&n=DSfxHq_ggIpqiQSG\&q=85\&s=f847a30aa1e0b600543ae4dec6229cdd)

Zapier 작업에서 Didit 인증 세션을 생성하는 모습입니다.

***

## 인기 Zap 템플릿

> [card] Google Forms → Didit → Gmail
>
> 사용자가 온보딩 양식을 작성 → 인증 세션 생성 → 결과를 사용자와 관리자에게 이메일로 발송.

> [card] HubSpot → Didit → HubSpot
>
> 새 연락처 → KYC 시작 → 연락처 속성을 인증 상태와 ID 데이터로 업데이트.

> [card] Stripe → Didit → Slack
>
> 새 고객 → 신원 확인 → Slack으로 결과를 팀에 알림.

> [card] webhook → Didit → Airtable
>
> 커스텀 트리거 → 사용자 인증 → 컴플라이언스 기록을 위해 세션 결과를 Airtable에 기록.

***

## 사용 가능한 트리거 및 작업

아래 이름은 [마켓플레이스](https://zapier.com/apps/didit/integrations)의 현재 Didit Zapier 앱과 일치합니다. Zapier 내부에서 레이블이 약간 다르게 보이더라도 Zapier UI를 기준으로 하세요. 기본 동작은 같습니다.

### 트리거(Zap 시작)

| 트리거 | 기반 이벤트 | 설명 |
| - | - | - |
| **세션 상태 업데이트** | [`status.updated` webhook](https://docs.didit.me/ko/integration/webhooks) | 인증 세션의 상태가 바뀔 때마다 실행됩니다 (`Approved`, `Declined`, `In Review`, `Resubmitted`, `Abandoned`, `Kyc Expired` 등). |

### 작업(작업 수행)

| 작업 | 기반 endpoint | 설명 |
| - | - | - |
| **인증 세션 생성** | `POST /v3/session/` | 워크플로, 선택적 콜백 URL, `vendor_data`로 새 세션을 시작합니다. 사용자와 공유할 세션 URL을 반환합니다. |
| **인증 세션 조회** | `GET /v3/session/{sessionId}/decision/` | 지정한 `session_id`에 대한 전체 결정 payload(ID 데이터, 라이브니스, AML 적발 결과, 최종 상태)를 가져옵니다. |

***

## 알아야 할 사항

> [!WARNING]
>
> Didit Zapier 앱은 의도적으로 **가장 가치가 큰 자동화 영역**, 즉 세션 시작과 상태 업데이트 대응에 범위를 한정했습니다. 다음 항목은 현재 Zapier에서 제공되지 않으며 API를 직접 호출해야 합니다:
>
> * Zap 단계에서 문서 이미지, 영상 또는 POA 애셋을 업로드하는 작업.
> * [`PATCH /v3/session/{sessionId}/update-status/`](https://docs.didit.me/ko/sessions-api/update-status)를 통한 결정 재정의.
> * KYB 전용 엔드포인트(등기부, 주요 인물).
> * 세션 수준 상태 변경 이외의 webhook 이벤트 유형(예: `transaction.status.updated`, `user.status.updated`).
>
> 이러한 기능이 노코드 도구에서 필요하다면, API 키를 사용해 Zapier의 **Webhooks by Zapier** 단계를 통해 [Sessions API](https://docs.didit.me/ko/sessions-api/create-session.md)를 호출하세요.

***

## 팁 및 모범 사례

> [accordion] 벤더 데이터로 세션 연결하기
>
> 세션을 생성할 때는 항상 고유 식별자(이메일, 사용자 ID 또는 UUID)를 **벤더 데이터** 필드에 전달하세요. 그래야 인증 결과를 시스템의 올바른 사용자와 연결할 수 있습니다.

> [accordion] 모든 상태 결과 처리하기
>
> Zapier의 Paths 기능으로 Zap 경로를 만들어 상태마다 다르게 처리하세요. 승인됨, 거부됨, 검토 중, 재제출됨, 중단됨, 만료됨 각각은 맞춤 응답이 필요합니다.

> [accordion] Filters로 불필요한 실행 줄이기
>
> Zapier Filters를 추가해 특정 상태일 때만 후속 작업을 실행하세요. 예를 들어 상태가 `"Approved"`일 때만 환영 이메일을 보낼 수 있습니다.

> [accordion] 실제 운영 전에 테스트하기
>
> 실제 사용자를 처리하기 전에 Zapier의 테스트 기능과 Didit의 **Try Webhook** 버튼(Console → API & Webhooks)을 함께 사용해 Zap 전체를 검증하세요.

***

## 다음 단계

> [card] [빠른 시작 가이드](https://docs.didit.me/ko/getting-started/quick-start.md)
>
> Didit 계정을 설정하고, 워크플로를 만들고, API 키를 발급받으세요.

> [card] [Webhook](https://docs.didit.me/ko/integration/webhooks.md)
>
> 서버 측 연동을 위한 webhook payload와 서명 검증에 대해 알아보세요.


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