얼굴 대조 1:1 API: 셀피 및 신분증 사진 비교

Didit 얼굴 대조는 두 얼굴을 1:1로 비교하며, 일반적으로 라이브니스 감지에서 촬영한 셀피와 사용자의 신분증에 있는 인물 사진을 비교하여 0에서 100 사이의 유사도 점수를 반환합니다. 설정한 임계값에 따라 검증 통과 여부가 결정되며, 독립형 POST /v3/face-match/ API는 기본적으로 30점 이하의 점수를 거부합니다. 인증 결과 확인에 관한 Academy 강의 중 6:16 챕터에서 실제 세션 내의 얼굴 대조 검사를 다룹니다.

​

재시도 및 실행 가능한 피드백

Didit 세션에서 해결 가능한 촬영 문제(셀피가 너무 어둡거나 흐림, 중심에서 벗어남, 또는 유사도가 경계선에 걸침)로 얼굴 대조에 실패한 경우 즉시 거부되지 않습니다. 라이브니스 감지에 사용되는 것과 동일한 모델로, 사용자는 설정 가능한 시도 횟수 내에서 안내와 함께 재시도하도록 요청받습니다.

• 시도 횟수 한도 — face_match_max_attempts는 세션당 얼굴 대조 제출의 총 횟수를 제어합니다. 기본값은 3(최초 시도 1회 + 재시도 2회)이며, 워크플로 노드별로 설정할 수 있습니다(범위: 1–3).
• 재시도 피드백 — 시도 횟수가 남아 있는 동안 재시도 가능한 실패가 발생하면 사용자는 해당 단계에 머물며 feedback_codes가 반환됩니다(웹 및 모바일 SDK는 이를 코칭 메시지로 자동 표시합니다):
  {
    "detail": "Make sure your face matches your document photo, improve lighting and try again.",
    "error": "LOW_FACE_MATCH_SIMILARITY",
    "feedback_codes": ["LOW_FACE_MATCH_SIMILARITY"],
    "attempts_used": 1,
    "max_attempts": 3
  }
  
• 한도 소진 — 시도 횟수가 모두 소진되면 산출된 상태(Declined 또는 In Review)가 적용됩니다.

​

작동 방식

---

​

문서 요구사항

최적의 인증 성공률을 위해 문서는 다음 기준을 충족해야 합니다:

​

일반 요구사항

• 정부에서 발급하고 설정된 유효 기간 내에 있는 유효한 문서
• 물리적으로 온전한 상태(세부 정보를 가리는 손상, 긁힘, 얼룩이 없음)
• 모든 중요 정보(성명, 생년월일, MRZ 등)가 선명하게 판독 가능해야 함
• 제출된 모든 문서 간의 데이터 일관성 유지

​

이미지 요구사항

• 실시간 원본 사진(스크린샷, 스캔본 또는 디지털 사본 불가)
• 지원 형식: JPG, JPEG, PNG, PDF
• 최대 파일 크기: 5MB
• 문서의 모든 모서리가 보이는 풀컬러 이미지
• 빛 반사, 그림자, 디지털 편집 또는 조작이 없어야 함
• 실물 문서 필요(디지털 신분증은 공식적으로 인정되는 특정 지역에서만 지원됨)

​

국가 및 문서 유형별 추가 설정

콘솔에서 국가 및 문서 유형별로 세부 규칙을 직접 구성할 수 있습니다. 이러한 설정을 통해 컴플라이언스 요구사항에 맞게 수락 기준과 텍스트 변환 환경설정을 맞춤 설정할 수 있습니다.

• 만료 모드: 만료일이 지난 문서를 처리하는 방식을 선택합니다.
  • 만료된 문서 거부: 문서의 만료일이 오늘보다 이전인 경우, 만료된 것으로 표시하고 거부합니다.
  • 만료된 문서 허용: 만료일이 지난 문서에 플래그를 지정하거나 차단하지 않습니다.
• 선호 문자 형식: 추출된 성명 및 필드를 정규화할 방식을 선택합니다.
  • 라틴 문자(A–Z) 선호: 예: “Mohammed”
  • 원래 문자 체계(비라틴 문자) 선호: 예: “محمد”
• 지역 지원 및 하위 유형: 지역별로 문서를 활성화하고, 문서 유형에 여러 변형이 포함된 경우 허용 가능한 하위 유형을 지정합니다.
  • 예: 미국 운전면허증의 경우 허용할 정확한 하위 유형을 선택합니다(예: Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License 등).
  • “허용되는 하위 유형” 제어 기능을 사용하여 여러 변형을 빠르게 포함하거나 제외할 수 있습니다(예: “128개 선택됨”).

팁: 이러한 설정은 국가 및 문서 유형별로 적용되므로, 특정 시장에서는 엄격하게 적용하고 다른 시장에서는 보다 유연하게 적용할 수 있습니다.