For the complete documentation index, see llms.txt. This page is also available as Markdown.

#13 Refer friends who shop, get rewards

Refer friends who shop, get rewards

Business case

This setup helps you turn referrals into real revenue, not only sign-ups.

Rewarding the member only after their friend's first purchase improves the referral quality. It aligns the incentive cost with a completed business outcome.

Use this setup when you want to:

  • acquire new customers through trusted recommendations

  • motivate members to bring buyers, not only registrations

  • combine points and gifts to make the reward more attractive

Important concepts when talking about referrals

  • referrer - the original member

  • referee - the friend invited by the member

Use this setup to reward the referrer when the referee makes their first purchase.

In this example, the referrer gets:

  • extra points

  • a gift reward

This setup uses a Referral Campaign with a Referee's transaction trigger.

For this use case, use these elements:

  • Campaign type: Referral

  • Trigger: Referee's transaction

  • Referrer reward: Add points

  • Referrer reward: Give one gift reward

  • Main condition: Reward only after the referee's first purchase

Use two separate referrer rules with the same condition:

  • one rule for points

  • one rule for the gift

This keeps the setup clear and easy to maintain.

Step-by-step setup

1

Prepare the referral flow

Before you create the campaign, make sure the referral link flow works end to end.

  1. Retrieve each member's referrer token.

  2. Add that token to your referral link or app flow.

  3. Capture the token during registration.

  4. Send the token in the referred member creation request.

The referrer and referee must already be linked before the first purchase happens.

Learn more about how referral programs work:

Referral Programs
2

Create the gift reward

Go to RewardsReward ListAdd reward.

Then:

  1. Choose the reward type.

    • Use Material reward for a physical gift.

    • Use Coupon for a voucher or gift code.

  2. Enter the reward name and description.

  3. Set availability and visibility.

  4. Add redemption limits if needed.

  5. Set the reward to Active.

  6. Save the reward.

Example reward:

  • Welcome gift coupon

You will select this reward later in the referral campaign.

Learn more about how rewards work:

Rewards
3

Create the referral campaign

Go to Campaigns > Referral and click Add referral campaign.

Set the basic campaign details:

  • Campaign trigger: Purchase transaction

  • Name: Refer a friend - first purchase reward

  • Start date: choose when the campaign should begin

  • Status: Active

This means the campaign reacts when the referred member makes a purchase.

4

Add the rule for points

In Rules for Referrer, add a new rule for the points reward.

Use this condition:

  • Referee's first transaction dateIs after the date when the campaign was started

Then add this effect:

  • Add units

    • Wallet type: your points wallet

    • Calculation formula: 100

This rule gives the referrer 100 points after the referee's first purchase.

If you want to reward only meaningful purchases, add another condition for the minimum transaction value.

Learn more about how points work:

Wallets
5

Add the rule for the gift

In Rules for Referrer, add a second rule.

Use the same condition:

  • Referee's first transaction dateIs after the date when the campaign was started

Then add this effect:

  • Give reward

    • Reward: the gift reward you created earlier

This rule gives the referrer the gift after the same qualifying purchase.

6

Add limits and fraud protection

Set campaign limits before launch.

Recommended options:

  • limit the number of rewarded referrals per member

  • add a minimum purchase value for the referee

  • set a daily or total cap for the campaign

Example:

  • max 5 rewarded referrals per member per day

  • reward only when the first purchase is above $20

These limits reduce abuse and keep costs predictable.

7

Test the full flow

Run one full test before launch.

  1. Create a test referrer.

  2. Register a test referee with the referrer token.

  3. Make the referee's first purchase.

  4. Check that the referrer receives:

    • the points

    • the gift reward

  5. Make a second purchase for the same referee.

  6. Confirm the reward is not granted again for the first-purchase rule.

Also verify the referral relation in the member profile.

Example configuration

Here is a simple version of this use case:

  • Referrer reward 1: 100 points

  • Referrer reward 2: 1 welcome gift coupon

  • Trigger: referee purchase transaction

  • Condition: only the referee's first transaction qualifies

  • Optional extra condition: transaction value must be above $20

Expected result

After launch, the flow looks like this:

  1. Member A shares a referral link.

  2. Member B registers with Member A's referrer token.

  3. Member B makes a first purchase.

  4. Open Loyalty grants Member A:

    • points in the selected wallet

    • the configured gift reward

Troubleshooting

The referrer did not get rewarded

Check these points:

  • the referred member was created with the correct referrer token

  • the campaign is active

  • the first purchase happened after the campaign start date

  • the transaction meets all rule conditions

Points were granted, but the gift was not

Check these points:

  • the gift reward is active

  • the reward is available in the campaign period

  • the second referrer rule points to the correct reward

The reward triggered more than expected

Check these points:

  • campaign limits are configured

  • the first-purchase condition is present in both referrer rules

  • test transactions are not duplicated by the integration

Best practices

  • Reward the first purchase, not only registration.

  • Add a minimum purchase value.

  • Start with clear limits.

  • Test the full flow before launch.

Last updated

Was this helpful?