Skip to main content
← Back to the Table of Contents

Configuring Stripe

Payments go through Stripe, and each studio uses its own Stripe account: the money from your sales lands directly with you, without passing through the platform. Until the keys are filled in, the shop remains browsable but no payment can complete.

The keys to enter

The four fields live in the Payment tab of the settings, and the matching values in your Stripe dashboard: https://dashboard.stripe.com/apikeys

  • Publishable key (pk_…) — used by your customers’ browser to render the card form. It is not secret.
  • Secret key (sk_…) — used by the server to charge. It is encrypted at rest and never shown again in clear: the field displays a masked value once saved.
  • Webhook secret (whsec_…) — it authenticates the notifications Stripe sends to the platform. Without it, subscriptions do not renew properly and credits are not granted again: this is not an optional field.
  • Connect webhook secret — only if you use Stripe Connect to route payments to your coaches.

Currency and tax

The same tab carries the currency (euro or dollar) and the tax rate applied to orders. The currency must match the one of your Stripe account: a mismatch makes payments fail.

Testing before charging

Stripe provides two sets of keys: test keys (sk_test / pk_test) and live keys (sk_live / pk_live). Always start with the test keys — the checkout works end to end, with Stripe’s test card numbers, and no money moves. Switch to the live keys once the shop satisfies you.

Paying a coach (Stripe Connect)

Stripe Connect routes the payment of a product to the Stripe account of the coach attached to it, rather than to yours. Once Connect is enabled on your account, the coach’s Connect ID is entered on their record. A product with no coach, or a coach with no Connect ID, is charged to your account as usual.

If a payment fails

The Stripe dashboard is the source of truth: it shows every attempt, successful or not, with the reason for the decline. On the platform side, the order is only marked completed — and the credits granted — once the payment is confirmed by Stripe. An order left pending is therefore an order whose payment never went through.