> 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/guides/perkville-staff-training-guide.md).

# Perkville staff training guide

### Welcome to Perkville!

Perkville makes it easy to reward your customers for doing things they already love, like shopping, visiting your business, booking services, and referring their friends.

As a staff member, you're an important part of making the loyalty program a great experience. This guide will show you how to help customers earn points, redeem rewards, and get answers to common questions.

**Before you get started:** Every business has its own earning activities, rewards, and program rules. Look for the \[brackets] throughout this guide to add your business's details.

### 1. How the rewards program works

It's pretty simple:

**Earn points → Save points → Get rewards!**

Customers earn points for eligible activities at your business. Once they've collected enough points, they can redeem them for rewards.

#### Ways customers can earn points

Depending on your loyalty program, customers might earn points for:

* Making purchases
* Visiting your business or checking in
* Booking appointments or services
* Referring a friend
* Celebrating a birthday
* Participating in special promotions

#### Your business's earning activities

| **Activity**                           | **Points earned** |
| -------------------------------------- | ----------------- |
| \[Make a purchase]                     | \[1 point per $1] |
| \[Visit your business]                 | \[10 points]      |
| \[Refer a friend who makes a purchase] | \[500 points]     |
| \[Birthday bonus]                      | \[100 points]     |

*These are examples. Update this table to match your rewards program.*

#### What can customers redeem?

Rewards might include discounts, free products, complimentary services, or other perks your business chooses.

| **Reward**               | **Points needed** |
| ------------------------ | ----------------- |
| \[10% discount]          | \[250 points]     |
| \[Free product]          | \[500 points]     |
| \[Complimentary service] | \[1,000 points]   |

#### How to view your earning activities

*For administrators.*

1. Log in to your Perkville business dashboard.
2. Open **Loyalty Program** from the left menu or **My Business** menu.
3. Find **Earning Activities**.
4. Review the activities, point values, limits, and participating locations.

Some activities award points automatically through your connected business software, while others may require manual staff action.

### 2. Getting started with Perkville

#### How to log in

1. Visit [Perkville](https://www.perkville.com/).
2. Log in using your staff email address and password.
3. Open your business dashboard.

That's it! You're ready to help customers.

#### What can staff members do?

Not everyone needs access to everything. Perkville has different staff permission levels.

| **Staff role** | **What they can do**                                                        |
| -------------- | --------------------------------------------------------------------------- |
| Scan Voucher   | Mark vouchers as used and receive applicable notifications                  |
| Front Desk     | Look up customers, help with redemptions, view referrals, and run reports   |
| Employee       | Front Desk responsibilities, plus adding points and correcting transactions |
| Admin          | Manage the rewards program, staff access, and business settings             |

Some permissions can be customized, and access may be limited by location.

**Good to know:** If you can't find an option mentioned in this guide, your staff account might not have permission to use it. Check with your manager.

#### How to add a staff member

*For administrators.*

1. Go to **Settings → Staff members**.
2. Click **Add Staff Member**.
3. Enter the employee's email address.
4. Choose their permission level.
5. Enter their title and select their assigned locations.
6. Save the staff member.

Choose the permission level that matches what the employee needs to do.

#### How to update or remove staff access

1. Go to **Settings → Staff members**.
2. Click an employee's name to update their information or permissions.
3. To remove an employee, use the **X** next to their name.

Before removing an administrator, make sure another authorized administrator can access the account. If the departing employee is responsible for billing, transfer that responsibility first.

**Want more details?** Check out [Staff members and permissions](https://docs.perkville.com/features/settings/staff-members) for a complete breakdown of staff roles and how to manage access.

### 3. Helping customers with their points

One of the most common questions you'll hear is:

*"Where are my points?"*

Here's how to help.

#### How to find a customer

1. Log in to your Perkville business dashboard.
2. Select **Customers** from the left menu.
3. Search for the customer's name or email address.
4. Click their name to open their profile.

From the customer profile, you can review their point balance, transaction history, and other account details.

#### How to invite a customer

If a customer hasn't activated their rewards account, you may be able to send them an invitation.

1. Go to **Customers**.
2. Search for the customer and open their profile.
3. If the customer has a pending account, click **Invite**.
4. Follow the prompts to send the invitation.

The customer can then follow the invitation instructions to join the rewards program.

#### How customers earn points automatically

Many earning activities can be tracked through your business's connected software.

For example, if your program awards points for eligible purchases or visits, customers may receive points automatically after those activities are recorded.

Other activities may require staff assistance.

**Quick tip:** Make sure customers use the same email address for their Perkville account and their account with your business. Different email addresses are a common reason points don't appear as expected.

#### What if points are missing?

Before adding points manually, check a few things:

1. Make sure you're looking at the correct customer account.
2. Check their transaction history.
3. Confirm they completed an eligible activity.
4. Verify that their email address matches the one associated with your business.
5. Check that the activity was recorded correctly in your connected system.
6. Confirm that the activity and location qualify for points.

Points typically appear within an hour, but some transactions may take up to 48 hours to process.

If the points still haven't appeared after the expected processing period, contact your manager or Perkville Support.

**Want more details?** See [What to do when a customer is missing points](https://docs.perkville.com/faqs/points/my-customer-is-missing-points.-what-should-i-do) for additional troubleshooting steps.

#### How to add points manually

*Requires Employee or Admin permissions.*

Sometimes customers need a little help getting the points they've earned.

1. Go to **Customers**.
2. Search for the customer and open their profile.
3. Check the transaction history to make sure the points haven't already been awarded.
4. Click **Give points**.
5. Choose the appropriate earning activity or adjustment option.
6. Enter the required information.
7. Save the transaction.
8. Check that the points were added.

**Remember:** Only add points for approved activities. Double-check the customer's account first so you don't accidentally award points twice.

Manual point adjustments do not automatically send an email notification to the customer.

#### How to fix an incorrect transaction

Mistakes happen!

If an incorrect transaction was recorded:

1. Open the customer's profile.
2. Find the transaction in their history.
3. Select the checkbox next to the incorrect transaction.
4. Click **Void transaction**.
5. Confirm the adjustment.

You can then add the correct transaction if needed and approved.

Voiding transactions requires Employee or Admin permissions.

#### Need to add points to multiple customers?

Perkville also allows authorized staff to add points to multiple customers at once.

Go to **My Business → Add / Redeem** to access the bulk point tools.

You can give the same number of points to multiple customers or use a CSV upload for different quantities.

**Want more details?** Learn about [Customer management](https://docs.perkville.com/features/customers) and [Bulk point updates](https://docs.perkville.com/features/customers/bulk-point-updates) for more instructions.

### 4. Referrals: Friends bring friends!

Referrals are a great way for customers to earn extra points while introducing friends and family to your business.

#### How referrals work

Here's how a typical Perkville referral works:

1. **Share a referral offer.** A customer visits the referral page in their loyalty account and shares the offer with a friend through email, social media, or their personalized referral link.
2. **Receive the offer.** The friend receives the referral offer, often through a text message or email.
3. **View the details.** The friend opens the referral offer to learn more.
4. **Claim the offer.** The friend claims the offer and receives a voucher with instructions for using it.
5. **Complete a qualifying activity.** When the friend completes the activity required by your program, such as making a purchase or signing up for an eligible service, the referring customer receives their referral reward.

The exact referral process depends on your program settings.

**Example:**

Refer a friend who makes their first qualifying purchase and earn \[500 points]!

*Update the reward amount and qualifying activity to match your program.*

#### Where customers can share referrals

Customers can share their referral offers through:

* Email
* Text messages
* Social media
* Personalized referral links

Customers can access their referral-sharing options through their rewards program.

#### How to check a referral

1. Go to **Customers**.
2. Search for the customer who made the referral.
3. Open their profile.
4. Click **View referrals**.
5. Review the referral's status.

You can see pending and completed referrals.

A referral may still be pending if the friend hasn't completed the required activity.

#### How to submit a referral manually

*For staff with the required permissions.*

1. Open the referring customer's profile.
2. Click **Submit referral**.
3. Enter the referred friend's email address.
4. Select a location if prompted.
5. Review the information and submit.

**Heads up:** If the referred friend has already earned points at your business, Perkville may display a warning.

Depending on the employee's permissions, they may be able to override the warning and submit the referral. Always verify that the referral qualifies before proceeding.

#### What if referral points are missing?

First, confirm that the referred friend completed the activity required by your business.

For example, claiming a referral offer might not be enough if your program requires the friend to make a purchase.

If everything looks correct but the points are missing, contact your manager or Perkville Support.

**Want more details?** Check out [How referrals work](https://docs.perkville.com/features/referrals) for a step-by-step explanation of the referral process, including how offers are shared, claimed, and completed.

### 5. Redeeming rewards

When customers save enough points, they can redeem them for the rewards your business offers.

#### How customers redeem rewards

Customers can redeem rewards through their Perkville rewards account.

1. Log in to the rewards account.
2. Browse the available rewards.
3. Choose a reward.
4. Review the details and point cost.
5. Confirm the redemption.

The points are deducted from the customer's balance when they redeem the reward.

They'll receive a voucher with instructions for using their reward.

#### How to help a customer redeem

Staff with the appropriate permissions can also assist with redemptions from the business dashboard.

1. Open **Customers**.
2. Find the customer.
3. Confirm they have enough points.
4. Select **Redeem points**.
5. Choose the reward and complete the redemption.
6. Check the voucher details and follow your business's fulfillment process.

**Quick tip:** Always read the reward's fine print before completing a redemption. Some rewards have location restrictions, expiration dates, or special instructions.

#### How to find a voucher

Customers can find their vouchers by logging in and going to **Perks → My Vouchers**.

Staff can also review voucher activity from the customer's profile.

A voucher includes useful information such as:

* The name of the reward
* The number of points redeemed
* The voucher status
* The expiration date, if applicable
* Any terms or restrictions
* A voucher code, coupon code, or other fulfillment details

#### Understanding voucher statuses

| **Status**                 | **What it means**                                              |
| -------------------------- | -------------------------------------------------------------- |
| Unused                     | The reward has been redeemed but hasn't been marked as used    |
| Used                       | The voucher has been marked as used                            |
| Issued                     | The voucher was issued without requiring a later status change |
| Pending further processing | The voucher is waiting for an automated or external process    |
| Expired                    | The voucher expired before it was used                         |
| Voided                     | The voucher was canceled and its points returned               |

Your rewards program may not use every voucher status.

**Good to know:** Redeeming a reward and using the reward are two different things. Points are deducted when the reward is redeemed, even if the customer hasn't used the voucher yet.

#### How to mark a reward as used

For rewards that require staff to confirm voucher usage:

1. Find the customer's voucher.
2. Confirm that the voucher is valid.
3. Fulfill the reward using your business's instructions.
4. Mark the voucher as **Used**.

Depending on the voucher settings, you can update its status through the customer profile or use the **Mark Perks as Used** scanning process.

Some rewards are fulfilled through coupon codes or automated integrations and don't require staff to mark a voucher as used.

**Want more details?** Learn about [Vouchers](https://docs.perkville.com/features/vouchers) and [Voucher statuses](https://docs.perkville.com/features/redeeming-rules/custom-rewards/voucher-statuses).

#### What if someone redeems a reward by mistake?

Oops! It happens.

If the reward hasn't been used or fulfilled, authorized staff may be able to void the redemption and return the customer's points.

1. Open the customer's profile.
2. Locate the redemption transaction.
3. Confirm that the reward hasn't already been provided.
4. Check that the voucher is eligible to be voided.
5. Select the transaction.
6. Click **Void transaction**.
7. Confirm the points were returned.

If the reward was already used or provided, speak with your manager before making any changes.

**Want more details?** Read [How to handle mistaken redemptions](https://docs.perkville.com/faqs/redemptions/understanding-voucher-redemptions-and-how-to-handle-mistaken-redemptions) for guidance on when a voucher can be voided.

### 6. Reports: See how your program is doing

Want to see how many rewards customers have redeemed or how referrals are performing?

Perkville has reports to help you keep track.

#### How to view redemption reports

1. Open **Reports**.
2. Select **Redemption Details**.
3. Choose the date range and any relevant filters.
4. Click **Run Report**.
5. Review or download the CSV report.

This can help you see which rewards customers are redeeming and review individual transactions.

**Quick tip:** A customer might redeem a reward on one day and actually use it on another. The Redemption Details report uses the voucher's creation date, not necessarily the date the reward was used.

**Want more details?** See [Redemption Details](https://docs.perkville.com/features/reports/redemption-details) for available filters and report columns.

#### How to view referral reports

1. Open **Reports**.
2. Choose **Referral Overview** or **Referral Details**.
3. Select the dates and locations you want to review.
4. Run the report.

Use the results to see how many referrals have been sent, how many have been completed, and how your referral program is performing.

**Want more details?** Check out [Referral Overview](https://docs.perkville.com/features/reports/referral-overview) to learn more about referral metrics and filters.

#### What other reports are available?

Depending on your needs, you can also review:

* **Points By Customer:** See customer point balances.
* **Transaction Detail:** Review individual earning and redemption transactions.
* **Redemption Overview:** See overall reward redemption activity.
* **Registration Rate:** Track customer participation in your program.

**Want more details?** Visit [Perkville Reports](https://docs.perkville.com/features/reports) for a complete overview of the available reports.

### 7. When you need a little help

Most customer questions are easy to solve by checking their account and transaction history.

For anything more complicated, reach out to your manager or Perkville Support.

Common reasons to ask for help include:

* Missing points that haven't appeared after the expected processing period
* Referral bonuses that aren't being awarded correctly
* Duplicate customer accounts
* Vouchers that aren't working
* Integration or account issues
* Questions about staff permissions

When reporting an issue, include the customer's email address, the date of the activity, and any relevant transaction details. Use an approved support channel when sharing customer information.

**Perkville Support:** <support@perkville.com>

***

## Customer FAQs

### Everything customers want to know about their rewards

Customers have questions. We've got answers!

Use the FAQs below as a starting point for your loyalty program. Just update the \[bracketed details] to match your business and remove any questions that don't apply.

These can be shared on your website, added to welcome emails, or used by staff when answering questions.

#### What is \[Loyalty program name]?

\[Loyalty program name] is our way of rewarding you for being part of \[Business name]!

Earn points for eligible activities, like making purchases, visiting our business, or referring friends, and use those points to redeem rewards.

#### How do I sign up?

It's easy!

Visit \[Loyalty program URL] and follow the instructions to create your account.

Make sure to use the same email address you have registered with \[Business name].

#### How do I earn points?

You can earn points by \[list eligible activities].

Here are some ways to earn:

* \[Activity] = \[X points]
* \[Activity] = \[X points]
* \[Activity] = \[X points]

Visit \[Loyalty program URL] to see the available earning activities.

#### How do I check my points?

Log in to your rewards account at \[Loyalty program URL] to see your point balance and recent activity.

#### My points are missing. What should I do?

First, make sure you're using the same email address for your rewards account and your account with our business.

Some points may take a little time to appear.

If you're still missing points after \[processing timeframe], contact \[Support contact], and we'll help you look into it.

#### How do I redeem my points?

Once you have enough points:

1. Log in to your loyalty account.
2. Browse the available rewards.
3. Choose the reward you want.
4. Redeem your points.
5. Follow the instructions on your voucher.

Enjoy your reward!

#### Where do I find my redeemed rewards?

Log in to your account and go to **Perks → My Vouchers**.

You'll find your redeemed vouchers and their instructions there.

#### Do my points expire?

\[Add your business's point expiration policy.]

#### Can I use rewards at any location?

Rewards can be used at \[participating locations].

Some rewards may be limited to specific locations, so check the details before redeeming.

#### How do I refer a friend?

It's easy to share the rewards!

1. Log in to your loyalty account.
2. Open your referral page.
3. Share your referral offer through email, text, social media, or your personalized referral link.
4. Your friend can open the offer, claim it, and follow the instructions to use their voucher.
5. Once your friend completes \[qualifying activity], you'll receive \[referral reward].

#### Does my friend get a reward too?

\[Describe your business's referral offer.]

If your loyalty program includes a special offer for new customers, your friend can claim it through the referral link and receive a voucher with instructions for using it.

#### When will I get my referral points?

You'll receive your referral points once your friend completes \[qualifying activity].

Simply sharing the referral offer or having your friend claim it may not be enough to complete the referral.

If you think a qualifying referral is missing, reach out to \[Support contact].

#### Can I get my points back if I redeemed the wrong reward?

Oops! It happens.

Contact \[Support contact] as soon as possible.

If the reward hasn't been used or fulfilled, we can review whether the redemption can be canceled.

#### I forgot my password. How do I log in?

No problem!

Visit \[Loyalty program URL] and click **Forgot password?**.

Follow the instructions in the email to reset your password.

#### Can I change the email address on my account?

If you need to update the email address associated with your loyalty account, contact \[Support contact].

We can help you review the account information and determine the next steps.

#### Who do I contact if I need help?

We're happy to help!

Contact \[Business name] at \[Support email or phone number] with any questions about your rewards.

***

## A few things to check before sharing

This guide is designed to work for different types of businesses, so you'll want to make a few adjustments before sharing it with your team.

* **Make it yours.** Add your business name, earning activities, point values, rewards, and contact information.
* **Check your settings.** Confirm that the staff instructions match the features and permissions enabled for your business.
* **Keep things current.** If you add a new reward or change how customers earn points, update the relevant section.
* **Skip what you don't use.** Don't offer birthday points? Leave that example out.
* **Double-check your workflows.** Some Perkville features and instructions depend on the business's integration or account settings.
* **Use the help center when you need more details.** The links throughout this guide provide additional instructions for anyone who wants to learn more.

**That's it!** The more familiar your team becomes with the rewards program, the easier it'll be to help customers earn points and enjoy their rewards.


---

# 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/guides/perkville-staff-training-guide.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.
