跳到主要内容

支付网关集成

快速设置

先在 Settings → Essentials → Hotel Basic Details 设置酒店的 Property currency，再配置支付网关和收款规则。

本指南帮助你在 Payment 设置页配置网关连接与收款规则。

入口位置​

Settings → Payment

快速参考​

设置区域控制内容主要结果
Payment Gateway IntegrationStripe 或 Red Dot 配置客人可在 Kiosk 流程中付款
Payment Collection Mode押金与全额支付开关控制客人在入住时支付内容
Property Currency（在 Settings → Essentials）押金与预订支付展示的生效币种保持设置页与运营页金额一致
Opera Payment Mapping结算、收银员、支付类型映射确保 Opera 正确接收支付入账
Opera Payment Policy Controls舍入、预授权、免收/隐藏逻辑强制执行 Opera 专属支付行为

开始前准备​

  • 准备好支付网关账户
  • 确定要收押金、收全额，或两者都收
  • 在 Settings → Essentials → Hotel Basic Details 确认押金策略与酒店币种来源
  • 如使用 Opera，准备好收银和支付映射参数

分步设置​

第 1 步：选择支付网关​

  1. 前往 Settings → Payment。
  2. 在 Payment Gateway Integration 选择 Stripe 或 Red Dot Payment。

Stripe​

  1. 点击 Connect Stripe。
  2. 完成 Stripe 开通流程。
  3. 返回 Streamliner，确认 Stripe 已连接。

Red Dot Payment​

  1. 输入 Merchant ID。
  2. 输入 Secret Key。
  3. 选择 Environment（TEST 或 LIVE）。
  4. 点击 Save Payment Gateway Settings。

第 2 步：选择收款选项​

开关作用
Collect Security Deposits入住时预授权押金
Collect Full Payment入住时收取未结余额
  1. 开启一个或两个开关。
  2. 若两个都关闭，入住流程不会要求付款。
  3. 点击 Save Payment Gateway Settings。

第 3 步：配置押金明细（若已启用）​

  1. 输入 Deposit Amount。
  2. 选择 Deposit Type（按每晚或固定金额）。
  3. 点击 Save Payment Gateway Settings。
押金币种来源

支付设置使用 Settings → Essentials → Hotel Basic Details 中解析后的 Property Currency。 若币种由 PMS 提供，AVA 会使用 PMS 币种并锁定本地编辑。

第 4 步：配置 Opera 支付映射（仅 Opera）​

  1. 在 Step 3: Configure Opera PMS Payment Mapping 中设置：
    • Settlement Code
    • Default Cashier ID
    • Default Comment Type / Location
    • Payment Type to Payment Method Code 行映射
  2. 点击 Save Opera Payment Mapping。

第 5 步：配置 Opera 支付策略控制（仅 Opera）​

  1. 在 Opera Payment Policy Controls 中设置支付行为：
    • 发票可见性与退房校验
    • 舍入调整与交易代码
    • 自动延迟扣款选项
    • 免收 / 隐藏 / 不收款规则列表
  2. 点击 Save Payment Policies。

保存后预期结果​

  • ✅ 完成后会显示已连接网关详情
  • ✅ 启用押金后会显示押金字段
  • ✅ 仅当 PMS 提供商为 Opera 时显示 Step 3: Configure Opera PMS Payment Mapping
  • ✅ 仅当 PMS 提供商为 Opera 时显示 Opera Payment Policy Controls
  • ✅ 同页中的支付设置可独立保存
  • ✅ 保存 Settings → Check-In → Check-In Policy 不会清空已保存的 Opera 映射值
迁移说明

支付设置已从 Settings → Essentials 迁移至 Settings → Payment。

故障排查​

网关设置不可用​

现象： 支付开关或保存按钮不可点击。

处理方法：

  1. 确认当前账号有设置写入权限。
  2. 若选择 Stripe，请先连接 Stripe。
  3. 刷新页面后重试。

未显示 Opera 第 3 步​

现象： 未显示 “Step 3: Configure Opera PMS Payment Mapping”。

处理方法：

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认当前 PMS 提供商为 Opera。
  3. 在 PMS 设置中点击 Save。
  4. 返回 Settings → Payment 并刷新一次。

客人未被要求付款​

现象： 客人在入住流程中跳过付款。

处理方法：

  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 并刷新。

相关设置​

仍未解决？​

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

  • ❌ 重新保存后支付仍失败
  • ❌ Opera 映射值无法持久保存
  • ❌ Stripe 或 Red Dot 连接反复断开

建议附上：

  • Settings → Payment 截图
  • PMS 提供商名称
  • 示例预订 ID 与时间戳