시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역partialMatchAction 및 noMatchAction을 제어하는 결정 로직에 대해 설명합니다.
1×1 매칭
이 방법은 데이터베이스와 입력 데이터 포인트 1개(일반적으로 국가 신분증 또는 유사한 식별자)를 대조하는 방식입니다. 직접 일치하는 항목이 발견되면 신원을 확인합니다. 그러나 초기 시도가 실패하면 신뢰할 수 있는 대체 데이터 소스를 워터폴 순서로 시도할 수 있습니다. 즉, 일치 항목을 찾거나 모든 옵션을 소진할 때까지 연속적인 서비스 제공업체를 통해 검증을 계속합니다. 중요한 점은 부분 일치로 프로세스가 중단되지 않는다는 것입니다. 완전하고 확정적인 일치를 찾거나 일치하는 항목이 없다고 판단될 때만 프로세스를 중단합니다. 1x1 매칭 로직에서는 신원에 대해 완전 일치를 받으려면 사용자의 개인 데이터를 하나의 소스와 대조해야 합니다.*
*해당 국가 소스는 신원에 대한 완전 일치가 이루어질 때까지 스크리닝됩니다. 완전 일치가 발견되지 않으면 시스템은 사용자의 신원에 대한 부분 일치를 찾기 위해 해당 소스를 반복적으로 스크리닝합니다.
위의 1×1 표와 아래의 2×2 표는 일반적인 모델을 설명하며, 모든 서비스에 적용되는 보장은 아닙니다. 결정적인 필드는 서비스 및 전송하는 선택적 입력 항목에 따라 다릅니다. 레지스트리는 보유한 필드와 사용자가 제공한 필드만 비교할 수 있으며, 서비스 결과는 실제로 비교하는 필드에 따라 결정됩니다. 모든 서비스가 식별 번호를 비교하는 것은 아니며, 일부 서비스는 식별 번호를 전송할 때만 비교합니다. 예를 들어 스페인 - DNI/NIE 검증(
esp_dni)은 이름, 생년월일, 주소가 필요하며 national_id를 선택적 입력으로 받습니다. 이름, 생년월일, 주소는 항상 비교하며, national_id를 전송하는 경우 식별 번호도 비교합니다.필수 필드가 반드시 결정적인 필드는 아니며, 선택적 필드가 결정적인 필드가 될 수도 있습니다. 요청이 수락되려면 필수 필드를 전송해야 하며, source_data에 나열된 필드는 레지스트리가 반환한 데이터입니다. 둘 다 어떤 필드가 결과를 결정했는지는 알려주지 않습니다. 각 서비스 페이지의 응답 예시는 가능한 응답 중 하나를 보여주므로, 해당 validation 객체의 키가 해당 서비스가 비교하는 필드의 전체 목록은 아닙니다. 지원 국가 및 서비스 아래에 나열된 각 서비스의 API 참조 페이지에는 입력 아래에 필수 및 선택 입력 항목이 나열되어 있습니다.2×2 매칭
이 방식은 두 개의 입력 데이터 포인트(예: 성명 + 생년월일, 또는 국가 신분증 번호 + 전화번호)를 데이터베이스의 해당하는 두 필드와 대조해야 합니다. 1×1 방식과 마찬가지로 여러 데이터 소스를 순차적으로 쿼리하는 워터폴 방식을 따릅니다. 두 데이터 필드 모두에서 완전한 일치를 찾을 때까지 각 단계를 계속 진행합니다. 부분 일치나 단일 필드 일치만으로는 충분하지 않으며, 두 필드 모두에서 확실한 일치가 이루어지거나 모든 소스를 확인할 때까지 검증 프로세스가 계속됩니다. 2×2 매칭 로직은 신원에 대해 완전 일치 결과를 받기 위해 사용자의 개인 데이터를 두 개의 소스와 대조해야 합니다.*
*해당 국가의 소스는 신원에 대한 완전 일치가 확인될 때까지 스크리닝됩니다. 완전 일치를 찾지 못한 경우, 시스템은 사용자 신원에 대한 부분 일치를 확인하기 위해 해당 소스를 반복해서 스크리닝합니다.
데이터 범주 및 속성 일치
다음은 성명, 생년월일 및 ID 데이터 범주에서 완전 일치로 처리되는 시나리오입니다. 부분 일치는 성명 범주에서만 발생할 수 있습니다.성명 범주 일치
성명 범주에서 다음 데이터 속성 일치 시나리오 중 하나라도 충족되면 완전 일치로 간주됩니다.- 성명 결합 완전 일치 (이름과 성을 결합한 값의 유사도가 85%의 유사도 임계값을 충족하는 경우)
- 이름 완전 일치 + 성 완전 일치
- 이름 완전 일치 + 모계 성 완전 일치
- 이름 완전 일치 + 부계 성 완전 일치
- 이름 완전 일치
- 성 완전 일치
- 부계 성 완전 일치
- 모계 성 완전 일치
- 모계 성 완전 일치 + 부계 성 완전 일치
생년월일 범주 일치
생년월일 범주에서는 다음 데이터 속성 일치 시나리오가 충족될 때만 완전 일치로 간주됩니다.- 출생 연도 완전 일치 + 출생 월 완전 일치 + 출생 일 완전 일치
ID 범주 일치
ID 범주에서는 다음 데이터 속성 일치 시나리오가 충족될 때만 완전 일치로 간주됩니다.- 식별 번호 완전 일치
데이터 속성의 퍼지 일치
국가별 데이터 소스를 대상으로 다양한 데이터 속성에 적용되는 퍼지 일치 기준은 다음과 같습니다.- 이름 데이터 속성 이름 카테고리 데이터 속성이 완전 일치를 생성하려면 데이터 소스의 기록과 비교하여 레벤슈타인(Levenshtein) 문자 유사도가 70% 이상이어야 합니다. 전체 성명 결합(이름 + 성 조합)의 경우, 더 높은 임계값인 85% 유사도가 적용됩니다. 예를 들어, 입력된 이름 속성이 ‘Christophel’이고 실제 이름이 ‘Christopher’인 경우, 퍼지 일치 로직에 따라 완전 일치가 반환됩니다. 이 방식은 이름, 성, 부성, 모성 데이터 속성에 적용됩니다.
- 생년월일 및 신분증 데이터 속성 생년월일 또는 신분증 데이터 카테고리 내의 데이터 속성에는 어떤 종류의 퍼지 일치도 적용하지 않습니다. 해당 필드에는 정확한 일치가 필요합니다.
예시
다음은 퍼지 일치 로직 기준을 충족하여 완전 일치를 생성하는 데이터 속성 입력 예시입니다.관련 항목
- 데이터베이스 검증 개요 — API 엔드투엔드 작동 방식, 지원되는 등록부, 요금 안내.
- 결과 코드 — 공급자 응답 코드 전체 목록(사망자, 미성년자, 문서를 찾을 수 없음, 생체 인식 불일치).
- 경고 — 입력값 누락으로 인해 서비스를 실행할 수 없을 때 표시되는 항목.
- 지원 국가 및 서비스 — 모든 프로덕션 등록부, 필수 필드 및 호출당 가격.
- 보고서 — 서비스별 월간 결제 내역 내보내기.