Getting Connected
This guide walks you through connecting your Stripe account to OnSeason so you can accept payments from guests. You have two options: create a new Stripe account (recommended for most users) or connect an existing one.
Before you begin, make sure you have:
An active OnSeason workspace
Owner or Admin role in the workspace (Members and Viewers cannot manage payment integrations)
Your business details (legal name, address, tax information)
A bank account for receiving payouts
Option 1: Create a New Stripe Account (Recommended)
This is the easiest option. OnSeason creates a Stripe Express account for you and guides you through a simple setup wizard.
Navigate to Stripe Settings — Go to Settings > Integrations > Stripe in your OnSeason dashboard.
Click Create New Account — Click the "Create New Account" button. OnSeason starts the Stripe Express onboarding process and redirects you to Stripe.
Complete the Stripe Onboarding Wizard — Stripe walks you through a guided setup: business details (business type, legal name, address), personal information (required by financial regulations), bank account (where you want payouts), and identity verification (upload documents if requested).
Return to OnSeason — After completing the wizard, you're automatically redirected back to OnSeason.
Confirm Connection — Your Stripe integration page now shows "Payments Enabled" with a green status indicator. You're all set!
If you close the Stripe onboarding before finishing, don't worry. Go back to Settings > Integrations > Stripe and click "Resume Setup" to continue where you left off. The onboarding link expires after 24 hours — if it expires, OnSeason generates a fresh link automatically.
Option 2: Connect an Existing Stripe Account
If you already have a Stripe account, you can connect it directly.
Navigate to Stripe Settings — Go to Settings > Integrations > Stripe in your dashboard.
Click Connect Existing Account — Click "Connect Existing Account". You'll be redirected to Stripe.
Authorise OnSeason — Stripe asks you to authorise OnSeason to access your account. Review the permissions and click "Connect".
Return to OnSeason — You're redirected back to OnSeason with your account connected.
Connecting an existing Stripe account uses OAuth — a secure authorisation method. OnSeason never sees your Stripe password. Stripe handles the connection securely.
Adding Your Publishable Key
After connecting, you need to add your Stripe publishable key so your booking engine can process payments on the client side.
For new Express accounts:
Open your Stripe Dashboard (click "Open Stripe Dashboard" from the integration page)
Go to Developers > API Keys
Copy the Publishable key (it starts with pk_live_ or pk_test_)
Paste it into the publishable key field on your OnSeason Stripe integration page
For existing Standard accounts: The publishable key is populated automatically during the connection process.
Make sure you copy the Publishable key, not the Secret key. The publishable key is safe to use on your booking engine — it can only be used to create payment tokens, not to charge cards directly.
What Happens Next?
With Stripe connected, your booking engine can now accept payments from guests. Payments are processed through your Stripe account, and you have full visibility.
Payouts are sent to your bank account on Stripe's schedule (typically 2-7 business days).
View your payment activity on your OnSeason Financial Dashboard or directly in your Stripe Dashboard.
To understand what happens after a guest pays, see Understanding Payment Statuses.