# Refer a Friend

This is a basic referral system integrated with the Wallet system and allows both the affiliate and the referral to obtain a reward.

### Setting up Referrals

{% hint style="success" %}
Old customers cannot be attached as a referral, only newly registered accounts.
{% endhint %}

The backend is very simple allowing you to choose between a percentage reward or a fixed amount reward.

* You'll also be able to choose the range of the order that qualifies for the reward
* An affiliate reward (This is the person sending out the link)
* A Customers Reward (Optionally give the person being referred to your website a reward)
* Referral Type (A choice between New Users, One Time & Recurring)

### Make sure your rules do not overlap

{% hint style="warning" %}
Only one rule will execute at a time per order, if there are two rules that reward on similar parameters, it will only reward the first rule. For example if you have a one-time referral rule with the exact same Min & Max Order Totals and different rewards as a new user rule, whichever is the first one will be rewarded and the second one will not be rewarded. New User rules should be above One Time rules for this reason.\
\
If you had two New User sign ups and the Order totals overlap both rules, only the first one will be rewarded and the second one will never work.
{% endhint %}

{% hint style="danger" %}
**Rules are bypassed on Orders paid with Wallet Credit**
{% endhint %}

{% tabs %}
{% tab title="New User" %}
This means newly registered customers signed up at affiliate link that have not spent anything previously and its their first order. This will only work once per new customer and does not offer recurring rewards.
{% endtab %}

{% tab title="Recurring" %}
This is a continuous referral, everytime a referral places an order with or without the referral link the rule will be executed. This is typically paid with a % reward type & will work with existing referrals & new referrals aswell. \
\
Optionally, you can set a date so the promotion only applies to referrals registered from that date onward, ensuring that older, existing referrals are excluded if desired.

**It will not reward on orders paid by Wallet credit**
{% endtab %}

{% tab title="One Time" %}
This can be any newly registered customer with the affiliate link, existing referrals can be upsold aswell but **must use the referral link**, this reward type can only be claimed once. They cannot keep getting the same reward unless you change the rule name to a new one.
{% endtab %}
{% endtabs %}

<figure><img src="/files/NlMCa3NHXqlTVRblkmoF" alt=""><figcaption></figcaption></figure>

### Customising Rewards per Affiliate

You can only set a % reward unique commission for a customer, not a fixed reward. This is to prevent mistakes overtime where you over reward someone. You can do this in the Edit User options on your users page.

<figure><img src="/files/u38UCwQ7QghEikzXngm2" alt=""><figcaption></figcaption></figure>

### Frontend view of the Referral Dashboard

<figure><img src="/files/RO4i2zQRdhKx19AY5LMO" alt=""><figcaption></figcaption></figure>


---

# 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://competitions.gitbook.io/competition-docs/other-features/refer-a-friend.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.