Partli
Sign inStart trial

Connect your Stripe

Authorize Partli to read your existing Stripe account so we attribute paid checkouts automatically.

You don't create a new Stripe account

This is OAuth into the Stripe account you already have, the same way “Sign in with Google” works. You don't do KYC. You don't re-enter bank details. You don't create anything new. You sign in to your existing account, click Authorize, and that's it.

Setup (~30 seconds)

  1. In Partli, go to Account → Integrations.
  2. Find the workspace whose Stripe account you want to connect, click Connect Stripe.
  3. You're redirected to Stripe. If you have multiple accounts, pick the one that processes your payments.
  4. Stripe shows: “Partli is requesting permission to access your Stripe account in read-only mode.” Click Authorize access.
  5. You're redirected back to Partli. Connection done.

What we do with the access

We listen for two events on your account:

  • checkout.session.completed — every time a Stripe Checkout closes successfully.
  • invoice.paid — every time a subscription invoice is paid (covers recurring billing too).

For each, we look at the client_reference_id field. If our partli.js snippet stamped a click ID there, we match it to the partner who referred the visitor and create a commission. If there's no click ID, the event is ignored — your direct sales are never touched.

What we actually do with the access

Stripe's OAuth scope is broad by default (read_write) — that means our access token could technically write to your account, but we never do. We only listen for two webhook events (checkout.session.completed, invoice.paid) on connected accounts. We don't create charges, refunds, customers, or modify anything else. Disconnect any time from Account → Integrations to revoke access.

vs. Stripe Connect Express (your partners)

Confusingly, Stripe markets several different things under the “Connect” name. These are not the same:

Who does itWhat it isWhy
You (the merchant)Connect OAuth (this page)Authorize Partli to read your existing Stripe account's events. Optional but recommended.
Your partnersConnect Express onboardingCreate a Stripe-managed account so we can transfer payouts to them. Required if you want them to be paid via Stripe.

You authorize once and never think about it again. Your partners onboard once each, the first time they receive a payout (~3 minutes per partner).

Disconnecting

Same place: Account → Integrations → Disconnect. We revoke the OAuth grant on Stripe's side and stop listening to events from your account. Existing commissions are unaffected.

Troubleshooting

  • Connected but no sales appear: check that your Stripe Checkout buttons run AFTER our partli.js snippet loads. The snippet has to be in <head> for it to wrap Stripe.js calls.
  • Unrelated sales appearing as commissions: shouldn't happen — we ignore events without a client_reference_id we recognise. If you see it, check the tracking diagnostic page.
  • OAuth callback errors: usually means the redirect URI isn't registered on Partli's Stripe Connect platform settings. Email us.
PreviousJavaScript snippetNext REST API