# 인증 워크플로우 만들기

Source: https://help.didit.me/ko/workflows/build-a-verification-workflow
Updated: 2026-10-12

워크플로우는 사용자가 완료할 검사와 결과에 따라 벌어질 일을 정합니다. 애플리케이션별로 만들고 반드시 게시하세요. 초안은 적용되지 않습니다.

워크플로우는 **애플리케이션별로** 존재하므로 먼저 올바른 애플리케이션에 있는지 확인하세요. 표준 플로우라면 Simple 모드로, 분기가 필요하면 Advanced 모드로 만든 다음 반드시 **게시**하세요 - 초안은 적용되지 않습니다. 세션은 시작할 때의 버전을 그대로 유지하므로, 변경 사항은 새 세션에만 영향을 줍니다.

[Video: 코드 없이 KYC 인증 워크플로우 만들기 - Didit Academy](https://www.youtube.com/watch?v=7-nJ3JE20i4)

[Video: 전화번호 인증: SMS, WhatsApp, Viber, Telegram을 통한 OTP - Didit Academy](https://www.youtube.com/watch?v=mybuK4SbU6o)

[Video: 이메일 인증: OTP 코드, 일회용 및 유출된 이메일 - Didit Academy](https://www.youtube.com/watch?v=4zUl0o9bS0o)

**워크플로우**는 신분증, 라이브니스, 얼굴 일치, AML 등 사용자가 거치는 검사 항목과, 각 결과에 따라 벌어지는 일을 정의하는 곳입니다. 모든 인증 세션은 워크플로우를 기준으로 실행됩니다.

## 어디에서 만드는가

**신원 확인 → 워크플로 → 새 워크플로**를 여세요. 개인용 KYC 또는 기업용 KYB, 단순 또는 고급 모드와 템플릿을 선택한 뒤 **초안 만들기**를 누르세요. 앱과 Live 또는 Sandbox 환경을 확인하세요. 행 메뉴에서 다른 앱으로 복사할 수 있습니다.

![Didit 콘솔의 Workflows 목록](https://help.didit.me/screenshots/workflows-list-light.webp)

*워크플로우는 현재 있는 애플리케이션 범위로 한정됩니다.*

## 두 가지 구성 방법

[Video: 간단 및 고급 워크플로 빌더 - Didit Academy](https://www.youtube.com/watch?v=X6KBx-S_uvQ)

1. **Simple 모드**

   템플릿 - **KYC**, **적응형 연령 인증**, **생체 재인증**, **주소 인증** - 을 선택하고 원하는 검사(라이브니스, 얼굴 일치, AML, NFC, 전화, 이메일 등)를 켜고 끄세요. 표준 플로우를 가장 빠르게 구동하는 방법입니다.

2. **Advanced 모드**

   시각적 그래프 빌더를 사용해 조건부 분기를 추가하세요. 국가, 문서 유형, 나이, 검사 결과에 따라 사람들을 라우팅하고 서로 다른 경로로 다른 결과를 보낼 수 있습니다. "이 검사들을 순서대로 실행"을 넘어서는 로직이 필요할 때 사용하세요.

3. **게시**

   게시된 버전은 읽기 전용입니다. **워크플로 편집**으로 새 초안을 열고 게시하세요. **버전 기록**에서 이전 버전을 복원할 수 있습니다. 진행 중인 세션은 시작할 때의 버전을 유지합니다.

## 은행 및 위치 확인

애플리케이션에서 활성화되어 있다면 워크플로에 **은행 확인** 또는 **위치 확인** 단계를 추가하세요. 은행 설정에는 연결, 신원 일치, 위험 신호, 결과, 수집 데이터가 포함됩니다. 지원 국가와 금융 데이터는 공급자와 활성화된 기능에 따라 달라집니다. 위치 설정은 정확도, 데이터 유효 시간, 허용 영역, 권한 거부나 위치 사용 불가 또는 규칙 불일치 시의 동작을 제어합니다. 세션의 **은행** 또는 **위치** 영역에서 반환된 증거를 확인하세요. 설정이 보인다고 모든 공급자나 클라이언트가 지원하는 것은 아닙니다.

## 순서는 보기보다 훨씬 중요합니다

거절로 구성된 단계는 **워크플로우를 중단시키므로**, 단계 순서는 사용자가 겪는 경험과 여러분이 지불하는 비용을 동시에 결정합니다. 비용이 큰 묶음 앞에 저렴한 위험 검사를 배치하면, 비싼 부분에 비용을 지불하기 전에 트래픽을 걸러낼 수 있습니다.

전체 그림은 [결정 규칙과 임계값](https://help.didit.me/ko/workflows/decision-rules)에 있습니다 - 이 글 다음으로 읽어야 할 글입니다. 워크플로우의 단계는 그 동작의 절반에 불과하기 때문입니다.

## 추가할 수 있는 모든 모듈

| 카테고리 | 모듈 |
|---|---|
| 문서 | 신분증 인증, NFC, Document AI, 주소 증빙 |
| 생체 | 수동 라이브니스, 능동 라이브니스, 얼굴 일치 1:1, 얼굴 검색, 생체 인증, 연령 추정 |
| 연락처 | 전화번호 인증, 이메일 인증 |
| 데이터 | 데이터베이스 검증, 설문지 |
| 위험 | AML 스크리닝, 지속적인 AML 모니터링, 기기 및 IP 분석 |

KYB 검사에는 기업 등기, 기업 AML, 문서 및 주요 관계자가 포함됩니다.
각 모듈을 활성화할 때마다 완료된 세션의 가격에 더해지며, 월 요금제 크레딧으로 결제됩니다(무료 요금제에서는 전화번호 인증에 사용할 수 없습니다). 여러 개를 켜기 전에 [과금 대상 검사 기준](https://help.didit.me/ko/billing-credits/what-counts-as-billable)을 참고하세요.

## 워크플로우 ID 찾기

각 워크플로우는 고유 ID를 가지며 콘솔의 **Workflows** 페이지에 표시됩니다. API로 세션을 생성한다면 이 ID가 필요합니다. [연동 방법](https://help.didit.me/ko/integration/integration-options)을 참고하세요.

## 검사가 실패했을 때 벌어지는 일 제어하기

기본적으로 검사가 실패하면 세션이 거절되며, 사용자는 마지막에 인증이 성공하지 못했다는 안내를 받습니다 - 어떤 검사가 왜 실패했는지는 세션 상세 정보에서 정확히 확인할 수 있습니다. **Advanced 모드**에서는 각 결과를 직접 라우팅할 수 있습니다. **Declined**로 보내거나, 팀원이 최종 결정을 내리도록 **In Review**로 보낼 수 있습니다.

각 결과가 어떻게 보이는지는 [각 세션 상태가 의미하는 것](https://help.didit.me/ko/verification-sessions/session-statuses)을, 실패한 단계만 다시 시도하게 하려면 [인증 재시도 허용하기](https://help.didit.me/ko/verification-sessions/retry-a-verification)를 참고하세요.

## 워크플로우가 예상치 못하게 동작하게 만드는 것들

실제로 발생하는 순서대로 정리하면 다음과 같습니다.

1. **다른 워크플로우, 또는 다른 애플리케이션의 복사본을 수정했습니다.** 여러분의 세션이 사용하는 워크플로우 ID와 대조해 확인하세요.
2. **초안이 게시된 적이 없습니다.** 저장된 초안은 라이브 버전이 아닙니다.
3. **오래된 세션으로 테스트하고 있습니다.** 세션은 생성 시점의 구성을 그대로 유지합니다. 새 세션을 만드세요.
4. **문서 유형은 허용되어 있지만 하위 유형이 선택되지 않았습니다** - 이는 모든 것이 아니라 아무것도 매칭되지 않는 결과를 낳습니다. [지원 문서 및 국가](https://help.didit.me/ko/documents-coverage/supported-documents-and-countries)를 참고하세요.
5. **이전 단계가 거절되어 플로우가 중단되었습니다.** 그래서 테스트하려는 단계가 실행되지 않았습니다.
6. **복사한 워크플로우가 모든 것을 그대로 가져오지 않았습니다.** 워크플로우를 복제한 후에는 깨끗한 복사본이라고 가정하지 말고, 신경 쓰는 단계와 규칙을 직접 확인하세요.

> **Note:** **Questionnaire** 검사의 국가 코드 목록은 대다수 국가를 포괄합니다. 필요한 코드가 보이지 않는다면, 지원되지 않는다고 단정하지 말고 지원팀에 문의하세요.

## 실제 사용자에게 보이기 전에 테스트하세요

애플리케이션 이름 아래 스위치에서 **Sandbox**를 선택하고 테스트 API 키를 만들어 사용하세요. 검사는 모의 처리되고 요금이 없으며 원하는 결과를 지정할 수 있습니다.

[샌드박스에서 테스트하기](https://help.didit.me/ko/getting-started/sandbox-and-testing)

## 다음 단계

- 각 결과가 무엇을 하는지 설정하기: [결정 규칙과 임계값](https://help.didit.me/ko/workflows/decision-rules)
- 플로우를 브랜드에 맞추기: [브랜딩과 인증 경험 커스터마이징](https://help.didit.me/ko/workflows/customize-branding-and-experience)
- 코드 없이 세션을 시작하거나 API로 자동화하기: [연동 방법](https://help.didit.me/ko/integration/integration-options)
- 전체 기술 참고 자료: [Workflows](https://docs.didit.me/console/workflows)