设置证件姓名匹配策略

快速设置

先使用 Balanced 模式。大多数酒店可在 3 分钟内完成设置。

本指南帮助你控制 AVA 将预订姓名与护照或身份证姓名进行比较时的严格程度。

查找位置

Settings → Security → General Settings → Document Name Matching

该策略包含两个标签页：Reservation Lookup 和 Document Upload。 选择与你要配置的入住步骤对应的标签页。 AVA 只显示当前策略面板。

快速参考

设置	控制内容	典型结果
Strict	最高匹配严格度	更多客人会进入前台复核
Balanced	默认匹配严格度	安全性良好，同时自助入住更顺畅
Lenient	较低匹配严格度	更多缩写姓名会自动通过
Custom	手动阈值和规则	结果取决于你配置的值

父名

Strict 模式接受省略的父名标记，如 bin、binti、binte、bte、S/O 和 D/O。 它仍然会阻止不安全的部分匹配。

原生脚本匹配

当两个姓名都使用同一种脚本时，AVA 会先比较该原生脚本文字。 这能在不改变当前模式的情况下，提升泰文和 CJK 预订的匹配效果。

使用不同脚本的姓名

当姓名使用不同脚本时，AVA 还会检查确定性的音译结果，以覆盖各个词元。 这样可以防止一个较短的音译词元批准不完整的 Lenient 匹配。 原生脚本文字完全匹配时，仍然会被接受。

强化姓氏保护

如果证件包含姓氏，AVA 要求预订姓名中的姓氏达到所选策略的阈值。 即使名字相同，姓氏不同的预订也不会通过。 如果护照中没有姓氏，而预订姓名增加了另一个姓名，AVA 会将该案例转至预订姓名验证。

双词证件姓名

当证件姓名包含两个词元时，AVA 要求这两个词元都得到有意义的支持。

这个保护规则适用于 Balanced、Lenient 和 Custom 模式。 它可以防止其中一个词元单独承担全部匹配结果。

只要证件中的两个词元都能在匹配中体现，AVA 仍然接受紧凑或词序交换的匹配。

仅姓氏匹配

当姓名的两部分都可用时，仅凭共享姓氏不能批准匹配。 这可以保护拥有复合姓氏（例如 DELA PAZ）的客人。

只要证件中的两个词元都得到支持，有效缩写、别名、姓名倒置和原生脚本证据仍可通过。 员工当面核实客人身份后，仍可使用现有的 ACI 覆盖选项。

姓名对	结果	原因
"Alex DELA PAZ" vs "Jordan DELA PAZ"	❌ 复核	只有共享姓氏支持此次匹配
"Zilin Zhu" vs "Zhuzilin Zhuzilin"	❌ 复核	证件中的一个词元没有得到有意义的支持
"A B" vs "B A"	✓ 通过	两个词元都存在，即使顺序发生变化
"M Taka" vs "Mitsui Takafumi"	✓ 通过	匹配中仍然出现证件中的两个词元

设置匹配模式

1. 前往 Settings → Security → General Settings

2. 在 Document Name Matching 中选择 Reservation Lookup 或 Document Upload

3. 选择一种模式

4. 查看场景预览卡片

5. 点击 Save General Settings

   ✓ 你选择的策略会应用于新的入住尝试。

预览行为

预览卡现在使用标准的精选场景。 Strict、Balanced 和 Lenient 显示相同的示例列表。 结果遵循 CCI 的词元级评分和双词安全保护规则。

调整 Custom 模式

如果团队已有明确的复核 SOP，请使用 Custom 模式。

1. 选择 Reservation Lookup 或 Document Upload
2. 选择 Custom
3. 设置 Base similarity threshold（80-95）
4. 选择是否允许：
   • Initial + surname prefix matching
   • Alias name matching
5. 设置缩写控制：
   • Minimum surname prefix length（3-6）
   • Minimum surname coverage（0.30-0.80）
   • Require two tokens
   • Require single-character initial
6. 点击 Save General Settings

自动安全规则

保存时，AVA 会规范化证件匹配设置：

• 无效的模式值会重置为 Balanced
• 自定义阈值必须保持在 80-95 之间
• 姓氏前缀最小长度必须保持在 3-6 之间
• 姓氏覆盖率最小值必须保持在 0.30-0.80 之间
• "true" 和 "false" 文本值会转换为实际开关

✓ 如果你输入了范围外的值，AVA 会保存已修正的值。

父名

姓名对	Strict	Balanced	Lenient
"AHMAD BIN IBRAHIM" vs "AHMAD IBRAHIM"	✓ 通过	✓ 通过	✓ 通过
"AHMAD IBRAHIM" vs "AHMAD BIN IBRAHIM"	✓ 通过	✓ 通过	✓ 通过
"AHMAD BIN IBRAHIM" vs "AHMAD BIN ABDULLAH"	❌ 复核	❌ 复核	❌ 复核

马来常见姓名省略

快速检查

仅将此规则用于一个获准的马来语前导词元。 它适用于 Balanced 和 Lenient 模式。

有时，马来姓名包含一个 AVA 可以安全省略的前导词元。 AVA 仍然要求剩余词元构成强匹配。

这样可以避免仅凭共享的马来语前缀就通过匹配。

Strict 和 Custom 模式不使用此例外。 AVA 在预订查找、证件上传、暂存建议和暂存提交验证中使用相同的匹配器。

姓名对	Strict	Balanced	Lenient
"MOHD AHMAD BIN IBRAHIM" vs "AHMAD BIN IBRAHIM"	❌ 复核	✓ 通过	✓ 通过
"MOHD AHMAD BIN IBRAHIM" vs "MOHD AHMAD BIN IBRAHIM"	✓ 通过	✓ 通过	✓ 通过
"MOHD AHMAD BIN IBRAHIM" vs "MOHD AHMAD BIN ABDULLAH"	❌ 复核	❌ 复核	❌ 复核
"MOHD AHMAD BIN IBRAHIM" vs "AHMAD ABDULLAH"	❌ 复核	❌ 复核	❌ 复核

单行马来西亚身份证件

一些马来西亚身份证件会将完整姓名打印在同一行。 AVA 可能会根据该行内容推断名字和姓氏的分界。

在 Balanced 和 Lenient 模式下，AVA 可以接受预订中省略一个获准的前导词元。 证件中的其余词元必须与预订姓名完全匹配。

证件姓名	预订姓名	Balanced 和 Lenient	Strict 和 Custom
MUHAMMAD HAFIZ ABDULLAH	HAFIZ ABDULLAH	✓ 通过	❌ 复核
MOHD AHMAD BIN IBRAHIM	AHMAD BIN IBRAHIM	✓ 通过	❌ 复核
SITI HAFIZ ABDULLAH	HAFIZ ABDULLAH	❌ 复核	❌ 复核
MUHAMMAD AMIR HAMZAH	AMIRA HAMZAH	❌ 复核	❌ 复核

此例外仅适用于能够推断姓名分界的已识别非护照证件。 它不适用于护照、未知证件类型或省略两个前导词元的情况。

常见示例

姓名对	Strict	Balanced	Lenient
"John Michael Doe" vs "John Michael Doe"	✓ 通过	✓ 通过	✓ 通过
"Jon Smyth" vs "John Smith"	❌ 复核	✓ 通过	✓ 通过
"M Taka" vs "Mitsui Takafumi"	❌ 复核	✓ 通过	✓ 通过
"K Taka" vs "Mitsui Takafumi"	❌ 复核	❌ 复核	❌ 复核
"A Kumar" vs "Arun Kumar"	❌ 复核	✓ 通过	✓ 通过
"HSIEH / YU-CHEN" vs "Hung Yu Chen"	❌ 复核	❌ 复核	❌ 复核

别名

只有同时满足以下三个条件时，别名才能通过：

1. 已启用 Alias name matching。
2. 证件提供了别名。
3. 在所选模式下，别名与预订匹配。

仅有不同的主要姓氏不能通过。

预订姓名	证件上的主要姓名	证件提供的别名	Balanced 结果
"Alice Tan"	"Alice Lim"	"Alice Tan"	✓ 启用别名匹配时通过
"Alice Tan"	"Alice Lim"	无	❌ 复核
"Alice Tan"	"Alice Wong"	"Alice Chen"	❌ 复核
"Alice Tan"	"Alice Lim"	"Alice Tan"	❌ 禁用别名匹配时复核

启用 Lenient 之前

Lenient 模式可以减轻前台工作量，但它也会接受更多边缘姓名模式。

故障排查

进入复核的客人太多

你会看到： 很多合法客人都被转到员工复核。

解决方法：

1. 将 Strict 切换为 Balanced
2. 在 Custom 中稍微降低阈值
3. 如果 OTA 姓名经常被缩写，请启用缩写匹配

过多缩写姓名通过了

你会看到： 你希望对短姓名进行更严格筛查。

解决方法：

1. 将 Lenient 切换为 Balanced 或 Strict
2. 在 Custom 中提高阈值
3. 增加姓氏前缀长度或覆盖率

更改似乎没有生效

你会看到： 编辑后结果看起来没有变化。

解决方法：

1. 再次点击 Save General Settings
2. 刷新页面
3. 用新的入住流程测试

错误的姓名匹配策略正在变更

你会看到： 预订查找和证件上传产生了意外结果。

解决方法：

1. 返回 Settings → Security → General Settings。
2. 打开 Document Name Matching。
3. 选择 Reservation Lookup 或 Document Upload。
4. 查看并保存该标签页的策略。

✓ AVA 会将已保存的策略应用于所选入住步骤。

自定义值在保存后变了

你会看到： 已保存的自定义值看起来和你输入的不一样。

解决方法：

1. 重新打开 Document Name Matching
2. 将你的值与允许范围对比
3. 使用范围内的值再次保存

仍然卡住？

如果出现以下情况，请联系 success@vouch-technologies.com：

• ❌ 重试后姓名匹配结果仍然不稳定
• ❌ 设置保存成功，但行为没有改变
• ❌ 你需要帮助调整自定义值以满足本地合规要求

建议附上：

• 你选择的模式
• 自定义值（如果有）
• 2-3 组预订姓名与证件姓名示例

相关指南

• 安全概览
• 证件检查
• 面部验证