AVA가 문서 이름을 읽는 방식
AVA는 여권에서 이름을 읽을 때 두 가지 방법을 사용합니다. 아래쪽의 machine-readable zone(MRZ)과 인쇄된 텍스트를 보는 visual scan입니다. 대부분의 여권에서는 MRZ가 우선입니다. 일부 국가에서는 MRZ가 이름과 성을 안정적으로 분리하지 못하므로 visual scan이 우선됩니다.
이 가이드는 추출된 이름이 투숙객이 기대하는 것과 다르게 보일 수 있는 이유, 단일 이름만 있는 투숙객을 어떻게 처리하는지, 그리고 AVA가 이름을 어디에서 읽는지 이해하는 데 도움을 줍니다.
빠른 참조
| 상황 | AVA의 동작 | 사용자가 보는 내용 |
|---|---|---|
| 표준 여권에 MRZ가 선명함 | MRZ 이름을 사용 | 이름이 machine-readable zone과 일치 |
| 말레이시아, 미얀마, 인도네시아, 싱가포르 여권 | visual(인쇄된) 이름을 사용 | 이름이 MRZ 위의 인쇄 텍스트와 일치 |
| 이름이 하나뿐인 게스트(mononym) | 단일 이름을 저장하고 PMS용으로 복제 | 이름과 성이 같은 값으로 표시 |
| 싱가포르 IC에 결혼 전 이름 또는 별칭이 있음 | 생년 이름과 별칭 이름을 모두 예약과 대조 | 별칭이 일치해도 기본(생년) 이름을 저장 |
| 프랑스 여권에 배우자 성이 있음 | 출생 성과 혼인 성을 분리 | 출생 성은 last name으로 저장되고, 혼인 성은 매칭에 사용 가능 |
| MRZ가 흐리거나 잘리거나 오류가 있음 | visual scan으로 되돌림 | 대신 인쇄 텍스트에서 이름을 가져옴 |
Document Name Overwrite가 켜져 있으면 AVA는 지원되는 문서 흐름 중에 일치한 문서 이름을 게스트 기록에 복사합니다. 꺼져 있으면 AVA는 예약 또는 PMS의 게스트 이름을 유지합니다.
동작 방식
이름이 어디에서 오는가
AVA는 모든 문서에서 두 출처의 이름을 읽은 뒤, 더 신뢰할 수 있는 쪽을 선택합니다.
1. Machine-Readable Zone (MRZ)
MRZ는 여권 아래쪽에 있는 대문자 블록입니다. << 구분자로 나뉜 구조화된 이름 데이터가 들어 있습니다.
AVA가 MRZ를 신뢰하는 경우:
- 여권이 표준 2줄 MRZ 형식일 때
- 체크 디지트 검증을 통과할 때
- first name과 last name 구역이 모두 있을 때
- 해당 국가가 단일 필드 이름 형식을 사용하지 않을 때
AVA가 MRZ를 신뢰하지 않는 경우:
- 체크 디지트가 실패할 때(문자를 잘못 읽은 경우)
- MRZ가 없거나, 흐리거나, 불완전할 때
- 이름 구역이 하나만 있을 때(surname과 given name 사이에
<<구분자가 없음)
MRZ 각 줄에는 작은 검증 번호가 포함됩니다. 이 값이 데이터와 맞지 않으면 카메라가 문자를 잘못 읽은 것입니다. AVA는 MRZ 전체를 거부하고 투숙객에게 다시 촬영을 요청합니다.
2. Visual Scan (인쇄 텍스트)
AVA는 문서에 인쇄된 이름 필드도 읽습니다. 사진과 MRZ 위에 보이는 텍스트입니다. MRZ가 신뢰할 수 없을 때 사용하는 대체 경로이며, 신분증이나 운전면허증 같은 비여권 문서의 경우 기본 출처입니다.
국가별 이름 처리
일부 국가의 여권은 MRZ가 이름과 성을 안정적으로 분리하지 못합니다. AVA는 이를 감지하면 이름 분리를 위해 visual scan으로 전환합니다.
Visual 이름을 사용하는 국가
| 국가 | 이유 | 달라지는 점 |
|---|---|---|
| 말레이시아 | MRZ가 전체 이름을 한 필드에 넣을 수 있음 | MRZ 이름 대신 인쇄된 이름 필드를 읽음 |
| 미얀마 | 이름에 family name이 없거나 한 필드만 쓰는 경우가 많음 | 인쇄된 이름을 읽고 mononym을 감지할 수 있음 |
| 인도네시아 | 단일 이름(mononym)을 가진 시민이 많음 | 인쇄된 이름을 읽으며 이름 하나만 저장할 수 있음 |
| 싱가포르 | 특정 이름 패턴에서 MRZ 형식이 모호할 수 있음 | first/last 분리를 위해 인쇄된 이름 필드를 읽음 |
AVA가 이름을 visual scan에서 읽더라도 document number, date of birth, expiry date, nationality에는 여전히 MRZ를 사용합니다. 이름 분리만 visual로 바뀝니다.
그 밖의 모든 국가
위에 나열되지 않은 국가의 여권은 MRZ를 읽을 수 있고 체크 디지트 검증을 통과하면 MRZ 이름을 사용합니다.
단일 이름(mononym) 게스트 처리
일부 게스트는 법적 이름이 하나뿐입니다. 인도네시아와 미얀마 시민에게서 흔합니다. AVA는 이를 두 단계로 처리합니다.
1단계: 추출
AVA가 다음 조건의 여권을 감지하면:
- MRZ 이름 구역에
<<구분자가 없고, 그리고 - visual scan에 단일 이름만 있음(공백 없음)
이름을 first name만 저장하고, last name은 비워 둡니다.
2단계: PMS 동기화
대부분의 숙소 관리 시스템은 first name과 last name을 모두 요구합니다. PMS로 게스트 데이터를 보낼 때 AVA는 단일 이름을 두 필드에 복제합니다.
| Document Shows | AVA Stores | Sent to 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) 규칙을 따릅니다.
이름 재정렬
문서와 예약이 같은 이름 토큰을 갖고 있지만 first/last name에 다르게 나뉘어 있는 경우가 있습니다. 말레이시아, 인도네시아, 미얀마, 싱가포르 출신 투숙객에게 흔합니다.
예시:
| 출처 | First Name | Last Name |
|---|---|---|
| Document | AHMAD BIN IBRAHIM | (empty) |
| Reservation | AHMAD | BIN IBRAHIM |
AVA는 양쪽이 같은 이름 조각을 포함한다고 판단합니다. 일치가 확인되면 예약의 분리 방식을 채택해 저장된 이름이 PMS 기록과 맞도록 정렬합니다.
별칭 및 혼인 성 매칭
AVA는 기본 문서 이름이 예약과 일치하지 않을 때 대체 이름도 확인합니다.
싱가포르 신분증
싱가포르 IC에는 두 줄의 이름이 표시될 수 있습니다.
- Birth name(기본) - 예: DASIMA BINTE MOHAMMAD
- Married name(alias) - 예: MRS DASIMA KAYA
AVA는 두 이름을 모두 예약과 비교합니다. alias가 일치하면 체크인은 진행되지만, 공식 게스트 이름은 birth name으로 저장됩니다.
프랑스 여권
프랑스 여권에는 혼인 성이 인라인으로 표시될 수 있습니다. 예: "FREBOURG ép. GODIN". AVA는 이를 다음처럼 분리합니다.
- Primary last name: FREBOURG
- Alias last name: GODIN
둘 다 예약 이름과 비교됩니다.
다시 촬영을 요청하는 경우
AVA는 다음 상황에서 게스트에게 여권 사진을 다시 찍으라고 요청합니다.
- ❌ MRZ 체크 디지트가 실패할 때(문자를 잘못 읽은 경우)
- ❌ MRZ 텍스트가 너무 짧거나 불완전할 때
- ❌ 백엔드가 어떤 출처에서도 신뢰할 수 있는 이름을 결정할 수 없을 때
- ❌ 여권이 single-field 국가의 것이고 visual 이름도 없을 때
다시 촬영 요청은 AVA가 문서를 자신 있게 읽지 못했다는 뜻입니다. 게스트는 더 선명한 사진만 다시 찍으면 됩니다. 보통은 조명이 더 좋고 MRZ 전체가 보이도록 촬영하면 됩니다.
문제 해결
게스트 이름이 중복되어 보임(first name과 last name이 같음)
보이는 현상: 게스트의 first name과 last name이 PMS에서 같은 값으로 표시됩니다.
이유: 게스트가 단일 법적 이름(mononym)을 가지고 있기 때문입니다. AVA는 PMS 요구사항을 맞추기 위해 이를 복제합니다.
조치: 별도 조치가 필요하지 않습니다. 단일 이름 게스트에게는 예상된 동작입니다.
게스트 이름 분리가 여권과 다르게 보임
보이는 현상: first name과 last name이 여권에 보이는 방식과 다르게 바뀌거나 묶여 있습니다.
이유: 말레이시아, 미얀마, 인도네시아, 싱가포르 여권의 경우 AVA가 visual scan을 사용하기 때문에 MRZ와 다른 방식으로 이름이 나뉠 수 있습니다.
해결:
- 저장된 이름을 실제 여권의 인쇄 텍스트와 MRZ 둘 다와 비교합니다.
- 전체 이름은 맞지만 first/last 분리만 다르면 이는 정상입니다.
- 이름이 명백히 잘못되었다면 전체 문서가 보이도록 다시 스캔해 달라고 요청합니다.
여권을 계속 다시 스캔하라는 요청이 뜸
보이는 현상: 게스트가 다시 시도해도 AVA가 계속 새 사진을 요청합니다.
해결:
- 게스트에게 여권을 어두운 표면 위에 평평하게 놓도록 요청합니다.
- MRZ 하단 두 줄 전체가 보이고 초점이 맞는지 확인합니다.
- 반사광, 그림자, 손가락이 문서 일부를 가리는 상황을 피합니다.
- 계속 실패하면 프런트 데스크에서 체크인을 완료합니다.
혼인 성은 일치하지만 저장된 이름이 다름
보이는 현상: 체크인은 통과했지만 저장된 이름이 혼인 성이 아니라 출생 이름입니다.
이유: AVA는 예약과 일치한 이름이 alias였더라도 문서의 기본(출생/법적) 이름을 항상 저장합니다.
조치: 별도 조치가 필요하지 않습니다. 법적 준수를 위한 설계입니다.
계속 해결되지 않나요?
다음 경우 success@vouch-technologies.com으로 문의하세요:
- ❌ 특정 국적에서 여권 스캔이 계속 실패함
- ❌ 여러 번 다시 시도해도 이름 추출 결과가 명백히 잘못됨
- ❌ 위에 없는 국가의 이름 처리 방식이 궁금함
함께 보내면 좋은 정보:
- 게스트의 국적과 문서 유형
- 추출된 이름과 실제 문서의 스크린샷
- 호텔 국가 설정