> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/features/referrals/completing-a-referral.md).

# Completing a referral

{% hint style="info" %}

#### Key Concepts

**Completed Referral:** A referral that has met the required conditions such that the referrer is eligible for their reward.

**Referrer / Referee:** These terms distinguish the two parties in a referral. The **referrer** is the existing member who refers someone else to the business. The **referee** is the friend/new customer who was referred.

**Earning Rules:** The configurable rules that determine how customers earn points in the loyalty program.

**Activities:** A special type of earning rule used to *track* certain customer activities without awarding points for them.
{% endhint %}

For referral setup options, see [Configuring your referral program](https://docs.perkville.com/features/referrals/configuring-your-referral-program.md).

If you are troubleshooting a referral that was submitted but did not award the expected referral points or reward, see [Why hasn't the referrer received their referral reward?](https://docs.perkville.com/faqs/referrals/why-hasnt-the-referrer-received-their-referral-reward.md).

## **Completing referrals on Perkville**

Referrals on Perkville are marked as "completed" when referral-eligible [earning rules](https://docs.perkville.com/features/earning-rules.md) or activities are earned by the referee. You can decide which earning rules and activities complete a referral by toggling the **Completes Referral** setting on.

Claiming a referral offer does not normally complete the referral by itself. The referred person must complete an activity that your program treats as referral-completing.

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FVyXP8eMg4klDkG1o6ETk%2FScreenshot%202025-06-27%20at%202.48.58%E2%80%AFPM.png?alt=media&#x26;token=420d8325-8e64-49d4-8bff-cbf85f739ac8" alt=""><figcaption><p>By toggling <strong>Completes Referrals</strong> to Yes, you are making the activity eligible to complete referrals when the referred friend earns the activity.</p></figcaption></figure>

{% hint style="info" %}
**Example Scenario:**

* Dave refers his friend Melissa.
* Melissa visits the business and makes a purchase, satisfying an earning rule that completes the referral.
* Since the earning rule's "Completes Referral" toggle is set to "Yes", Dave earns points for the referral.
  {% endhint %}

## Reviewing referral-eligible perks

You can get a high-level overview of which activities are eligible to complete referrals via your Rewards Program page. You will see a completes referral icon next to the earning activity.

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FRUv8o5mGJ5QttvCESUwi%2FScreenshot%202025-06-27%20at%202.51.51%E2%80%AFPM.png?alt=media&#x26;token=88f20535-62c6-43d4-b4b6-457712d6baba" alt=""><figcaption><p>The icon of two people indicates an activity is eligible to complete referrals.</p></figcaption></figure>

## Membership restrictions and completing referrals

If rewards participation is restricted only to members, this will affect how you can complete a referral.

* Earning activities will not be awarded to non-members and will not complete referrals.
* If you manually award an earning activity to a non-member, any referrals will complete.
* Activities will trigger referral completions for non-members.

## Multiple referrals count

If an individual is referred to your business by multiple other individuals, all of the referrers will receive bonus points.

For example, if Elise is referred to your business by Samantha and Sarah, both Samantha and Sarah will receive bonus points and their referrals will be marked as completed.

## The "Join restriction" and referrals

The [join restriction](https://docs.perkville.com/features/settings/advanced/join-restriction.md) setting prevents users from earning points until they join the rewards program. Ordinarily, a referred person must [earn points](https://docs.perkville.com/features/earning-rules.md) or receive an activity to complete any pending referrals. However, if a point-earning transaction is *attempted* for a referred person and rejected *only* because they haven't joined Perkville yet, the referral is completed anyway.

In this way, the join restriction does not prevent referrals, and referred persons do not need to join Perkville before their referrals are completed.

For example, if Ted is referred to your business by Olivia and Ted completes a purchase that would award points except that Ted hasn't joined Perkville yet, Olivia's referral would still be completed. If that referral awards points, Olivia would receive them.

## Referrals recorded in an integrated POS or membership system

A referral source entered in another system does not, by itself, establish that a Perkville referral was created or completed. Whether those fields are imported depends on the specific integration configuration. A Perkville referral still requires the correct referrer/referee association and a qualifying activity configured to complete the referral.

For businesses using Club Automation, see [Club Automation integration guidance](https://docs.perkville.com/integrations/integration-reference/club-automation.md). If you are unsure whether referral-source data flows into Perkville, contact your Customer Success Representative before promising an automatic referral award.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/features/referrals/completing-a-referral.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
