# Referral overview

### ℹ️ What Is a Referral in Jaka?

The **Referral Program** in Jaka helps your customers promote your store by sharing a referral link or discount code.\
When someone buys through that referral, both the referrer and your store benefit.

A referral happens when:

1. A customer (referrer) shares their referral link or discount code
2. A new customer clicks the link or uses the code
3. The new customer places an order
4. The referrer earns a reward (discount, commission, or benefit you define)

Jaka tracks this entire flow for you — no manual work needed.

***

### 🧩 Key Referral Terms&#x20;

Here are a few important terms you’ll see in the referral feature:

* **Referrer (Advocate)**\
  The person who shares your store and refers new customers.
* **Referral Link**\
  A unique link assigned to the referrer. Orders made through this link are tracked automatically.
* **Referral Discount Code**\
  A code the referrer can share instead of a link. It also tracks referral orders.
* **Referral Reward**\
  What the referrer earns after a successful referral (for example: discount, cashback, or store credit).
* **Referral Conversion**\
  A successful referral order created using a referral link or code.

***

### ✅ How the Referral Program Works

Currently Jaka app provides referral popup and reward customers with discount only.

1. &#x20;Store owner displays the referral **Widget** (Displays for advocates) on the online store.

<figure><img src="https://2078839253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdV1PFu8mN1B3K5QZCrx%2Fuploads%2FzGFkJ0wTJhUeSjwbKlb8%2F2024-10-22_14-44-40.png?alt=media&#x26;token=7148a154-c938-4768-b84e-d53a4ba259d8" alt=""><figcaption></figcaption></figure>

2. Customer 1 (referrer) click on referral popup > enter their email address > get a referral link right away

<figure><img src="https://2078839253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdV1PFu8mN1B3K5QZCrx%2Fuploads%2F7qztdgOd38MKIxiRPbQz%2F2024-10-22_14-30-26.png?alt=media&#x26;token=a6f84506-3455-4f55-b567-5d53ec8dd123" alt=""><figcaption></figcaption></figure>

Customer 1 (referrer) share referral link to their fiend (customer 2)  and offer him x % discount  > their friends open the referral link to purchase products > the **Popup (Displays for friends)** shows up

<figure><img src="https://2078839253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdV1PFu8mN1B3K5QZCrx%2Fuploads%2Fuy4R4e4sidiGI4Xex72U%2F2024-10-22_15-18-33.png?alt=media&#x26;token=44bf5c6a-80c9-4839-b1bb-0d4493f9efe8" alt=""><figcaption></figcaption></figure>

&#x20;3\. Customer 2 will purchase the  products on your store and use the discount code at checkout. If the order is created, the referrer who shared the discount code will receive a discount too.&#x20;

Email notification will sent with discount code.&#x20;

* set discount for referrer here&#x20;

<figure><img src="https://2078839253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdV1PFu8mN1B3K5QZCrx%2Fuploads%2F7Pp6wSrO1CWR5Ko1pPlg%2F2024-10-22_15-20-53.png?alt=media&#x26;token=a66a0957-5580-41cb-8b34-ccd56b5eb9a8" alt=""><figcaption></figcaption></figure>

* email will look like this&#x20;

<figure><img src="https://2078839253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdV1PFu8mN1B3K5QZCrx%2Fuploads%2Ff4JsaFZVPzEmDeJnyjq3%2F2024-10-22_15-21-50.png?alt=media&#x26;token=f175f2c6-924a-43d0-ab2e-3096773ca047" alt=""><figcaption></figcaption></figure>

On the **Setting** window pops up, you can edit the coupon of the Referral with a **Percentage** or a **Fixed** **Amount** and other conditions of the coupon below:

* This discount requires a minimum order subtotal: the minimum amount of the order of Referral friend so the Referral will get a coupon as a reward from the Merchant
* The reward will expire in: the valid day's number from the day the reward is sent so that Referral can use it

Also, you also can customize the front-end interface of the Referral contains **button** and **popup** after clicking the button.&#x20;


---

# 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.jaka.app/shopify/2-referral-program/referral-overview.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.
