How to set up Stripe

Connect Stripe in Payment Providers, add the webhook signing secret, browse your Stripe catalog, and link Stripe prices to membership plans, gear, and training offerings.

1. 1

   Before you start

   Use this guide if you want your branch to accept Stripe payments for:

   • Membership plans
   • Gear products
   • Training offerings

   You need:

   • a branch admin account in CompTeam
   • a Stripe account you can log into
   • a branch that already has its billing currency configured

   CompTeam now uses a central Stripe setup in Payment Providers. You connect Stripe once, then reuse the same Stripe catalog everywhere else in the app.

2. 2

   Open Billing and connect Stripe

   Go to Payment Providers in the sidebar and find the Branch Stripe account card.

   Click Connect Stripe. CompTeam sends you to Stripe's secure OAuth flow. In Stripe:

   1. Sign in to the Stripe account you want this branch to use.
   2. Review the access request.
   3. Approve the connection.

   After Stripe redirects you back to CompTeam, the Payment Providers page should show:

   • the connected Stripe account name
   • the account id (acct_...)
   • the branch catalog preview

   If you prefer or need a fallback flow, the same Payment Providers card still lets you save a Stripe secret key manually.

3. 3

   Add the webhook signing secret

   Still on Payment Providers, add your Webhook Signing Secret in the Stripe card.

   CompTeam shows you the branch-specific Webhook URL to use in Stripe.

   In your Stripe Dashboard:

   1. Create or edit a webhook endpoint.
   2. Paste the webhook URL shown in CompTeam.
   3. Copy the generated signing secret (whsec_...).
   4. Paste that secret back into CompTeam and click Save.

   This lets CompTeam verify that incoming Stripe events really came from Stripe before it updates payments inside your branch.

4. 4

   Browse your Stripe catalog

   Once Stripe is connected, the Payment Providers page can load your branch's Stripe products and prices.

   Use the catalog search to inspect:

   • product name and product id
   • whether a product or price is active
   • one-time vs. recurring prices
   • amount, currency, and interval

   CompTeam treats Stripe as the source of truth for linked pricing. That means when you link a Stripe price to a CompTeam record, the Stripe amount and currency win over local manual pricing fields.

5. 5

   Link Stripe prices to plans, gear, and training

   After the connection is set up, go to the relevant admin page and use Choose from Stripe:

   Membership Plans

   Go to Membership Plans and edit or create a plan.

   • Use Choose from Stripe next to Stripe Price ID for the main recurring membership price.
   • Use Choose from Stripe next to Stripe Signup Fee Price ID if you also charge a one-time signup fee.

   Gear

   Go to Gear, open a product, and use Choose from Stripe to attach a one-time Stripe price.

   Training Offerings

   Go to Training Offerings Admin and use Choose from Stripe to attach a one-time Stripe price to a drop-in, private lesson, or seminar.

   CompTeam validates that the selected price belongs to the currently connected Stripe account, so you cannot accidentally attach a foreign Stripe price from another branch.

6. 6

   How to verify everything is working

   Do a quick branch-admin smoke test after setup:

   1. Return to Payment Providers and confirm the Stripe account id is visible.
   2. Confirm the catalog loads at least one product or price.
   3. Link one test item:
      • a recurring membership plan, or
      • a gear product, or
      • a training offering
   4. Re-open that record and check that the Stripe-linked price is still shown.

   If you ever need to switch Stripe accounts, use Disconnect in Payment Providers and reconnect the correct one. Existing linked ids remain stored, but CompTeam will only validate and hydrate them correctly against the account currently connected to the branch.

   For recurring member collection, continue with the SEPA direct debit guide if your branch also uses invoice-based bank collection. Stripe and SEPA can coexist in the same branch.