AVA가 문서 이름을 읽는 방식
AVA는 여권 이름을 읽을 때 두 가지 방법을 사용합니다. 아래쪽의 machine-readable zone(MRZ)과 인쇄된 텍스트에 대한 visual scan입니다. 대부분의 여권에서는 MRZ가 우선입니다. 일부 국가에서는 MRZ가 이름을 안정적으로 구분하지 못하기 때문에 visual scan이 우선됩니다.
이 안내서는 추출된 이름이 게스트의 예상과 다르게 보이는 이유, 단일 이름 게스트를 처리하는 방식, 그리고 AVA가 이름을 어디에서 가져오는지를 설명합니다.
빠른 참고
| 상황 | AVA의 처리 방식 | 게스트가 보는 내용 |
|---|---|---|
| MRZ가 선명한 일반 여권 | MRZ 이름 사용 | 이름이 machine-readable zone과 일치 |
| 말레이시아, 미얀마, 인도네시아, 싱가포르 여권 | visual(인쇄된) 이름 사용 | 이름이 MRZ 위의 인쇄 텍스트와 일치 |
| 이름이 하나뿐인 게스트(mononym) | 단일 이름을 저장하고 PMS용으로 복제 | 이름과 성이 같은 값으로 표시 |
| 싱가포르 IC의 혼인명 또는 별칭 이름 | 생년 이름과 별칭 이름을 모두 예약과 대조 | 별칭이 일치해도 기본(생년) 이름이 저장 |
| 프랑스 여권의 배우자 성 | 생년 성과 혼인 성을 분리 | 생년 성은 성으로 저장되고, 혼인 성은 매칭용으로 사용 |
| MRZ가 흐리거나 잘렸거나 오류가 있음 | visual scan으로 대체 | 대신 인쇄 텍스트를 사용 |
Document Name Overwrite가 켜져 있으면 AVA는 지원되는 문서 흐름에서 일치한 문서 이름을 게스트 레코드로 복사합니다. 이 기능이 꺼져 있으면 AVA는 예약 또는 PMS 게스트 이름을 유지합니다.
작동 방식
이름의 출처
AVA는 모든 문서에서 이름을 두 곳에서 읽은 뒤 더 신뢰할 수 있는 쪽을 선택합니다.
1. Machine-Readable Zone(MRZ)
MRZ는 여권 아래쪽에 있는 대문자 블록입니다. << 구분자로 나뉜 구조화된 이름 데이터를 담고 있습니다.
AVA가 MRZ를 신뢰하는 경우:
- 여권이 표준 2줄 MRZ 형식인 경우
- AVA가 2줄 여권 MRZ의 약간 다른 줄 길이를 정규화하는 경우
- check digit 검증을 통과하는 경우
- 이름과 성 구간이 모두 존재하는 경우
- 국가가 단일 필드 이름 형식을 사용하지 않는 경우
AVA가 MRZ를 신뢰하지 않는 경우:
- check digit이 실패한 경우(문자를 잘못 읽은 경우)
- MRZ가 없거나, 흐리거나, 불완전한 경우
- 이름 구간이 하나뿐인 경우(성분과 이름 사이에
<<구분자가 없는 경우)
각 MRZ 줄에는 작은 검증 숫자가 포함됩니다. 이것이 데이터와 일치하지 않으면 카메라가 문자를 잘못 읽었다는 뜻입니다. AVA는 전체 MRZ를 거부하고 게스트에게 사진을 다시 찍도록 요청합니다.
AVA는 검증 전에 2줄 여권 MRZ의 작은 줄 길이 차이도 보정합니다. 이 덕분에 다시 스캔하지 않아도 되는 경우가 많습니다.
2. Visual Scan(인쇄 텍스트)
AVA는 문서에 인쇄된 이름 필드도 읽습니다. 사진과 MRZ 위에 보이는 그 텍스트입니다. 이것은 MRZ가 신뢰할 수 없을 때 사용하는 대체 방식이며, ID나 운전면허증 같은 비여권 문서에서는 기본 소스입니다.
국가별 이름 처리
일부 국가는 MRZ가 이름과 성을 안정적으로 분리하지 못하는 여권을 발급합니다. AVA는 이를 감지해 이름 분리에 visual scan을 사용합니다.
Visual 이름을 사용하는 국가
| 국가 | 이유 | 달라지는 점 |
|---|---|---|
| Malaysia | MRZ가 전체 이름을 하나의 필드에 넣을 수 있음 | MRZ 이름 대신 인쇄된 이름 필드를 읽음 |
| Myanmar | 성이 없는 경우가 많거나 단일 필드를 사용 | 인쇄된 이름을 읽고 mononym을 감지할 수 있음 |
| Indonesia | 많은 시민이 단일 이름을 가짐(mononym) | 인쇄된 이름을 읽고 이름 하나만 저장할 수 있음 |
| Singapore | 특정 이름 패턴에서 MRZ 형식이 모호할 수 있음 | 이름/성 구분을 위해 인쇄된 이름 필드를 읽음 |
AVA가 visual scan에서 이름을 읽더라도, document number, date of birth, expiry date, nationality는 계속 MRZ를 사용합니다. 이름 분리만 visual 방식으로 바뀝니다.
그 밖의 모든 국가
위에 나열되지 않은 국가의 여권은 MRZ가 읽을 수 있고 check digit 검증을 통과하면 AVA가 MRZ 이름을 사용합니다.
단일 이름(mononym) 게스트 처리 방식
인도네시아와 미얀마 시민처럼 법적 이름이 하나뿐인 게스트도 있습니다. AVA는 이를 두 단계로 처리합니다.
1단계: 추출
AVA가 다음 조건의 여권을 감지하면:
- MRZ 이름 구간에
<<구분자가 없고, - visual scan에 단일 이름(공백 없음)이 보이는 경우
이름을 first name only로 저장하고 last name은 비워 둡니다.
2단계: PMS 동기화
대부분의 PMS는 이름과 성을 모두 요구합니다. 게스트 데이터를 PMS로 보낼 때 AVA는 단일 이름을 양쪽 필드에 복제합니다.
| 문서에 표시 | AVA에 저장 | PMS로 전송 |
|---|---|---|
| SUKARNO | First name: SUKARNO, Last name: (empty) | First name: SUKARNO, Last name: SUKARNO |
| (empty), SUHARTO | First name: (empty), Last name: SUHARTO | First name: SUHARTO, Last name: SUHARTO |
이 방식은 항공사가 단일 이름 여행자에게 사용하는 IATA Passenger Name Record(PNR) 관례를 따릅니다.
이름 재정렬
때로는 문서와 예약이 같은 이름 토큰을 가지고 있지만, 이름과 성의 분할 방식이 다를 수 있습니다. 말레이시아, 인도네시아, 미얀마, 싱가포르 게스트에게 흔합니다.
예시:
| 출처 | 이름 | 성 |
|---|---|---|
| 문서 | AHMAD BIN IBRAHIM | (empty) |
| 예약 | AHMAD | BIN IBRAHIM |
AVA는 양쪽이 같은 이름 부분을 담고 있다는 것을 감지합니다. 일치가 확인되면, 저장된 이름이 PMS 레코드와 맞도록 예약의 분할 방식을 따릅니다.
별칭 및 혼인명 매칭
AVA는 기본 문서 이름이 예약과 일치하지 않을 때 대체 이름을 확인합니다.
싱가포르 신분증
싱가포르 IC에는 두 줄의 이름이 표시될 수 있습니다.
- Birth name(기본 이름) - 예: DASIMA BINTE MOHAMMAD
- Married name(별칭) - 예: MRS DASIMA KAYA
AVA는 두 이름을 모두 예약과 대조합니다. 별칭이 일치하면 체크인은 계속되지만, 공식 게스트 이름으로는 birth name이 저장됩니다.
프랑스 여권
프랑스 여권에는 혼인 성이 한 줄에 표시될 수 있습니다. 예: "FREBOURG ép. GODIN". AVA는 이를 다음으로 나눕니다.
- Primary last name: FREBOURG
- Alias last name: GODIN
둘 다 예약 이름과 대조됩니다.
재스캔이 필요한 경우
AVA가 다음 경우 여권 사진을 다시 찍도록 요청합니다.
- ❌ MRZ check digits 실패(문자를 잘못 읽음)
- ❌ MRZ 텍스트가 너무 짧거나 불완전함
- ❌ 백엔드가 어느 소스에서도 신뢰할 수 있는 이름을 결정하지 못함
- ❌ 여권이 단일 필드 국가 문서이고, visual 이름도 없음
재스캔 요청은 AVA가 문서를 자신 있게 읽지 못했다는 뜻입니다. 게스트는 더 선명한 사진만 다시 찍으면 됩니다. 보통은 조명을 개선하고 MRZ 전체가 보이게 하면 충분합니다.
문제 해결
게스트 이름이 중복되어 보입니다(이름과 성이 같음)
보이는 현상: PMS에서 게스트의 이름과 성이 같은 값으로 표시됩니다.
이유: 게스트가 단일 법적 이름(mononym)을 가지고 있기 때문입니다. AVA는 PMS 요구를 맞추기 위해 이를 복제합니다.
조치: 별도 조치는 필요하지 않습니다. 단일 이름 게스트에서는 예상된 동작입니다.
게스트 이름 분할이 여권과 다르게 보입니다
보이는 현상: 이름과 성이 여권 표시와 다르게 뒤바뀌거나 묶여 있습니다.
이유: 말레이시아, 미얀마, 인도네시아, 싱가포르 여권에서는 AVA가 visual scan을 사용하므로 MRZ와 다른 방식으로 이름을 나눌 수 있습니다.
해결:
- 저장된 이름을 실물 여권의 인쇄 텍스트와 MRZ 모두와 비교합니다.
- 전체 이름은 맞지만 이름/성 분할만 다르면, 이는 정상입니다.
- 이름이 명백히 잘못되었다면, 전체 문서가 보이도록 다시 스캔하도록 게스트에게 요청합니다.
게스트가 여권 재스캔을 계속 요청받습니다
보이는 현상: 게스트가 다시 시도해도 AVA가 계속 새 사진을 요청합니다.
해결:
- 게스트에게 여권을 어두운 표면에 평평하게 놓으라고 안내합니다.
- MRZ 전체(아래쪽 두 줄)가 선명하게 보여야 합니다.
- 반사광, 그림자, 손가락이 문서를 가리는 상황을 피합니다.
- 계속 실패하면 프런트 데스크에서 체크인을 완료합니다.
혼인명은 일치하지만 저장된 이름이 다릅니다
보이는 현상: 체크인은 통과했지만 저장된 이름은 혼인명이 아니라 생년 이름입니다.
이유: AVA는 예약에 맞는 이름이 별칭이더라도, 문서의 기본(생년/법적) 이름을 항상 저장합니다.
조치: 별도 조치는 필요하지 않습니다. 법적 준수를 위한 설계입니다.
아직 막혔나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 특정 국적에서 여권 스캔이 계속 실패함
- ❌ 여러 번 재시도해도 이름 추출 결과가 명백히 잘못됨
- ❌ 위에 나열되지 않은 국가의 이름 처리 방식이 필요함
포함하면 좋은 정보:
- 게스트의 국적과 문서 유형
- 추출된 이름과 실제 문서의 스크린샷
- 호텔 국가 설정