시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역신분증 인증을 위한 세 가지 방법
신분증 인증(ID Verification)은 여전히 하나의 설정 가능한 기능이며, 요금은 사용된 방법에 따라 결정됩니다. 다만 이제 문서 사진만이 유일한 진행 방법은 아닙니다. 국가별로 사용자가 어떤 방법을 사용할 수 있는지 선택할 수 있습니다.- 문서 촬영, 변경 없음: 이미 설정한 모든 문서 유형, 촬영 규칙, 임계값은 이전과 똑같이 동작합니다. 방법을 지정하지 않은 워크플로는 문서 촬영만 사용합니다.
- 비문서 조회: 사용자가 국가 신분증 번호와 몇 가지 개인 정보를 입력하면, 해당 국가의 공신력 있는 출처와 대조합니다. 문서 사진이나 문서 업로드를 사용하지 않습니다. 대부분의 국가에서 이 출처는 정부 등록부이며, 일부 국가에서는 신용정보기관, 금융 서비스, 공공요금 또는 주거 기록 관련 파일이 출처가 됩니다. 어떤 출처를 사용하는지는 지원 범위 표에서 국가별로 확인할 수 있습니다.
- 운영 환경에서 사용 가능한 5개 디지털 ID 지갑: MitID(덴마크), Finnish Trust Network(핀란드), Smart-ID(에스토니아, 라트비아, 리투아니아, 벨기에), Mobile-ID(에스토니아, 리투아니아), BankID Sweden이 이제 운영 환경에서 사람을 확인합니다. 사용자는 이미 보유한 신원으로 로그인하고, 지갑은 서명된 속성 묶음을 전달합니다.
- 로그인 페이지에 브랜드 적용: 지갑 로그인 페이지에는 화이트 라벨 색상이 적용되며, Smart-ID와 Mobile-ID는 나머지 흐름과 동일한 인증 디자인 안에서 실행됩니다.
- 로드맵 항목도 표시됨: iDIN, Vipps, BankID Norway, itsme, Freja eID, Personalausweis, UAE PASS, gov.br, OneID, EUDI Wallet 등 카탈로그의 다른 모든 지갑은 출시 예정으로 표시되며, 아직 활성화할 수 없습니다. 지원 범위와 요금은 지갑 페이지를 참고하세요.
- 국가별 선택: 신분증 인증 단계의 국가 탭에서 국가별로 각 방법과 각 지갑을 켜거나 끌 수 있으며, 같은 설정은 API를 통해서도 사용할 수 있습니다.
사진을 반환하는 출처는 셀피도 대조합니다
정부 등록부가 본인 초상 사진을 반환하는 경우(남아프리카공화국, 나이지리아, 아르헨티나, 파나마)에는 조회 시 셀피도 함께 받아 그 초상과 비교하며, 이는 조회 요금에 포함됩니다. 국가별 스위치인skip_liveness_and_face_match(기본값: 켜짐)를 사용하면, 일치 후 워크플로가 자체 라이브니스 감지 및 얼굴 대조 단계를 건너뛸 수 있습니다. 이 옵션을 끄면 두 단계를 그대로 실행합니다. 아르헨티나에서는 셀피 없이 조회하는 방식도 선택할 수 있으며, 자세한 내용은 국가별 조회 출처 선택에서 확인하세요.
방법이 성공하지 않을 때의 처리 방식은 직접 결정합니다
조회에는 부분 일치, 불일치, 출처 무응답에 대해 각각 별도의 스위치가 있습니다. 지갑에는 로그인 실패, 취소, 시간 초과에 대한 스위치가 하나 있습니다. 각 스위치는 사용자를 문서 촬영으로 보내거나 세션을 거부합니다.- 재시도 횟수는 직접 설정합니다: 1회에서 5회까지 설정할 수 있으며 기본값은 1회입니다. 출처가 실제로 응답한 조회만 횟수에 포함됩니다.
- 입력 오류에는 비용이 없습니다: 형식 검사에 실패한 번호는 출처에 전달되지 않으므로 횟수에 포함되지 않고 과금되지도 않습니다.
- 저장 전에 콘솔에서 요금을 확인할 수 있습니다: 각 조회 스위치에는 해당 설정의 비용이 명확하게 표시됩니다.
모든 결과에 인증 방법이 표시됩니다
세션, 결정 API,status.updated webhook에는 이제 각 신분증 인증을 수행한 방법과 그에 해당하는 보증 등급이 포함됩니다. 문서는 Documentary, 조회는 Data match, 지갑은 Cryptographic으로 표시됩니다. 이 등급들은 서로 다른 증거를 나타내며, 우열을 나타내지 않습니다.
- 공공 등록부 대조: 비교한 모든 필드에 대해 사용자가 입력한 값, 출처가 보유한 값, 일치 여부를 보여줍니다. 출처가 응답하지 않은 경우에는 출처 오류 세부 정보도 별도로 제공합니다.
- 자격 증명 세부 정보: 지갑, 발급 기관, 지갑이 주장한 보증 수준, 서명 검증 결과를 포함합니다.
- 기존 연동은 영향받지 않습니다: 문서 세션은
document와documentary를 보고하며, 새 필드는 비워 둡니다.
요금
문서 촬영 요금은 변경되지 않았습니다. 건당 $0.15이며, 매월 처음 500건은 무료입니다. 비문서 조회 요금은 국가 및 식별자 표에 USD 기준 응답된 시도 건당으로 게시되어 있으며, 지갑 요금은 지갑 페이지에 있습니다. 하나의 출처가 둘 이상의 서비스를 조회하는 경우 응답한 각 서비스에 대해 과금되며, 재시도로 요금이 추가될 수 있습니다.- 응답한 조회는 과금됩니다: 출처가 응답했다면 일치 여부와 관계없이 조회 요금이 부과됩니다.
- 응답이 없으면 과금되지 않습니다: 출처가 한 번도 응답하지 않은 경우에는 과금되지 않습니다.
- 대체 방법은 별도로 과금됩니다: 문서 촬영으로 대체한 사용자에게는 그 촬영 요금이 별도로 추가됩니다.
국가별 조회 출처 선택
비문서 조회에 사용할 수 있는 출처가 둘 이상인 국가에서는 이제 실행할 출처를 직접 선택할 수 있습니다.- 국가당 출처 하나, 선택은 사용자가: 국가 탭에서 출처가 둘 이상인 국가마다 사용할 출처를 고를 수 있습니다.
- 셀피 없는 아르헨티나 조회: 아르헨티나의 국가 등록부는 같은 요금으로 셀피 없이 조회할 수 있습니다. 초상 사진이 반환되지 않으므로 라이브니스 감지 및 얼굴 대조 단계는 이후에도 계속 실행됩니다.
- 검증된 셀피를 사용하는 브라질 조회: 브라질에서는 셀피가 CPF 소유자의 것임을 확인하는 출처를 사용할 수 있으며, 이후 얼굴 대조 단계에서 그 셀피를 사용합니다.
기업 확인(KYB): 구매할 등록부 데이터의 양을 선택하세요
국가별 등록부 확인은 이제 세 가지 데이터 등급으로 제공되며, 선택하기 전에 가격이 표시됩니다.- Lite, Shareholders 또는 UBOs: KYB 등록부 확인 단계와 단건 확인에서 국가별로 등급을 선택합니다. 콘솔에는 등급마다 해당 국가의 가격이 표시됩니다.
- 새로운 독립 endpoint:
POST /v3/kyb/shareholders/와POST /v3/kyb/ubo/입니다. 응답에는 요청한 등급과 실제로 제공된 등급이 표시됩니다. 소유 구조 데이터가 없는 국가나 기업은 Lite 등급으로 제공되며 Lite 요금이 부과됩니다. 자세한 내용은 Shareholders와 UBOs를 참고하세요. - 신청자는 등록부 응답을 기다리지 않습니다: 신청자는 기업을 확인하고 계속 진행할 수 있으며, 소유 데이터를 아직 가져오는 중이더라도 진행할 수 있습니다. 이 경우 기업 기록에는 소유 데이터가 없다고 표시하는 대신 아직 가져오는 중임을 표시합니다.
- 수동 기업 입력의 요금은 명확합니다: 신청자가 직접 입력한 기업은 정액 $0.75가 과금되며, 국가 탭에 해당 수수료가 표시됩니다.
워크플로 편집기가 게시 전에 실수를 잡아냅니다
편집기는 이제 의도한 흐름과 반대로 조용히 동작하게 될 워크플로를 표시합니다.- 상충하는 분기 표시: 조건이 연결된 결과와 모순되는 분기(예: 결과가 세션 거부됨으로 이어지는 “ID 상태가 거부됨이 아님”)에는 캔버스에 경고 배지가 표시됩니다. 그래프 검증 API도 같은 경고를 반환합니다
- 문서 하위 유형별 분기: 국가 신분증과 거주 허가증처럼 정확한 문서 하위 유형에 따라 세션을 분기합니다
- 세션이 경로를 택한 이유 확인: 세션 타임라인에 각 분기 결정과 세션을 종료한 상태 노드가 표시됩니다.
include=events를 사용하면 결정 API에서workflow_terminal_node_id로도 확인할 수 있습니다 - 위조 임계값 설명: 신분증 인증 단계에서 각 위조 임계값이 하는 일을 설명합니다
얼굴 확인에 대한 더 많은 제어
이제 얼굴 검색을 언제 실행할지 직접 정할 수 있으며, 다른 문서에서 돌아온 얼굴이 세션을 거부하도록 설정할 수도 있습니다.- 워크플로별 얼굴 검색 끄기: Rules 탭의 라이브니스 감지와 연령 추정에 있는 스위치(
face_search_enabled)입니다. 기본값은 켜짐이므로 기존 워크플로는 변경되지 않습니다. 얼굴 검색을 참조하세요 - 같은 얼굴, 다른 문서: 다른 신분증 문서에서 이미 승인된 얼굴이 다시 확인되었을 때의 처리 방식을 선택하고, 세션에서 판정 결과를 확인할 수 있습니다
- 라이브 녹화가 아닌 캡처 거부: 라이브니스 영상 분석이 이제 보고만 하는 것이 아니라 세션을 거부할 수도 있습니다
- 에뮬레이트된 카메라 감지: 에뮬레이트되거나 가상화된 기기에서 수행한 라이브니스 캡처는 조치를 취할 수 있는 위험을 높입니다
- 모든 결과에 문서 라이브니스 점수 제공: 결정 API는 경고가 발생하지 않은 경우에도 초상 교체, 인쇄본, 화면 재생에 대한
document_liveness점수를 포함합니다 - 중요 필드 가려짐 감지: 문서의 번호나 다른 중요 필드가 가려져 있으면 설정 가능한 경고가 표시되며, 독립형 신분증 인증 API에서도 마찬가지입니다
AML 스크리닝
API로 지속적인 모니터링을 관리할 수 있으며, AML 단계에서 문서에 기재된 모든 사람을 스크리닝할 수 있습니다.- API로 지속적인 모니터링 설정:
POST /v3/users/aml-monitoring/와POST /v3/businesses/aml-monitoring/로 한 번에 최대 1,000개의 프로필에 대해 모니터링을 켜거나 끌 수 있습니다. 예상치만 확인하는 드라이 런을 사용할 수 있으며, 대량 요청은 작업으로 실행됩니다. AML 모니터링을 참조하세요 - 모니터링이 실행되었다는 증거: 각 AML 결과에 지속적인 모니터링 증거가 표시됩니다
- 문서에 기재된 모든 사람 스크리닝: AML 단계에서 세금 증명서나 설립 정관처럼 이전 Document AI 단계에서 찾은 사람을 대상으로 할 수 있으며, 각 AML 단계에서 스크리닝할 대상을 직접 선택합니다
- 단일 검사로 지갑 스크리닝: 세션 없이 콘솔에서 요청 시 지갑 스크리닝을 실행할 수 있습니다. 해당 항목의 이름은 이제 지갑 검증 및 스크리닝입니다
- 샌드박스에서 AML 시험:
POST /v3/aml/의sandbox_scenario로 최종 사용자 세션 없이 일치 항목을 시뮬레이션할 수 있습니다
거래 모니터링
기성 iGaming 프리셋으로 시작하고, 현재 값 필터와 더 넓어진 통화 목록으로 규칙을 세분화할 수 있습니다.- iGaming 규칙 프리셋: 보너스 악용이나 칩 덤핑처럼 게이밍 플랫폼을 위한 기성 이벤트 규칙이며, 규칙 라이브러리에서 확인할 수 있습니다
- 현재 거래 금액 기반 거래 빈도 필터: 속도 조건이 현재 거래의 금액을 기준으로 필터링할 수 있습니다
- 더 많은 통화: 통화 선택기에 유통 중인 모든 통화가 표시되며, 거래 PDF에는 각 금액이 해당 통화의 소수점 자릿수에 맞게 표시됩니다
- 샌드박스 거래 표시: 샌드박스 애플리케이션에서 평가된 거래는 환경을 명시하므로, 빈 규칙 실행 결과를 고장난 규칙으로 오해하지 않습니다
Didit Copilot
Copilot은 자신이 변경한 내용을 보여주고, 이를 실행 취소할 수 있게 하며, 콘솔의 더 많은 부분에서 작업할 수 있습니다.- 변경 내용 확인 및 실행 취소: 워크플로를 편집하는 대화 턴 후에는 변경 사항을 나열하는 변경 카드가 표시되며, 실행 취소를 누르면 되돌려집니다
- 슬래시 스킬: 작성 창에 ”/“를 입력하면 현재 페이지의 템플릿 목록이 표시됩니다
- 콘솔의 더 많은 기능 실행: 조직이나 애플리케이션 전환, 애플리케이션 이름 변경, 복제, 이름 변경, 보관, 워크플로 연결, 멤버, 역할, webhook, 목록 대화 상자 열기, 세션에서 사용자 차단 또는 PDF 다운로드를 수행할 수 있습니다
- 대화를 더 세밀하게 제어: 헤더에서 응답 언어를 선택하고, Word 및 일반 텍스트 파일을 첨부하며, 기록에서 모든 대화를 삭제할 수 있습니다
- AI 생성 안내: 응답은 작성 창 아래에 AI가 생성한 것으로 표시됩니다
- 도움말 센터의 Copilot 작업: Copilot이 수행할 수 있는 작업 목록이 모든 언어로 문서화되어 있습니다
브랜딩: SMS 코드와 만료된 문서 이메일에 귀사의 이름 표시
- SMS 코드에 귀사의 브랜드 표시: 사용자 정의의 새 SMS 탭에서 인증 코드 메시지 안에 표시되는 브랜드인 SMS 발신자 이름을 설정할 수 있으며, 실시간 미리보기도 제공됩니다. 비워 두면 애플리케이션의 공개 이름이 사용됩니다
- 만료된 문서 재제출 이메일: 만료된 문서에 대한 재제출 이메일에는 문서가 만료되었다는 내용이 표시되며, 이 이메일의 문구는 텍스트 탭에서 수정할 수 있습니다
지원
- 티켓 첨부 파일 드래그 앤 드롭 — 티켓에 파일을 끌어다 놓거나 클립 아이콘을 사용하세요
- 내 티켓 직접 닫기 — 콘솔 또는 Copilot에서 티켓을 해결됨으로 표시하고, 답장하면 다시 열립니다
세션 API 및 webhook
- API로 사용자 이력 PDF 생성 —
GET /v3/users/{vendor_data}/generate-pdf/는 사용자의 최근 완료된 세션 20건을 담은 브랜딩된 PDF 한 부를 반환합니다. 콘솔의 PDF 다운로드와 같은 보고서입니다. PDF 생성을 참조하세요 - 주소 증명 및 Document AI의 코드 인식 — 문서에서 찾은 QR 코드와 바코드가
detected_codes로 반환되며 세션 검토에 표시됩니다 - 뒷면 사용 불가 경고 — 워크플로에서 양면을 요청했지만 Didit 문서 카탈로그에 인식된 문서의 뒷면이 등록되어 있지 않은 경우, 신분증 인증 결과에 정보성 경고
DOCUMENT_BACK_SIDE_NOT_AVAILABLE이 포함되며, 이때는 앞면만 수집될 수 있습니다 X-Signature-Simple지원 중단 — webhook 검증에는 대신X-Signature-V2를 사용하세요. webhook을 참조하세요- MCP에서 webhook 전송 확인 — Didit MCP에서 세션의 webhook 목록을 확인하고 다시 전송할 수 있습니다. 아래에서 설명합니다
Didit MCP
연결된 AI 에이전트가 이제 세션 결정을 설명하고, webhook 전송 문제를 해결하며, 검증된 워크플로를 구축할 수 있습니다.- 결정 설명 —
didit_session_explain_decision은 세션이 승인됨, 거부됨 또는 검토 중으로 끝난 이유를 추적합니다. 경고, 상태 규칙 또는 검토자 재정의를 보여줍니다 - webhook 확인 및 재전송 —
didit_session_webhooks는 세션의 webhook 전송 목록을 보여주고 첫 번째 전송을 기다릴 수 있으며,didit_session_webhook_resend는 전송 하나를 다시 보냅니다 - 간단한 사양으로 워크플로 구축 —
didit_workflow_build_graph는 말씀하신 국가명을 그대로 사용한 기능 목록을 받아 완전하고 검증된 그래프를 만듭니다 - 국가별 지원 항목 확인 —
didit_workflow_get_kyb_registry_catalog는 법인 등기부 등급과 가격을 반환하고, 신분증 인증 방법 카탈로그 도구는 국가별 조회 및 지갑 정보를 반환합니다
신규 문서
- 경찰 신분증 — 이제 아르헨티나, 브루나이, 콜롬비아, 필리핀에서 허용됩니다
- 캐나다, 몰도바 및 미국의 신규 카드 — 바코드 검증이 포함된 앨버타 운전면허증 및 신분증(2026), 몰도바 운전면허증(2026), NYC 신분증(2019)
- 뒷면 촬영 — 브라질 주 운전면허증, 태국 운전면허증, 캐나다 여권의 B 페이지를 양면으로 촬영할 수 있습니다
- ePassport 신뢰 저장소 갱신 — 최신 국가 서명 인증서가 반영되었습니다
Web SDK 0.3.0에서 0.4.0으로
@didit-protocol/sdk-web이 이번 달 0.3.0에서 0.4.0으로 업그레이드되었습니다. npm install @didit-protocol/sdk-web@latest로 업그레이드하세요. 이미 호출하고 있는 모든 기능은 그대로 작동합니다.
- 브라우저에서 거래 제출 —
submitTransaction()은 범위가 지정된 거래 토큰과 함께 모니터링용 거래를 전송하며, 기기 인텔리전스는 자동으로 수집됩니다. SDK 거래 제출을 참조하세요 - 지갑 소유권 확인 — 거래에 지갑 소유권 확인이 필요하면 SDK가 이를 실행하고 완료 여부를 콜백으로 알립니다
- 모달 언어 4개 추가 — 보스니아어, 카자흐어, 키르기스어, 알바니아어
- 웹에서 네이티브 SDK의 카메라 옵션 사용 —
defaultDocumentCamera,defaultLivenessCamera,showDocumentCameraSwitchButton,showLivenessCameraSwitchButton을 사용하면 키오스크나 기기를 사람에게 향하게 하는 운영자를 위해 후면 카메라로 얼굴 촬영을 열고, 촬영 중 카메라 전환 버튼을 숨길 수 있습니다. 요청한 카메라가 없는 기기는 현재 가진 카메라를 그대로 사용합니다. 인증 URL을 직접 여는 경우에는 일치하는 쿼리 매개변수(liveness_camera=back,liveness_camera_switch=false등)를 직접 설정하세요
네이티브 SDK 4.9.0
iOS SDK, Android SDK, React Native SDK, Flutter SDK이 모두 4.9.0에 도달했으며, React Native와 Flutter에는 같은 네이티브 릴리스가 포함됩니다. 연동 API 변경은 필요하지 않습니다.- 사용자가 언어 선택 —
showLanguageSelector를 설정하면 시작 화면에 웹 흐름과 같은 간결한 검색 가능 언어 선택기가 표시됩니다. 기본값은 숨김입니다(4.9.0) - 앱의 신분증 인증 방법 — 국가 신분증 번호 조회, 디지털 신원 지갑 로그인 또는 둘 다로 설정된 국가에서는 한 진입 화면에서 문서 촬영과 함께 이를 제공합니다. 웹에서 실행되는 것과 같은 흐름입니다. 조회 시 해당 국가가 요구하는 필드를 수집하고, 전송 전에 기기에서 이를 검증하며, 구성이 허용하는 경우 문서 촬영으로 대체합니다(4.8.0)
- 진입 화면의 문서 이미지 — iOS 방법 선택 화면의 각 문서 유형에 고유한 일러스트가 표시됩니다(4.8.0)
- 더 명확한 설문지 오류 — 설문지 제출이 거부되면 사용자는 서버가 알려준 사유를 볼 수 있습니다(4.8.0)
Didit Academy: 신규 강의 28개
콘솔 실제 화면으로 녹화한 짧은 콘솔 안내 영상 28개가 새로 추가되었으며, 각 영상은 2~7분 길이이고 글로 된 요약이 함께 제공됩니다. didit.me/academy에서 확인하세요.- Didit Copilot — 5분
- 정부 데이터베이스 검사 — 5분
- 조건부 워크플로 — 4분
- API 키 및 webhook — 3분
- 적합한 SDK 선택 — 3분
- AML 스크리닝: 제재, PEP 및 부정적 언론 보도 — 7분
- 문서 및 국가별 규칙 — 6분
- NFC 여권 인증 — 5분
- 재사용 가능한 KYC — 2분
- 전화번호 인증 — 6분
- 국가별 문서 지원 범위 — 4분
- 수동형 라이브니스 — 2분
- 주소 증명 — 5분
- 커스텀 설문지 — 6분
- 이메일 인증 — 6분
- 사용자 데이터 검토 — 4분
- 연령 추정 — 4분
- 라이브니스 감지, 얼굴 대조 및 얼굴 검색: 5분
- 기기 및 IP 사기 신호: 6분
- 각 검사에 드는 비용: 4분
- 세션 감사 로그: 4분
- 팀으로 케이스 검토하기: 3분
- Didit 결제가 작동하는 방식: 4분
- 인증 링크 만들기: 5분
- 차단 목록 및 허용 목록: 5분
- 데이터 보존: 2분
- 지속적인 AML 모니터링: 2분
- 지원을 받는 방법: 3분
개선 사항
- 모델 학습 옵트아웃: 설정의 조직 설정에서 인증 데이터를 Didit 모델 개선에 사용할 수 있는지 제어합니다
- 더 명확해진 잔액 부족 알림: 알림에 조직 이름과 설정한 임계값이 표시됩니다
- 청구서에 연락처 정보 포함: 조직의 연락처 정보가 모든 청구서에 표시됩니다
- 샌드박스에서 실제 능동형 라이브니스 캡처 실행: 사용자에게 제공되는 것과 동일한 능동형 라이브니스 흐름을 테스트하실 수 있습니다
- 사용자 프로필의 수동 업로드: 직접 업로드한 문서와 얼굴이 사용자 프로필에 표시됩니다
- 커스텀 도메인은 라이브 애플리케이션용: 샌드박스 애플리케이션의 도메인 탭에서 커스텀 도메인은 라이브 애플리케이션에만 적용된다고 안내합니다