Skip to main content

Payment Gateway Integration

Quick Setup

Plan about 5 minutes. You only need your gateway credentials and deposit rules.

This guide helps you connect Stripe or Red Dot Payment and control when guests pay. You can collect security deposits, full payment, or both.

SettingWhat It ControlsGuest Impact
Payment GatewayWhich provider collects moneyShows or hides the payment step
Collect Security DepositsPre-authorization at check-inAdds a deposit step
Collect Full PaymentCharge remaining balanceShows “Pay outstanding balance”

Where to Find It​

Settings → Essentials → Payments

Supported Payment Gateways​

GatewayConnection Type
StripeOAuth connection
Red Dot PaymentAPI credentials

Before You Start​

  • Have your payment gateway account ready
  • Decide if you want to collect deposits, full payment, or both
  • Confirm your property currency and deposit policy
  • For Red Dot: collect your Merchant ID, Secret Key, and Environment

Configuration Steps​

Step 1: Select a Payment Gateway​

  1. Open Payment Gateway Integration
  2. Select Stripe or Red Dot Payment

For Stripe​

  1. Click Connect Stripe
  2. Complete the onboarding process
  3. Return to settings and confirm the account is connected

For Red Dot Payment​

  1. Enter the Merchant ID from Red Dot
  2. Add your Secret Key. Click Edit Secret to update an existing key. Leave the masked value as-is to keep the current secret.
  3. Choose Environment (TEST for sandbox, LIVE for production)

Step 2: Choose Payment Collection Options​

Find the two toggles:

ToggleWhat It Does
Collect Security DepositsPre-authorizes a deposit during check-in
Collect Full PaymentGuests pay outstanding balance during check-in
  • Turn on one or both options
  • If both are off, check-in won't collect any payment

Step 3: Configure Deposit Details (If Enabled)​

When Collect Security Deposits is on:

  1. Enter a Deposit Amount
  2. Select Deposit Currency
  3. Choose Deposit Type (per night or flat amount)

Step 4: Save Your Changes​

  1. Click Save Payment Gateway Settings
  2. Wait for the success message
  3. Test with a sample reservation if possible

What to Expect​

  • ✅ Connected gateway details appear after setup
  • ✅ Deposit fields appear when deposits are enabled
  • ✅ Full payment panel appears when that option is on
  • ✅ A note appears when no payment collection is enabled

Guest & Staff Impact​

Gateway selection

  • Guests see: A payment step only when a gateway is connected.
  • Staff see: If no gateway is configured, payment steps are hidden and the front desk handles payment as usual.

Collect security deposits

  • Guests see: A deposit step during check-in when enabled.
  • Staff see: Deposit collection is automatic; you can reduce manual pre-auth at the desk.

Deposit type

  • Per night: The deposit amount applies to each night (e.g., $50 × 3 nights).
  • Flat rate: A single deposit amount for the entire stay.

Collect full payment

  • Guests see: “Pay outstanding balance” if there is money due.
  • Staff see: Fewer unpaid balances at check-in when enabled.

Allow skip pre-auth

  • Guests see: If enabled, deposit steps are skipped and they can proceed.
  • Staff see: You can let the front desk collect deposits instead of the kiosk.

Troubleshooting​

Toggles Are Disabled​

What you see: The collection toggles are greyed out.

Fix:

  1. Confirm the payment gateway is connected
  2. Complete Stripe onboarding if prompted
  3. Refresh the page and try again

Red Dot Secret Key Won't Edit​

What you see: You click Edit Secret but the key will not save.

Fix:

  1. Click Edit Secret and confirm the warning
  2. Enter the new secret key
  3. Save to persist the change

Red Dot Secret Key Keeps Reverting to *****​

What you see: The secret key field shows masked text after saving.

Fix:

  1. Re-open Edit Secret
  2. Enter the full secret key again
  3. Save and confirm the success message

Deposit Fields Are Missing​

What you see: Deposit amount and currency fields do not appear.

Fix:

  1. Turn on Collect Security Deposits
  2. Confirm the gateway connection is active

Guests Not Asked to Pay​

What you see: Guests skip payment during check-in.

Fix:

  1. Verify the correct toggle is enabled
  2. Confirm the reservation has a balance due
  3. Check that the payment gateway is active

Still Stuck?​

Contact success@vouch-technologies.com if:

  • ❌ The gateway still shows disconnected after you reconnect
  • ❌ You see errors after re-entering the Red Dot secret key
  • ❌ Payments fail for multiple reservations in a row

Helpful to include:

  • Screenshot of the payment settings page
  • Payment gateway name (Stripe or Red Dot)
  • Time the issue started