Stripe Connect Integration

Important — Stripe Connect is for tenant↔customer payments, NOT for SaaS subscription billing

On Booknetic SaaS, three different Stripe configurations can be active at the same time. Don't mix them up:

You don't need to set up all three. Most SaaS owners set up:

• SaaS billing Stripe (so they get paid by tenants) +
• Stripe Connect (so their tenants get paid by their customers).

Prerequisites

Before you start:

• A Stripe account (https://dashboard.stripe.com) that will own the Connect platform.
• A business in a country where Stripe Connect is available (https://stripe.com/global).
• The stripe-connect plan capability enabled on every plan whose tenants should be able to onboard to Stripe Connect (Booknetic SaaS → Plans → edit a plan → toggle stripe-connect ON).

Set up your Stripe Connect platform

Step 1: Open Stripe Connect setup.

Sign in at https://dashboard.stripe.com/connect/set-up. The Connect setup wizard walks you through several stages — the exact wording may change as Stripe updates the UI, but the structure is consistent.

Step 2: Tell Stripe about your platform.

• Platform profile — describe what your platform does (multi-tenant booking software). Stripe uses this for risk review.
• Business model — pick the option that matches your platform. For most SaaS booking platforms, "Multi-party platform with connected accounts collecting payments from their own customers" is the right choice.
• Acknowledge responsibilities — Stripe lists your obligations as a platform; tick the box once you've read them.

Step 3: Pick how your connected accounts (tenants) get paid out.

• Direct charges, destination charges, or separate charges/transfers. Most Booknetic SaaS owners use destination charges so tenants own the customer relationship while you remain in the payment flow.

Step 4: Select your industry.

Stripe's industry taxonomy affects risk scoring and the fee bands available to your platform. Pick the option that most closely matches your tenants' actual business:

• "Personal services" / "Salons & spas" / "Health & wellness" — for grooming and wellness SaaS platforms.
• "Education" — for tutoring/coaching booking platforms.
• "Professional services" — for consulting/legal/agency booking.
• "Business Management Software" or "Other" — fallback when none of the above fit.

Step 5: Choose your onboarding model.

For the rest of this guide, we assume Stripe-hosted Express.

Step 6: Brand the Connect experience.

Upload your business logo and an icon. Optionally customize accent colors. These are shown to tenants during onboarding.

Paste Stripe credentials into Booknetic

1. In Stripe Dashboard → Developers → API keys (https://dashboard.stripe.com/apikeys), copy:
   • Publishable key (pk_live_... or pk_test_...)
   • Secret key (sk_live_... or sk_test_...)
2. In Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe Connect, paste both keys.
3. Save.

Configure the Stripe Connect webhook

1. In Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe Connect, copy the Webhook URI (the URL contains booknetic_saas_action=stripe_webhook).
2. In Stripe Dashboard → Developers → Webhooks → Add endpoint, paste the URL.
3. Subscribe to at least these events (Stripe's UI lets you add more):
   • payment_intent.succeeded
   • payment_intent.payment_failed
   • charge.refunded
   • account.updated (so Booknetic knows when a tenant's Verified status changes)
4. After creating the endpoint, copy the Signing secret (whsec_...) back into Booknetic Stripe Connect settings.
5. Save.

Tenant onboarding

1. Ensure the tenant's plan has the stripe-connect capability enabled.
2. The tenant goes to Tenant panel → Settings → Payment Settings → Payment Methods → Stripe Connect and clicks Register.
3. Booknetic redirects them to Stripe's hosted onboarding flow.
4. Tenant fills business details, bank account, and ID verification.
5. On completion, Stripe redirects them back to Booknetic. Their Stripe Connect status shows in their tenant panel.

Tenant statuses and what they mean

Refunds and disputes

Refunds are handled in Stripe Dashboard or Stripe Express Dashboard, not in Booknetic. To issue a refund:

1. Tenant or platform owner opens the relevant payment in Stripe Dashboard.
2. Click Refund and pick full or partial.
3. The booking status in Booknetic does not automatically change to "refunded" — the tenant should update the appointment status manually.

Disputes (chargebacks) flow to the connected account's dashboard. The tenant — not the platform — is responsible for responding.

Common setup blockers