Connect Stripe
SharePay takes each share of a split on your own Stripe account, connected through Stripe Connect as a Standard account. The money settles to you and every payment appears in your Stripe Dashboard, exactly like your other payments. SharePay never holds the money, and SharePay's fee is taken from each charge as it is captured, so there is no monthly bill.
Do this in test mode first: switch the SharePay dashboard to test mode and the onboarding runs in Stripe test mode, where nothing real is verified and placeholder details are fine. Once a test split works end to end, connect for real in live mode.
What you need
- The owner or an admin role in SharePay.
- Your business and identity details for Stripe's own checks. If you already have a Stripe account, you can sign in to it during onboarding.
1. Start onboarding
In the SharePay dashboard, go to Settings, Payments and choose Connect next to Stripe. You are sent to Stripe's hosted onboarding.
From your own code, POST /api/merchants/connect returns { url }, the same
link. It is one-shot and expires in about five minutes, so never store it. If
yours goes stale, POST /api/merchants/connect/refresh mints a fresh one for
the same account.
2. Finish Stripe's flow
Complete every step Stripe asks for. If you leave part way, choose Continue
setup on Stripe in Settings, Payments to pick up where you stopped.
Calling POST /api/merchants/connect again is safe too: it reuses the account
you already started rather than opening a second one.
3. Check you are ready
You are ready when gates.take_split is null on GET /api/merchants/me.
On Stripe, stripe_charges_enabled turns true at the same moment. Until then,
hosted checkout fails with Finish Stripe onboarding before accepting checkouts.
Poll this rather than waiting to hear from us. When the account still looks
incomplete, /me checks with Stripe on read, so it is right even if Stripe's
own update arrived late or not at all. The full list of fields is in Become a
merchant.
Stripe decides this inside its own hosted flow, and SharePay is not notified
when it declines, so nobody will contact you about it. If you come back from
Stripe and stripe_charges_enabled is still false, contact support.
What your customers see
Each person in the split opens their SharePay payment link and enters their card in Stripe's card form, with 3-D Secure where their bank asks for it. Their card is held, not charged, until everyone has paid; then every share is captured together. If the split does not complete, every hold is released. A customer pays only their own share.