跳到主要内容

完整 STB EVA 入驻配置

快速设置

完成 6 个步骤即可启用新加坡政府合规申报。大多数酒店可在 15-25 分钟内完成。

本指南将引导你在 Settings → Government Integration 中完成 STB E-Visitor Authentication (EVA) 的全流程入驻配置。

步骤操作你需要准备的内容
1保存 Hotel CodeHotel Licensing Board (HLB) 代码
2提交 STB 表单可访问 form.gov.sg
3生成并提交 JWKSJWKS 提交链接
4输入 EVA API Key来自 STB 邮件的 API key
5生成并通知 STB已准备好的测试交易
6等待 STB 确认STB 批准邮件

开始前​

请确认以下条件：

  • 你的酒店国家已设置为 Singapore
  • 你拥有 Settings write 权限
  • 你已准备好 Hotel Licensing Board (HLB) 代码
  • 你可以访问外部 STB 表单
如何找到 Hotel Code

如果你不知道 HLB 代码，可在 licence1.business.gov.sg/hotelreg/search 搜索你的酒店。

分步入驻流程​

步骤 1：保存 Hotel Code​

Government Integration page showing Step 1 with Hotel Code field

  1. 前往 Settings → Government Integration

  2. 开启 Enable E-Visitor Authentication (EVA) Integration

  3. 输入从 Hotel Licensing Board 获取的 Hotel Code

  4. 点击 Save Hotel Code

    ✓ 你会看到 “Hotel code saved successfully”

无法保存？

请先确认 Government Integration 已启用（开关为蓝色），再保存 hotel code。

步骤 2：提交 STB EVA 入驻表单​

Step 2 showing Open STB Form button and confirmation action

  1. 在 Step 2 区块点击 Open STB Form

  2. 在 form.gov.sg 完成 HIS-EVA Hotel Onboarding Application

  3. 返回 Streamliner

  4. 点击 I have submitted the form

  5. 在确认弹窗中点击 Yes, I have submitted the form

    ✓ Step 2 会显示为已完成

STB 需要哪些信息

该表单会要求填写酒店资料和 API 访问需求。处理时间通常为 3-5 个工作日。

步骤 3：生成并提交 JWKS​

JWKS（JSON Web Key Set）是用于让你的酒店通过 STB 系统认证的安全凭证。

如果你需要新的密钥（大多数酒店）​

Step 3 showing Generate JWKS and Download buttons

  1. 在 Step 3 点击 Generate JWKS

    ✓ 你会看到带时间戳的 “JWKS generated successfully”

  2. 点击 Download JWKS txt

  3. 保存该文件（稍后需要上传给 STB）

  4. 点击 Submit JWKS Form 打开 STB 提交入口

  5. 上传你下载的 JWKS 文件

  6. 返回 Streamliner

  7. 点击 I have submitted the JWKS

  8. 在弹窗中确认

    ✓ Step 3 会显示为已完成

如果你已经有 STB 凭证​

有些酒店会直接从 STB 收到 JWKS 凭证。此时请使用 Override Keys，而不是重新生成新密钥：

Advanced options expanded showing Override Keys button

  1. 在 Step 3 展开 Advanced options

  2. 点击 Override Keys

  3. 在弹出的弹窗中输入你现有的凭证：

    • JWKS（JSON 格式）
    • Public Key（PEM 格式）
    • Private Key（PEM 格式）

  4. 点击 Save Override Keys

    ✓ 你会看到 “EVA keys overridden successfully”

  5. 点击 I have submitted the JWKS 进行确认

    ✓ Step 3 会显示为已完成

请妥善保管你的密钥

不要通过邮件或聊天工具分享你的 private key 或 JWKS。这些凭证可用于访问政府系统。

步骤 4：输入 EVA API Key​

STB 处理完你的 JWKS 提交后，会通过邮件发送 API key 给你。

  1. 在邮箱中查找来自 STB、标题包含 “EVA API Key” 的邮件

  2. 复制该 API key（UUID 格式）

  3. 返回 Streamliner 的 Step 4

  4. 将 key 粘贴到 Enter EVA API Key

  5. 点击 Save API Key

    ✓ 系统会自动验证该 key ✓ 你会看到 “API key saved successfully”

验证需要一点时间

系统会使用你的 API key 测试 STB 端点。这通常需要 5-10 秒。验证期间不要关闭页面。

步骤 5：生成测试交易并通知 STB​

Step 5 showing test transaction ID and notification options

保存 API key 后，系统会自动生成一笔测试交易。

  1. 等待测试交易生成完成

    ✓ 你会看到由 STB 返回的 transaction ID

  2. 点击 Send Automated Email to STB 通知 STB

    ✓ Step 5 会显示为已完成

    如果自动邮件不可用，请点击 Copy transaction ID，然后手动将交易详情通过邮件发送给 STB。

如果自动邮件显示警告

如果你看到 “We sent this test transaction to your email only”，表示 STB 尚未收到通知。请手动将邮件转发给 STB，然后在 Streamliner 中完成确认。

如果你希望为你的酒店启用自动 STB 通知，请联系 success@vouch-technologies.com。

步骤 6：等待 STB 确认​

Step 6 showing waiting status and confirmation button

STB 会审核你的测试交易，并确认集成成功。

  1. 等待 STB 的确认邮件（通常需要 1-2 个工作日）

  2. 返回 Streamliner

  3. 点击 Mark STB Confirmation Received

    ✓ 你会看到 “STB confirmation recorded. EVA onboarding is complete.” ✓ 所有 6 个步骤都会显示为已完成

All steps completed showing successful onboarding

🎉 你的 EVA 集成现已启用！ 客人的入住数据将自动提交至 STB。

管理你的集成​

重新生成测试交易​

如果测试交易过期或失败：

  1. 前往 Step 5
  2. 点击 Re-generate Test Transaction
  3. 使用新的 transaction ID 通知 STB

重置入驻流程​

如果你需要重新开始：

  1. 联系 success@vouch-technologies.com
  2. 请求重置 EVA 入驻流程
  3. 使用新的凭证重新完成全部 6 个步骤
重置会清除现有凭证

重置会删除所有 JWKS、API key 和进度。仅在当前凭证丢失或泄露时才执行此操作。

故障排查​

Step 1 按钮被禁用​

你会看到： 无法保存 hotel code。

解决方法：

  • 确认 Enable E-Visitor Authentication (EVA) Integration 已开启
  • 检查 hotel code 输入框不为空
  • 尝试刷新页面

Step 2 无法确认​

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

解决方法：

  1. 先完成 Step 1
  2. 确认你已在 form.gov.sg 实际提交 STB 表单
  3. 返回并点击确认按钮

Override Keys 失败​

你会看到： 保存 override 凭证时出现错误。

解决方法：

  • 确认 JWKS 是合法的 JSON 格式
  • 确认 public key 和 private key 使用带正确头部的 PEM 格式（-----BEGIN PUBLIC KEY-----）
  • 确认至少填写了一个字段（JWKS、public key 或 private key）

API key 验证失败​

你会看到： 点击 Save API Key 后出现错误。

解决方法：

  1. 检查 key 是否完整（共 36 个字符，含连字符）
  2. 删除 key 前后的多余空格
  3. 确认你使用的是与当前环境对应的 TEST 或 LIVE key
  4. 确认 Step 3（JWKS）已完成