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. If you use Stripe, choose Live or Test before connecting.

Where to Find It

Settings → Payment

Quick Reference

Setting Area	What It Controls	Main Outcome
Payment Gateway Integration	Stripe or Red Dot setup	Guests can pay in kiosk flows
Stripe Environment	Live or Test mode for Stripe gateway and terminal connections	Locks after connection
Payment Collection Mode	Deposit and full payment toggles	Controls what guests pay at check-in
Property Currency (in Settings → Essentials)	Resolved currency for deposits and reservation payment display	Keeps payment amounts consistent across settings and operations
Deposit Currency	Currency used for deposit amounts on this page	Saves with your other payment settings
Opera Payment Mapping (Step 3 card)	Settlement, cashier, payment type mapping	Opera receives payment postings correctly
Opera Payment Policy Controls	Rounding, pre-auth, waive/hide logic	Opera-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 cashier ID and payment method code mappings

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. Open Advanced.
2. Choose Live or Test.
3. Click Connect Stripe.
4. Finish Stripe onboarding.
5. Return to Streamliner and confirm Stripe is connected.

Stripe mode

Use Live for production and Test for sandbox onboarding. After Stripe connects, the environment becomes read-only until you disconnect.

Terminal Stripe setup also defaults to Live unless you change it before connecting.

Terminal checkout

When a kiosk has one mapped Stripe terminal, AVA opens it automatically during checkout. When more than one terminal is mapped, you choose from the terminal picker in the payment modal. If terminal mode is off, AVA keeps the gateway or QR payment flow.

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

Toggle	What It Does
Collect Security Deposits	Pre-authorizes a deposit during check-in
Collect Full Payment	Guests 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. If you see Deposit Currency, choose the currency your hotel uses for deposits.
4. 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. Your selected Deposit Currency saves with the rest of your payment settings.

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.

How mapping rows work

Each row links one payment method to one OPERA payment method code. AVA saves these rows with your other payment settings.

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.

Opera payment comments

After a successful Opera payment or deposit posting, AVA adds a reservation comment in Opera. This happens automatically and does not change the payment result in Streamliner.

What to Expect After Save

• ✅ Connected gateway details appear after setup
• ✅ Stripe shows Live or Test in the connected status badge
• ✅ Deposit fields appear when deposits are enabled
• ✅ Deposit currency stays saved after you click Save
• ✅ 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.

Stripe environment is locked

What you see: The Environment dropdown is disabled after Stripe connects.

Fix:

1. Disconnect Stripe.
2. Open Advanced.
3. Choose Live or Test.
4. Reconnect Stripe.

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.

Opera payment mappings do not save

What you see: Your cashier or payment method rows disappear after you click Save.

Fix:

1. Open Settings → Essentials → PMS Integration.
2. Confirm Opera is still the active PMS.
3. Return to Settings → Payment.
4. Re-enter Default Cashier ID and each mapping row.
5. Click Save Opera Payment Mapping again.

Opera reservation comment is missing

What you see: The payment posts successfully, but you do not see a new reservation comment in Opera.

Fix:

1. Confirm the payment or deposit finished successfully in Streamliner.
2. Check that the Opera reservation has a matching payment record.
3. Retry the payment only if your hotel policy allows it.
4. Contact support if the payment posts and the comment still does not appear.

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.

Related Settings

• Check-In Policy
• PMS Connection
• Opera PMS Integration

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