서류 촬영은 기존과 동일합니다.
documents_allowed를 통해 이미 구성한 모든 항목(허용되는 유형, 하위 유형, 촬영 규칙, 임계값, 경고)은 이전과 똑같이 작동하며, 방법에 대해 아무것도 지정하지 않은 워크플로는 서류 촬영 전용으로 유지됩니다.
각 방법의 작동 방식
서류 촬영
이 섹션의 나머지 부분에서 설명하는 내용은 다음과 같습니다. 사용자가 문서를 촬영하면 Didit이 이를 판독하고 진위 여부를 확인한 후 추출된 필드를 반환합니다. Didit이 지원하는 모든 국가에서 검사당 $0.15에 이용할 수 있습니다. 신분증 인증 개요부터 살펴보세요.비문서 조회
사용자가 국가 신분증 번호와 몇 가지 개인 정보를 입력하면, Didit이 해당 국가의 공인 출처와 대조하여 확인합니다. 문서 사진 촬영은 필요하지 않습니다. 해당 출처는 대부분의 국가에서 정부 등록부이지만, 모든 국가가 그런 것은 아닙니다. 캐나다, 프랑스, 인도네시아, 네덜란드, 노르웨이, 싱가포르, 영국, 미국의 경우 신용 정보 기관의 파일, 금융 서비스 기록, 공과금 납부 내역 또는 거주 기록 파일이 대신 사용됩니다. 출처와 적용되는 동의 체계가 이에 따라 달라지므로 정확한 출처는 일반화되지 않고 아래 표 및 비문서 조회에 국가별로 명시되어 있습니다. 출처에서 증명사진을 반환하는 경우(현재 남아프리카 공화국, 나이지리아, 아르헨티나, 파나마의 4개국이며, 모두 정부 등록부입니다) 사용자에게 셀피도 요청합니다. 해당 셀피에 대해 수동 라이브니스 감지가 실행되고 등록부 사진과 얼굴 대조가 수행되며, 이 모든 과정은 조회 내에서 조회 가격에 포함되어 진행됩니다. 출처에서 데이터만 반환하는 경우에는 얼굴을 대조할 대상이 없으므로 셀피를 촬영하지 않습니다. 필요한 경우 라이브니스 감지 및 얼굴 대조를 별도의 워크플로 단계로 실행하세요. 국가별 전체 요청 필드, 형식 규칙 및 동의 체계는 비문서 조회에서 확인할 수 있습니다.지갑
사용자는 국가 eID나 은행 신원 등 이미 보유하고 있는 디지털 신원으로 로그인합니다. 지갑이 사용자를 인증한 다음, 서명된 신원 속성을 Didit과 공유합니다. 지갑에 따라 사용자가 개인 식별 코드나 전화번호를 입력할 수 있으며, 지갑 확인에는 문서 사진이 필요하지 않습니다. 로그인 환경은 앱 전환, QR 코드 또는 사용자의 휴대폰에서 확인하는 비교 코드 등 지갑에 따라 다릅니다. Smart-ID 및 Mobile-ID는 비교 코드를 사용합니다. 지갑별 속성, 프로덕션 가용성 및 실패 처리 방식은 디지털 신원 지갑에서 확인할 수 있습니다.보증 등급
모든 신분증 인증 결과에는 이를 생성한 방법에서 파생된 보증 등급이 부여됩니다. 이 등급은 순위가 아니라 실제로 무엇이 입증되었는지를 있는 그대로 설명합니다.보증 등급은 관리자 대상 라벨입니다. 세션 payload, 콘솔 및 내보내기 데이터에 표시됩니다. 최종 사용자에게는 등급, 가격 또는 조회된 출처의 이름이 표시되지 않습니다.
국가별 방법 구성
방법은 신분증 인증(OCR) 기능 구성의 methods 키 아래에 ISO 3166-1 alpha-3 국가 코드를 키로 하여 설정됩니다. 키를 생략하거나, 국가를 생략하거나, 국가 내에서 특정 방법을 생략하면 해당 국가는 서류 촬영 전용으로 적용됩니다.
available로 표시되어 있습니다.
이 예제에서는 사용자의 환경에서 지갑이 활성화되어 있는지에 의존하지 않도록 지갑을 비활성화된 상태로 둡니다.
출시 예정으로 표시된 지갑을 활성화하는 워크플로는 거부되며, 해당 저장 요청의 다른 구성도 함께 거부됩니다.
카탈로그에서 특정 국가에 대해 지갑을 available로 표시하면 해당 국가의 지갑 블록은 다음과 같습니다.
- 가용성은 서버에서 결정됩니다. 기능 카탈로그에서 해당 국가에 대해
available로 표시하지 않은 방법이나 지갑은 거부됩니다. 콘솔의 국가 탭이나didit_workflow_get_id_verification_methods_catalogMCP 도구를 통해 카탈로그를 먼저 확인하세요. - 지갑은 허용 목록이며 순위가 아닙니다.
providers는 국가에서 제공할 수 있는 지갑을 정의합니다. 전송하는 순서는 의미가 없으며 정규화되어 제거됩니다. 선택은 최종 사용자가 수행합니다.
대체 수단(fallback): 비문서 방식이 완료되지 않을 때 일어나는 동작
네 가지 스위치에 따라 다음 동작이 결정됩니다. 각 스위치는fallback_to_document(사용자를 신분증 촬영 단계로 이동) 또는 decline(신분증 인증을 거부하며 세션 종료) 중 하나로 설정할 수 있습니다. wallet.on_failure는 아래에 설명된 retry도 지원합니다. 네 스위치 모두 기본값은 fallback_to_document입니다.
wallet.on_failure는 지갑만 허용하는 국가(신분증 촬영 비활성화)를 위한 세 번째 값인 retry도 지원합니다.
retry는 지갑 전용입니다. “일치 항목 없음”으로 응답한 등록부는 재시도할 내용이 없으므로 조회 스위치에는 fallback_to_document 또는 decline만 설정할 수 있습니다.
신분증 촬영으로 이어지는 실패 처리가 필요한 document.fallback_only와 함께 사용하는 것은 허용되지 않습니다.
지갑으로 로그인하여 반환된 데이터가 워크플로의 검사(연령, 이름 일치 등)를 통과하지 못한 경우는 인증된 로그인에 해당합니다. 워크플로의 규칙에 따라 결정되며, wallet.on_failure는 적용되지 않습니다.
token 자체는 진짜이지만 요구 사항을 충족하지 못하는 로그인(잘못된 보증 수준, 유효하지 않은 서명, 필수 클레임 누락)은 실패로 처리되어 wallet.on_failure를 따릅니다.
id_lookup.max_attempts(1~5, 기본값 1)는 스위치가 작동하기 전까지 사용자에게 허용되는 응답된 조회 횟수입니다. 클라이언트 측 형식 검사를 통과하지 못한 번호는 등록부에 전송되지 않으므로 시도 횟수를 소모하지 않으며, 사용자에게는 수정을 요청하기만 합니다.
지갑이나 조회가 신분증 촬영으로 대체되려면 해당 국가에서 신분증 촬영이 활성화되어 있고 최소 하나의 신분증 유형이 허용되어 있어야 합니다.
신분증 촬영이 비활성화되어 있거나 해당 국가에 허용된 신분증 유형이 없으면, 스위치가 fallback_to_document로 설정되어 있더라도 로그인 실패나 불일치 조회 시 세션이 거부됩니다. 단, wallet.on_failure: retry는 예외로 절대 거부되지 않고 사용자가 지갑 단계에 머무릅니다.
대체할 수 있는 수단이 없기 때문입니다.
결과를 생성한 방식: fallback_from
verification_method에는 검증된 결과를 생성한 방식인 wallet, id_lookup, document 중 하나가 항상 기록됩니다.
fallback_from은 두 가지 결과 모두에서 비문서 방식이 신분증 단계를 완료하지 못한 이유를 설명합니다.
- 대체 수단 실행. 사용자가 신분증 촬영 단계로 이동합니다. 이후 진행되는 신분증 인증에는
verification_method: "document"가 적용되며,fallback_from에는 실패한 방식이 기록됩니다(예:{ "method": "wallet", "reason": "cancelled", "action": "fallback_to_document" }). 지갑으로 인증된 세션에는verification_method: "wallet"및fallback_from: null이 적용됩니다. - 거부. 스위치가
decline으로 설정되어 있거나 대체할 신분증 수단이 없는 경우입니다. 거부된 신분증 인증에는"action": "decline"이 포함된fallback_from이 기록됩니다.
method는 wallet 또는 id_lookup이며, reason은 해당 방식을 종료시킨 결과(cancelled, timeout, no_match, provider_error 등)입니다.
동일한 필드가 세션 결정 및 status.updated webhook으로 전달됩니다.
등록부의 무응답(시간 초과 또는 서비스 장애)은 예외로, 이 자체로 사용자를 거부하지는 않습니다.
조회 비용은 청구되지 않고 시도 횟수도 차감되지 않으며, 사용자에게 다시 시도하라는 안내가 표시됩니다.
해당 단계에서 응답 없는 조회가 3회 발생한 후에는 id_lookup.on_provider_error가 적용됩니다. decline은 거부 처리하고, fallback_to_document는 사용자를 신분증 촬영으로 이동시킵니다.
해당 스위치가 fallback_to_document이지만 국가에 대체할 신분증 수단이 없는 경우 조회가 열린 상태로 유지되어 사용자가 계속 시도할 수 있으며 세션은 거부되지 않습니다.
대체 수단으로만 신분증 촬영 제공
기본적으로 지갑 또는 신분증 조회와 함께 신분증 촬영을 지원하는 국가는 첫 화면에 두 방식을 나란히 표시합니다. 신분증 촬영을 처음부터 전면에 제공하지 않고 해당 국가에 계속 활성화해 두려면document.fallback_only를 true로 설정하십시오.
사용자는 해당 국가의 지갑 또는 신분증 조회부터 시작합니다.
단일 지갑인 경우 사용자는 해당 지갑으로 바로 이동합니다.
지갑 로그인이 실패하거나 취소되거나 시간 초과된 사용자, 또는 조회가 일치하지 않는 사용자만 신분증 촬영 단계로 이동합니다.
어떤 결과에서 신분증 촬영으로 이어질지는 위의 스위치에 의해 결정되므로, 스위치 중 적어도 하나는 fallback_to_document로 설정되어 있어야 합니다.
fallback_only는 선택 사항이며 기본값은 false입니다.
document.enabled가 true가 아니거나 해당 국가의 지갑이나 신분증 조회 중 신분증 촬영으로 대체되도록 설정된 항목이 하나도 없으면 거부됩니다.
대체 수단으로 제공할 신분증 유형을 documents_allowed에서 활성화하십시오(예: 핀란드의 경우 여권 및 신분증).
각 방식의 비용
위 가격은 정가 기준이며, 두 방식 모두 귀하의 요금제 할인이 적용됩니다. 조회는 실행되는 서비스에 대해 공개 데이터베이스 검증 소매 요금을 사용하며, 한 번의 시도에 여러 서비스가 관여할 수 있습니다. 나이지리아는 NIN 또는 BVN 중 하나를 선택합니다. 국가별 표에는 설정된 전체 시도 가격이 표시되며, 응답을 받은 각 재시도는 별도로 청구됩니다.
결제 규칙
- 응답한 등록부에 대해 조회 비용이 청구됩니다. 일치, 부분 일치, 불일치 모두 청구 대상입니다. 쿼리가 실행되었고 응답 자체가 상품이기 때문입니다.
- 응답하지 않은 등록부는 청구되지 않습니다. 공급자 오류에는 비용이 발생하지 않습니다.
- 클라이언트 측 형식 검사를 통과하지 못한 번호는 청구되지 않으며, 등록부에 도달하지 않았으므로
max_attempts횟수에도 포함되지 않습니다. - 사용자가 대체 방식으로 전환하는 경우 문서 촬영 비용이 추가로 청구됩니다. 응답을 받은 후 문서로 전환된 조회는 두 번의 검사가 실행되었으므로 두 건의 비용이 발생합니다.
커버리지
문서 캡처는 Didit이 지원하는 모든 국가에서 이용할 수 있으며 아래 표에는 중복 기재하지 않았습니다: 확인 건당 $0.15. 이 표에는 문서 외 방식이 존재하는 국가만 나열되어 있습니다. 표에 기재되지 않은 국가이거나 계획 없음으로 표시된 항목은 문서 캡처만 지원됩니다.지원 범위는 백엔드가 제공하는 기능 카탈로그에서 생성되므로, 이 표는 콘솔과 API가 검증에 사용하는 소스와 동일합니다. 출시 예정은 해당 항목이 콘솔에 표시되지만 아직 활성화할 수 없음을 의미하며, 라이브 기능이 아니며 확정된 출시 일정도 제공되지 않습니다.
세션에 기록되는 내용
모든 신분증 인증 결과에는 이를 생성한 인증 방식, 보증 등급, 그리고 비문서 기반 방식이 실행된 경우 방식별 증거 블록이 포함됩니다. 문서 기반 세션은 이전과 동일한 형식으로 반환되며, 새로운 키에는null이 전달됩니다.
세 가지 방식 모두에 대한 필드별 유형과 예시는 신분증 인증 데이터 모델에서 확인할 수 있으며, 동일한 키가
status.updated webhook으로 전달됩니다.
관련 문서
- 비문서 조회 — 국가별 필드, 형식, 동의 및 보존
- 디지털 신분증 지갑 — 지갑별 속성, 보증 및 실패 동작
- 콘솔에서의 신분증 인증 방식 — 국가 탭 및 세션 방식 칩
- 워크플로 기능 설정 —
methods키 참조