- Authorize Stripe so Partnero receives the payments your customers make.
- Add referral tracking to your site so Partnero knows which partner referred each customer — from your sign-up flow, or from Stripe Payment Links.
Your program’s own integration guide, with your program ID already filled in, lives in the app under
Integration → Guides. It is the source of truth for the snippets below.
Step 1: Authorize Stripe
Authorizing lets Partnero see the payments your customers make, including renewals. You only need one of these.Option A: Install the Partnero app for Stripe
Option A: Install the Partnero app for Stripe
Partnero is a verified Stripe partner.
- Log in to Stripe and open the Partnero app on the Stripe marketplace.
- Click Install from partner and confirm.
- Back in the Stripe dashboard, click Connect Program.
- Choose the Partnero program to connect.
Step 2: Add referral tracking to your site
This is what tells Partnero which partner referred a customer. Without it, Stripe sends Partnero payments it cannot attribute to anyone. Pick the method that matches how your business takes payment.Install the tracking script
Both methods start here. This snippet identifies visitors arriving through a partner’s referral link and stores the partner key in a first-party cookie. Copy your own snippet from the app — don’t retype the one below. It is generated per program and already contains your program ID:- Open the program and go to Integration.
- Copy the PartneroJS snippet shown there. It also appears inside every guide on the Guides tab.
</head> tag on every page a referred visitor might land on — ideally site-wide.
For reference, the snippet looks like this, where YOUR_PROGRAM_ID is filled in for you:
Then choose a method
- Stripe Payment Links
- User sign-up
Use this if customers pay through Stripe Payment Links, a Pricing table,
or a Buy button. One script covers all three.Add it to every page containing payment links, at the bottom of the page directly above the closing
If your payment links use a custom domain rather than
</body> tag.buy.stripe.com, name it:In a refer-a-friend program the cookie is
partnero_referral instead of partnero_partner, and the referrer
is sent as referring_customer.key. The Payment Links script is identical.What gets tracked
Once both steps are done, Partnero records one-off purchases, subscription renewals and any other charges your referred customers make, and reverses the commission automatically when a payment is refunded. Commissions are calculated on the amount after discounts and without tax. One-time purchases through Checkout or Payment Links also leave out shipping. Partial refunds reduce the commission proportionally. See What commissions are calculated on.Attribution from your own backend
When a visitor arrives through a referral link, PartneroJS stores the partner key in a first-party cookie namedpartnero_partner (partnero_referral in a refer-a-friend program). That cookie is where the partner key comes
from — read it on your server from the incoming request headers.
If you create Stripe charges server-side, pass the key in Stripe metadata instead of relying on Partnero to
match the customer:
partner_key— the value from the cookie. Attributes the sale to that partner even when no customer record exists yet.customer_key— the same key you used when creating the customer in Partnero.
Coupons
The Stripe integration can also sync coupons and promotion codes between Stripe and Partnero, so a partner’s discount code attributes the sale. See Create and use Stripe coupons.Troubleshooting
Purchases are not appearing in Partnero
Purchases are not appearing in Partnero
Check step 2 actually ran. Open the customer in Partnero and confirm it exists and has a partner attached.
A payment Partnero cannot tie to a customer is not attributed to anyone.
The customer exists but the sale is attributed to nobody
The customer exists but the sale is attributed to nobody
Partnero could not recognise the payer. Confirm the email used in Stripe is the same one you sent at
sign-up — a different billing email is the usual cause. If you pass
customer_key in metadata, compare it
against the key in Partnero character for character.Payment Links are not carrying attribution
Payment Links are not carrying attribution
The script must sit on the page containing the link, below the link markup and above the closing
</body>
tag. If your links use a custom domain, pass stripe_payment_links_domain.Nothing is tracked after a renewal
Nothing is tracked after a renewal
Renewals arrive as
invoice.payment_succeeded, which requires Stripe to be authorized (step 1). Creating the
customer alone is not enough.Next steps
Stripe coupons
Attribute sales from a partner’s discount code
Transactions API
Record transactions yourself
