> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.bitbybit.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Understanding referral

> How bitLoyalty referral works: who can refer, how a friend's order is attributed, when points are given, and what happens on a refund.

A customer shares a personal link, a friend buys through it, and when the friend's first qualifying order is paid, both earn points. This page explains the rules, so you can predict what the History page shows.

To turn referral on, see [Set up referral](https://knowledge.bitbybit.studio/loyalty/how-to-set-up-referral.md).

## Who earns points

| Role | Who | Earns |
| - | - | - |
| **Referrer** | An identified customer with a referral link. No earlier order needed. | Fixed points when the friend's qualifying order is paid. |
| **Friend** | Someone new to your store (no earlier paid order) who buys through the link. | Fixed points on their first qualifying order. |

A customer in **Customers** who has never paid for an order still counts as new.

## How a referral is counted

**1. The referrer shares a link**

Each identified customer has one link per channel: Commerce (WhatsApp) and Shopify.

**2. The friend opens the link**

The visit is recorded, but it isn't a referral yet.

**3. The friend orders**

> [tab] Commerce
>
> The friend sends the pre-filled WhatsApp message. The referral shows **Pending** until the order is paid.

> [tab] Shopify
>
> The referral is recorded when the order is paid, including Buy it now orders. It needs the referral script active on your Online Store. Draft and point-of-sale orders don't count.

**4. The order is paid**

If the rules below pass, both sides get their points straight away and the referral shows **Rewarded**.

## Rules

* **One referral per friend**, and only their first qualifying order.
* **New customers only.** A friend with an earlier paid order isn't eligible.
* **No self-referral.**
* **Seven-day window.** The order must be paid within 7 days of opening the link.
* **Your limits.** Minimum purchase and quota per referrer, if you set them.

A referral that fails a rule shows **Rejected** and no points are given.

> [!NOTE]
>
> Self-referral and repeat-friend checks match on contact details such as phone number, email, and Shopify customer. Someone using a different number or email can pass them, so review unusual patterns in History.

## Referral statuses

| Status | Meaning |
| - | - |
| **Pending** | The friend's order isn't paid or doesn't qualify yet. On Commerce, this starts right after the friend messages. |
| **Rewarded** | The order qualified and both sides got points. |
| **Rejected** | A rule failed, for example the friend wasn't new or the order was paid after 7 days. No points given. |
| **Reversed** | The order was refunded or cancelled after rewarding. Both sides' points were taken back. |

Shopify referrals usually skip **Pending**. There is no approval step and no separate Expired status. History doesn't show why a referral was rejected — use the rules above.

## Program states

| State | Meaning |
| - | - |
| **Off** | Links aren't offered. Customers keep existing links, and new customers get theirs when you switch back on. |
| **Preparing** | First-time setup: bitbybit is creating links for existing customers. Links aren't available yet. |
| **Ready** | Links can be shared and friends credited. |

A link shows only when the program is **Ready** and its channel is ready (Shopify script active, or WhatsApp connected). It is also hidden for unidentified customers and referrers who hit the quota.

## Who sees what

* **Customers** see only their own link and how many friends they referred.
* **Merchants** see every referral and its timeline in [Referral history](https://knowledge.bitbybit.studio/loyalty/referral-history-reference.md), and can copy any customer's links from their detail page.

## FAQ

> [accordion] Can a referral reward be a voucher instead of points?
>
> No. Referral rewards are fixed points only.

> [accordion] Does the friend get anything just for opening the link?
>
> No. Points are given only after their first qualifying order is paid.

> [accordion] Do unidentified chat visitors get a link?
>
> No. Only customers identified in **Customers** get a referral link.

## Related

* [Set up referral](https://knowledge.bitbybit.studio/loyalty/how-to-set-up-referral.md)
* [Referral history reference](https://knowledge.bitbybit.studio/loyalty/referral-history-reference.md)
* [bitLoyalty overview](https://knowledge.bitbybit.studio/loyalty/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.