支付网关集成
先配置支付网关，再设置押金和 Opera 支付政策规则。大多数酒店可在 5 分钟内完成。
本指南帮助你在新的 Payment 设置页中配置收款规则。
入口位置
Settings → Payment快速参考
| 设置区域 | 控制内容 | 主要结果 |
|---|---|---|
| Payment Gateway Integration | Stripe 或 Red Dot 设置 | 客人可在自助终端流程中付款 |
| Stripe Environment | Stripe 网关和终端连接的 Live 或 Test 模式 | 连接后会锁定 |
| Payment Collection Mode | 押金与全额付款开关 | 控制客人在入住时支付什么 |
| Property Currency（在 Settings → Essentials） | 用于押金和预订付款展示的已解析币种 | 让各设置和操作中的付款金额保持一致 |
| Deposit Currency | 本页押金金额使用的币种 | 与其他支付设置一起保存 |
| Opera Payment Mapping (Step 3 card) | 结算、收银员、支付类型映射 | 让 Opera 正确接收付款入账 |
| Opera Payment Policy Controls | 舍入、预授权、免收/隐藏逻辑 | 强制执行 Opera 专属的付款行为 |
开始前准备
- 准备好你的支付网关账号
- 决定是否收取押金、全额付款，或两者都收
- 在 Settings → Essentials → Hotel Basic Details 中确认你的押金政策和物业币种来源
- 如果使用 Opera，请准备好收银员 ID 和支付方式代码映射
分步设置
第 1 步：选择支付网关
- 前往 Settings → Payment。
- 在 Payment Gateway Integration 中选择 Stripe 或 Red Dot Payment。
对于 Stripe
- 打开 Advanced。
- 选择 Live 或 Test。
- 点击 Connect Stripe。
- 完成 Stripe 开通流程。
- 返回 Streamliner，确认 Stripe 已连接。
生产环境使用 Live，沙盒开通使用 Test。 Stripe 连接后，在你断开之前，环境会变为只读。
终端 Stripe 设置在连接前也默认使用 Live，除非你先手动更改。
当某个自助终端只映射了一个 Stripe 终端时，AVA 会在结账时自动打开它。 当映射了多个终端时，你需要在付款弹窗中从终端选择器里选择。 如果终端模式关闭，AVA 会继续使用网关或 QR 付款流程。
对于 Red Dot Payment
- 输入 Merchant ID。
- 输入 Secret Key。
- 选择 Environment（
TEST或LIVE）。 - 点击 Save Payment Gateway Settings。
第 2 步：选择收款选项
| 开关 | 作用 |
|---|---|
| Collect Security Deposits | 在入住时预授权押金 |
| Collect Full Payment | 在入住时收取未结余额 |
- 打开一个或两个开关。
- 如果两个都关闭，入住流程不会请求付款。
- 点击 Save Payment Gateway Settings。
第 3 步：配置押金明细（如已启用）
- 输入 Deposit Amount。
- 选择 Deposit Type（按晚或固定金额）。
- 如果看到 Deposit Currency，请选择酒店用于押金的币种。
- 点击 Save Payment Gateway Settings。
支付设置使用 Settings → Essentials → Hotel Basic Details 中解析后的 Property Currency。 如果 PMS 提供币种，AVA 会使用该值并锁定本地编辑。 你选择的 Deposit Currency 会与其他支付设置一起保存。
第 4 步：配置 Opera 支付映射（仅限 Opera）
- 在 Step 3: Configure Opera PMS Payment Mapping 中设置：
- Settlement Code
- Default Cashier ID
- Default Comment Type / Location
- Payment Type to Payment Method Code 行
- 点击 Save Opera Payment Mapping。
每一行都会把一种支付方式关联到一个 OPERA 支付方式代码。 AVA 会将这些行与其他支付设置一起保存。
第 5 步：配置 Opera 支付政策控制（仅限 Opera）
- 在 Opera Payment Policy Controls 中设置付款行为：
- 发票可见性和退房校验
- 舍入调整和交易代码
- 自动延迟扣款选项
- 免收 / 隐藏 / 不收款规则列表
- 点击 Save Payment Policies。
当 Opera 支付或押金成功入账后，AVA 会在 Opera 中添加一条预订备注。 这会自动完成，不会改变 Streamliner 中的付款结果。
保存后会看到什么
- ✅ 设置完成后会显示已连接的网关详情
- ✅ 启用押金后会显示押金字段
- ✅ 押金币种会在你点击 Save 后继续保留
- ✅ 仅当 PMS 提供商为 Opera 时，才会显示 Opera 映射和 Opera 政策区域
- ✅ 当当前活动 PMS 提供商为 Opera 时，会显示 Step 3: Configure Opera PMS Payment Mapping 卡片
- ✅ 同一页面上的支付设置可独立保存
支付设置已从 Settings → Essentials 移到 Settings → Payment。
故障排查
网关设置被禁用
你会看到： 支付开关或保存按钮被禁用。
处理方法：
- 确认你的账号有 settings 写入权限。
- 如果选择的是 Stripe，请先连接 Stripe。
- 刷新页面后重试。
Stripe 环境被锁定
你会看到： Stripe 连接后，Environment 下拉框被禁用。
处理方法：
- 断开 Stripe。
- 打开 Advanced。
- 选择 Live 或 Test。
- 重新连接 Stripe。
未显示 Opera 区域
你会看到： Opera 映射和政策卡片缺失。
处理方法：
- 打开 Settings → Essentials → PMS Integration。
- 确认 PMS 提供商是 Opera。
- 返回 Settings → Payment。
- 刷新一次页面。
- 检查是否出现 Step 3: Configure Opera PMS Payment Mapping。
Opera 支付映射无法保存
你会看到： 点击 Save 后，收银员或支付方式行消失。
处理方法：
- 打开 Settings → Essentials → PMS Integration。
- 确认 Opera 仍然是当前活动 PMS。
- 返回 Settings → Payment。
- 重新输入 Default Cashier ID 和每一行映射。
- 再次点击 Save Opera Payment Mapping。
Opera 预订备注缺失
你会看到： 付款已经成功入账，但在 Opera 中看不到新的预订备注。
处理方法：
- 确认付款或押金在 Streamliner 中确实已成功完成。
- 检查 Opera 预订是否有匹配的付款记录。
- 仅当酒店政策允许时，才重新尝试该付款。
- 如果付款已入账但备注仍未出现，请联系支持。
客人没有被要求付款
你会看到： 客人在入住过程中跳过了付款步骤。
处理方法：
- 确认已连接支付网关。
- 确认 Collect Security Deposits 或 Collect Full Payment 已启用。
- 确认该预订存在应付余额。
- 保存后用一条测试预订重新验证。
押金币种显示错误或无法编辑
你会看到： 押金币种与你预期不符，或者字段修改后没有保留。
处理方法：
- 打开 Settings → Essentials → Hotel Basic Details。
- 检查 Property Currency 是否由 PMS 管理，或者可以本地编辑。
- 如果由 PMS 管理，请在 PMS 中更新币种并等待同步。
- 刷新 Settings → Payment 并确认币种。
相关设置
仍然有问题？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 重新保存设置后付款仍然失败
- ❌ Opera 映射值无法持久保存
- ❌ Stripe 或 Red Dot 连接反复断开
建议附上：
- Settings → Payment 的截图
- PMS 提供商名称
- 示例预订 ID 和时间戳