If your organization trades through more than one company, each company
connects its own Stripe account. Pick the company under Billing entity at
the top of the Stripe page before you activate, go live, or deactivate. The
line under the picker reminds you that payments for that company’s gyms settle
to the account you are setting up. The picker only appears when you have more
than one billing entity. See Billing entities.
When to use it
Stripe lets you rehearse payments in a sandbox, then take real money through your own Stripe account. You start in test mode against the 1Club sandbox, then turn on Live mode to onboard your own Stripe Connect account. Payment status flows back to 1Club automatically through webhooks, with no webhook setup on your side. Typical uses:- Validating checkout before going live - book a couple of courts in the portal with Stripe test cards, check the checkout, receipt, and booking confirmation, then turn on Live mode and complete onboarding.
- Memberships and drop-ins - members pay recurring dues at checkout and drop-in visitors pay per session, while you watch the Payouts capability to confirm money is landing in your bank account.
- Two companies, two payouts - a group runs its gyms through two companies, and each company connects its own Stripe account so its sales pay out to its own bank account.
Before you start
- Stripe is a paid-plan integration. On the Free plan and during the free trial, Activate is greyed out until you upgrade.
- Configuring Stripe requires the settings.manage.organization permission.
- You don’t need a Stripe account to try test mode. 1Club ships a sandbox you can use immediately.
- To go live you need a Stripe account (you can create one during onboarding) with the business details, bank account, and identity documents Stripe requires for your country.
Activate Stripe (test mode)
Activating Stripe puts you straight into test mode against the 1Club sandbox. No Stripe account is created yet.- Go to Settings > Integrations.
- Under Payments, click Activate next to Stripe. 1Club opens the Stripe page.
- The Stripe status card shows Active and says test payments use the 1Club sandbox. No real cards are charged.
- Run a checkout in the member portal or kiosk using Stripe’s test card numbers to confirm the flow end to end.
Go live (Stripe Connect onboarding)
Real payments require your own Stripe Connect account. The Live mode toggle drives the whole transition:- Turn the Live mode toggle on.
- If you have no Stripe account yet, 1Club creates a Stripe Connect (Express) account and opens Stripe’s onboarding in a new tab. You stay in test mode until onboarding is complete.
- Complete Stripe’s onboarding form: business details, representative, bank account, and any identity documents Stripe asks for.
- Return to 1Club. The page refreshes your account status automatically after a couple of seconds.
- Once Stripe reports that card payments are active and nothing blocking is due, turn Live mode on again. This time it switches, and real charges start processing.
Stripe Connect accounts always live on the live side of Stripe. Test mode only
changes which Stripe keys process your payments (the platform sandbox), not
which account exists. That is why you can activate Stripe and take test
payments long before you create a Connect account.
Test mode vs. live mode
The Live mode toggle on the Stripe page controls where payments go:- Test mode (off) uses the 1Club sandbox on the platform’s Stripe account. Real cards are not charged. Use Stripe’s test card numbers to simulate payments. No Connect account is required.
- Live mode (on) uses your own Stripe Connect account. Customers are charged for real and payouts go to your bank account.
Stripe status
The Stripe status card at the top of the page shows a status chip:- Not activated - Stripe isn’t set up for this company. Click Activate.
- Active - you are taking payments, either in test mode with the sandbox or through a Stripe account that is fully set up.
- Pending or Restricted - you have a Stripe account, but Stripe still needs information or has limited it. Click Complete setup.
- Complete setup - reopens Stripe’s onboarding. Shown until the account status is Active.
- View dashboard - opens the Stripe Dashboard in a new tab.
- Refresh status - pulls the latest account status from Stripe right away. The page also re-reads it every 30 seconds while it is open.
Account capabilities
Once you have a Stripe account, the card lists what Stripe allows the account to do under Account capabilities, each with a status chip such as Active, Pending, Restricted, or Inactive:- Charges - whether Stripe will accept card payments on this account.
- Payouts - whether Stripe will send money from your Stripe balance to your bank.
- Transfers - whether the account can receive the money 1Club passes on to it from your sales.
- Setup - Completed when Stripe needs nothing more from you, including documents it will only ask for later. Otherwise Incomplete.
Setup progress and requirements
If Stripe still needs information before you can take payments, a Setup progress card appears below the status card:- A warning says Stripe needs more information and asks you to select Complete setup.
- A progress bar tracks the two money capabilities, Charges and Payouts, with a caption such as “1 of 2 capabilities enabled”.
- If Stripe has disabled the account, a Disabled reason line says why.
- Currently due lists items that block payments until you submit them.
- Pending verification lists documents you have already submitted that Stripe is still reviewing.
Payment terminals
To take payments in person, set up card readers under Settings > Sales > Payment terminals. The Stripe page links there with a Manage button. Terminals from every provider you use are managed in one place.Deactivate
- Pick the company under Billing entity, if you have more than one.
- Click Deactivate at the top of the Stripe page.
- Confirm in the Deactivate Stripe? dialog. It says Stripe stops working and its settings are deleted. With more than one billing entity, it also says the change applies to the selected company only, and your other companies stay connected.
What syncs
- Charges and refunds made in 1Club appear in your Stripe Dashboard.
- Payment status updates from Stripe (succeeded, failed, refunded, disputed) flow back to 1Club through webhooks, with no setup needed on your side.
- Payouts go from Stripe to the bank account you configured during onboarding. Schedule and currency are controlled in the Stripe Dashboard.
Worked examples
Padel gym validating checkout before going live. A racket-sports gym activates Stripe, leaves Live mode off, and books a couple of courts in the portal using Stripe test cards. Once the checkout, receipt, and booking confirmation all look right, it turns on Live mode, completes Stripe onboarding with its bank details, turns Live mode on again, and starts collecting real court fees. Martial-arts gym selling memberships and drop-ins. A jiu-jitsu gym runs live Stripe. Members pay recurring dues at checkout and drop-in visitors pay per session. The gym watches Payouts show Active to confirm money is landing in its bank account, and opens View dashboard to handle a disputed charge. A group trading through two companies. A fitness group runs its city-centre gyms through one company and its suburban gyms through another. On the Stripe page it picks the first company under Billing entity, activates Stripe and goes live, then picks the second company and does the same. The Integrations list shows Stripe as connected for 2 of 2 billing entities, and each company’s sales pay out to its own bank account.Tips & best practices
- Do all your rehearsal in test mode. A successful test-card payment through the real portal checkout is the cleanest proof your setup works before real money is involved.
- Clear Currently due items promptly. They block payments, so the sooner they are submitted the sooner you can go live.
- Treat items in the Pending verification card as a checklist. They don’t block payments today, but leaving them unresolved risks a later Stripe restriction.
- After returning from Stripe onboarding, give the page a moment, or click Refresh status to pull the latest capabilities.
Troubleshooting
- Activate is greyed out - your organization is on the Free plan or the free trial. Upgrade to a paid plan to activate payments.
- “Stripe needs more information before you can take payments” - open the Setup progress card and submit everything under Currently due through Complete setup.
- Live mode doesn’t turn on - either your Stripe account is not ready (click Complete setup to finish onboarding) or your plan doesn’t allow live payments (upgrade to a paid plan).
- Payments succeed in test mode but fail live - confirm Live mode is on and that Charges shows Active.
- Charge succeeded in Stripe but not visible in 1Club - payment status arrives through Stripe’s webhooks, usually within seconds. If it doesn’t appear, contact support with the Stripe PaymentIntent ID.
Related
- Integrations - the full integration catalog and how activation works.
- Billing entities - the companies you trade through, each with its own payment accounts.
- myPOS - an alternative card payment provider with hosted checkout and in-person terminals.
- DatecsPay - hosted card checkout through BORICA.
- Charges - where individual charges are recorded.
- Invoices - invoices you can attach a Stripe payment link to.