# Referrals

### What is the Referral Program?

The Taxido Referral Program is a way for existing users to invite their friends and family to join Taxido. Both the referrer and referee receive rewards when the referee completes their first ride.

{% hint style="success" %}

#### Benefits for Everyone:

* **Referrers** earn rewards for bringing new users
* **Referees** get a welcome bonus for joining
* **Taxido** grows its user base through word-of-mouth
  {% endhint %}

{% hint style="success" %}

#### Two Types of Referrals:

* **Rider-to-Rider Referrals** - Existing riders refer new riders
* **Driver-to-Driver Referrals** - Existing drivers refer new drivers
  {% endhint %}

### How the Referral Program Works

{% hint style="info" %}

#### <mark style="color:blue;">Step 1: Referrer Shares Invite Code</mark>

<mark style="color:blue;">Existing users find their unique referral code in the app and share it with friends via text, email, or social media.</mark>
{% endhint %}

{% hint style="info" %}

#### <mark style="color:blue;">Step 2: Referee Joins Using Code</mark>

<mark style="color:blue;">New users enter the referral code during signup to link themselves to the referrer.</mark>
{% endhint %}

{% hint style="info" %}

#### <mark style="color:blue;">Step 3: Referee Takes First Ride</mark>

<mark style="color:blue;">The new user must complete their first ride to trigger the reward process.</mark>
{% endhint %}

{% hint style="info" %}

#### <mark style="color:blue;">Step 4: Rewards Are Given</mark>

<mark style="color:blue;">Both users receive their rewards automatically after the first ride is completed.</mark>
{% endhint %}

### Reward System Explained

#### Types of Rewards:

* **Referrer Reward** - Given to the person who shared their code
* **Referee Reward** - Given to the new user who joined with a code

#### Reward Options:

* **Cash Bonus** - Direct money added to user's wallet

{% hint style="info" %} <mark style="color:blue;">**Example Rewards:**</mark>

<mark style="color:blue;">When a new user joins with a referral code and completes their first ride worth $150:</mark>

* <mark style="color:blue;">Referrer gets: $15 cash bonus (10% of ride amount)</mark>
* <mark style="color:blue;">Referee gets: $7.50 cash bonus (5% of ride amount)</mark>
  {% endhint %}

**Important:** Rewards are only given after the referee completes their first ride, not just for signing up.

### Admin Configuration

#### Setting Up Referral Program

1. Go to Admin Panel → Settings → Referral section
2. Enable or disable the referral program
3. Set reward percentages for referrers and referees
4. Set minimum ride amount requirements

\[Referral Settings Page - Shows configuration options for rewards]

Referral Settings Configuration<br>

<figure><img src="https://74030740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6o4UzjBZtMQpeq4oeh8s%2Fuploads%2FjHwpUS5riOFM15wmkbhz%2Fimage.png?alt=media&#x26;token=4b6ff790-441d-4d87-9a42-03bb0c21a55f" alt=""><figcaption></figcaption></figure>

#### Monitoring Referral Activity

1. Go to Admin Panel → Referrals&#x20;
2. **Overview**: Total referrals, rewards, and status breakdown (Pending, Credited, Trash).
3. **Referral Table**: Referrer, referred user, ride amount, bonus, status, created/credited dates.
4. **Filters/Search**: Sort by status, referrer, date; search by name or email.
5. **Stats**: Top referrers, total rewards, and program performance insights.

Referrals Details

<figure><img src="https://74030740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6o4UzjBZtMQpeq4oeh8s%2Fuploads%2F2MbvVcg7mi5AyLZHV8u0%2FScreenshot%20from%202025-11-17%2014-14-29.png?alt=media&#x26;token=ba5fdc39-a1dd-4b3a-8150-93eadfc7e375" alt=""><figcaption></figcaption></figure>

### How Rewards Are Calculated

The system automatically calculates and distributes rewards:

1. When a new user signs up with a referral code, the connection is recorded
2. When that user completes their first ride, the system checks the referral link
3. Rewards are automatically added to both users' accounts
4. Users receive notifications about their rewards

**Calculation Example:**

Sarah refers her friend John using her referral code:

* John signs up with Sarah's code
* John takes his first ride worth $200
* System automatically adds $20 to Sarah's wallet (10%)
* System automatically adds $10 to John's wallet (5%)

#### Default Settings:

* **Minimum Ride Amount:** $100
* **Referrer Bonus:** 10% of ride amount
* **Referred User Bonus:** 5% of ride amount

### Real-Life Examples

#### Example 1: Simple Referral

**Situation:** Mike wants to invite his colleague Lisa to try Taxido.

**Process:**

* Mike shares his referral code with Lisa
* Lisa downloads the app and enters Mike's code during signup
* Lisa takes her first ride worth $120
* Mike receives $12 cash bonus (10%)
* Lisa receives $6 cash bonus (5%)

#### Example 2: Driver Referral

**Situation:** Driver Alex refers another driver to join Taxido.

**Process:**

* Alex shares his referral code with another driver
* New driver signs up using Alex's code
* New driver completes first ride worth $180
* Alex receives $18 cash bonus (10%)
* New driver receives $9 cash bonus (5%)

### Key Points to Remember

#### For Administrators:

* Rewards are configurable and can be changed anytime
* Program can be enabled/disabled with one setting
* Detailed reports show program effectiveness
* Minimum ride requirements can prevent abuse

#### For Users:

* Referral codes are unique to each user
* Rewards only come after the referred person's first ride
* Both parties must be new to receive rewards
* Referees can't use their own referral code
* Rider referrals only work with other riders
* Driver referrals only work with other drivers

#### Program Rules:

* One referral code per user
* Rewards only for first-time users
* Rewards only after first completed ride
* No rewards for fraudulent activity
* Each user can only receive referral rewards once

### Requirements and Warnings

#### Eligibility Requirements:

* **Referrers:** Must be active users with valid accounts
* **Referees:** Must be completely new users (never had an account)
* **Ride Amount:** Must meet minimum requirement ($100 default)
* **User Type Matching:** Riders refer riders, drivers refer drivers

**Important Warnings:**

* Self-referral is not allowed (using your own code)
* Cross-type referrals are not allowed (rider cannot refer driver)
* Each referral code can only be used once per referee
* Rewards are only given for the first completed ride
* Abuse of the system may result in account suspension

#### Fraud Prevention Measures:

* System validates all referral connections
* Duplicate referrals are automatically blocked
* Ride amount verification prevents abuse
* Account status checks ensure valid users