시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역methods 키에 기록됩니다. 콘솔과 Management API는 같은 객체를 보는 두 가지 방식입니다.
국가 및 허용된 신원 확인 방법
워크플로를 열고 신분증 인증 노드를 선택한 다음 국가를 선택합니다. 각 국가 행에는 해당 국가가 허용하는 방법이 표시됩니다. 국가를 선택하면 편집기가 열립니다.
국가에 문서 촬영이 없으면 다음과 같은 경우 문서 촬영으로 전환… 옵션은 항상 꺼져 있습니다. 대체할 대상이 없기 때문입니다. 이 옵션을 사용하려면 해당 국가의 문서 촬영을 켜야 합니다.
사용 가능한 방법을 모두 끈 국가는 저장할 때 거부되며, “사용 설정된 방법이 없어 아무도 여기서 인증할 수 없습니다”라는 메시지가 표시됩니다. 이 설정으로는 누구도 인증할 수 없기 때문입니다.
대체 수단으로만 문서 촬영 제공
국가를 열고 여기서 사용자가 인증하는 방식을 선택합니다:
지갑 우선을 선택하면
document.fallback_only와, 이에 맞는 대체 전환 옵션(wallet.on_failure, 그리고 조회가 활성화된 경우 조회 전환 옵션)이 한 번에 기록됩니다. 지갑만을 선택하면 document.enabled가 false로, wallet.on_failure가 retry로 설정됩니다. 완료되지 않은 로그인은 다시 시도할 수 있으며, 세션은 사용자가 완료하거나 만료될 때까지 열려 있습니다.
이 동작은 모든 국가의 모든 지갑에서 동일합니다. 두 선택 모두 프로덕션 상태인 지갑을 선택하거나 조회를 활성화하기 전까지 사용할 수 없습니다.
출시 예정으로 표시된 지갑은 우선 순위를 가질 수 없습니다. 국가의 모든 지갑이 출시 예정이면 문서 촬영이 계속 우선입니다.
국가 목록에는 이 설정을 사용하는 각 국가 아래에 지갑, 이후 문서 촬영이 표시되며, 미리보기에는 지갑만 표시됩니다.
같은 설정은 지갑 및 비문서 조회 화면의 추가 설정 아래에 대체 수단으로만 문서 촬영 제공 전환 옵션으로도 있습니다. 두 컨트롤은 같은 설정을 편집합니다.
가용성은 서버가 결정합니다
이 탭은 API가 검증하는 것과 같은 기능 카탈로그를 읽으므로, 플랫폼이 실제로 지원하는 항목만 제시할 수 있습니다:- 카탈로그가 해당 국가에서 제공하지 않는 방법은 선택 항목으로 표시되지 않습니다.
- 카탈로그에서 출시 예정으로 표시한 소스 또는 지갑은 로드맵을 볼 수 있도록 나열되지만, 켤 수는 없습니다.
- 지갑 로그인은 환경별로 켜집니다. 꺼져 있는 동안에는 카탈로그 설정과 관계없이 모든 지갑에 출시 예정이 표시됩니다.
Smart-ID 또는 Mobile-ID 활성화
Smart-ID와 Mobile-ID는 지원되는 국가에서 사용할 수 있습니다. 국가별 지원 범위는 지갑 카탈로그를 참조하십시오. 워크플로를 변경하기 전에 현재 환경에 표시된 사용 가능 여부를 확인하십시오.- 워크플로를 열고, 워크플로를 선택한 다음 워크플로의 신분증 인증 노드를 선택하고 국가를 엽니다.
- 국가 편집기를 열고 허용된 지갑을 찾습니다.
- Smart-ID 또는 Mobile-ID는 사용 가능한 경우에만 선택하고, 대체 수단을 원하면 문서 촬영을 켜 둡니다.
- 지갑 로그인이 실패했을 때의 동작을 선택한 다음 워크플로를 저장하고 게시합니다.
- 해당 워크플로로 새 인증 세션을 시작하고, 완료된 세션의 자격 증명 카드를 확인합니다.
예상 요청과 응답
조회 소스 또는 지갑의 자세히 보기를 선택하면 예상되는 요청과 응답이 열립니다. 최종 사용자에게 무엇을 요청하는지 쉬운 말로 보여주고, 소스가 무엇을 반환하는지도 보여줍니다. 각 조회 소스는 정확한 이름으로 표시됩니다. 대부분의 국가에서는 정부 등록부이고, 일부 국가에서는 신용 정보 기관 또는 주민 기록 파일입니다. 출처와 동의 체계를 결정하는 것이 바로 이 이름이기 때문입니다. 최종 사용자는 응답 필드, 소스 이름, 가격을 절대 보지 못합니다.일괄 전환
전역 설정은 방법을 지원하는 모든 국가에서 해당 방법을 켜므로, 36개 국가를 하나씩 설정할 필요가 없습니다. 국가별 편집기 설정이 여전히 우선합니다. 방법을 전역으로 켠 뒤, 원하지 않는 특정 국가에서만 끄십시오.탭의 가격
문서 촬영은 건당 $0.15의 가격을 표시합니다. 비문서 조회는 국가별 가격을 표시하며, 가격 카탈로그에 아직 게시되지 않은 가격은 견적이 아니라 탭에서 플레이스홀더로 표시됩니다. 지갑 행에는 지갑, 적용 범위, 사용 가능 여부가 표시됩니다. 탭에는 각 조회 폴백 스위치의 청구 결과도 명시되어 있으므로, 설정을 저장하기 전에 구성의 비용을 확인할 수 있습니다.- 응답한 등록부는 조회 건으로 청구됩니다(일치와 불일치 모두 해당). 이후 사용자가 폴백하면 문서 촬영이 그 위에 추가로 청구됩니다.
- 응답하지 않은 조회는 청구되지 않으므로, 장애가 발생해도 비용은 문서 가격만큼만 발생합니다.
- 폴백을 끄면 해당 사용자는 거부되며, 이후 추가 청구는 없습니다.
세션 읽기
세션 상세의 신분증 인증 블록에는 해당 인증을 생성한 방식을 나타내는 칩과, 보증 수준을 나타내는 두 번째 칩이 표시됩니다. 보증 수준 칩은 문서 / 문서 기반, 비문서 조회 / 데이터 일치, 또는 지갑 이름과 암호화 기반 중 하나입니다.비문서 방식에서 문서 촬영으로 폴백한 세션은 문서 / 문서 기반 세션으로 표시됩니다. 해당 신분증 인증의
fallback_from에는 먼저 시도한 방식과 그 종료 사유(예: wallet 및 cancelled)가 action: "fallback_to_document"와 함께 기록됩니다.- 문서: 기존과 동일하게. 앞면, 뒷면, 셀피 이미지, 품질 점수, 추출된 필드와 경고가 포함됩니다.
- 비문서 조회: 비교된 모든 필드를 나열하는 등록부 대조 항목이 표시됩니다. 각 필드에는 사용자가 입력한 값, 출처가 보유한 값, 그리고 일치, 부분 일치 또는 불일치 결과가 포함됩니다. 출처 이름, 확인 시각, 시도 횟수도 함께 표시됩니다. 응답하지 않은 출처는 필드 판정 대신 오류가 있는 별도 행으로 표시됩니다. 출처가 얼굴 사진을 반환한 경우에는 해당 사진과 사용자의 셀피가 얼굴 점수와 함께 나란히 표시됩니다.
- 지갑: 자격 증명 카드가 표시됩니다. 지갑, 발급 기관, 자격 증명 유형, 지갑이 주장한 보증 수준, 인증된 시각, 서명 검증 여부, 지갑이 공유한 속성이 포함됩니다.
관련 문서
- 신분증 인증 방식: 세 가지 방식, 폴백, 청구
- 비문서 조회: 국가별 필드와 동의
- 디지털 ID 지갑: 지갑별 속성과 보증 수준
- 워크플로: 워크플로 구성 및 게시
- 워크플로 기능 구성: API를 통한 동일한 설정