跳到主要内容

支付网关集成

快速设置

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

本指南帮助你在 Settings → Payment 中设置支付和账单规则。 结账四舍五入只能在本页面配置。 Check-In 页面和 Assisted Check-In Setup 向导不包含四舍五入控件。 如果你使用 Stripe，请在连接前先选择 Live 或 Test。 网关 Stripe 凭据保留在支付卡片上。 终端的手动凭据保留在终端配置卡上，并且只使用测试密钥。 如果你的酒店使用手动 Stripe 测试凭据，网关卡和终端卡会分别保存这些凭据。 请为每张已配置的卡使用 Stripe 测试密钥。 住宿收费政策与 PMS 提供的值匹配。 Opera 旅行社名称，例如 Booking.com (VCC)，也可以触发同样的免收。 对于 Opera 房型套餐免收，AVA 会先免收房费、房内服务费和房 GST。 对于到店前 Opera 预测，预测房费及其费率信息税费会一并免收。 单独入账的额外项目及其税费仍需支付。 对于 Mews，匹配费率中包含的已验证产品（例如套餐早餐）可以遵循住宿免收政策。 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押金和全额支付开关控制客人在入住时支付什么
Pre-arrival online payments房费和押金开关、电子邮件时间以及预授权场景控制到店前符合条件的在线支付
Accommodation Charge Policies用于免收或隐藏住宿费用的匹配值当 PMS 支持此能力时，控制住宿行和应付金额
AVA Billing Rules针对房费、税费、押金和附加项的 PMS 隐藏与免收信号将隐藏行显示为 ✅，保持应付总额为数字，并保留应付的额外项目
Property Currency（在 Settings → Essentials 中）用于押金和预订支付显示的解析后币种保持支付金额在各设置和操作中一致
Deposit Currency本页押金金额所使用的币种与其他支付设置一起保存
PMS Payment Mapping当 PMS 支持时按物业配置支付方式映射你的 PMS 会将已收款项记录在预期类别下
Checkout Rounding Adjustment小额余额容差和结账调整支持的 PMS 可以带小额余额完成结账
Pre-Authorization Controls从 Stripe 预授权延迟捕获房费当前 PMS 支持延迟捕获时显示
Opera-Specific Payment Controls结账验证、路由和不收款逻辑强制执行 Opera 专用支付行为
No Post Controls按旅程和押金政策控制 OPERA 入账限制应用下述优先级规则
四舍五入依赖项

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

基于能力的控件

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

PMS 终端可用性

只有当前 PMS 能力支持 PMS 终端选项时，AVA 才会显示该选项。 对于旧版 ows 供应商，AVA 不提供 OPI 选项。 现有的受支持 PMS 终端设置会继续生效。

了解 v4 旅程中的 OPERA No Post​

快速设置

对于 v4 旅程，AVA 会先检查支付政策，然后检查匹配的 No Post 开关。 审核大约需要 2 分钟。

AVA 按照以下第一个匹配规则应用 No Post。

优先级适用情况结果
1已认证的 Assisted Check-In当双设备 ACI 支持此功能时，由员工选择决定；否则由已保存的默认设置决定。
2已启用支付且选择了 Do not collect 或押金为 0 的 kiosk 或符合条件的 Pre-arrival无论开关状态如何，均为 No Post
3已启用支付且需要押金的 kiosk由 Set No Post after Payment 决定；开启时，每位 kiosk 客人都会收到 No Post
4已关闭支付的 kiosk由 Set No Post after Payment 决定
5需要押金或未启用支付的 Pre-arrival遵循已配置的支付政策

对于 Assisted Check-In，AVA 会在押金规则之前检查已认证的员工设备决定。 伪造的 ACI 标头不能绕过客人政策。 该选择适用于该操作中由 PMS 办理入住的每个预订。 这包括主预订和新办理入住的共享客人。 该选择不会重新限制已经入住该房间的预订。 ACI 修复遵循 ACI 设置；kiosk 修复遵循 kiosk 规则。 较旧的 v2 行为保持不变。

当 Set No Post after Payment 关闭时，只有在未收取所需押金的情况下，kiosk 客人才会收到 No Post。 支付关闭时，只有 Set No Post after Payment 决定 kiosk 的结果。

选择 No Post 设置​

  1. 前往 Settings → Payment。

  2. 打开 Opera-Specific Payment Controls。

  3. 如果每位符合条件的 kiosk 客人都应收到 No Post，请保持 Set No Post after Payment 开启。

  4. 使用 Tick No Post by default on Assisted Check-In 预先选中员工选择。

  5. 检查 Deposit Collection 和 Do not collect，因为它们可能具有更高优先级。

  6. 点击 Save Payment Policies。

    ✓ AVA 会在下一次符合条件的旅程中使用已保存的设置。

设置被隐藏时

当支付已开启且选择了 Do not collect 时，AVA 会隐藏 Set No Post after Payment。 此时最高优先级规则已经强制应用 No Post。 AVA 会继续为 ACI 政策提供 Tick No Post by default on Assisted Check-In。

让双设备 ACI 员工做出决定​

当 OPERA 报告支持此功能时，经过验证的双设备员工 kiosk 会在 Proceed to Check-In 上方显示 Set No Post in the PMS。 已保存的设置会预先选中此复选框。 员工可以在办理入住前选中或清除此项。

该员工选择对本次 ACI 操作最终有效。 它适用于 OPERA 在该操作中办理入住的每个预订。 对于原子多房间入住，所有房间卡共用同一个选择。 押金设置不会覆盖此 ACI 选择。

单设备员工 kiosk 或客人平板不会显示此复选框。 这些流程使用已保存的设置。 较旧的员工版本也会继续使用已保存的设置。

Kiosk 共享客人

自助 kiosk 入住会将 No Post 应用于该操作中新置为在店状态的预订。 之后到店的同伴只会在其新预订上获得 No Post。 之后的客人加入时，AVA 不会重新限制该房间的预订。

No Post 是后续操作

即使 No Post 更新失败，OPERA 入住也可能成功。 请在 OPERA 中核实预订，并在需要时手动应用限制。 当 PMS 未声明支持 No Post 时，AVA 也会跳过该请求。

No Post 不可用​

你会看到： No Post 控件缺失，或结果与开关设置不一致。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认 Opera 是当前活动 PMS。
  3. 刷新 Settings → Payment。
  4. 检查支付是否已开启，以及是否选择了 Do not collect。
  5. 对于 ACI，确认你使用的是经过验证的双设备员工 kiosk。
  6. 检查旅程类型和匹配的 No Post 设置。
  7. 如果 Opera 已处于活动状态但优先级行为不正确，请联系支持团队。

当最高优先级规则始终适用时，AVA 会隐藏 Set No Post after Payment。 当 PMS 能力不可用或未验证时，AVA 也会隐藏 Opera 控件。

开始之前​

  • 准备好你的支付网关账户
  • 决定你要使用 Detailed 还是 Simplified 账单视图
  • 决定你要押金、全额支付，还是两者都要
  • 在 Settings → Essentials → Hotel Basic Details 中确认你的押金政策和物业币种来源
  • 确认你的 PMS 暴露住宿支付政策能力。如果 AVA 无法确认支持，控件会保持隐藏。
  • 如果需要 Auto Delay Capture，确认你的 PMS 暴露延迟预授权捕获支持。
  • 如果你使用 Opera，AVA 的账单规则首先在这里可用。
  • 如果你的 PMS 支持支付映射，请准备好收银员 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 测试凭据字段时使用此项。 手动 Stripe 网关凭据必须使用 Test 模式保存，并且三个凭据字段都必须填写。 你必须同时提供 Publishable Key、Secret Key 和 Webhook Secret。

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

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

仅填写完整的测试凭据

AVA 会拒绝不完整的手动网关保存操作。 保存被拒绝时，已有凭据会保持不变。 保存时，如果字段已被遮罩，请保持遮罩值不变。

终端结账

当某个 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。
Assisted Check-In 支付请求

在 Assisted Check-In 中，员工可以为每个房间请求押金、房费或两者。 当房间有应付金额时，两者默认都会选中。 员工可以在请求支付前取消任一项目。 没有应付金额的房间会继续流程，不会进入支付步骤。 Let assisted check-in staff collect payments 开关也必须开启。 该开关默认开启，不影响 Self Check-In 或 Pre-arrival。

对于单设备 ACI，员工选择 Check-in 后会出现支付请求。 设备会先返回员工界面，然后由客人完成支付。 对于双设备 ACI，员工会以 PAYMENT 步骤将支付发送到客人平板。 如果员工未发送任何支付项目，客人平板不会要求支付。

当在线网关和读卡器都可用时，客人可以选择 Pay online 或 Pay with Card Reader。 在线选项会显示 QR 码。 读卡器选项使用员工选择的终端。

ACI 支付选择按房间分别设置

开始支付前，请检查每个房间请求的项目。 AVA 不会要求员工为该房间取消的项目。

关闭 Assisted Check-In 支付请求​

当酒店在 AVA 外部收取 ACI 支付时，使用此设置。

  1. 前往 Settings → Check-In → Check-In Policy → Kiosk & payments。

  2. 关闭 Let assisted check-in staff collect payments。

  3. 选择 Save。

    ✓ ACI 不再将房间视为欠款。 ✓ 单设备 ACI 会继续直接办理入住。 ✓ 双设备 ACI 不会提供 PAYMENT 步骤。

该设置默认开启。 它仅影响 Assisted Check-In。 Self Check-In 和 Pre-arrival 支付规则保持不变。

更改何时生效

kiosk 会在下一个 Welcome 页面、新旅程或重新加载时载入更改。 已打开的平板支付可以完成，员工也可以跳过该步骤。

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

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

在输入金额前，请先选择 Pre-authorization hold。 启用此选项时，金额必须大于 0。 如要跳过安全押金，请改选 Do not collect。

未保存押金模式时的酒店默认设置

如果酒店从未保存过此设置，AVA 会显示 Do not collect。 如果物业需要押金，请选择其他模式并保存。

零金额不会启用押金

选择 Pre-authorization hold 时，如果 Deposit Amount 为空或为零，AVA 会拒绝保存。 内联消息会说明错误，并提供 Switch to "Do not collect" instead 选项。

网关连接要求

在支付网关连接之前，AVA 会禁用 Pre-authorization hold 和 Deposit Amount。 Do not collect 仍可用，因此你可以清除无效的押金配置。

押金币种来源

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

支付值检查

AVA 会在保存前检查支付值。字段可编辑时，请使用以下格式。

设置可接受的值
Deposit Currency三个大写字母，例如 USD 或 THB
Rounding Threshold大于或等于 0 的数字
Transaction Code (Rounding)大于或等于 0 的整数
Auto Delay Capture Expiry Days大于或等于 0 的整数

配置住宿收费政策​

当 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. 测试一笔匹配已配置值的预订。
基于能力的可见性

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

Opera 来源标签

如果 Opera 返回旅行社标签，AVA 可以匹配类似 Booking.com (VCC) 的值。

AVA 账单规则​

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

  • 当连接能力允许时，Mews 和 Opera 支持这些规则。
  • 隐藏的房费或税费行在详细账单中显示为 ✅。
  • 当供应商返回被免收的房费或税费行时，这些行仍会显示。
  • Mews v2 免收政策可以清除整张发票的收费行。
  • 已验证的 Mews 费率包含产品（例如套餐早餐）可以遵循房型套餐免收政策。
  • Mews 费率组规则仅适用于已预订费率组包含的产品。
  • 分配到其他费率组的产品仍需支付。
  • 相对于已验证包含产品定价的服务费可以遵循该免收政策。
  • 只有当 Mews 余额不超过 THB 0.01 且是免收后的住宿四舍五入残余金额时，才会隐藏该余额。
  • 未分类的正数费用和真正的额外项目仍需支付，包括真正的 THB 0.01 额外项目。
  • 对于 Opera 房型套餐免收，AVA 会先免收房费、房内服务费和房 GST。
  • 到店前预测的 Opera 房费及其费率信息税费会一并免收。
  • 单独入账的 Opera 额外项目及其税费可以继续支付。
  • 被免收的押金或附加项行会从应付总额中移除。
  • 评估后的应付金额决定结账时显示和收取的余额。
  • 如果账单因其他原因未完成评估，AVA 可能使用 PMS 摘要或已存快照。
  • Mews 无法确定的免收不会使用未经验证的金额；工作人员必须查看完整发票。
  • 启用房费收款后，AVA 可以在查询预订时将客人引导至前台。
  • 如果 AVA 无法证明产品分类，会扣留未经验证的金额供工作人员审核。
  • 即使可见的房费、税费或服务入账显示为正数，明确的 Opera 零余额仍保持为零。 当已路由或已结算的对应项目不可见时，同样适用。 只有当金额和币种与标准化 Opera 账单一致时，AVA 才信任该零余额。不匹配时仍视为未确认。
  • 简化账单会显示隐藏的房费和税费行、一个 Extras 分隔线，以及按代码分组的额外项目。
  • 当 PMS 完成同步时，预测账单行可能仍会显示。
  • 收款前，请将异常余额与 PMS 进行比较。
  • 没有政策匹配时，AVA 使用收到的账单响应。
能力分阶段开放

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

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

配置到店前在线支付​

使用此卡片让符合条件的客人在到店前在线支付。 前往 Settings → Payment → Pre-arrival online payments 查找此卡片。 该卡片位于 Billing View 和支付收款设置之后。 在 Settings → Check-In → Check-In Policy 中配置到店前长住规则。

设置控制内容要求
Enable pre-arrival room payment在到店前收取当前房费余额房费收款必须设置为 Pre-authorization hold 或 Direct sale charge
Enable pre-arrival deposit payment在到店前请求已配置押金的预授权押金收款必须设置为 Pre-authorization hold
Pre-auth validity (days)银行保留预授权有效的时长输入 1 至 365 天

  1. 打开 Settings → Payment → Pre-arrival online payments。

  2. 打开房费支付开关、押金支付开关，或同时打开两者。

  3. 收取押金时，输入 Pre-auth validity (days)。

  4. 查看第一封计划发送的电子邮件及其发送时间。

  5. 查看 Pre-auth scenarios 表格。

  6. 点击 Save。

    ✓ AVA 会分别保存房费和押金选项。 ✓ 客人在到店前会看到当前的房费和押金金额。

谨慎选择房费支付

当 PMS 能识别 OTA 已支付的预订或提供合适的费率计划时，启用房费支付。 这样有助于避免客人为 OTA 已收取的房费余额再次支付。

收款模式控制开关

当房费收款设置为 Do not collect 时，AVA 会禁用并清除房费开关。 当押金收款不是 Pre-authorization hold 时，AVA 会禁用并清除押金开关。

AVA 何时请求预授权

只有当支付邀请和入住时间都在有效期内时，AVA 才会请求预授权。 到店前天数加上入住晚数必须小于有效期。 当日期恰好等于过期边界时，AVA 会跳过请求。

了解房费支付时间​

当前页面不提供单独的直接销售时间控制。 房费支付邀请遵循计划发送的到店前电子邮件。

  1. 打开 Settings → Payment → Pre-arrival online payments。

  2. 查看第一封计划发送的电子邮件及其发送时间。

  3. 点击 Configure，在 Pre-arrival Emails 中调整计划。

  4. 查看场景表格中的每一封计划发送的电子邮件。

    ✓ AVA 对符合条件的房费和押金邀请使用计划电子邮件流程。

预授权时间

到店前支付开关默认关闭。 Pre-auth validity (days) 的默认值为 7。 当电子邮件时间和入住时长符合有效期时，AVA 会请求预授权。

支付类型和排除项

到店前支付使用受支持的在线网关。 到店前支付可以将符合条件的已选房间合并为一份在线支付报价。 AVA 在生成支付时会重新检查每个已选房间。 终端和现金支付方式仍不包括在内。 到店前支付不允许生成 QR 和终端支付。 所选的 Detailed 或 Simplified 账单视图会控制押金摘要。 启用后，直接销售房费支付遵循 Room collection。 押金支付仍遵循预授权有效期规则。

阅读预授权场景​

该表格显示每封计划发送的到店前电子邮件对应的 1 至 10 晚入住情况。 它帮助你了解银行冻结在该电子邮件发送时是否仍然有效。

表格列含义
Nights客人的入住时长，从 1 晚至 10 晚
Days to checkout计划发送邮件的到店前天数加上入住晚数
Request pre-auth?冻结是否在你的有效期设置内

当总天数小于 Pre-auth validity (days) 时，AVA 显示 ✅。 当总天数达到或超过有效期边界时，AVA 显示 ❌。 使用多封电子邮件时，每封计划邮件都会获得自己的结果。

例如，第一封邮件在到店前 5 天发送，入住 2 晚，则总计 7 天。 当有效期为 8 天时，AVA 会在该场景显示 ✅。

没有电子邮件计划

如果到店前电子邮件计划不可用或已禁用，卡片无法估算第一封邀请的时间。 点击电子邮件消息旁的 Configure 设置计划。

长住限制会禁用这些开关

如果启用了 Pre-arrival → Block long-stay reservations，AVA 会禁用两个开关。 AVA 还会清除已保存的到店前支付选项。 启用到店前在线支付前，请关闭该规则。

到店前支付设置不可用​

你会看到： 开关被禁用，或卡片显示收款不可用。

解决方法：

  1. 在 Settings → Payment 中确认网关已连接。
  2. 启用房费支付前，将房费收款设置为 Pre-authorization hold 或 Direct sale charge。
  3. 启用押金支付前，将押金收款设置为 Pre-authorization hold。
  4. 打开 Settings → Check-In → Check-In Policy。
  5. 如果合适，请关闭 Pre-arrival → Block long-stay reservations。
  6. 返回 Settings → Payment 并再次保存。
已支付的现有支付

AVA 接受已经支付的状态。 当相关房费或押金支付已经完成时，AVA 不会请求第二次支付。

第 5 步：配置 PMS 支付映射（受支持时）​

对于 Opera，请在 Opera PMS Payment Mapping 中设置以下字段：

  1. 设置：
    • Settlement Code
    • Default Cashier ID
    • Default Comment Type / Location
    • Payment Type to Payment Method Code 行
  2. 点击 Save Opera Payment Mapping。

AVA 会从当前活动的 Opera 物业加载这些选项。 AVA 会在不同实例中分别缓存每个列表，最长可达 30 天。 需要最新代码时，点击 Refresh from OPERA。 刷新列表会更新所有匹配的选择器，包括其他设置页面上的字段。

映射行如何工作

每一行将一种 AVA 支付方式关联到一个 Opera 支付方式代码。 AVA 会在下拉列表中显示活动的 Opera 支付方式。 列表包含每种方式的描述、卡类型和交易代码。 你无需单独维护 Opera 支付方式列表。 AVA 会把这些行与其他支付设置一起保存。

Opera 代码列表

Settlement Code 使用 Opera 交易代码。 Default Cashier ID 使用你 Opera 物业中的活动收银员。 支付方式行只能接受活动的 Opera 支付方式。 预订备注设置使用单独的 Opera 备注类型和位置列表。 每个列表分别加载，因此一个列表不可用不会隐藏其他列表。 如果某个列表不可用，AVA 会保留其他列表可用。 使用不可用列表的字段仍可手动输入。

过期映射恢复

对于 Opera 卡支付，AVA 首先读取权威的 Vouch Core 映射。 这样，刚刚保存的映射可以在支付入账前生效。 如果 Core 暂时不可用，AVA 可以使用有效的近期本地映射。 如果 AVA 找不到可用的 Opera 映射，会刷新一次配置。 只有在尚未发送 Opera 支付请求时，AVA 才会重试支付。

检查已保存的代码

AVA 会保留 Opera 不再提供的已保存代码，但会将其标记为不可用。 使用该代码的支付不会入账到 Opera。 收款前，请将标记的代码替换为活动选项。

较旧的 web-be-pms 版本

如果你的 Opera 服务不提供结算代码，该字段会保持为自由文本。 其他可用列表仍可使用下拉菜单。

Opera 支付备注默认值

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

基于能力的可用性

映射区域可能保留 Opera 专用措辞。 其可见性取决于当前 PMS 集成提供的支付映射能力。

配置 Mews 支付方式映射​

当已收取的支付方式必须显示在特定的已启用 Mews 支付类别下时，使用 Mews 映射。 未配置的支付方式会保留其正常的 AVA 入账行为。

  1. 在 Settings → Essentials → PMS Integration 中确认 Mews 是当前活动 PMS。

  2. 前往 Settings → Payment。

  3. 找到 Mews Payment Method Mappings。

  4. 从当前支付目录中选择来源支付方式。 来源可以包括 PromptPay、卡品牌、电子钱包或自定义来源代码。

  5. 选择一个已启用的 Mews 外部支付类别作为目标。

  6. 仅当来源方式不同时，才添加另一行。

  7. 点击 Save。

    ✓ AVA 会在保存前对每个标准化来源各验证一次。 ✓ 后续 Vouch 入账会使用所选的 Mews 类别。

先检查 Mews 类别

目标类别必须已在 Mews 中为你的物业启用。 请让 Mews 管理员先启用该类别，再保存覆盖设置。 新的映射不会更改现有支付记录。

清除覆盖设置

移除来源行并保存，即可恢复该方式的默认入账行为。 这只会影响后续的 Vouch 入账。 请在 Mews 或你的会计报告中单独检查现有记录。

配置 Furama 支付方式映射​

当已收取的支付必须使用有效的 Furama iPMS 支付类型时，请使用 Furama 映射。 未配置的支付方式会保留其正常的 AVA 入账行为。

  1. 在 Settings → Essentials → PMS Integration 中确认 Furama iPMS 处于启用状态。

  2. 前往 Settings → Payment。

  3. 找到 Payment method mappings。

  4. 为每种支付方式在 Record as 下选择 Furama 支付类型。 卡支付方式按品牌映射，例如 Visa 或 Amex。 命名的非卡支付方式按方式映射，例如 Cash。

  5. 点击 Save Payment Gateway Settings。

  6. 如有需要，在 Furama PMS 设置中设置 Default payment type code (optional)。

  7. 点击 Save PMS Settings。

    ✓ 优先使用明确配置的映射。 ✓ 默认代码处理未明确映射的支付方式。 ✓ 两项设置都没有时，AVA 会在入账前拒绝未映射的支付。

验证 Furama 代码

Furama 的目录由控制单元共享，其中可能包含其他酒店的代码。 请选择经 Furama 管理员确认有效的代码。

清除 Furama 映射

选择 Use default 并保存，即可删除该支付方式的覆盖设置。 这只影响未来的入账。

第 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
  • ✅ 账单视图会与其他支付设置一起保存
  • ✅ 启用押金后会显示押金字段
  • ✅ 只有押金金额大于 0 时，预授权冻结才会保存
  • ✅ 点击 Save 后押金币种会继续保留
  • ✅ Auto Delay Capture 仅在当前 PMS 支持时显示
  • ✅ 当前 PMS 报告支持时，会显示 PMS 支付映射
  • ✅ Opera 策略区域仅对 Opera PMS 显示
  • ✅ 非 Opera PMS 的集成报告支持时，也可以显示支付映射卡片
  • ✅ 同一页面上的支付设置彼此独立保存
迁移说明

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

故障排查​

支付值验证失败​

你会看到： AVA 将支付字段标记为无效，或 MCP 返回 valid: false。

解决方法：

  1. 为 Deposit Currency 使用三个大写字母。

  2. 为 Rounding Threshold 输入 0 或更大的值。

  3. 为四舍五入代码和过期天数输入 0 或更大的整数。

  4. 修正字段，然后点击 Save。

  5. 对于 MCP，在应用更新前再次运行 settings_validate。

    ✓ 保存或应用更改前，验证结果应显示 valid: true。

网关设置被禁用​

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

解决方法：

  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 网关保存被拒绝​

你会看到： AVA 拒绝手动 Stripe 网关保存操作。

解决方法：

  1. 打开 Settings → Payment → Payment Gateway Integration。

  2. 将 Environment 设置为 Test。

  3. 提供全部三个字段：Publishable Key、Secret Key 和 Webhook Secret。

  4. 重新保存已有凭据时，保持遮罩值不变。

  5. 再次保存支付网关设置。

    ✓ AVA 会保存完整的测试配置。 ✓ 保存被拒绝不会替换已有凭据。

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。

Mews 映射选项不可用​

你会看到： Mews 映射卡片缺失，或来源和目标选项无法加载。

解决方法：

  1. 确认 Mews 是当前活动 PMS。
  2. 等 Mews 完成加载后，刷新 Settings → Payment。
  3. 确认支付目录和 Mews 配置可用。
  4. 如果卡片仍不可用，请联系支持团队。

在能够验证当前来源和目标选项之前，AVA 会禁用更改。

Mews 支付类别不可用​

你会看到： AVA 拒绝所选的 Mews 支付类别。

解决方法：

  1. 请 Mews 管理员为该物业启用此类别。
  2. 刷新 Settings → Payment。
  3. 从刷新后的列表中选择已启用的类别。
  4. 再次保存映射。

在映射成功保存前，请勿重试支付。

Furama 支付映射选项不可用​

你会看到： Furama 映射卡片缺失，或其支付选项无法加载。

解决方法：

  1. 确认 Furama iPMS 是当前活动 PMS。
  2. 确认 Furama 连接已保存。
  3. 刷新 Settings → Payment。
  4. 在 Settings → Essentials → PMS Integration 中检查 Control Unit。
  5. 请 Furama 管理员确认支付目录可用。

AVA 在能够读取当前来源和目标选项之前，会禁用映射更改。

Furama 拒绝支付类型​

你会看到： AVA 开始入账后，Furama 拒绝了一笔支付。

解决方法：

  1. 刷新 Payment method mappings。
  2. 将目标替换为有效的 Furama 支付类型。
  3. 确认该代码属于你所在物业的控制单元。
  4. 如有需要，为未映射的方式设置 Default payment type code (optional)。
  5. 保存两个设置页面。
  6. 仅重试一次支付。

不要使用标记为停用的代码，也不要使用其他物业目录中的代码。

支付过程中缺少 Opera 支付映射​

你会看到： 由于缺少卡品牌映射，Opera 支付无法开始。

原因： AVA 可能仍在使用较旧的本地 Opera 配置快照。

解决方法：

  1. 等待 AVA 完成自动配置刷新。

  2. 仅当 AVA 仍显示错误时，才重试支付。

  3. 在 Settings → Payment 中检查 Opera PMS Payment Mapping。

  4. 确认卡品牌有匹配的支付方式代码。

  5. 如果映射存在但支付仍无法开始，请联系支持团队。

    ✓ AVA 会在发送 Opera 支付请求前执行一次此刷新。

Opera 代码列表为空​

你会看到： 收银员、结算代码、备注类型、备注位置或支付方式列表为空。

解决方法：

  1. 确认当前 PMS 是 Opera。
  2. 检查该代码是否存在于 Opera 中且处于活动状态。
  3. 刷新 Settings → Payment。
  4. 如适用，选择其他可用代码。
  5. 如果列表仍为空，请联系 Opera 管理员。

AVA 会分别加载每个列表。其他映射字段仍可继续配置。

代码无法从 OPERA 加载​

你会看到： AVA 显示“无法从 OPERA 加载代码”。

解决方法：

  1. 确认 Opera 是当前活动 PMS。
  2. 检查 Opera 连接是否已配置且运行正常。
  3. 在 Opera PMS Payment Mapping 中点击 Try again。
  4. 当 AVA 保留字段可编辑时，手动输入代码。
  5. 如果列表仍不可用，请联系支持团队。

如果刷新失败，AVA 会保留之前读取的代码并显示刷新警告。 如果 Opera 返回部分结果，AVA 会保留成功加载的列表，并仅将缺失的列表标记为不可用。 除非 Opera 将有效的已保存映射标记为不可用，否则不要替换它们。

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. 保存后使用示例预订重新测试。

零押金金额无法保存​

你会看到： 由于押金金额为空或为 0，AVA 拒绝支付设置。

原因： Pre-authorization hold 需要正数金额。

解决方法：

  1. 打开 Settings → Payment → Security Deposits & Incidentals。
  2. 在 Deposit Amount 中输入大于 0 的金额。
  3. 点击 Save Payment Gateway Settings。

如果不想收取押金，请选择 Do not collect。 你也可以在内联错误消息中点击 Switch to "Do not collect" instead。

✓ AVA 会保存安全的收款选项，并停止请求零金额的预授权冻结。

押金币种不正确或无法编辑​

你会看到： 押金币种与预期设置不匹配，或字段更改无法保留。

解决方法：

  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 映射值无法保留
  • ❌ Mews 映射选项或支付类别仍不可用
  • ❌ Stripe 或 Red Dot 连接反复断开

建议一并提供：

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