Quickstart

Get your first referral tracked in under 10 minutes.

What you'll build

By the end of this guide you will have:

A live referral campaign
A widget embedded on your site (or a hosted page link ready to share)
Referral tracking firing on sign up or payment

Step 1: Create a Campaign

Log in to your Referral Rocket dashboard.
Click New Campaign.
Choose a campaign type. If you're not sure, start with Double-Sided Referral — it rewards both the referrer and the new user.
Fill in the basics:
- Campaign name (internal label)
- Reward — e.g. "$20 for the referrer, $10 for the new user"
- Qualifying event — when the reward is triggered (sign up, first payment, etc.)
Click Save & Continue.

See Campaign Types for a full breakdown of all six campaign structures.

Step 2: Choose Your Installation Method

Option A — Hosted Page (no code required)

From the Campaign Detail page, copy the Hosted Campaign URL.
Share this link in your emails, social posts, or in-app banners.
Done — participants sign up on the hosted page and get their referral link automatically.

Use this if: you want to launch immediately without touching your codebase.

Option B — Embed on Your Site (recommended)

Add one script tag to the <head> of your site. Find your campaign-id on the Campaign Detail page under Installation.

<script
  type="text/javascript"
  campaign-id="YOUR-CAMPAIGN-ID"
  defer
  src="https://app.referralrocket.io/widget/widgetIndex.js">
</script>

Verify it's working: Open your browser console and type window.Rocket. You should see the Referral Rocket object, not undefined.

Step 3: Track Referrals

When a new user registers, call addParticipant. The SDK reads the referral cookie automatically — no need to manually pass a referral code.

const campaign = window.Rocket.getCampaign();

campaign.addParticipant({
  email: 'newuser@example.com',
  fName: 'Jane',
  lName: 'Smith'
}).then(function(participant) {
  console.log('Referral tracked! Share link:', participant.shareLink);
});

On Payment (if your qualifying event is a purchase)

After a successful payment, call qualifyParticipant to mark the event complete and trigger the referrer's reward.

const campaign = window.Rocket.getCampaign();

campaign.qualifyParticipant({
  email: 'newuser@example.com',
  amountPaid: 49.00       // optional, for percentage-based rewards
}).then(function() {
  console.log('Reward triggered for referrer.');
});

Using Stripe? See the Stripe Integration guide for payment link, pricing table, and checkout session setups.

Step 4: Test Your Integration

Open your site in an incognito window.
Grab a referral link from any existing participant (or create one via the hosted page).
Visit your site via that referral link.
Complete the sign up (and payment if applicable).
Go to Campaign > Participants in your dashboard — the new referral should appear with the referring participant linked.
Check Reward Management to confirm the reward is queued.