๐ Invitation Code
Introduction
The Invitation Code system allows existing users to invite new people to join the app by sharing a special invitation code. When a new person registers using the invitation code, the referrer (the person who sent the invitation) earns financial gains from the recharges made by the invited person.
How Does the System Work?
- The user shares their invitation code with others.
- The new person registers in the app and enters the invitation code.
- The new person is linked to the referrer in the system.
- When the invited person makes recharges in the app, the referrer receives a percentage of gains from each recharge.
- The referrer can track their gains and number of users who joined through them from the dashboard.
Note
The invitation system motivates users to attract new users to the app, as the referrer receives continuous financial gains from every recharge made by the people they invited.
How to Access:
Side Menu โ ๐ Invitation Code โ Invitation Code
๐ Open Invitation Code Page
Main Invitation Code Page
When opening the page, you'll find a list of all users who have invited others to join the app. Each row represents a referrer with the total number of people who joined through them and total gains earned.
Search Filters:
| Filter | Description |
|---|---|
| ID | Search by user ID |
| User | Search by user UUID |
| Button | Function |
|---|---|
| ๐ Search | Apply filters and display results |
| ๐ Reset | Clear all filters |
Referrers Table Columns:
| Column | Description |
|---|---|
| Name | Referrer's username with profile picture and UID |
| Number of Users | Total number of people who joined the app through this user's invitation code |
| Gains from Users | Total financial gains the referrer earned from recharges by their invited users |
| Created | Registration date or first invitation date (e.g., 7 months ago, 1 year ago) |
| Operations | "Users" button โ to view the list of people who joined through this referrer |
Referrers Table Example:
| Name | Users | Gains from Users | Created |
|---|---|---|---|
| Hello World (UID: 6423561) | 1 | 20 | 7 months ago |
| ุนููู (UID: 1234567) | 1 | 30 | 9 months ago |
| Abdallah Ibrahim (UID: 4339201) | 1 | 15 | 1 year ago |
| Mohammed Sayed tst (UID: 4030180) | 3 | 0 | 1 year ago |
| Sameh (UID: 7303408) | 2 | 1000010035 | 2 years ago |
Invited Users List
When pressing the "Users" button next to any referrer, a page opens displaying all people who joined the app through that referrer's invitation code.
Invited Users Table Columns:
| Column | Description |
|---|---|
| ID | Unique identifier of the invited user |
| Name | Name of the invited user who joined via the invitation code |
| Gains from Users | Total financial gains the referrer earned from this specific invited user's recharges |
| Created | Date the invited user joined (e.g., 2 years ago) |
| Operations | "Transaction Log" button โ to view all recharge details and referrer gains from this user |
Transaction Log (Recharge Details)
When pressing the "Transaction Log" button next to any invited user, a page opens displaying all recharge transaction details made by the invited user and the gains the referrer earned from each transaction.
Transaction Log Columns:
| Column | Description |
|---|---|
| ID | Unique identifier for the recharge transaction |
| Recharge Value | The recharge amount made by the invited user (e.g., 25.00, 100.00, 200.00) |
| Referrer Gain | The amount the referrer earned from this transaction (percentage of recharge value) |
| Created | Date of the recharge transaction |
Transaction Log Example:
| ID | Recharge Value | Referrer Gain | Created |
|---|---|---|---|
| 15 | 25.00 | 2.50 | 2 years ago |
| 14 | 25.00 | 2.50 | 2 years ago |
| 7 | 200.00 | 20.00 | 2 years ago |
| 6 | 100.00 | 10.00 | 2 years ago |
How is the referrer gain calculated?
The referrer gain is calculated as a percentage of the recharge value made by the invited user. In the example above:
- Recharge of 25.00 โ Referrer gain 2.50 (10% rate)
- Recharge of 200.00 โ Referrer gain 20.00 (10% rate)
- Recharge of 100.00 โ Referrer gain 10.00 (10% rate)
Quick Summary:
| Action | Steps |
|---|---|
| View referrers list | Invitation Code โ Invitation Code |
| Search for referrer | Enter ID or UUID โ Press Search |
| View invited users | Press "Users" next to referrer |
| View transaction log | Press "Transaction Log" next to invited user |
โ๏ธ Invitation Code Settings
How to Access:
Side Menu โ ๐ Invitation Code โ Settings
๐ Open Invitation Code Settings Page
The settings page contains two main tabs:
Tab 1: Percentage Invitation Code
This tab controls the rates and financial rewards for the invitation system:
| Field | Description | Default Value | Required |
|---|---|---|---|
| Referrer Earn Percentage (%) | The percentage the referrer earns from each recharge the invitee makes within one month of the invitation | 2% | โ Yes |
| Referrer Reward (Coins) | The number of coins the referrer receives immediately when the invitee uses the code and joins the app | 10,000 | โ Yes |
| Invitee Reward (Coins) | The number of coins the invitee (new person) receives when using the invitation code and registering | 20,000 | โ Yes |
Example of How Settings Work
With default settings (2% rate, 10,000 referrer reward, 20,000 invitee reward):
- Ahmed shares his invitation code with Mohammed.
- Mohammed registers using the code โ Mohammed immediately receives 20,000 coins ๐
- Ahmed (referrer) immediately receives 10,000 coins ๐
- During the first month, if Mohammed recharges $100 โ Ahmed receives $2 (2% of recharge value) ๐ฐ
Tab 2: Invitation Code Setting
This tab controls the invitation text content displayed to users in both Arabic and English:
| Field | Description | Required |
|---|---|---|
| content โ Content (Arabic) | Invitation text or instructions in Arabic โ displayed to Arabic-speaking users | โ Optional |
| content en โ Content (English) | Invitation text or instructions in English โ displayed to English-speaking users | โ Optional |
Steps to Modify Settings:
- Go to Invitation Code โ Settings.
- Select the desired tab:
- percentage invitation code โ to modify rates and rewards.
- invitation code setting โ to modify invitation text content.
- Modify values as needed.
- Press "Submit" to save settings.
Important Note
- Changing the referrer earn percentage affects all new invitations from the moment of change.
- Changing the referrer reward or invitee reward affects new users who will use the invitation code after the change.
- The percentage only applies within one month from the invitation date.
Tips for Setting Configuration
- Increasing referrer earn percentage motivates users more to invite their friends.
- Increasing invitee reward encourages new people to accept the invitation and register.
- Maintain a balance between rewards to avoid exploitation while ensuring sufficient motivation.