Back to home

Help Center

Reward Your Users

Rewards with Referral Factory and Webhooks

Automatically reward your referral program participants using webhooks 🎁 This opens up a world of possibilities for connecting your referral program with your own software, custom applications, or other platforms to issue rewards.

In this guide 👇

1. What You Can Do With Webhook Rewards

1.1. Who Can You Reward?

1.2. What Events Can Trigger A Reward?

2. How To Add a Webhook Reward in Referral Factory

Would you prefer to learn more about Referral Factory rewards in general? You'll find a full breakdown here: 📖 Rewarding with Referral Factory: A Full Guide 📖

1. What You Can Do With Webhook Rewards

With Webhooks and Referral Factory, you have the flexibility to reward and incentivize in a way that suits your needs. Before we dive into the step-by-step guide, here are some of the options that you will need to consider when creating your reward:

1.1. Who Can You Reward?

You can reward:

👉 The Person Referring (the person doing the referring, who shares their referral link)

👉 The Person Invited (the person being referred, who signs up on the referral link they were sent)

👉 Both! Note that you will need to add multiple rewards, one for the Person Referring and another for the Person Invited.

Click here to learn more about different types of users.

1.2. What Events Can Trigger A Reward?

You can trigger a reward on:

👉 An invited referral (when the Person Invited fills in their details on their friend's referral link)

👉 A converted referral (when the Person Invited "qualifies")

👉 Both! Note that you will need to add multiple rewards, one for each of the triggers.

In addition to these triggers, you have the option to set up:

👉 A Standard Reward (These are simple, once-off rewards based on rules you set)

👉 A Milestone Reward (These allow you to change the value of a reward based on a goal or target number of referrals at various milestones. One common use case of a milestone reward structure is enabling a tiered structure, offering larger incentives as participants rack up more referrals. Click here to learn more)

👉 A Recurring Reward (These rewards are issued at regular intervals that you set. These can be weekly, monthly, quarterly, yearly, or at a custom interval. Click here to learn more).

2. How To Add a Webhook Reward in Referral Factory

→ To add a Webhook Reward, go to the Rewards tab from the left-hand side of your Referral Factory dashboard.

→ Click Add New Reward.

Screenshot showing that you can add a Webhook Reward in Referral Factory.

→ Give your reward a name.

→ Select who you want to reward: the Person Referring or the Person Invited.

→ Use the drop-down select field to connect your campaign.

📌 Rewards are linked to campaigns. If you have multiple campaigns and want to issue rewards in each of them, you will need to create multiple rewards.

→ Click Next.

Screenshot showing that you can add a Webhook Reward in Referral Factory.

→ In the Choose Reward step, select Webhooks.

→ Enter the endpoint URL that should receive the webhook.

→ Configure your outbound webhook method.

→ If you would like, add your Headers and Hidden Fields.

→ Structure your data payload.

→ Click Next.

→ Click Next.

→ Select whether you want to issue a Standard, Milestone, or Recurring Reward.

👉 Standard rewards typically operate on an ongoing basis with no changes to the reward value as participants accumulate more and more referrals.

→ Select whether you want your standard reward to be issued as a fixed value or as a commission.

👉 To add a fixed value reward:

→ Set the target number of referrals invited or referrals converted that trigger a reward.

💡 Want to reward when the referral is invited AND when that referral converts? Set up multiple rewards within the same campaign.

→ Optionally, set the reward currency. You can leave this blank if your reward is not monetary.

→ Set the reward value. You can enter "0" if your reward is not numerical or monetary.

→ Set whether you would like to limit the number of rewards that can be issued to any single user.

📌 The limit is the number of rewards to be issued, not the value of the rewards.

→ Click Next.

👉 To add a commission value reward:

→ Select whether a reward should be triggered when a referral is invited or when a referral is qualified (successful or converted).

💡 Want to reward when the referral is invited AND when that referral converts? Set up multiple rewards within the same campaign.

→ Enter the commission value as a percentage.

→ Optionally, enter a maximum value for the reward. This will cap your reward value even if the percentage of the total deal or spend is a higher amount.

→ Set whether you would like to limit the number of rewards that can be issued to any single user.

→ Click Next.

👉 Milestone rewards allow you to change the value of a reward based on a goal or target number of referrals at various milestones. One common use case of a milestone reward structure is enabling a tiered structure, offering larger incentives as participants rack up more referrals.

→ Select whether your Milestone rewards should trigger on invited or converted referrals.

💡 Want to reward when the referral is invited AND when that referral converts? Set up multiple rewards within the same campaign.

→ Set the target number of referrals that should trigger Milestone 1.

→ Enter the reward value for Milestone 1. Enter 0 if the reward is not monetary or numerical.

→ A name will be automatically generated for each milestone so you can easily keep track.

→ Click + Add Milestone and repeat the previous 3 steps to add additional tiers or milestones.

→ Once you have set all the required milestones, click Next.

👉 Recurring rewards allow you to pay out the reward at regular intervals like weekly, monthly, or yearly. One common use case for a recurring reward structure is to pay out an affiliate commission on subscription-based products like SaaS referrals.

→ Select whether you want your recurring reward to be issued as a fixed value or as a commission.

👉 To add a fixed value reward:

→ Set the target number of referrals invited or referrals converted that trigger a reward.

💡 Want to reward when the referral is invited AND when that referral converts? Set up multiple rewards within the same campaign.

→ Optionally, set the reward currency. You can leave this blank if your reward is not monetary.

→ Set the reward value. You can enter "0" if your reward is not numerical or monetary.

→ Set the reward period, this is the interval at which the recurring reward should be issued. You can set the interval to be weekly, monthly, quarterly, annually, or at a custom interval of your choice.

→ If you would like to limit the number of intervals that recur, use the dropdown menu to place a cap on the recurring reward.

→ Finally, select how unqualified referrals should be treated.

→ Click Next.

👉 To add a commission value reward:

→ Select whether a reward should be triggered when a referral is invited or when a referral is qualified (successful or converted).

💡 Want to reward when the referral is invited AND when that referral converts? Set up multiple rewards within the same campaign.

→ Enter the commission value as a percentage.

→ Optionally, enter a maximum value for the reward. This will cap your reward value even if the percentage of the total deal or spend is a higher amount.

→ Set whether you would like to limit the number of rewards that can be issued to any single user.

→ Click Next.

→ At this stage, you have the option to enable auto-issue. By default, Referral Factory will NOT automatically issue your rewards. However, you can toggle the switch to allow rewards to be issued as soon as they become due. You can also switch auto-issue on and off from inside the Rewards tab.

→ Click ‘Activate’.

→ Success!

→ Use the link on the screen to test that your webhook fires.