Overview
Follow the recommended Refport integration path from referral link click to embedded partner portal.
Refport is built around one integration path: capture referral clicks, report conversions, give partners a portal inside your product, and connect payment systems so commissions stay accurate.
Recommended path
Create a program in the Refport dashboard, set the commission rules, and choose the branded domain partners will use for referral links.
You only need one active program before you integrate. Partner enrollment can happen later through the dashboard, API, or embedded portal.
Install the browser tracker on every public page where referred visitors can land. The tracker reads the refp_id query parameter and stores it in a first-party cookie for later lead and sale attribution.
Start with Install tracking.
Report a lead when a visitor creates an account. Report a sale when a referred customer pays.
For most products, use Better Auth or manual lead tracking for sign-ups, then use the Stripe or Shopify integration for payment events.
Start with Track conversions.
Add the portal to your app so partners can copy their referral link, view performance, and manage payouts without leaving your product.
Start with Embedded Portal.
Connect Stripe or Shopify so Refport can ingest paid events, renewals, refunds, and customer context without custom webhook code in your app.
Start with Integrations.
Choose your implementation route
| Route | Best for | Start here |
|---|---|---|
| Hosted portal + Stripe | SaaS apps that want the fastest production path | Embedded Portal, then Stripe |
| Hosted portal + Shopify | Commerce stores or merchant dashboards | Embedded Portal, then Shopify |
| Custom React portal | Products that need referral UI to match their app exactly | Embedded Portal |
| Manual conversion API | Custom auth, billing, or server-side payment flow | Track conversions |
Core concepts
| Concept | Meaning |
|---|---|
| Click | Captured automatically when someone lands through a Refport link |
| Lead | A sign-up, account creation, demo request, or other qualified conversion |
| Sale | A paid event that can trigger revenue attribution and commissions |
| Partner | The person or business enrolled in your referral program |
| Embed token | A short-lived public token that lets one signed-in partner view portal data |