How to Integrate Stripe to SuiteOp

Stripe is one of three payment providers supported by SuiteOp for collecting guest payments. Once connected, your organization can manage subscription billing, collect guest payments tied to reservations, process upsell and service fee transactions, and issue refunds — all from within the SuiteOp dashboard.

Note

SuiteOp also supports JusPay (Hyperswitch) and GuestyPay as payment providers. You can use multiple providers simultaneously — each upsell can be assigned to a different payment account.

What Stripe Powers in SuiteOp

• Subscription billing — Your organization’s SuiteOp plan is managed through Stripe. View your current plan, upcoming invoices, invoice history, and payment method on the Billing page.
• Guest payments — Collect payments from guests linked to specific reservations. Payments can be authorized (held) and captured later, or charged immediately.
• Upsell and fee collection — When guests purchase upsells or incur service fees through the guest portal, charges are processed via Stripe.
• Refunds — Issue full or partial refunds for any guest payment directly from SuiteOp.
• Payment accounts — Configure one or more Stripe Connect payment accounts for your organization to receive guest payments. This is useful if different properties or brands need separate Stripe accounts.
• Stripe Customer Portal — Organization admins can open the Stripe-hosted portal to update payment methods, view invoices, or manage their subscription without leaving SuiteOp.

Prerequisites

Before you begin, make sure you have:

• A Stripe account (if you do not have one, create a free account)
• Admin or Owner role in SuiteOp (the manage_organization permission is required for billing, and manage_payments for payment accounts)
• Your Stripe Publishable Key and Secret Key — see Stripe’s guide on finding your API keys

Caution

Never share your Stripe Secret Key publicly. Treat it like a password. SuiteOp stores it securely and uses it only for server-side API calls.

Connecting Your Stripe Account

1. Open the Integrations page

   Navigate to Integrations in the sidebar. You will see a list of available integrations organized by category.

   

2. Select Stripe

   Find Stripe under the Payment category and click on it.

   

3. Enter your API keys

   You will be prompted to enter your Publishable Key and Secret Key from Stripe.

   To find these keys in your Stripe account:

   1. Log in to the Stripe Dashboard
   2. Navigate to Developers > API Keys
   3. Copy the Publishable key (starts with pk_live_ or pk_test_)
   4. Reveal and copy the Secret key (starts with sk_live_ or sk_test_)

   Note

   If you are testing, use the test mode keys (toggle Test mode in the Stripe Dashboard). You can switch to live keys when you are ready to accept real payments.

4. Complete the connection

   Paste both keys into SuiteOp and follow the on-screen prompts. Once complete, you will be redirected back to SuiteOp and the integration status will show as connected.

Configuring Payment Accounts

After connecting Stripe, you can set up payment accounts for collecting guest payments. This uses Stripe Connect, which lets your organization receive payments directly. Payment accounts from all providers (Stripe, JusPay, and GuestyPay) are managed in Settings > Payments.

1. Navigate to payment settings

   Go to Settings > Payments in the dashboard.

2. Add a payment account

   Click Add Payment Account and fill in the required details (account name, currency).

3. Complete Stripe onboarding

   You will be redirected to Stripe to complete the onboarding process for your connected account. This includes verifying your business details and bank account information.

4. Return to SuiteOp

   Once onboarding is complete, you will be redirected back to SuiteOp. Your payment account is now ready to accept guest payments.

Note

You can add multiple payment accounts if different properties or brands use separate Stripe accounts. Each account needs its own set of API keys.

Managing Billing

Organization admins can view and manage billing from Organization > Billing in the sidebar. This page shows:

• Current subscription — Your plan, billing period, and line items
• Payment method — The default card on file (brand, last four digits, expiration)
• Upcoming invoice — A preview of your next charge, including line items and total
• Invoice history — Up to 12 recent invoices with links to download PDFs or view on Stripe
• Billing address — Your organization’s billing address, which syncs to your Stripe customer record

To update your payment method or manage your subscription in more detail, click Manage in Stripe to open the Stripe Customer Portal.

Verifying the Connection

After setup, confirm everything is working:

1. Go to Organization > Billing and verify your subscription details appear
2. Go to Settings > Payments and verify your payment account shows as active
3. Optionally, process a small test payment on a reservation to confirm the end-to-end flow

Troubleshooting

Billing page shows no subscription

Your organization may not have a Stripe customer linked yet. Contact SuiteOp support to ensure your account is properly provisioned.

Payment account onboarding is incomplete

If you left the Stripe onboarding flow before completing it, go to Settings > Payments, select the account, and click to resume onboarding. Stripe requires business verification before you can accept payments.

Payments are failing

• Verify your API keys are for the correct mode (live vs. test)
• Check that the payment method on file has not expired
• Review the error details on the reservation’s payment history

Webhook events are not updating subscription status

SuiteOp listens for Stripe webhook events to keep your subscription status in sync. If your status seems stale, contact support to verify the webhook endpoint is configured correctly in your Stripe Dashboard under Developers > Webhooks.

Note

SuiteOp processes six webhook event types across billing and payments: customer.subscription.updated, customer.subscription.deleted, invoice.payment_failed, payment_intent.succeeded, payment_intent.payment_failed, and charge.refunded. All other Stripe events are safely ignored.

---

Related Articles

• JusPay Integration — Set up JusPay/Hyperswitch as an alternative payment provider
• GuestyPay Integration — Use Guesty’s built-in payment system
• Creating Upsells — Create upsells and assign payment accounts
• Managing Charges & Payments — Capture, refund, and manage reservation charges