跳到主要内容

支付网关集成

快速设置

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

本指南帮助你在 Settings → Payment 中设置支付和账单规则。 如果你使用 Stripe，请在连接前先选择 Live 或 Test。 网关 Stripe 凭据保留在支付卡片上。 终端的手动凭据保留在终端配置卡上，并且只使用测试密钥。 如果你的酒店使用手动 Stripe 测试凭据，网关卡和终端卡会分别保存这些凭据。 请为每张已配置的卡使用 Stripe 测试密钥。 住宿收费政策与 PMS 提供的值匹配。 Opera 旅行社名称，例如 Booking.com (VCC)，也可以触发同样的免收。 对于 Opera 房型套餐免收，AVA 会先免收房费、房内服务费和房 GST。 对于到店前 Opera 预测，预测房费及其费率信息税费会一并免收。 单独入账的额外项目及其税费仍需支付。 对于 Mews，匹配费率中包含的已验证产品（例如套餐早餐）可以遵循住宿免收政策。 执行该免收后，只有当正的 THB 0.01 余额是住宿四舍五入的残余金额时，AVA 才会将其隐藏。 真正的额外项目和未分类费用仍需支付，包括真正的 THB 0.01 额外项目。 旧的 OTA 来源选择器已不再属于本页面。

位置​

Settings → Payment

快速参考​

设置区域控制内容主要结果
Billing View详细或简化的客人账单摘要显示逐项明细或更短摘要
Payment Gateway IntegrationStripe 或 Red Dot 的设置客人可以在 kiosk 流程中支付
Stripe EnvironmentStripe 网关和终端连接的 Live 或 Test 模式连接后锁定
Manual Stripe Test Credentials网关和终端卡上的仅测试 Stripe 密钥网关和终端的 Stripe 设置分开保存
Terminal Payment ConfigurationStripe 终端 API key、publishable key 和 webhook secret终端凭据与网关 Stripe 分开保存
Payment Collection Mode押金和全额支付开关控制客人在入住时支付什么
Accommodation Charge Policies用于免收或隐藏住宿费用的匹配值当 PMS 支持此能力时，控制住宿行和应付金额
AVA Billing Rules针对房费、税费、押金和附加项的 PMS 隐藏与免收信号将隐藏行显示为 ✅，保持应付总额为数字，并保留应付的额外项目
Property Currency（在 Settings → Essentials 中）用于押金和预订支付显示的解析后币种保持支付金额在各设置和操作中一致
Deposit Currency本页押金金额所使用的币种与其他支付设置一起保存
Opera Payment Mapping结算、收银员和支付类型映射Opera 能正确接收入账
Checkout Rounding Adjustment小额余额容差和结账调整支持的 PMS 可以带小额余额完成结账
Pre-Authorization Controls从 Stripe 预授权延迟捕获房费当前 PMS 支持延迟捕获时显示
Opera-Specific Payment Controls结账验证、路由和不收款逻辑强制执行 Opera 专用支付行为
四舍五入依赖项

只有在 Check-In Policy 中启用了 Check-in outstanding-balance blocking 或 Checkout balance settlement 时，Rounding adjustment 才会生效。 如果两者都关闭，AVA 会保留已保存的四舍五入值，但该控件不会生效。 只有当前 PMS 报告支持结账四舍五入时，AVA 才会显示该控件。 能力数据缺失或格式错误时，该控件会保持隐藏。

基于能力的控件

AVA 从当前 PMS 的能力中读取结账四舍五入支持情况。 只有该能力声明了供应商代码字段时，才会显示 Transaction Code (Rounding)。 不支持或未验证的 PMS 能力不会发送新的四舍五入设置。

开始之前​

  • 准备好你的支付网关账户
  • 决定你要使用 Detailed 还是 Simplified 账单视图
  • 决定你要押金、全额支付，还是两者都要
  • 在 Settings → Essentials → Hotel Basic Details 中确认你的押金政策和物业币种来源
  • 确认你的 PMS 暴露住宿支付政策能力。如果 AVA 无法确认支持，控件会保持隐藏。
  • 如果需要 Auto Delay Capture，确认你的 PMS 暴露延迟预授权捕获支持。
  • 如果你使用 Opera，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，除非你在连接前更改它。

手动 Stripe 测试凭据​

当你的酒店启用了手动 Stripe 测试凭据字段时使用此项。

  1. 打开你要编辑的 Stripe 卡。
  2. 输入 Publishable Key、Secret Key 和 Webhook Secret。
  3. 该卡只使用测试密钥。
  4. 点击 Save。
  5. 如果之后字段被遮罩，可以直接再次点击 Save，无需重新输入。
分开的 Stripe 卡

网关 Stripe 凭据保存在支付网关卡上。 终端 Stripe 凭据保存在终端配置卡上。 请将网关和终端密钥分开保存。

终端结账

当某个 kiosk 只映射了一个 Stripe 终端时，AVA 会在结账时自动打开它。 当映射了多个终端时，你可以在支付弹窗中的终端选择器里挑选。 如果终端模式关闭，AVA 会保留网关或 QR 支付流程。 如果 kiosk 使用直接 Stripe Terminal 凭据，即使 Stripe Account ID 为空，AVA 仍然可以开始结账。 当同时存在直接凭据和 Connect 账户时，AVA 会保留 Connect 账户行为。 终端手动凭据与网关 Stripe 凭据相互独立。 它们只用于测试终端。 如果字段被遮罩，你可以不重新输入值而直接再次保存。

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 会与其他支付设置一起保存。

配置住宿收费政策​

当 PMS 支持住宿支付政策时，使用这些控件。 这些控件显示在 Settings → Payment 的 Payment Policy Controls 下。

控件功能
Waive Accommodation Charges不收取住宿费用、相关税费或服务费。这些行仍然可见。
Hide and Waive Accommodation Charges隐藏且不收取住宿费用、相关税费或服务费。

单独入账的额外项目及其税费仍然可见且需支付。 如果两项政策都匹配，隐藏政策只会改变可见性。 应付金额保持不变。

  1. 前往 Settings → Payment。
  2. 找到 Payment Policy Controls → Accommodation Charge Policies。
  3. 将 PMS 中的每个匹配值添加到相应列表。
  4. 点击 Save Payment Policies。
  5. 测试一笔匹配已配置值的预订。
Opera 来源标签

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

基于能力的可见性

只有当前 PMS 暴露所需能力时，AVA 才会显示这些控件。 控件暂时不可用时，已有值仍会保存。

AVA 账单规则​

当你的 PMS 会为房费、税费、押金或附加项行发送隐藏或免收信号时使用此项。

  • 当连接能力允许时，Mews 和 Opera 支持这些规则。
  • 隐藏的房费或税费行在详细账单中显示为 ✅。
  • 当供应商返回被免收的房费或税费行时，这些行仍会显示。
  • Mews v2 免收政策可以清除整张发票的收费行。
  • 已验证的 Mews 费率包含产品（例如套餐早餐）可以遵循房型套餐免收政策。
  • 相对于已验证包含产品定价的服务费可以遵循该免收政策。
  • 只有当 Mews 余额不超过 THB 0.01 且是免收后的住宿四舍五入残余金额时，才会隐藏该余额。
  • 未分类的正数费用和真正的额外项目仍需支付，包括真正的 THB 0.01 额外项目。
  • 对于 Opera 房型套餐免收，AVA 会先免收房费、房内服务费和房 GST。
  • 到店前预测的 Opera 房费及其费率信息税费会一并免收。
  • 单独入账的 Opera 额外项目及其税费可以继续支付。
  • 被免收的押金或附加项行会从应付总额中移除。
  • 简化账单会显示隐藏的房费和税费行、一个 Extras 分隔线，以及按代码分组的额外项目。
能力分阶段开放

如果你的 PMS 不支持 AVA 账单规则，AVA 会保留普通支付摘要。

  1. 打开使用该 PMS 账单规则的预订。
  2. 在 AVA 中刷新该预订。
  3. 比较可见行与应付余额。
  4. 在 PMS 同步完成后再次测试。

第 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 步：配置结账四舍五入调整​

当 PMS 支持时，AVA 会在 Payment Policy Controls 下显示此控件。

PMS 供应商支持情况其他设置
AVA支持不需要供应商代码
Opera / OHIP支持将供应商代码保存在 Transaction Code (Rounding) 中
Cloudbeds、Mews、eZee 和 Furama不支持控件保持隐藏

  1. 前往 Settings → Check-In → Check-In Policy。

  2. 打开 Check-in outstanding-balance blocking 或 Checkout balance settlement。

  3. 前往 Settings → Payment。

  4. 找到 Payment Policy Controls。

  5. 打开 Enable Rounding Adjustment。

  6. 使用酒店默认币种设置 Rounding Threshold。

  7. 如果使用 Opera，请在 Transaction Code (Rounding) 中输入供应商代码。

  8. 点击 Save Payment Policies。

    ✓ 当余额在阈值范围内时，AVA 会在结账期间应用调整。

调整方式

入住期间，AVA 接受阈值范围内的余额，不会入账交易。 结账期间，AVA 会在完成结账前入账四舍五入调整。 AVA 不使用供应商代码。Opera 使用已配置的供应商代码。

第 7 步：配置自动延迟捕获​

当 PMS 支持延迟捕获时，使用 Auto Delay Capture。 AVA 会在 Stripe 预授权过期前捕获房费。 押金不会被捕获。

设置功能
Enable Auto Delay Capture在预授权过期前自动捕获房费
Auto Delay Capture Expiry Days设置 AVA 在过期前多少天捕获房费

  1. 前往 Settings → Payment。

  2. 找到 Payment Policy Controls → Pre-Authorization Controls。

  3. 打开 Enable Auto Delay Capture。

  4. 输入 Auto Delay Capture Expiry Days。

  5. 点击 Save Payment Policies。

    ✓ 当预授权仍然有效时，AVA 会在过期前捕获房费。

基于能力的可见性

只有当前 PMS 报告支持延迟捕获时，AVA 才会显示这些控件。 Opera 当前报告支持。 其他 PMS 供应商只有在报告相同能力后才会显示这些控件。

PMS 变更可能清除此设置

如果切换到不支持延迟捕获的 PMS，AVA 会关闭 Auto Delay Capture。 AVA 还会清除其过期天数值，以防使用过时设置。

第 8 步：配置 Opera 专用支付控件（仅限 Opera）​

  1. 前往 Settings → Payment。

  2. 找到 Opera-Specific Payment Controls。

  3. 设置支付行为：

    • 结账时的店内发票访问和出生日期验证
    • Ignore Waive Payment Routing 行为

  4. 在 Do Not Collect Any Incidental / Deposit 中，添加每个匹配的费率代码、市场细分、担保类型或备注。

  5. 点击 Save Payment Policies。

    ✓ 匹配的附加项或押金行会从应付余额中移除。

Opera 支付备注

AVA 会尝试在入账支付或押金前添加 Opera 预订备注。 如果备注创建失败，AVA 仍会在 Streamliner 中入账支付或押金。 即使 Opera 备注创建失败，也能继续收取支付。 住宿收费政策已在上方配置。

四舍五入调整依赖项​

如果希望结账四舍五入影响支付行为，请使用此项。

  1. 前往 Settings → Check-In → Check-In Policy。

  2. 打开 Check-in outstanding-balance blocking 或 Checkout balance settlement。

  3. 返回 Settings → Payment。

  4. 打开 Payment Policy Controls 并设置 Enable Rounding Adjustment。

    ✓ 只有其中一项政策启用时，AVA 才会应用四舍五入设置。

已保存的值会保留

如果之后关闭两个入住余额政策，AVA 会保留已保存的四舍五入值。 该控件只是不再影响支付行为。

保存后会看到什么​

  • ✅ 设置完成后会显示已连接的网关详情
  • ✅ Stripe 的连接状态徽标会显示 Live 或 Test
  • ✅ 账单视图会与其他支付设置一起保存
  • ✅ 启用押金后会显示押金字段
  • ✅ 点击 Save 后押金币种会继续保留
  • ✅ 只有在 Opera PMS 下才会显示 Opera 映射和 Opera 策略区域
  • ✅ 当 active PMS provider 是 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。

Stripe 终端凭据被拒绝​

你会看到： 网关或终端 Stripe 凭据无法保存，或者 AVA 在保存后清除了它们。

解决方法：

  1. 确认正在编辑正确的 Stripe 卡。
  2. 网关和终端凭据分别保存。
  3. 手动 Stripe 设置使用仅限测试的值。
  4. 确认密钥以 sk_test_ 开头。
  5. 确认可发布密钥以 pk_test_ 开头。
  6. 再次保存设置。
  7. 如果字段被遮罩，可以不重新输入值而再次保存。

Stripe 测试凭据不显示​

你会看到： 网关卡或终端卡中缺少手动 Stripe 字段。

解决方法：

  1. 刷新 Settings → Payment。
  2. 确认酒店已加入手动 Stripe 测试凭据的分阶段开放范围。
  3. 如果字段仍不显示，请联系支持团队。

支付策略控件不显示​

你会看到： 缺少住宿、结账四舍五入、延迟捕获或 Opera 专用支付控件。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认当前 PMS 正确。
  3. 返回 Settings → Payment。
  4. 刷新页面一次。
  5. 请管理员确认 PMS 能力已启用。
PMS 支付映射

当前 PMS 报告支持时会显示支付映射。 Opera 当前报告此能力。 映射区域与其他按能力控制的支付策略控件分开。

自动延迟捕获缺失​

你会看到： Pre-Authorization Controls 中没有显示 Auto Delay Capture。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认正确的 PMS 处于活动状态。
  3. 更改 PMS 连接后刷新 Settings → Payment。
  4. 向管理员或 Vouch 支持团队确认该 PMS 是否报告支持延迟捕获。

如果 PMS 未报告支持，控件会保持隐藏。 这是预期行为。

自动延迟捕获设置被拒绝​

你会看到： 保存支付设置时，AVA 提示延迟捕获不可用。

解决方法：

  1. 确认当前 PMS 支持延迟捕获。
  2. 如果更换了 PMS 供应商，请关闭 Auto Delay Capture。
  3. 保存支付设置。
  4. PMS 能力可用后重试。

AVA 不会为不受支持或未验证的 PMS 保存延迟捕获设置。

PMS 支付映射无法保存​

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

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认正确的 PMS 处于活动状态，并报告支持支付映射。
  3. 返回 Settings → Payment。
  4. 重新输入 Default Cashier ID 和每个映射行。
  5. 再次点击 Save Opera Payment Mapping。

Opera 支付币种不匹配​

你会看到： Opera 显示内部错误，或者支付或押金入账后没有显示。

解决方法：

  1. 检查 Settings → Essentials → Hotel Basic Details 中的 Property Currency。
  2. 确认 Opera 预订使用相同币种。
  3. 重试支付或押金。
  4. 如果 Opera 仍返回内部错误，请联系支持团队。

Opera 预订备注缺失​

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

解决方法：

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

Opera 备注类型或位置不正确​

你会看到： Opera 创建了支付备注，但类型或位置与预期不符。

解决方法：

  1. 打开 Settings → Payment。
  2. 检查 Opera PMS Payment Mapping。
  3. 验证 Default Comment Type / Location。
  4. 再次保存映射。
  5. 测试另一笔 Opera 支付或押金。

房费被意外免收​

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

解决方法：

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

住宿政策控件不可用​

你会看到： 看不到 Accommodation Charge Policies，或者 AVA 显示 PMS 不受支持的消息。

解决方法：

  1. 确认 PMS 供应商支持住宿支付政策。
  2. 刷新 Settings → Payment。
  3. 如果控件仍未显示，说明 AVA 尚无该 PMS 的支持数据。
  4. 保留已有政策值。编辑器隐藏时，AVA 仍会保存这些值。

账单行与 PMS 不匹配​

你会看到： AVA 中的房费、税费、押金或附加项行看起来不同。

解决方法：

  1. 确认预订来自支持 AVA 账单规则的 PMS。
  2. 如果使用 Opera，请等待下一次预订同步。
  3. 刷新 Settings → Payment 或重新打开预订。
  4. 检查 PMS 账单，确认该行是否被隐藏或免收。

Mews 包含的产品需要审核​

你会看到： 匹配房型套餐免收后，某个 Mews 套餐产品需要审核。

原因： AVA 无法证明该产品的分类。

解决方法：

  1. 通过 Staff Access 打开预订。
  2. 在 Mews 中查看预订费率、包含的产品和完整发票。
  3. 确认预订匹配已配置的住宿政策。
  4. 在 AVA 中刷新预订。
  5. 不要收取未经验证的金额。
  6. 请前台工作人员查看完整的 Mews 发票。

客人在支付前被转到前台​

你会看到： 客人在查询预订后无法继续。 AVA 要求客人前往前台。

原因： 支付政策匹配，但 Mews 无法对受管控的费用进行分类。

解决方法：

  1. 查看 Mews 费率、包含的产品和完整发票。
  2. 确认 Accommodation Charge Policies 中的匹配值。
  3. Mews 完成同步后刷新预订。
  4. 通过完整的 Mews 发票确认应付金额。
  5. 仍需审核时，请前台工作人员完成入住。

不要收取未经验证的金额。

客人未被要求支付​

你会看到： 客人在入住期间跳过支付。

解决方法：

  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 并验证币种。

结账四舍五入不可用​

你会看到： Enable Rounding Adjustment 没有显示。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认当前 PMS 供应商。
  3. AVA 和 Opera 支持结账四舍五入。
  4. Cloudbeds、Mews、eZee 和 Furama 当前不支持。
  5. 更改 PMS 连接后刷新 Settings → Payment。
  6. 如果 AVA 或 Opera 仍隐藏该控件，请联系支持团队。

四舍五入调整仍未生效​

你会看到： Rounding adjustment 仍显示为灰色，或已保存的值没有改变支付行为。

解决方法：

  1. 打开 Settings → Check-In → Check-In Policy。
  2. 打开 Check-in outstanding-balance blocking 或 Checkout balance settlement。
  3. 保存设置。
  4. 返回 Settings → Payment，确认四舍五入值仍已保存。

仍然无法解决？​

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

  • ❌ 重新保存设置后支付仍然失败
  • ❌ 客人看不到账单视图变化
  • ❌ 对于受支持的 PMS，延迟捕获控件仍不可用
  • ❌ Opera 映射值无法保留
  • ❌ Stripe 或 Red Dot 连接反复断开

建议一并提供：

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