AVA가 문서 이름을 읽는 방식
AVA는 여권 이름을 읽을 때 하단의 기계판독영역(MRZ) 과 인쇄된 텍스트에 대한 시각 스캔을 함께 사용합니다. 대부분의 여권에서는 MRZ를 우선하지만, 일부 국가는 MRZ만으로 성과 이름을 안정적으로 나누기 어려워 인쇄된 이름을 우선합니다.
이 가이드는 추출된 이름이 게스트가 예상한 표기와 다르게 보일 수 있는 이유, 단일 이름 게스트를 처리하는 방식, AVA가 이름 출처를 결정하는 기준을 설명합니다.
빠른 참조
| 상황 | AVA의 동작 | 화면에서 보이는 내용 |
|---|---|---|
| MRZ가 선명한 일반 여권 | MRZ 이름 사용 | 이름이 기계판독영역과 일치 |
| 말레이시아, 미얀마, 인도네시아, 싱가포르 여권 | 시각 스캔 이름 사용 | MRZ 위에 인쇄된 이름과 일치 |
| 이름이 하나뿐인 게스트 | 단일 이름으로 저장 후 PMS 전송 시 복제 | 이름과 성에 같은 값이 표시 |
| 혼인명 또는 별칭이 있는 싱가포르 신분증 | 본명과 별칭을 모두 예약과 비교 | 별칭이 일치해도 저장되는 값은 본명 |
| 배우자 성이 함께 적힌 프랑스 여권 | 출생 성과 혼인 후 성을 분리 | 성에는 출생 성 저장, 혼인 후 성은 매칭에 사용 가능 |
| MRZ가 흐리거나 잘렸거나 오독됨 | 시각 스캔으로 대체 | 인쇄된 텍스트 기준으로 이름 표시 |
동작 방식
이름이 추출되는 위치
AVA는 각 문서에서 두 가지 출처를 읽은 뒤 더 신뢰할 수 있는 쪽을 선택합니다.
1. 기계판독영역(MRZ)
MRZ는 여권 하단의 대문자 블록입니다. 이름 데이터가 << 구분자로 구조화되어 있습니다.
AVA가 MRZ를 신뢰하는 경우:
- 표준 2줄 MRZ 형식의 여권인 경우
- 체크 디지트 검증을 통과한 경우
- 이름과 성 구간이 모두 존재하는 경우
- 국가가 단일 필드 이름 형식을 사용하지 않는 경우
AVA가 MRZ를 신뢰하지 않는 경우:
- 체크 디지트가 실패한 경우(문자를 잘못 읽음)
- MRZ가 없거나 흐리거나 일부가 잘린 경우
- 이름 구간이 하나뿐인 경우(성/이름 사이
<<구분이 없음)
MRZ 각 줄에는 작은 검증 숫자가 포함됩니다. 이 숫자가 데이터와 맞지 않으면 카메라가 문자를 잘못 읽었다는 의미입니다. 이 경우 AVA는 MRZ 전체를 버리고 게스트에게 사진을 다시 찍도록 요청합니다.
2. 시각 스캔(인쇄된 텍스트)
AVA는 사진과 MRZ 위에 인쇄된 이름 필드도 읽습니다. MRZ를 신뢰할 수 없을 때는 이 값이 대체 출처가 되며, 신분증이나 운전면허증처럼 여권이 아닌 문서에서는 기본 출처가 됩니다.
국가별 이름 처리
일부 국가는 여권 MRZ가 이름과 성을 안정적으로 구분하지 못합니다. AVA는 이런 국가를 감지하면 이름 분리에 시각 스캔을 사용합니다.
시각 스캔 이름을 사용하는 국가
| 국가 | 이유 | 달라지는 점 |
|---|---|---|
| 말레이시아 | MRZ에 전체 이름이 하나의 필드로 들어갈 수 있음 | MRZ 이름 대신 인쇄된 이름 필드를 읽음 |
| 미얀마 | 성이 없거나 이름이 단일 필드로 표기되는 경우가 많음 | 인쇄된 이름을 읽고 단일 이름을 감지할 수 있음 |
| 인도네시아 | 단일 이름(모노님)을 가진 시민이 많음 | 인쇄된 이름을 읽고 하나의 이름만 저장할 수 있음 |
| 싱가포르 | 특정 이름 패턴에서 MRZ 분리가 모호할 수 있음 | 이름/성 분리에 인쇄된 이름 필드를 사용 |
AVA가 이름에 시각 스캔을 사용하더라도 문서 번호, 생년월일, 만료일, 국적은 계속 MRZ에서 가져옵니다. 시각 스캔으로 바뀌는 것은 이름 분리 방식뿐입니다.
그 외 모든 국가
위 목록에 없는 국가의 여권은 MRZ가 읽히고 체크 디지트 검증을 통과하면 MRZ 이름을 사용합니다.
단일 이름 게스트 처리 방식
인도네시아나 미얀마 국적 게스트처럼 법적 이름이 하나뿐인 경우가 있습니다. AVA는 이를 두 단계로 처리합니다.
1단계: 추출
AVA는 다음 조건을 모두 만족하면:
- MRZ 이름 구간에
<<구분자가 없고 - 시각 스캔 결과가 공백 없는 단일 이름인 경우
이름을 이름만 있는 상태로 저장하고 성은 비워 둡니다.
2단계: PMS 동기화
대부분의 PMS는 이름과 성을 모두 요구합니다. AVA는 PMS로 전송하기 전에 단일 이름을 양쪽 필드에 복제합니다.
| 문서에 표시된 값 | AVA 저장 값 | PMS 전송 값 |
|---|---|---|
| SUKARNO | 이름: SUKARNO, 성: (비어 있음) | 이름: SUKARNO, 성: SUKARNO |
| (비어 있음), SUHARTO | 이름: (비어 있음), 성: SUHARTO | 이름: SUHARTO, 성: SUHARTO |
이 방식은 단일 이름 승객을 처리할 때 항공업계에서 사용하는 IATA PNR 관행과 일치합니다.
이름 재정렬
문서와 예약에 같은 이름 토큰이 있지만 이름/성 분리가 다를 때가 있습니다. 말레이시아, 인도네시아, 미얀마, 싱가포르 게스트에게서 자주 발생합니다.
예시:
| 출처 | 이름 | 성 |
|---|---|---|
| 문서 | AHMAD BIN IBRAHIM | (비어 있음) |
| 예약 | AHMAD | BIN IBRAHIM |
AVA는 두 쪽 모두 같은 이름 조각을 포함하는지 확인합니다. 매칭이 성립하면, 저장된 이름을 PMS 기록과 맞추기 위해 예약의 이름/성 분리 방식을 채택합니다.
별칭과 혼인명 매칭
기본 문서 이름이 예약과 일치하지 않을 때 AVA는 대체 이름도 함께 확인합니다.
싱가포르 신분증
싱가포르 신분증에는 두 줄의 이름이 있을 수 있습니다.
- 본명(primary) - 예: DASIMA BINTE MOHAMMAD
- 혼인명/별칭(alias) - 예: MRS DASIMA KAYA
AVA는 두 이름 모두를 예약과 비교합니다. 별칭이 일치하면 체크인은 통과하지만, 저장되는 공식 이름은 본명입니다.
프랑스 여권
프랑스 여권에는 혼인 후 성이 같은 줄에 함께 표시될 수 있습니다. 예: "FREBOURG ép. GODIN". AVA는 이를 다음처럼 분리합니다.
- 기본 성: FREBOURG
- 별칭 성: GODIN
두 값 모두 예약 이름과 비교됩니다.
재촬영 요청이 발생하는 경우
AVA는 다음 상황에서 게스트에게 여권 사진을 다시 찍도록 요청합니다.
- ❌ MRZ 체크 디지트가 실패한 경우(오독된 문자)
- ❌ MRZ 텍스트가 너무 짧거나 불완전한 경우
- ❌ 두 출처 모두에서 신뢰할 수 있는 이름을 만들 수 없는 경우
- ❌ 단일 필드 국가 여권인데 시각 스캔 이름도 읽히지 않는 경우
재촬영 요청은 AVA가 문서를 확실하게 읽지 못했다는 뜻입니다. 일반적으로 조명을 더 밝게 하고 MRZ 전체가 보이게 다시 촬영하면 해결됩니다.
문제 해결
이름과 성이 똑같이 표시됨
보이는 현상: PMS에서 이름과 성이 같은 값으로 표시됩니다.
이유: 게스트의 법적 이름이 하나뿐인 경우입니다. AVA가 PMS 요구사항을 맞추기 위해 같은 값을 복제합니다.
대응: 조치가 필요하지 않습니다. 단일 이름 게스트에서는 정상 동작입니다.
여권에 보이는 이름 분리와 다르게 저장됨
보이는 현상: 이름과 성이 여권 표기와 다르게 나뉘어 보입니다.
이유: 말레이시아, 미얀마, 인도네시아, 싱가포르 여권은 AVA가 시각 스캔을 사용하므로 MRZ와 다른 분리 방식이 나올 수 있습니다.
대응:
- 저장된 이름을 실제 여권의 인쇄 텍스트와 MRZ 모두와 비교합니다.
- 전체 이름은 맞지만 이름/성 분리만 다르면 정상 범주입니다.
- 이름 자체가 명백히 잘못되었다면 문서 전체가 보이도록 다시 촬영해 달라고 안내합니다.
여권 재촬영 요청이 계속 반복됨
보이는 현상: 게스트가 여러 번 시도해도 새 사진을 계속 요청받습니다.
대응:
- 여권을 어두운 배경 위에 평평하게 놓도록 안내합니다.
- 하단 두 줄 MRZ 전체가 초점 안에 들어오도록 합니다.
- 빛 반사, 그림자, 손가락 가림이 없도록 합니다.
- 계속 실패하면 프론트데스크에서 직접 체크인을 진행합니다.
혼인명은 일치했는데 저장된 이름이 다름
보이는 현상: 체크인은 통과했지만 저장된 이름은 혼인명이 아니라 본명입니다.
이유: AVA는 예약 매칭에 어떤 이름이 사용됐는지와 관계없이 항상 문서상의 기본(법적) 이름을 저장합니다.
대응: 조치가 필요하지 않습니다. 법적 준수를 위한 설계입니다.
여전히 해결되지 않나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 특정 국적 문서에서 여권 스캔이 반복적으로 실패함
- ❌ 여러 번 재시도해도 이름 추출 결과가 명백히 잘못됨
- ❌ 목록에 없는 국가의 이름 처리 방식 안내가 필요함
함께 보내면 좋은 정보:
- 게스트 국적과 문서 종류
- 추출된 이름과 실제 문서를 비교한 스크린샷
- 호텔 국가 설정