Skip to main content

Payment Gateway Integration

Connect a payment provider and choose how you collect money during check-in. You can collect security deposits, full payment, or both, depending on your hotel policy.

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
  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​

  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​

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

Deposit Fields Are Missing​

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

Guests Not Asked to Pay​

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

Need Help?​