Stripe integration
Three ways to wire Partli into your Stripe billing — pick the one that matches your stack.
Most Partli customers charge end users via Stripe. Three integration paths, listed easiest first.
Path A — JS snippet + Connect Stripe (no code)
Best for non-technical merchants using Stripe Checkout or Payment Links.
- Paste partli.js into your site's
<head>. - Click Connect your Stripe in Partli — sign in to your existing Stripe account, click Authorize.
After this, every paid checkout that came from a partner referral is automatically attributed. No webhook code, no API keys.
Connect ≠ onboarding
Path B — JS snippet + your own webhook
Best if you want to keep webhook handling inside your own backend (for logging, side-effects, etc.) but still want zero-friction click capture.
- Install partli.js.
- In your existing Stripe webhook for
checkout.session.completed, readsession.client_reference_idand forward to Partli — see REST API install.
Path C — Pure REST API
Best for fully custom checkout flows or stacks that don't use Stripe Checkout directly. See REST API install.
What about refunds?
Automated refund clawback through a public endpoint isn't live yet. If a Stripe charge is refunded, find the related commission in your Partli dashboard and mark it as clawed back manually. As long as the commission is still in pending or approved (not yet paid out), no money has moved. Email [email protected] if this is a frequent operation for you.