Skip to main content

Payment Gateway Integration

Quick Setup

Set your payment gateway first. Then set deposit and Opera payment policy rules. Most hotels finish in 5 minutes.

This guide helps you set payment collection rules in the new Payment settings page.

Where to Find It​

Settings → Payment

Quick Reference​

Setting AreaWhat It ControlsMain Outcome
Payment Gateway IntegrationStripe or Red Dot setupGuests can pay in kiosk flows
Payment Collection ModeDeposit and full payment togglesControls what guests pay at check-in
Property Currency (in Settings → Essentials)Resolved currency for deposits and reservation payment displayKeeps payment amounts consistent across settings and operations
Opera Payment Mapping (Step 3 card)Settlement, cashier, payment type mappingOpera receives payment postings correctly
Opera Payment Policy ControlsRounding, pre-auth, waive/hide logicOpera-specific payment behavior is enforced

Before You Start​

  • Prepare your payment gateway account
  • Decide if you want deposits, full payment, or both
  • Confirm your deposit policy and property currency source in Settings → Essentials → Hotel Basic Details
  • If you use Opera, prepare your cashiering and payment mapping values

Step-by-Step Setup​

Step 1: Select a Payment Gateway​

  1. Go to Settings → Payment.
  2. In Payment Gateway Integration, select Stripe or Red Dot Payment.

For Stripe​

  1. Click Connect Stripe.
  2. Finish Stripe onboarding.
  3. Return to Streamliner and confirm Stripe is connected.

For Red Dot Payment​

  1. Enter Merchant ID.
  2. Enter Secret Key.
  3. Select Environment (TEST or LIVE).
  4. Click Save Payment Gateway Settings.

Step 2: Choose Payment Collection Options​

ToggleWhat It Does
Collect Security DepositsPre-authorizes a deposit during check-in
Collect Full PaymentGuests pay outstanding balance during check-in
  1. Turn on one or both toggles.
  2. If both are off, check-in does not request payment.
  3. Click Save Payment Gateway Settings.

Step 3: Configure Deposit Details (If Enabled)​

  1. Enter Deposit Amount.
  2. Choose Deposit Type (per night or flat amount).
  3. Click Save Payment Gateway Settings.
Deposit currency source

Payment settings use the resolved Property Currency from Settings → Essentials → Hotel Basic Details. If PMS provides currency, AVA uses that value and locks local edits.

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

  1. In Step 3: Configure Opera PMS Payment Mapping, set:
    • Settlement Code
    • Default Cashier ID
    • Default Comment Type / Location
    • Payment Type to Payment Method Code rows
  2. Click Save Opera Payment Mapping.

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

  1. In Opera Payment Policy Controls, set payment behavior:
    • Invoice visibility and checkout verification
    • Rounding adjustment and transaction code
    • Auto delay capture options
    • Waive / hide / no-collect rule lists
  2. Click Save Payment Policies.

What to Expect After Save​

  • ✅ Connected gateway details appear after setup
  • ✅ Deposit fields appear when deposits are enabled
  • ✅ Opera mapping and Opera policy sections appear only for Opera PMS
  • ✅ The Step 3: Configure Opera PMS Payment Mapping card appears when active PMS provider is Opera
  • ✅ Payment settings save independently on the same page
Migration Note

Payment setup moved from Settings → Essentials to Settings → Payment.

Troubleshooting​

Gateway settings are disabled​

What you see: Payment toggles or save buttons are disabled.

Fix:

  1. Confirm your account has settings write access.
  2. Connect Stripe first if Stripe is selected.
  3. Refresh the page and retry.

Opera sections do not appear​

What you see: Opera mapping and policy cards are missing.

Fix:

  1. Open Settings → Essentials → PMS Integration.
  2. Confirm PMS provider is Opera.
  3. Return to Settings → Payment.
  4. Refresh the page once.
  5. Check that Step 3: Configure Opera PMS Payment Mapping appears.

Guests are not asked to pay​

What you see: Guest skips payment during check-in.

Fix:

  1. Confirm a gateway is connected.
  2. Confirm Collect Security Deposits or Collect Full Payment is enabled.
  3. Confirm the reservation has a balance due.
  4. Save and retest with a sample reservation.

Deposit currency looks wrong or cannot be edited​

What you see: Deposit currency does not match your expected setting, or field changes do not persist.

Fix:

  1. Open Settings → Essentials → Hotel Basic Details.
  2. Check whether Property Currency is PMS-managed or editable.
  3. If PMS-managed, update currency in PMS and wait for sync.
  4. Refresh Settings → Payment and verify the currency.

Still Stuck?​

Contact success@vouch-technologies.com if:

  • ❌ Payments still fail after re-saving settings
  • ❌ Opera mapping values do not persist
  • ❌ Stripe or Red Dot connection repeatedly disconnects

Helpful to include:

  • Screenshot of Settings → Payment
  • PMS provider name
  • Example reservation ID and timestamp