跳到主要内容

设置 STB EVA 政府集成

快速设置

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

本指南帮助你从 政府合规 完成新加坡 STB EVA 入驻。

何时会跳过 EVA

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

面部验证后

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

设置控制内容结果
政府集成启用 EVA 入驻工具你可以开始 STB 入驻
EVA 环境选择沙盒（TEST）或生产（LIVE）流量立即保存；LIVE 需要确认
酒店代码EVA 请求中使用的酒店标识保存后解锁步骤 2
JWKSEVA 签名密钥和步骤 3 确认确认提交后解锁步骤 4
EVA API Key用于 EVA 交易调用的凭据有效保存后可以运行测试交易
EVA 跳过规则防止不必要的 EVA 提交与新加坡相关的客人无需调用 EVA 即可继续
生成新的 JWKS替换现有入驻凭据你必须重新完成步骤 3–6

开始之前​

  • 你的酒店国家是 Singapore。
  • 你拥有 Settings read 权限，并具有用于保存设置的写入权限。
  • 你知道 STB 酒店代码。
  • 你可以访问 STB 表单和 JWKS 提交链接。

没有 settings:write 的用户可以查看设置，但无法修改设置。

查找 STB EVA 设置​

  1. 打开 政府合规。
  2. 打开 Singapore → STB EVA。
  3. 选择 开始 STB EVA 设置、继续设置 或 解决设置问题。

如果你想查看交付健康状况，请使用 命令中心 → 分析。 如果入驻尚未完成，分析中会显示 需要设置 STB EVA。

旧链接

旧的 Settings → Government Integration 链接仍会重定向到 STB EVA 设置。

分步设置​

  1. 打开 政府合规 → Singapore → STB EVA。

  2. 打开 政府集成。

  3. 在 EVA 环境 中选择 TEST 或 LIVE。

    • 仅当服务器批准你使用 STB 沙盒商户时，才选择 TEST。
    • 仅当 STB 批准你的生产凭据后，才选择 LIVE。
    • 如果保存的值缺失或不受支持，Streamliner 会显示 TEST。

    ✓ 有效选择后，环境会立即保存。

  4. 如果选择 LIVE，请查看警告并点击 切换到 LIVE。 选择 取消 以保留当前环境。

    ✓ 更改环境不会替换你的酒店代码或 EVA 凭据。

  5. 输入酒店代码并点击 保存酒店代码。

    ✓ 现在可以开始步骤 2。

  6. 在 步骤 2 中，点击 查看 FormSG 问题 1–15 的指南。

  7. 完成官方 STB FormSG 申请时保持指南打开。

  8. 关闭指南，然后点击 打开 STB 表单。

  9. 提交 STB 入驻表单。

  10. 返回 Streamliner，然后点击 我已提交表单。

✓ 步骤 2 的状态会变为 已完成。

  1. 在 步骤 3 中，点击 生成 JWKS。
  2. 点击 下载 JWKS txt。
  3. 点击 提交 JWKS 表单，然后完成 STB JWKS 提交。
  4. 返回 Streamliner，然后点击 我已提交 JWKS。
  5. 在确认弹窗中，点击 是的，我已提交 JWKS。

✓ 步骤 3 的状态会变为 已完成。

  1. 在 步骤 4 中，输入 STB 发放的 API key，然后点击 保存 API Key。

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

  1. 等待自动验证。

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

  1. 在 步骤 5 中复制交易 ID。如有需要，点击 重新生成测试交易。
  2. 在 步骤 5 中，点击 向 STB 发送自动邮件。
  3. 等待 STB 的连通性确认邮件。
  4. 在 步骤 6 中，点击 标记已收到 STB 确认。

✓ 步骤 6 的状态会变为 已完成。

完成 FormSG 申请​

在官方 FormSG 申请旁使用产品内指南。 Vouch 不会代你提交表单。 提交前，请与你的酒店授权代表确认法律信息。

FormSG 问题应输入或选择的内容
1. Requested API Services选择 E-Visitor Authentication (for Hotel Applicants)。
2. Justifications输入下面可直接复制的文字，说明自动入住和客人同意。
3. Country of Incorporation输入申请组织的法定注册国家，而不是酒店所在地。
4. Organisation Name输入准确的法定名称。新加坡实体应与 Corppass 记录一致。
5. Hotel Name and Hotel Code输入你的物业名称和 HLB 酒店代码。没有酒店合作方的供应商申请者输入 N.A.。
6. Email Address for Test Environment使用有人监控的运营邮箱。STB 会使用该邮箱发送生产通知。
7. Reason for APEX JWT Request输入：Contactless check-in integration, implemented via appointed technology vendor Vouch Technologies on the hotel's behalf.
8. Nature of Business输入下面可直接复制的文字。有官方网站时请一并填写。
9–13. Contact details输入请求者的称谓、法定姓名、职位和行业。通常适合填写 Hospitality 或 ICT。
14. Applicant type选择 Hotel Applicant。你的酒店拥有 EVA 凭据。
15. Technology provider输入 Vouch Technologies。如果 STB 要求其他格式，请使用其法定名称。
可直接复制的 FormSG 文字

对于 问题 2，输入：EVA will be used for authorised, automated hotel check-in, and the hotel will obtain guest consent before any data is submitted.

对于 问题 8，输入：The Hotel provides accommodation and hospitality services to its guests. It has engaged technology vendor Vouch Technologies to implement a contactless check-in solution on its behalf, using EVA to support guest authentication during check-in.

确认申请者信息

酒店申请并拥有 EVA 凭据。 Vouch Technologies 作为指定技术提供商支持集成。 提交官方表单前，请检查所有法律信息。

提交表单后​

  1. STB 可能需要最多 7 个工作日 审核你的请求。
  2. 收到测试密钥后，请在 14 个日历日 内完成连通性测试。
  3. 请求生产凭据前，请将成功的测试证据提供给 STB。

安全使用沙盒测试访问权限​

只有服务器批准的沙盒商户会看到 测试访问。 沙盒测试交易使用 STB TEST。 这些交易无法联系正式 STB，也不会记录正式确认。

  1. 打开 政府合规 → Singapore → STB EVA。
  2. 出现 测试访问 时点击它。
  3. 确认页面说明沙盒访问已获批准。
  4. 返回 STB EVA 设置，完成已批准的 TEST 流程。

不要将沙盒商户切换到 LIVE。

LIVE 需要生产批准

只有在 STB 批准生产访问权限并提供生产凭据后，才可切换到 LIVE。 确认对话框有助于防止意外产生生产流量。

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

如果你看到类似 “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. 在 酒店代码 中保存一个值。
  2. 确认 政府集成 已启用。
  3. 再试一次。

步骤 3 无法确认​

你会看到： 我已提交 JWKS 一直处于禁用状态。

解决方法：

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

保存 API key 时被步骤 3 消息阻止​

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

解决方法：

  1. 返回 步骤 3。
  2. 点击 我已提交 JWKS。
  3. 确认弹窗。
  4. 在 步骤 4 中重试 保存 API Key。

保存 API key 失败​

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

解决方法：

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

API key 字段只显示星号​

你会看到： 步骤 4 显示 ********-****-****-****-************。

解决方法：

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

测试交易失败​

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

解决方法：

  1. 确认 EVA 环境 已保存。
  2. 确认步骤 3 和步骤 4 已完成。
  3. 点击 重新生成测试交易。
  4. 如果再次失败，请联系支持。

EVA 环境无法更改​

你会看到： Streamliner 拒绝你的 TEST 或 LIVE 选择。

解决方法：

  1. 沙盒商户必须保持 TEST。
  2. 未经沙盒批准，非沙盒商户无法切换到 TEST。
  3. 确认你拥有 settings:write 权限。
  4. 如果该政策与你的酒店不符，请联系 Vouch Support。

EVA 环境更改无法保存​

你会看到： 选择后，选择器恢复为之前的值。

解决方法：

  1. 等待成功或错误消息。
  2. 重试选择一次。
  3. 确认酒店上下文正确。
  4. 如果仍无法保存，请将准确的错误消息提供给支持团队。

STB 返回 B18 或 C18​

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

解决方法：

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

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

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

你会看到： 点击 向 STB 发送自动邮件 后出现 ⚠️ 警告，提示 “We sent this test transaction to your email only”。

解决方法：

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

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

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

解决方法：

  1. 前往 Settings → Essentials → Hotel Basic Details。
  2. 确认 Country 是 Singapore。
  3. 打开 政府合规 → Singapore → STB EVA。

仍然卡住？​

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

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

建议附上：

  • 政府集成页面截图
  • 准确的错误信息文本
  • 问题开始时间