跳到主要内容

设置 STB EVA 政府集成

快速设置

先打开 Government Integration，选择 TEST/LIVE，然后按顺序完成 6 个入驻步骤。大多数酒店可在 10 到 20 分钟内完成。

本指南帮助你从 Settings → Check-in 完成新加坡 STB EVA 入驻。

何时会跳过 EVA

如果客人的国籍或证件签发地被解析为新加坡，AVA 会跳过 EVA。 如果这两个值都不是新加坡，AVA 会把客人转到 EVA。

面部验证之后

如果 EVA 在面部验证后提交失败，AVA 会记录错误并继续推进客人流程。 你可以先完成入住，稍后再查看日志。

设置控制内容结果
Government Integration启用 EVA 入驻工具你可以开始 STB 入驻
EVA Environment目标 EVA 端点（TEST 或 LIVE）可以运行 API key 和测试交易
Hotel CodeEVA 请求中使用的酒店标识保存后解锁步骤 2
JWKSEVA 签名密钥和步骤 3 确认在你确认提交后解锁步骤 4
EVA API Key用于 EVA 交易调用的凭据有效保存后可以运行测试交易
EVA skip rule防止不必要的 EVA 提交与新加坡相关的客人会直接继续，不会发起 EVA 调用
Generate New JWKS替换现有入驻凭据你必须重新完成步骤 3 到 6

开始之前​

  • 你的酒店国家设为 Singapore。
  • 你拥有 Settings write 权限。
  • 你知道 STB 酒店代码。
  • 你可以访问 STB 表单和 JWKS 提交链接。

分步设置​

  1. 打开 Settings → Check-in → Government Integration。

  2. 打开 Government Integration。

  3. 在 Environment 中选择 TEST 或 LIVE，然后点击 Save EVA Environment。

  4. 输入酒店代码并点击 Save Hotel Code。

    ✓ 现在你可以开始步骤 2。

  5. 在 Step 2 中点击 Open STB Form。

  6. 提交 STB 入驻表单。

  7. 返回 Streamliner 并点击 I have submitted the form。

    ✓ 步骤 2 的状态会变为 Completed。

  8. 在 Step 3 中点击 Generate JWKS。

  9. 点击 Download JWKS txt。

  10. 点击 Submit JWKS Form 并完成 STB JWKS 提交。

  11. 返回 Streamliner 并点击 I have submitted the JWKS。

  12. 在确认弹窗中点击 Yes, I have submitted the JWKS。

✓ 步骤 3 的状态会变为 Completed。

  1. 在 Step 4 中输入 STB 发放的 API key，然后点击 Save API Key。

ℹ️ 如果之前保存过 key，字段在你点击进入前会显示为被遮罩的星号。

  1. 等待自动验证。

✓ 如果成功，Streamliner 会保存 key 并启动测试交易。

  1. 在 Step 5 中复制 transaction ID。如有需要，可点击 Re-generate Test Transaction。
  2. 在 Step 5 中点击 Send Automated Email to STB。
  3. 等待 STB 的连通性确认邮件。
  4. 在 Step 6 中点击 Mark STB Confirmation Received。

✓ 步骤 6 的状态会变为 Completed。

如果自动发送只发给了你自己

如果你看到类似 “We sent this test transaction to your email only” 的 ⚠️ 警告，说明 Streamliner 并没有把邮件发给 STB。

请把邮件转发给 STB。然后等待 STB 确认并完成步骤 6。

生成新的 JWKS 会替换现有凭据

如果密钥已存在，生成新的 JWKS 会替换旧密钥，并清除下游入驻进度。 你必须重新完成步骤 3 到 6，包括保存 API key、测试交易和 STB 确认。

故障排查​

你会看到： 客人无需提交 EVA 就完成了入住。

解决方法：

  1. 检查客人国籍和证件签发地。
  2. 如果其中任一项解析为新加坡，请将跳过 EVA 视为正常行为。
  3. 继续入住流程，不要再次把客人发送到 EVA。

步骤 2 按钮被禁用​

你会看到： 无法确认表单提交。

解决方法：

  1. 在 Hotel Code 中保存一个值。
  2. 确认 Government Integration 已启用。
  3. 再试一次。

步骤 3 无法确认​

你会看到： I have submitted the JWKS 一直处于禁用状态。

解决方法：

  1. 先生成或覆盖 JWKS。
  2. 在 STB 表单中提交 JWKS。
  3. 返回并点击确认按钮。
  4. 完成确认弹窗。

保存 API key 时出现步骤 3 提示​

你会看到： 错误提示需要先完成步骤 3 才能保存 EVA API key。

解决方法：

  1. 返回 Step 3。
  2. 点击 I have submitted the JWKS。
  3. 确认弹窗。
  4. 在 Step 4 中重试 Save API Key。

保存 API key 失败​

你会看到： 错误提示 API key 格式无效。

解决方法：

  1. 检查 key 是否为完整的 UUID 格式。
  2. 删除多余空格。
  3. 再次保存。

API key 字段只显示星号​

你会看到： Step 4 显示 ********-****-****-****-************。

解决方法：

  1. 点击 API key 字段内部。
  2. 粘贴新的 key 值。
  3. 点击 Save API Key。

测试交易失败​

你会看到： Step 5 显示错误信息。

解决方法：

  1. 确认 EVA Environment 已保存。
  2. 确认步骤 3 和步骤 4 已完成。
  3. 点击 Re-generate Test Transaction。
  4. 如果再次失败，请联系支持。

STB 返回 B18 或 C18​

你会看到： STB 拒绝提交，并返回 B18、C18 或两者都有。

解决方法：

  1. 检查 MRZ 是否模糊、被裁切、过长或被遮挡。
  2. 重新扫描证件，确保完整 MRZ 清晰可读并与护照一致。
  3. 确认客人信息与护照完全一致。
  4. 重新提交。
  5. 如果仍然失败，请联系支持并附上 transaction ID。
为什么这通常有效

AVA 现在会优先使用将发送给 STB 的清晰 MRZ 数据。 不准确的 OCR 或不匹配的证件数据仍可能触发 C18。

自动发送只显示“只发给你的邮箱”警告​

你会看到： 点击 Send Automated Email to STB 后出现 ⚠️ 警告，提示 “We sent this test transaction to your email only”。

解决方法：

  1. 在收件箱中查看 transaction 邮件。
  2. 将邮件转发给 STB。
  3. 等待 STB 确认，然后完成 Step 6。
  4. 如果你希望为你的酒店启用自动 STB 邮件，请联系支持。

入驻流程因 SG 警告而隐藏​

你会看到： 系统提示 EVA 入驻仅适用于新加坡。

解决方法：

  1. 前往 Settings → Essentials → Hotel Basic Details。
  2. 确认 Country 是 Singapore。
  3. 刷新并重新打开 Government Integration。

仍然卡住？​

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

  • ❌ 保存后步骤状态没有更新
  • ❌ 多次重试后 STB 确认仍失败
  • ❌ 自动发送反复失败

建议附上：

  • Government Integration 页面截图
  • 准确的错误信息文本
  • 问题开始时间