The two-sided model
1
Enroll each user as a referrer
When a user signs in, the widget (or a server call) enrolls them into your programme and mints
their personal referral link — no application needed.
2
They share their link
Their referral link (and optional promo code) is theirs to share. Referred visitors are tracked
like any other click.
3
A referred signup rewards both sides
When a referred person signs up, you report it to TrackRev. The inviter earns their reward, and
(optionally) the new user gets a referee bonus.
Embed the widget
Add the widget script to your app, authenticated with a publishable key:data-key— a publishable key from Settings → Developers (safe in the browser).data-user-id— your stable user id (external_user_id).data-user-email/data-user-tier— the user’s email andfree/paidtier, which determines their reward amount.
Or drive it with the API
Prefer to build your own UI? Call the referral endpoints directly:- Enroll a user as a referrer:
POST /api/v1/referrals/enroll. - Report a signup attributed to a referrer:
POST /api/v1/referrals/report-signup.
report-signup resolves the referrer from a
ref_code, a _vid, or an explicit referrer id, and runs self-referral
checks before granting a reward.
The full referral flow — enroll, report, reward, credit fulfilment, self-referral protection —
is covered end-to-end in the API reference and
Credits & fulfilment.

