管理预订支付
在预订弹窗中使用 Payments。大多数检查可在 3 分钟内完成。
本指南帮助你查看余额、收取付款并阅读 folio 详情。
| 项目 | 显示内容 | 使用位置 |
|---|---|---|
| Payment Summary | 已支付金额、预授权、交易 ID | 预订卡片 |
| Folio Details | 应付余额、费用、押金、付款 | 预订弹窗 |
| Capture Payment | 捕获已授权的付款 | 预订弹窗 |
| Source | folio 项目的来源 | Folio 面板 |
支付收取方式
- 支付规则来自 Settings → Payment。
- 物业币种来自 Settings → Essentials → Hotel Basic Details。
- 酒店可以收取押金、房费、退房付款,或三者全部收取。
- 当仍有余额时,AVA 可以在退房期间显示退房账单。
- 如果关闭了支付收取,入住时会跳过支付。
- 后台门户会显示支付网关中的支付数据。
- 如果评估后的应付余额仍为正数,AVA 可以请求退房付款。
- 如果 PMS 未评估账单,AVA 会使用常规摘要或已存储的余额。
- 已验证的 Mews 含费率产品可以遵循房间套餐免收规则。
- Mews 住宿免收后,当所有正数费用部分都是住宿费用时,AVA 会隐藏正数 THB 0.01 的舍入余数。
- 实际的 Mews 额外项目和未分类费用仍需支付,包括实际的 THB 0.01 额外项目。
- 如果酒店使用 PMS 终端支付,AVA 会通过 PMS 终端流程发送预授权。
- 受支持的 AVA 和 Opera PMS 连接可以对小额余额应用退房舍入。
查看支付信息
预订卡片上的 Payment Summary
在卡片视图中查看预订时,每张卡都会显示:
- Paid:该预订已支付的总金额
- Pre-auth:预授权金额(如适用)
- Transaction ID:支付网关参考号,并带有复制按钮
只要有支付数据,此摘要就会自动显示。
AVA 会优先使用预订显示币种展示 Paid 和 Pre-auth。 如果该币种缺失,AVA 会使用支付摘要币种。 如果两者都缺失,AVA 会回退到酒店物业币种。
如果使用 Opera,预订卡片可能会显示最多缓存 30 秒的余额。 新支付完成后,打开预订弹窗查看实时余额。
Command Center 中的支付阶段
启用支付集成后,Command Center 会在入住和退房流程中显示支付阶段。
- Check-In Payment Stage:入住进度中的徽标
- Checkout Payment Stage:仍适用退房付款时,退房进度中的徽标
- 徽标会显示待处理或已完成等状态指示
只有启用支付集成时才会显示支付阶段。 如果设置为 "DISABLE",入住和退房都会跳过支付阶段。 完成无需支付或零余额退房后,退房付款也会继续隐藏。 如果 AVA 已记录退房付款尝试,该阶段会继续显示。 Room Payment 徽标仅记录入住房费付款或预授权凭据。 退房付款不会使用 Room Payment 徽标。
预订弹窗中的详细支付信息
点击任意预订即可打开预订详情弹窗。 该视图可从以下位置打开:
- Check-Ins page:点击任意预订卡片或表格行
- Checkouts page:点击任意退房卡片
- Stayovers page:点击任意续住卡片
- Calendar view:点击任意预订块
- Command Center page:点击任意预订
在 Financials 中查看:
- Balance Due:当前未结余额
- Deposit Payment:已收押金详情
- Room Payment:房费详情
当 PMS 返回评估后的应付金额时,Balance Due 使用该金额。
否则,Balance Due 来自 PMS folio 摘要或已存储的快照。
对于单个预订,预订弹窗会获取当前余额。
如果你的 PMS 是 AVA,Streamliner 还会将押金和房费同步到 folio 账本。
同步会在支付摘要、账单视图和捕获流程中进行。
当 AVA 应用账单规则时,被隐藏的房费和税费行会显示为 ✅。
应付金额仍保持数值,并在完成评估后控制支付。
对于 Opera 房间套餐免收,AVA 会先免收房费、房内服务费和房间 GST。
对于到店前 Opera 预测,预测房费及其费率信息中的税费会一起免收。
单独记账的额外项目及其税费仍可收取。
Opera 明确返回的零余额始终优先于可见的房费、税费或服务费行。
即使路由或已结算的对应项目未显示在住客 folio 中,这一点仍然成立。
只有当金额和币种与标准化后的 Opera 账单匹配时,AVA 才信任该零余额。不匹配时仍视为未确认。
Opera 付款冲销在账单复核中会保留负号。
因此,一笔付款和一笔等额冲销在 folio 和应付余额中会相互抵销为零。
已验证的 Mews 含费率产品(例如捆绑早餐)可以遵循住宿免收规则。
附加到已验证含费产品的相对定价费用也可以遵循该免收规则。
住宿免收后,AVA 会隐藏由每晚服务费舍入造成的正数 THB 0.01 余数。
仅当每个正数费用部分都是住宿费用时才适用。
实际的额外项目和未分类费用仍需支付。
如果 AVA 无法证明分类,会暂扣未验证金额供员工复核。
收款前请将金额与实时 Mews 账单进行比较。
当 PMS 返回评估后的应付判定时,AVA 会使用其金额和币种作为房费支付依据。 如果判定因其他原因未完成评估,AVA 可能会保留已存储的快照。 Mews 的结论不明免收不会使用未验证金额。 收款前请前台员工复核完整发票。 启用房费收取后,AVA 可以在查找预订期间将住客引导至前台。
Furama 将每个房间存储为单独的 PMS 订单。 AVA 会合并入住期间所有房间的费用和付款,以计算全住期余额。 记账或发布 folio 费用前,请打开所选房间的行或卡片。 AVA 会将写入操作发送到该房间的 Furama 订单。 如果无法识别房间,AVA 会停止操作。
你可以展开 Folio Details 查看:
- Room Charges
- Extras
- Taxes
- Adjustments
- Deposits
- Payments
在账单摘要中,Deposits 和 Payments 会显示为负数。 这只是展示方式,因此 Balance Due 不会改变。 由发票支持的 PMS folio 还可能显示 Adjustments。 这些是 PMS 返回的费率变更或保留修正。 AVA 会将其纳入账单部分,因此可见行会与显示的余额相符。 调整金额可能是含税后的净额,而 PMS 会保留含税总额审计值。 检查 folio 总额时,请使用显示的部分金额。 部分酒店使用简化账单摘要视图。 此时你会看到隐藏的房费和税费行。 你还会看到 Extras 分隔线。 额外项目会按代码分组。 Room Charges、Tax 和总额仍然可见。
folio 面板还会显示 Fidelity 徽标、Last synced 和 Source 字段。 来源标签会被翻译,而不是显示原始后台 token。 你可能会看到 AVA ledger、Invoice-backed 或本地化标签。 如果你的 PMS 不支持 folio 详情,AVA 会保留快照余额并显示提供方原因。
每条支付记录都会显示:
- 支付状态,例如 "Authorized" 或 "Captured"
- 支付金额和币种
- 支付方式,例如信用卡或现金
- 支付网关名称
- 网关参考号或交易 ID
- 卡片信息,例如品牌和末四位数字
手动修改费率后复核费率调整
如果员工在 PMS 中重新设置预订费率,之前的费率保留调整可能仍然存在。 该调整会抵销原始房费,可能不再与新费率匹配。 AVA 现在会将该行保留在 Adjustments 下。
-
打开预订的 Folio Details。
-
展开 Adjustments,将该行与当前房费进行比较。
-
在 PMS 中打开预订,确认当前费率和调整。
-
当旧调整不再抵销房费时,在 PMS 中删除它。
-
在 AVA 中刷新 Folio Details。
✓ PMS 更新后,folio 各部分和 Balance Due 应当相符。
不要发布新的手动折扣来隐藏无法解释的余额。 请先检查 PMS 费率和现有调整。
支付类型
AVA 后台门户跟踪三类支付:
- Deposit Payment:入住前或入住时收取的预付款
- Room Payment:房费及附加服务费用
- Checkout Payment:退房期间收取的最终结算款
退房账单复核
当 AVA 打开退房账单时,你可能会看到以下提示之一。
| 提示 | 含义 | 你的操作 |
|---|---|---|
| Existing balance | AVA 找到已保留或未结的余额 | 确认金额并继续 |
| Different card | 客人想使用另一张卡 | 开始新的支付流程 |
| Dispute | 客人对费用有异议 | 按酒店的争议处理流程执行 |
如果支付页面将你带回 AVA,请等待验证消息。 退房页面可能会在完成前先刷新。
退房舍入调整
当 PMS 支持退房舍入时,AVA 可以接受小额退房余额。 余额必须在已配置的 Rounding Threshold 范围内。 该调整会在退房完成前发布。
| PMS 提供方 | 所需操作 |
|---|---|
| AVA | 启用调整。不需要供应商代码。 |
| Opera / OHIP | 启用调整,并将供应商代码保存到 Transaction Code (Rounding)。 |
| Cloudbeds、Mews、eZee 和 Furama | 在 PMS 或前台结清余额。 |
请参阅退房舍入设置。
终端支付重试
终端接受退房付款后,AVA 会立即开始轮询状态。 如果终端支付已经完成,AVA 会在重试时立即显示已支付状态。 这可以避免对同一笔有效支付重复扣款。
如果支付已取消,或支付上下文发生变化,AVA 可以启动新的终端流程。
更换退房卡
如果客人选择 Different card,AVA 会开始新的退房支付。 该支付成功后,AVA 会在网关后台取消之前可重复使用的退房预授权。 这项取消操作在后台进行,因此退房可以先完成。 如果网关回调稍后到达,旧预授权会在同步后清除。
PMS 终端预授权
如果酒店使用 PMS 终端支付,AVA 会通过 PMS 终端流程发送请求。
- AVA 会在发送请求前在本地解析支付金额。
- 旧版
OPI终端设置仍可作为 PMS Terminal 使用。 - 对预订预授权和入住支付步骤使用此流程。
- 退房仍使用已映射的 Stripe 终端或网关流程。
捕获付款
如果支付网关支持,你可以在弹窗中捕获已授权的付款:
- 打开预订详情弹窗。
- 滚动到 Financials。
- 如果某笔支付已授权但尚未捕获,点击 Capture Payment。
- 确认捕获操作。
- 等待结果更新。
只有尚未捕获的已授权付款才可以捕获。
支付捕获结果
捕获付款后,门户会显示:
- Payment captured:是或否
- Capture message:网关返回的详情或错误文本
如果结果没有立即出现,门户会轮询最长 60 秒。
收款前
- 确认 PMS 或住客 folio 中的预订余额。
- 检查该预订需要哪种支付方式。
- 确认支付网关已在 Settings → Payment 中连接。
- 验证支付集成已启用且未设置为 "DISABLE"。
- 如果正在退房,先查看退房账单提示。
如果支付被阻止
- 确认支付网关已连接且处于活动状态。
- 确认酒店关于押金、房费或退房付款的政策。
- 检查免收后评估的应付余额是否仍为正数。
- 启用支付收取后,通过退房流程收取剩余余额。
- 如有需要,让管理员检查 Settings → Payment。
- 确认支付集成类型未设置为 "DISABLE"。
故障排查
支付后余额没有更新
你会看到: folio 余额仍显示旧金额。
解决方法:
- 重新打开预订弹窗。
- 在 Folio Details 中点击 Refresh。
- 捕获付款后等待 10-30 秒。
- 如果余额仍未变化,刷新页面。
Opera 付款和冲销没有抵销为零
你会看到: Opera 显示付款和匹配的冲销,但 AVA 显示正余额。
解决方法:
- 确认两条记录属于同一个 Opera folio 窗口。
- 在 Opera 中确认付款和冲销金额大小相等、正负相反。
- 在 Folio Details 中点击 Refresh。
- 确认 Opera Window 1 的余额和币种与 AVA 匹配。
- 刷新后金额仍不一致时,请联系支持。
Paid 或 Pre-auth 显示的币种与预期不符
你会看到: 预订卡片上的支付摘要金额显示了不同的币种代码。
解决方法:
- 打开预订并确认预订币种。
- 检查支付数据是否包含自己的币种。
- 如果两者都为空,请查看 Settings → Essentials → Hotel Basic Details 中的 Property Currency。
- 如果该字段由 PMS 管理,请在 PMS 中更新币种并等待同步。
- 刷新页面并确认币种显示已更新。
Folio 详情不可用
你会看到: folio 开关被禁用,或预订只显示快照余额。
解决方法:
- 确认你的 PMS 支持 folio 详情。
- 在预订详情弹窗中点击 Refresh。
- 如果提供方仍报告不支持访问,请继续使用快照余额。
- 如果提供方原因看起来不正确,请联系支持。
余额与可见 folio 行不匹配
你会看到: AVA 显示余额不匹配警告,或 folio 总额看起来不符合预期。
原因: PMS 费率变更可能留下了与旧费率关联的调整。
解决方法:
-
在 Folio Details 中展开 Adjustments。
-
将该调整与 PMS 中当前房费进行比较。
-
如果调整已无效,请在 PMS 中删除它。
-
等待 PMS 更新,然后在 AVA 中点击 Refresh。
-
在 PMS 和 AVA 的总额一致前,不要收取付款。
✓ 可见的各个部分应当能够解释显示的余额。
Mews 含费产品需要复核
你会看到: 匹配房间套餐免收后,捆绑的 Mews 产品需要复核。
原因: AVA 无法证明该产品的分类。
解决方法:
- 复核 Mews 费率、含费产品和完整发票。
- 确认预订符合已配置的住宿政策。
- 等 Mews 完成同步后刷新预订。
- 不要收取未验证金额。
- 请前台员工复核完整的 Mews 发票。
- 如果金额仍不一致,请联系 AVA 支持。
退房支付返回后未验证
你会看到: 支付页面已返回,但退房余额仍显示未结。
解决方法:
- 等待几秒,让 AVA 验证支付。
- 检查终端或托管收据。
- 刷新预订或退房页面。
- 只有支付失败时才重试。
小额退房余额未调整
你会看到: 付款后仍有小额余额,或退房被阻止。
解决方法:
- 确认当前 PMS 支持退房舍入。
- 确认 Settings → Check-In → Check-In Policy 中已启用余额政策。
- 确认 Settings → Payment 中的 Enable Rounding Adjustment 已开启。
- 如果使用 Opera,确认供应商代码已保存到 Transaction Code (Rounding)。
- 刷新预订并检查 PMS 实时余额。
当提供方不支持退房舍入时,请使用 PMS 或联系前台。
旧预授权仍显示为未结
你会看到: 客人使用新卡付款后,之前的预授权仍然显示。
解决方法:
- 等待几分钟,等待网关取消回调。
- 刷新预订弹窗。
- 如果旧预授权仍未关闭,请联系支持。
仍然卡住?
如果出现以下情况,请联系 success@vouch-technologies.com:
- ❌ 刷新后 folio 余额仍然错误
- ❌ 捕获完成,但弹窗始终不更新
- ❌ 来源标签仍显示意外文本
- ❌ 退房账单提示一直循环
- ❌ AVA 始终没有验证退房付款
建议附上:
- 预订 ID 或确认号
- 支付时间
- folio 面板截图