管理预订支付
在预订弹窗中使用 Payments。大多数检查都能在 3 分钟内完成。
本指南帮助你查看余额、扣款并读取 folio 详情。 如果你处理的是退房支付,先看账单提示再继续会更稳妥。
| 项目 | 显示内容 | 使用位置 |
|---|---|---|
| Payment Summary | 已付金额、预授权、交易 ID | 预订卡片 |
| Folio Details | 应付余额、消费、押金、付款 | 预订弹窗 |
| Capture Payment | 扣取已授权的付款 | 预订弹窗 |
| Source | folio 条目的来源 | folio 面板 |
支付收款如何运作
- 支付规则来自 Settings → Payment。
- 物业币种来自 Settings → Essentials → Hotel Basic Details。
- 酒店可以收取押金、房费、退房付款,或三者都收。
- 当仍有余额时,AVA 可以在退房时显示账单。
- 如果关闭收款,入住会跳过支付步骤。
- 后台门户会显示来自支付网关的支付数据。
- 如果退房账单被免收但仍有正余额,AVA 不会创建退房付款。
- 请把客人交给前台复核。
查看支付信息
预订卡片上的 Payment Summary
在卡片视图中查看预订时,每张卡都会显示:
- Paid:该预订的已付总额
- Pre-auth:预授权金额(如适用)
- Transaction ID:支付网关参考号,带复制按钮
当有支付数据时,这个摘要会自动显示。
AVA 会先用预订展示币种显示 Paid 和 Pre-auth。 如果该币种缺失,AVA 会使用支付摘要币种。 如果两者都缺失,AVA 会回退到酒店物业币种。
Command Center 中的支付阶段
启用支付集成后,Command Center 会在入住和退房流程中显示支付阶段。
- Check-In Payment Stage:入住进度中的徽标
- Checkout Payment Stage:退房进度中的徽标
- 徽标会显示 Pending、Completed 等状态指示
只有在支付集成已启用时,才会出现支付阶段。 如果设置为 "DISABLE",入住和退房都会跳过支付阶段。
预订弹窗中的详细支付信息
点击任意预订即可打开预订详情弹窗。 此视图可从以下页面进入:
- Check-Ins page:点击任意预订卡片或表格行
- Checkouts page:点击任意退房卡片
- Stayovers page:点击任意住店卡片
- Calendar view:点击任意预订块
- Command Center page:点击任意预订
在 Financials 中查看:
- Balance Due:当前未结余额
- Deposit Payment:押金详情
- Room Payment:房费详情
当 folio 访问可用时,Balance Due 会取自 PMS folio 摘要。 如果你的 PMS 是 AVA,Streamliner 也会把押金和房费同步到 folio 账本中。 同步会发生在支付摘要、账单视图和扣款流程中。
你可以展开 Folio Details 查看:
- Room Charges
- Extras
- Taxes
- Deposits
- Payments
folio 面板还会显示 Fidelity 徽标、Last synced 和 Source 字段。 Source 标签会被翻译,不会显示后端原始 token。 你可能会看到 AVA ledger、Invoice-backed 或本地化标签。 如果你的 PMS 不支持 folio 详情,AVA 会保留快照余额并显示提供商原因。
每条支付记录都会显示:
- 支付状态,例如 "Authorized" 或 "Captured"
- 支付金额和币种
- 支付方式,例如信用卡或现金
- 支付网关名称
- 网关参考号或交易 ID
- 卡片信息,例如品牌和后四位
支付类型
AVA 后台门户会跟踪三种支付:
- Deposit Payment:在入住前或入住时收取的押金
- Room Payment:房费和附加服务费用
- Checkout Payment:退房时收取的最终结算
退房账单复核
当 AVA 打开退房账单时,你可能会看到以下提示之一。
| 提示 | 含义 | 你该怎么做 |
|---|---|---|
| Existing balance | AVA 找到了一个已保留或未关闭的余额 | 确认金额并继续 |
| Different card | 客人想换另一张卡 | 开始新的付款流程 |
| Dispute | 客人对收费有争议 | 按照酒店的争议处理流程执行 |
如果付款页面把你带回 AVA,请等待验证消息完成。 退房界面可能会在验证完成前刷新。
终端付款重试
如果终端付款已经完成,AVA 会在重试时立即显示已付款状态。 这可以防止对同一笔有效付款重复扣款。
如果付款被取消或付款上下文已改变,AVA 可以启动新的终端流程。
扣款
如果你的支付网关支持,你可以在弹窗中扣取已授权的付款:
- 打开预订详情弹窗。
- 滚动到 Financials。
- 如果某笔付款已授权但尚未扣款,你会看到 Capture Payment。
- 点击 Capture Payment。
- 确认扣款操作。
- 等待结果更新。
只有尚未扣款的已授权付款才支持扣款。
扣款结果
完成扣款后,后台门户会显示:
- Payment captured:Yes 或 No
- Capture message:来自支付网关的详情或错误文本
如果结果没有立即出现,后台门户会轮询更新,最长 60 秒。
收款前要确认
- 在 PMS 或客人 folio 中确认预订余额。
- 检查该预订需要哪种付款方式。
- 确认支付网关已在 Settings → Payment 中连接。
- 确认支付集成已启用且未设为 "DISABLE"。
- 如果你正在退房,请先查看退房账单提示。
如果支付被阻止
- 确认支付网关已连接且处于活动状态。
- 确认酒店关于押金、房费或退房付款的政策。
- 检查退房账单是否被免收但仍有正余额。
- 对于被免收但仍有正余额的情况,请使用前台处理。
- 如有需要,请管理员查看 Settings → Payment。
- 检查支付集成类型是否未设为 "DISABLE"。
故障排查
付款后余额没有更新
你会看到: folio 余额仍显示旧金额。
解决方法:
- 重新打开预订弹窗。
- 在 Folio Details 中点击 Refresh。
- 扣款后等待 10-30 秒。
- 如果余额仍未变化,请刷新页面。
Paid 或 Pre-auth 显示的币种与预期不同
你会看到: 预订卡上的支付摘要金额显示了不同的币种代码。
解决方法:
- 打开预订并确认该预订的币种。
- 检查支付数据是否包含自己的币种。
- 如果两者都为空,请查看 Settings → Essentials → Hotel Basic Details 中的 Property Currency。
- 如果该字段由 PMS 管理,请在 PMS 中更新币种并等待同步。
- 刷新页面并确认币种显示已更新。
Folio 详情不可用
你会看到: folio 开关被禁用,或者预订显示快照余额。
解决方法:
- 确认你的 PMS 支持 folio 详情。
- 在预订详情弹窗中点击 Refresh。
- 如果提供商仍然提示不支持访问,请继续使用快照余额。
- 如果提供商原因看起来不正确,请联系支持。
退房付款返回后没有验证
你会看到: 付款页面返回了,但退房余额仍然像是未结清。
解决方法:
- 等几秒让 AVA 验证付款。
- 检查终端或托管收据。
- 刷新预订或退房界面。
- 仅当付款失败时再重试。
仍然卡住?
如果出现以下情况,请联系 success@vouch-technologies.com:
- ❌ 刷新后 folio 余额仍然错误
- ❌ 扣款完成后弹窗始终不更新
- ❌ Source 标签仍然显示意外文本
- ❌ 退房账单提示一直循环
- ❌ AVA 从未验证退房付款
建议附上:
- 预订 ID 或确认号
- 支付时间
- folio 面板截图