# Referral Program

<mark style="color:$info;">The OpenRWA Referral Feature is a powerful growth tool that turns your existing investors into brand ambassadors. By offering a "Give-Get" incentive, you can lower your acquisition costs while rewarding loyal community members.</mark>

<mark style="color:$info;">**How the Referral Loop Works:**</mark>

* <mark style="color:$info;">Admin creates a program with specific rewards.</mark>
* <mark style="color:$info;">Investor A (Referrer) shares their unique invite code.</mark>
* <mark style="color:$info;">Investor B (New User) signs up using the code and receives a discount coupon.</mark>
* <mark style="color:$info;">Investor B makes an investment using the coupon.</mark>
* <mark style="color:$info;">Investor A automatically receives a cashback reward based on a percentage of that transaction.</mark>

***

### <mark style="color:blue;">Creating a New Program</mark>

<mark style="color:$info;">To get started, navigate to the Referral Management section in your Admin Dashboard.</mark>

{% stepper %}
{% step %}

#### Basic Information

* <mark style="color:$info;">**Program Name:**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">Give it a clear internal name (e.g., "Summer 2024 Offer").</mark>
* <mark style="color:$info;">**Duration:**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">Set a Start Date and End Date. The referral link will only be visible to investors during this active window.</mark>
  {% endstep %}

{% step %}

#### Configure Referrer Rewards (The "Get")

<mark style="color:$info;">Define what the existing investor receives for bringing someone in:</mark>

* <mark style="color:$info;">**Cashback Percentage:**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">The % of the new user's transaction amount paid to the referrer.</mark>
* <mark style="color:$info;">**Max Cashback Limit: (Optional)**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">The maximum amount a referrer can earn from a</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">single</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">new user.</mark>
  {% endstep %}

{% step %}

#### Configure New User Incentives (The "Give")

<mark style="color:$info;">Define the "welcome gift" for the person being referred:</mark>

* <mark style="color:$info;">Coupon Value: Set a fixed discount amount or percentage.</mark>
* <mark style="color:$info;">Max Discount Limit: If using a percentage, cap the maximum discount possible.</mark>
* <mark style="color:$info;">Coupon Validity: Set how many days the user has to use the coupon after signing up (e.g., 14 days).</mark>
  {% endstep %}
  {% endstepper %}

***

### <mark style="color:blue;">Managing Your Programs</mark>

<mark style="color:$info;">Once a program is live, you can manage it from the View Programs tab:</mark>

* <mark style="color:$info;">Extend Program: If a campaign is performing well, you can push the end date further out.</mark>
* <mark style="color:$info;">Discontinue: Stop a program immediately if you’ve reached your budget or want to change strategy.</mark>
* <mark style="color:$info;">Investor Tracking: In your Investor List, a new column "Referred By" will appear. This shows the email of the person who invited that specific user, allowing you to see which investors are your top promoters.</mark>

***

### <mark style="color:blue;">Analytics & Performance</mark>

<mark style="color:$info;">Knowledge is power. Use the Referral Dashboard to track:</mark>

* <mark style="color:$info;">Growth: Total signups and new registered users specifically from the referral link.</mark>
* <mark style="color:$info;">Financial Impact: The total value of discounts given to new users vs. the total cashback paid out to referrers.</mark>
* <mark style="color:$info;">Conversion: Detailed logs of transactions made by referred users to see the actual ROI of your program.</mark>

{% hint style="info" %} <mark style="color:$info;">**Wallet Requirement:**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">Remember, referrers must have a connected wallet to generate their code, as this is where their cashback rewards will be processed.</mark>
{% endhint %}

***

### <mark style="color:blue;">Investor Guide</mark>

#### For the Referrer: How to Share and Earn

<mark style="color:$info;">If you are an existing investor on the platform, you can earn cashback directly to your wallet by inviting others.</mark>

<mark style="color:$info;">**How to get your code:**</mark>

1. <mark style="color:$info;">Log In: Sign in to your OpenRWA account.</mark>
2. <mark style="color:$info;">Find the Referral Link: Click on your account dropdown (top right) and select Referrals.</mark>
   * *<mark style="color:$info;">Note: This link is only visible when an active referral program is running.</mark>*
3. <mark style="color:$info;">Connect Your Wallet: Click the "Get my invite code" button. You must have a wallet connected so the system knows where to send your cashback rewards.</mark>
4. <mark style="color:$info;">Share: Copy your unique code or link and send it to your network.</mark>

<mark style="color:$info;">**How you get paid:**</mark>

<mark style="color:$info;">When someone signs up using your code and makes an investment:</mark>

* <mark style="color:$info;">You receive a percentage-based cashback of their transaction amount.</mark>
* <mark style="color:$info;">The reward is automatically calculated and tracked via your Referral Performance dashboard.</mark>
* <mark style="color:$info;">You can view your total earnings and transaction history in the Referral section of your profile.</mark>

#### For the New User: How to Claim Your Discount

<mark style="color:$info;">If you’ve been invited to OpenRWA, you are eligible for a welcome discount on your first investment.</mark>

<mark style="color:$info;">**How to claim:**</mark>

1. <mark style="color:$info;">Sign Up: Click the referral link provided by your friend or enter their Referral Code manually during the registration process.</mark>
2. <mark style="color:$info;">Receive Your Coupon: Upon successful signup, the system will automatically generate a discount coupon for you.</mark>
   * *<mark style="color:$info;">Check your "My Coupons" section to see the validity (usually 14 days).</mark>*
3. <mark style="color:$info;">Invest: Browse the available asset tokens and head to the checkout.</mark>
4. <mark style="color:$info;">Apply Discount: During checkout, select your referral coupon. The discount will be applied immediately to your total investment amount.</mark>


---

# 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.spydra.app/how-to/public-chain/token-store/referral-program.md?ask=<question>
```

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.