# Referral Program
### Overview
Expand your user base through recommendations from existing customers with the **Enable3 Referral Program**.
The system offers flexible reward configuration, from fixed bonuses for each invite to multi-level models with revenue sharing, as well as automated tracking and transparent reward distribution.
### Why Use a Referral Program
#### Case #1: You want to organically acquire new users
**Problem**: Traditional acquisition channels (ads, influencers, paid installs) are expensive and often attract low-intent users.
**Solution**: Introduce a Referral Program that rewards users for inviting friends to join your digital product, too.
**How it works**: Each user receives a unique referral code or link that they can share with friends. When a new user joins using that code and takes meaningful action (you decide which), both users receive a reward.
**How to do it**: Turn on the Referral feature in the Admin Panel, configure the Fixed Reward model, and define rewards for both the inviter and the invited user. Promote the referral program through available channels.
**Outcome**: Users become active promoters of the product, bringing in new participants through trusted peer recommendations, thus reducing acquisition costs.
#### Case #2: You want to grow exponentially without inflating the budget
**Problem**: Referral programs often generate limited growth when users only benefit from inviting direct friends.
**Solution**: Introduce a multi-level referral share model where users earn a percentage of points generated by their referrals and their referrals’ networks.
**How it works**: Users earn a percentage of points generated by Level 1 referrals (their direct invites), Level 2 referrals (friends of their friends), and additional levels (up to four).
**How to do it**: Configure the Referral Share reward type and define percentage rewards for each level. Enable up to four referral levels to encourage network-based growth.
**Outcome**: Users are incentivized to expand the referral network continuously, creating a compounding growth effect where each new user can bring additional participants into the ecosystem.
#### 🎯Referral Program’s benefits
User-to-user invitation mechanics → **Organic user acquisition without additional spending**
Ability to reward both inviter and invited users → **Higher conversion rates compared to traditional referral campaigns**
Optional behavioral conditions for referrals → **Ability to reward only high-quality users who complete meaningful actions**
Multi-level referral structures (up to 4 levels) → **Viral growth effects**
Flexible reward models → **Programs can be optimized for immediate rewards or long-term engagement**
Compatibility with Web, Apps, and Telegram Mini Apps → **Referral campaigns can be launched across multiple customer channels**
### How to Set Up Referrals
#### Installation
Before configuring the **Referral** feature, it must first be installed. To install the Referral feature, go to **My Widget** in the Admin Panel. Locate the **Referral** feature card. Click Install.
My widget section, Referral card
Once installed, the Referrals section will become available for configuration.
#### Configuration
Go to the Referral section of the Admin Panel.
1. **First, you will need to choose the Referral Reward Type.**
Here, you have to decide between two types of reward distribution:
* **Fixed Reward**: Both the inviting and the invited users get a one-time fixed reward.
* **Referral Share**: The inviting user earns a portion (percentage) of the points from every invited user and the users invited by the invited user – up to 4 levels of depth.
Once the Referral Reward Type was selected, you can specify a **Condition** that invited users must fulfill in order to receive the Referral Reward.
{% hint style="info" %}
**Condition parameter attributes**:
1. The condition parameter is optional.
2. It’s applicable for both Fixed Reward and Referral Share.
3. Only missions or quests marked as Active are displayed and available for selection.
4. If you change the referral condition, users invited under the previous condition will remain valid referees.
{% endhint %}
The **Condition** is based on the selected **Mission or Quest** (e.g., “Complete your profile once registered”). If you don’t set the Condition, both the inviting and the invited users will receive the Reward as soon as the invited user is registered via the referral link.
{% hint style="warning" %}
If you select a manual Mission as a condition, users will receive the Reward only after your moderation approval for this Mission in the Admin Panel.
{% endhint %}
2. **Next, if you’ve selected the Fixed Reward, you need to set the reward amount for both users** — the inviting and the invited.
Do it in the **Reward Amount** block.
**If you’ve selected the Referral Share, the Reward Amount block will be replaced by the Referral Share block.** **There, you’ll be able to set the reward share percentage the user will receive from the earned points of the invited referral**, depending on their level.
To do that, in the **Tier % field**, specify the desired percentage, starting from 0.01 and up to 10.
**The Referral Reward will be credited to the user daily at 00:00 UTC as a single transaction**.
{% hint style="info" %}
What is a Referral Tier?
Each Tier is a level of referrals: Tier 1 is your friend, Tier 2 is your friend’s friend, and so on.
User earns a percentage of points from each level once they complete the conditions of the selected Mission or Quest.
{% endhint %}
{% hint style="warning" %}
Important note:
If loyalty is integrated into an App Store/Google Play application or Web (Widget/Landing View types), the referral code for the user will be displayed as a unique referral code that requires manual entry to activate.
If loyalty is integrated into a Telegram mini app, the referral link will be shown as a Telegram link when inviting a referral.
When a user follows a Telegram referral link, the system will automatically track their authorization in the bot and count them as a referred user.
{% endhint %}
{% hint style="success" %}
It is possible to store referral codes on your side.
We have an API endpoint that allows you to retrieve user balances, and the referral code is included in the same response.
Referral codes are also visible in the Admin Panel for each user.
{% endhint %}
3. **Lastly, write a description for your Referral page that the user will see**. Clearly define how your referral program works, what the user must do to participate, and what reward they will receive.
Congratulations, you’re all set!
### How Referrals Work
#### How to invite others through the referral program
To invite a referral to the loyalty widget, the user must first go to the Referral program page. This can be done in several ways:
* by clicking the Invite Friends & Get Rewards banner
* by clicking the Referral program icon in the widget header.
After the user opens the page, they need to copy their unique referral code displayed in the Share Your Referral Link block.
After the code has been copied, the user needs to share it with the person they want to invite. Alternatively, the user can click the Share button and share the invitation code via one of the suggested social media platforms.
#### How to activate a referral code if you’ve been invited
To activate an invitation referral code, the user needs to open the widget, click the kebab menu button in the header, and select the Enter Referral Code section.
After that, the Enter Referral Code pop-up will open, where the user needs to enter the invitation referral code and click Apply.
Please note:
* The "Enter referral code" section will be hidden for a user who has already successfully entered someone’s referral code once.
* The “Enter referral code” section will be hidden for the user after their first approved referral.
After the user enters the code and completes the configured condition (if set up), both users will see a corresponding informational pop-up about receiving the referral reward, and a Referral Reward transaction will appear in the Activity tab for each of them.
#### Displaying the referral program for B2C users depending on the selected View Type in the Admin Panel:
View Type: Widget, Referral program section.
View Type: Landing, Referral program module.
View Type: Telegram, Referral program section.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.enable3.io/enable3/referral-program.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.