Skip to main content

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.

If Stripe cannot verify your business

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.