跳到主要内容

支付网关集成

Quick Setup

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

本指南帮助你在 Settings → Payment 中设置收款和账单展示规则。 如果你使用 Stripe，请在连接前选择 Live 或 Test。

Where to Find It​

Settings → Payment

Quick Reference​

Setting AreaWhat It ControlsMain Outcome
Billing View详细或简化的客人账单摘要显示逐项明细行或更简短的摘要
Payment Gateway IntegrationStripe 或 Red Dot 设置客人可在 kiosk 流程中付款
Stripe EnvironmentStripe 网关和终端连接的 Live 或 Test 模式连接后会锁定
Payment Collection Mode押金和全额付款开关控制客人在入住时支付什么
Property Currency (in Settings → Essentials)押金和预订付款展示所用的已解析币种让各设置和操作中的付款金额保持一致
Deposit Currency本页押金金额使用的币种会与其他支付设置一起保存
Opera Payment Mapping结算、收银员和支付类型映射让 Opera 正确接收付款入账
Opera Payment Policy Controls舍入、预授权、免收和隐藏逻辑强制执行 Opera 专属的付款行为

Before You Start​

  • 准备好你的支付网关账号
  • 决定你想要 Detailed 还是 Simplified 账单视图
  • 决定你想收取押金、全额付款，还是两者都收
  • 在 Settings → Essentials → Hotel Basic Details 中确认你的押金政策和物业币种来源
  • 如果使用 Opera，请准备好收银员 ID 和支付方式代码映射

Step-by-Step Setup​

Step 1: Select a Payment Gateway​

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

For Stripe​

  1. 打开 Advanced。
  2. 选择 Live 或 Test。
  3. 点击 Connect Stripe。
  4. 完成 Stripe 开通流程。
  5. 返回 Streamliner，确认 Stripe 已连接。
Stripe mode

生产环境使用 Live，沙盒开通使用 Test。 Stripe 连接后，在你断开之前，环境会变为只读。

终端 Stripe 设置在连接前也默认使用 Live，除非你先手动更改。

Terminal checkout

当某个 kiosk 只有一个映射的 Stripe 终端时，AVA 会在结账时自动打开它。 当映射了多个终端时，你需要在付款弹窗的终端选择器中进行选择。 如果终端模式关闭，AVA 会继续使用网关或 QR 付款流程。

For Red Dot Payment​

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

Step 2: Choose Billing View​

使用此卡片来控制面向客人的账单摘要。 选择 Detailed 可显示逐项明细行。 选择 Simplified 则只显示 Room Charges、Tax 和总计。

  1. 前往 Settings → Payment。
  2. 在 Billing View 中，选择 Detailed 或 Simplified。
  3. 点击 Save。
Billing view placement

此卡片显示在支付页面的 Terminal Payment Configuration 之前。

Step 3: Choose Payment Collection Options​

ToggleWhat It Does
Collect Security Deposits在入住时预授权一笔押金
Collect Full Payment客人在入住时支付未结余额
  1. 打开其中一个或两个开关。
  2. 如果两个都关闭，入住时不会请求付款。
  3. 点击 Save Payment Gateway Settings。

Step 4: Configure Deposit Details (If Enabled)​

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

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

Step 5: Configure Opera Payment Mapping (Opera Only)​

  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。
How mapping rows work

每一行都会把一种支付方式关联到一个 OPERA payment method code。 AVA 会将这些行与其余支付设置一起保存。

Step 6: Configure Opera Payment Policy Controls (Opera Only)​

  1. 在 Opera Payment Policy Controls 中，设置付款行为：
    • 发票可见性和退房校验
    • 舍入调整和 transaction code
    • 自动延迟扣款选项
    • 免收、隐藏和不收款规则列表
  2. 点击 Save Payment Policies。
Opera payment comments

Opera 支付或押金成功入账后，AVA 会在 Opera 中添加一条预订备注。 这些操作会自动发生，不会改变 Streamliner 中的付款结果。

What to Expect After Save​

  • ✅ 设置完成后会显示已连接的网关详情
  • ✅ Stripe 连接状态徽标会显示 Live 或 Test
  • ✅ 账单视图会与其余支付设置一起保存
  • ✅ 启用押金后会显示押金字段
  • ✅ 点击 Save 后，押金币种会继续保留
  • ✅ 仅当 PMS 提供商为 Opera 时，才会显示 Opera 映射和 Opera 政策区域
  • ✅ 当当前活动 PMS 提供商为 Opera 时，会显示 Step 3: Configure Opera PMS Payment Mapping 卡片
  • ✅ 同一页面上的支付设置可独立保存
Migration Note

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

Troubleshooting​

Gateway settings are disabled​

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

Fix:

  1. 确认你的账号拥有 settings 写入权限。
  2. 如果选择了 Stripe，请先连接 Stripe。
  3. 刷新页面后重试。

Billing view does not change​

你会看到： 客人仍然看到旧的账单摘要布局。

Fix:

  1. 返回 Settings → Payment。
  2. 重新选择 Detailed 或 Simplified。
  3. 在 Billing View 卡片上点击 Save。
  4. 启动一个新的客人流程，或刷新预订界面。
  5. 如果仍然显示错误，请确认酒店使用的是当前的 CCI 设置路径。

Stripe environment is locked​

你会看到： Stripe 连接后，Environment 下拉框被禁用。

Fix:

  1. 断开 Stripe。
  2. 打开 Advanced。
  3. 选择 Live 或 Test。
  4. 重新连接 Stripe。

Opera sections do not appear​

你会看到： Opera 映射和政策卡片缺失。

Fix:

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认 PMS 提供商是 Opera。
  3. 返回 Settings → Payment。
  4. 刷新一次页面。
  5. 检查是否出现 Step 3: Configure Opera PMS Payment Mapping。

Opera payment mappings do not save​

你会看到： 点击 Save 后，你的收银员或支付方式行消失。

Fix:

  1. 打开 Settings → Essentials → PMS Integration。
  2. 确认 Opera 仍然是当前活动 PMS。
  3. 返回 Settings → Payment。
  4. 重新输入 Default Cashier ID 和每一行映射。
  5. 再次点击 Save Opera Payment Mapping。

Opera reservation comment is missing​

你会看到： 付款已成功入账，但在 Opera 中看不到新的预订备注。

Fix:

  1. 确认付款或押金在 Streamliner 中已成功完成。
  2. 检查 Opera 预订是否有匹配的付款记录。
  3. 仅当酒店政策允许时，才重新尝试该付款。
  4. 如果付款已入账但备注仍未出现，请联系支持。

Guests are not asked to pay​

你会看到： 客人在入住过程中跳过了付款。

Fix:

  1. 确认已连接支付网关。
  2. 确认已启用 Collect Security Deposits 或 Collect Full Payment。
  3. 确认该预订有应付余额。
  4. 保存后用示例预订重新测试。

Deposit currency looks wrong or cannot be edited​

你会看到： 押金币种与你预期不符，或者字段修改后没有保留。

Fix:

  1. 打开 Settings → Essentials → Hotel Basic Details。
  2. 检查 Property Currency 是由 PMS 管理还是可本地编辑。
  3. 如果由 PMS 管理，请在 PMS 中更新币种并等待同步。
  4. 刷新 Settings → Payment 并确认币种。

Still Stuck?​

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

  • ❌ 重新保存设置后付款仍然失败
  • ❌ 账单视图更改未对客人显示
  • ❌ Opera 映射值无法持久保存
  • ❌ Stripe 或 Red Dot 连接反复断开

Helpful to include:

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