跳到主要内容

支付网关集成

快速设置

先设置网关。然后选择账单视图和支付规则。大多数酒店 5 分钟即可完成。

本指南帮助你在 Settings → Payment 中设置支付和账单显示规则。 如果你使用 Stripe，请在连接前先选择 Live 或 Test。 房费免收会检查预订备注和来源标签里的独立关键词。 Opera 旅行社名称，例如 Booking.com (VCC)，也可以触发同样的免收。 旧的 OTA 来源选择器已不再属于本页面。

位置​

Settings → Payment

快速参考​

设置区域控制内容主要结果
Billing View详细或简化的客人账单摘要显示逐项明细或更短摘要
Payment Gateway IntegrationStripe 或 Red Dot 的设置客人可以在自助终端流程中支付
Stripe EnvironmentStripe 网关和终端连接的 Live 或 Test 模式连接后锁定
Payment Collection Mode押金和全额支付开关控制客人在入住时支付什么
Comment-Based Room Payment Waivers预订备注中的免收关键词当你的 PMS 提供关键词免收支持时，跳过空余额阻断
Property Currency (in Settings → Essentials)用于押金和预订支付显示的解析后币种保持支付金额在各设置和操作中一致
Deposit Currency本页押金金额所使用的币种与其他支付设置一起保存
Opera Payment Mapping结算、收银员和支付类型映射Opera 能正确接收支付入账
Opera Payment Policy Controls四舍五入、预授权、隐藏和不收款规则强制执行 Opera 专用支付行为

开始之前​

  • 准备好你的支付网关账户
  • 决定你要使用 Detailed 还是 Simplified 账单视图
  • 决定你要押金、全额支付，还是两者都要
  • 在 Settings → Essentials → Hotel Basic Details 中确认你的押金政策和物业币种来源
  • 确认你的 PMS 版本明确支持支付免收关键词。如果 AVA 不能确认支持，字段会保持隐藏。
  • 如果你使用 Opera，请准备好收银员 ID 和支付方式代码映射

分步设置​

第 1 步：选择支付网关​

  1. 前往 Settings → Payment。
  2. 在 Payment Gateway Integration 中选择 Stripe 或 Red Dot Payment。

Stripe​

  1. 打开 Advanced。
  2. 选择 Live 或 Test。
  3. 点击 Connect Stripe。
  4. 完成 Stripe 入驻流程。
  5. 返回 Streamliner 并确认 Stripe 已连接。
Stripe 模式

生产环境使用 Live，沙盒入驻使用 Test。 Stripe 连接后，在你断开之前，环境会变为只读。

终端 Stripe 设置默认也使用 Live，除非你在连接前更改它。

终端结账

当某个 kiosk 只映射了一个 Stripe 终端时，AVA 会在结账时自动打开它。 当映射了多个终端时，你可以在支付弹窗中的终端选择器里挑选。 如果终端模式关闭，AVA 会保留网关或 QR 支付流程。

Red Dot Payment​

  1. 输入 Merchant ID。
  2. 输入 Secret Key。
  3. 选择 Environment（TEST 或 LIVE）。
  4. 点击 Save Payment Gateway Settings。

第 2 步：选择账单视图​

使用此卡片控制客人可见的账单摘要。 选择 Detailed 可显示逐项明细。 选择 Simplified 可显示 Room Charges、Tax 和总额。

  1. 前往 Settings → Payment。
  2. 在 Billing View 中选择 Detailed 或 Simplified。
  3. 点击 Save。
账单视图位置

该卡片会出现在支付页面上的 Terminal Payment Configuration 之前。

第 3 步：选择支付收款选项​

开关功能
Collect Security Deposits在入住期间预授权押金
Collect Full Payment客人在入住期间支付未结余额
  1. 打开一个或两个开关。
  2. 如果两个都关闭，入住时不会请求支付。
  3. 点击 Save Payment Gateway Settings。

第 4 步：配置押金详情（如已启用）​

  1. 输入 Deposit Amount。
  2. 选择 Deposit Type（按晚或固定金额）。
  3. 如果你看到 Deposit Currency，请选择你酒店用于押金的币种。
  4. 点击 Save Payment Gateway Settings。
押金币种来源

支付设置会使用来自 Settings → Essentials → Hotel Basic Details 的解析后 Property Currency。 如果 PMS 提供了币种，AVA 会使用该值并锁定本地编辑。 你选择的 Deposit Currency 会与其他支付设置一起保存。

基于备注的房费免收​

当 AVA 应在受支持的 PMS 关键词免收场景中跳过房费时使用此功能。

  • 在 Payment Policy Controls 中设置一个免收关键词。
  • AVA 检查的是预订备注和来源标签里的该关键词。
  • Opera 也会把旅行社档案名称传入同一个匹配逻辑。
  • 如果关键词作为独立单词匹配，AVA 会跳过支付阻断。
  • 如果它只出现在更长的词元里，AVA 会继续把余额视为应付。
  • 如果没有匹配，AVA 仍会把余额视为应付。
Opera 来源标签

如果 Opera 返回旅行社标签，AVA 可以读取类似 Booking.com (VCC) 的值。 该标签可能满足免收关键词。

通用免收行为

当 AVA 无法确认关键词免收支持时，编辑器会保持隐藏。 Cloudbeds、eZee、Ava、Furama、未知供应商以及不受支持的 PMS 版本都不会显示该字段。

  1. 打开 Payment Policy Controls。
  2. 输入你的 PMS 写入预订备注的免收关键词。
  3. 点击 Save。
  4. 使用包含该关键词的预订进行测试。

第 5 步：配置 Opera 支付映射（仅限 Opera）​

  1. 在 Opera PMS Payment Mapping 中设置：
    • Settlement Code
    • Default Cashier ID
    • Default Comment Type / Location
    • Payment Type to Payment Method Code 行
  2. 点击 Save Opera Payment Mapping。
映射行的工作方式

每一行将一种支付方式关联到一个 OPERA payment method code。 AVA 会把这些行与其他支付设置一起保存。

Opera 支付备注默认值

AVA 在创建 Opera 支付或押金备注时，会使用你配置的 Default Comment Type / Location。 更改这个值后，请再次保存映射。

第 6 步：配置 Opera 支付策略控制（仅限 Opera）​

  1. 在 Opera Payment Policy Controls 中设置支付行为：
    • 发票可见性与结账校验
    • 四舍五入调整和交易代码
    • 自动延迟捕获选项
    • 隐藏和不收款规则列表
  2. 点击 Save Payment Policies。
Opera 支付备注

AVA 会尽量在支付或押金入账前先添加 Opera 预订备注。 如果备注创建失败，AVA 仍会在 Streamliner 中入账支付或押金。 这会让收款继续进行，即使 Opera 备注创建失败。 通用房费免收关键词在上方配置。

保存后会看到什么​

  • ✅ 设置完成后会显示已连接的网关详情
  • ✅ Stripe 的连接状态徽标会显示 Live 或 Test
  • ✅ 账单视图会与其他支付设置一起保存
  • ✅ 启用押金后会显示押金字段
  • ✅ 点击 Save 后押金币种会继续保留
  • ✅ 只有在 Opera PMS 下才会显示 Opera 映射和 Opera 策略区域
  • ✅ 当 当前 PMS 提供商 是 Opera 时，会显示 Step 3: Configure Opera PMS Payment Mapping 卡片
  • ✅ 同一页面上的支付设置彼此独立保存
迁移说明

支付设置已从 Settings → Essentials 移到 Settings → Payment。 旧的 OTA 来源选择器已被移除。

故障排查​

网关设置被禁用​

你会看到： 支付开关或保存按钮被禁用。

解决方法：

  1. 确认你的账户有设置写入权限。
  2. 如果选择了 Stripe，请先连接 Stripe。
  3. 刷新页面后重试。

账单视图没有变化​

你会看到： 客人仍然看到旧的账单摘要布局。

解决方法：

  1. 返回 Settings → Payment。
  2. 重新选择 Detailed 或 Simplified。
  3. 在 Billing View 卡片上点击 Save。
  4. 新建一个客人流程或刷新预订页面。
  5. 如果仍然不对，请确认酒店使用的是当前的 CCI 设置路径。

Stripe 环境被锁定​

你会看到： Stripe 连接后 Environment 下拉菜单被禁用。

解决方法：

  1. 断开 Stripe。
  2. 打开 Advanced。
  3. 选择 Live 或 Test。
  4. 重新连接 Stripe。

Opera 区域没有出现​

你会看到： 缺少 Opera 映射和策略卡片。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认 PMS 提供商是 Opera。
  3. 返回 Settings → Payment。
  4. 刷新页面一次。
  5. 检查是否出现 Step 3: Configure Opera PMS Payment Mapping。

Opera 支付映射没有保存​

你会看到： 点击 Save 后，收银员或支付方式行消失了。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认 Opera 仍然是当前 PMS。
  3. 返回 Settings → Payment。
  4. 重新输入 Default Cashier ID 和每一行映射。
  5. 再次点击 Save Opera Payment Mapping。

Opera 预订备注缺失​

你会看到： 支付成功入账了，但 Opera 中没有新的预订备注。

解决方法：

  1. 确认支付或押金在 Streamliner 中确实成功完成。
  2. 检查 Opera 预订是否有匹配的支付记录。
  3. 确认 Default Comment Type / Location 已在 Opera PMS Payment Mapping 中设置。
  4. 不要仅为了重新创建备注而重试。
  5. 如果支付已入账但备注仍未出现，请联系支持。

房费被意外免收​

你会看到： 预订跳过了房费，但你本来期望看到支付请求。

解决方法：

  1. 在 PMS 中打开该预订。
  2. 检查预订备注、来源名称和 Opera 旅行社标签。
  3. 如果该预订不应免收，请移除或修改该关键词。
  4. 刷新 AVA，并用新的预订再测试一次。

找不到支付免收关键词字段​

你会看到： 你看不到免收关键词字段，或者在 Payment Policy Controls 中看到不受支持的 PMS 提示。

解决方法：

  1. 确认你的 PMS 提供商支持关键词免收。
  2. 刷新 Settings → Payment。
  3. 如果字段仍未出现，说明 AVA 还没有该 PMS 的支持数据。
  4. 继续保留现有免收关键词。即使编辑器隐藏，AVA 仍会保存它们。

客人没有被要求支付​

你会看到： 客人在入住时跳过了支付。

解决方法：

  1. 确认网关已连接。
  2. 确认 Collect Security Deposits 或 Collect Full Payment 已启用。
  3. 确认预订有待结余额。
  4. 保存并用样例预订重新测试。

押金币种显示错误或无法编辑​

你会看到： 押金币种与你期望的不一致，或者字段更改不会保留。

解决方法：

  1. 打开 Settings → Essentials → Hotel Basic Details。
  2. 检查 Property Currency 是由 PMS 管理还是可编辑。
  3. 如果由 PMS 管理，请在 PMS 中更新币种并等待同步。
  4. 刷新 Settings → Payment 并确认币种。

仍然卡住？​

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

  • ❌ 重新保存设置后支付仍然失败
  • ❌ 客人仍看不到账单视图变更
  • ❌ Opera 映射值无法保留
  • ❌ Stripe 或 Red Dot 连接反复断开

建议附上：

  • Settings → Payment 的截图
  • PMS 提供商名称
  • 示例预订 ID 和时间戳