Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Customers

Perkville’s Customers page is the central hub for managing loyalty and referral program participants. From this page, business staff can search for customers by name, email, or an external member ID from a connected system, add new customers to the program, and send invitations to join. Staff can also manage customer communication, view membership status, track point history and balances, manually adjust points, log activities, and void transactions when necessary. Additionally, they can handle account transfers and manage referrals by viewing or submitting them. To access these tools, click Customers in the left-hand navigation menu of the Dashboard.

Accessing a customer's profile

To access and manage a customer's profile in Perkville:

  1. Start from the Dashboard and click Customers in the left navigation menu.

  2. Search by the customer's email address or name, or use Filter by External Member ID if you have the customer's ID from a connected system.

  3. Click the customer's name from the search results.

Searching by External Member ID

If your integration provides external member IDs to Perkville, select Filter by External Member ID, enter the member ID, and submit the search. If that ID is associated with a Perkville customer through the connected system, Perkville will display the matching customer record.

See Customer identifiers for more information about external member IDs and how they relate to Perkville profiles.

If you know the customer's ID from the Perkville API, you can go to the customer's profile by entering their user_id in the URL. For example: https://www.perkville.com/biz/1234/customer/{user_id}/

When a member exists in your POS but not in Perkville

If you can find a person in ABC Ignite, Club Automation, or another connected membership system but cannot find them in Perkville:

  1. Check the customer search. Search using the member's name and email address. If your integration provides an external member ID, try Filter by External Member ID using the value from the source system.

  2. Verify identifiers. Compare the email, external member ID, business and location with the source system. Look for alternate emails or an existing Perkville profile with different contact information.

  3. Confirm the member qualifies. Check whether your program includes that location, membership status/type, and any join or eligibility conditions.

  4. Check the integration. Confirm the source record was created or updated and that the integration has had an opportunity to transmit the relevant member data. A record in the source system does not guarantee a Perkville profile has already been created.

  5. Escalate before duplicating. If no matching account appears, contact Perkville Support with the business/location, source-system member ID, and approximate creation or update time. Avoid manually creating a second profile until Support confirms the correct next step.

See Integration Reference for provider-specific setup information and Customer identifiers for more on searching integrated member IDs.

Invite customers

Manually send invitations to customers to join your loyalty program by clicking Invite on the customer's profile.

You can also invite customers in bulk via the Invite customers page (accessible via your primary dashboard page).

You can only send invites to pending customers.

Manual points, redemptions, and adjustments

Business staff members can manually add points, redeem points, and make point adjustments.

The ability to give or redeem points for a customer is dependent on the staff member’s role. Find the right person at your business who has these permissions if you do not.

Manually adding points to a customer's account

To add points to the customer’s balance, click on the Give points button.

To remove points from the customer’s balance, click on the Redeem points button.

You can also add points to customers' profiles in bulk.

If you are trying to remove a customer's points because their membership was cancelled, consider using the automatic cancellation-based expiration setting instead of manually removing points. See Membership settings.

Manual point changes and cancellation-based expiration are different workflows. Participation restrictions for inactive members can also affect which manual actions are available on an individual customer profile.

Voiding transactions

You have the ability to void both earning and redeeming transactions, effectively reversing the transaction. This feature is helpful for correcting transactions made in error.

How to void a transaction

  1. Access the customer profile.

  2. Select the transaction you want to void by checking the box to the left of the transaction.

  3. Click the Void transaction button.

Only staff members with Employee or Admin level permissions can void transactions.

View and submit referrals

You can view pending and completed referrals by clicking View referrals on a customer's profile.

To manually submit a referral, click Submit referral. You will then be prompted to enter the email address of the friend being referred.

If the friend is already a member of your business

If the friend being referred is already a member of your business, you will receive a notification warning that the referred friend has already earned points at the business. Depending on your staff role, you'll be able to override this warning and award the referral bonus manually.

Change a voucher status

You can mark a customer's vouchers as USED or UNUSED by locating their redemption via their customer history page and then clicking on the status.

Manage the customer's email

You can manage a customer's email addresses by clicking Manage emails on the right hand side of their customer profile. This page describes the rules for managing customers' email addresses.

Switching the primary email

If a customer has a registered account and multiple confirmed email addresses (not pending), you can switch the primary email among those confirmed ones. Simply click the Make primary button next to the email you want to set as the primary email address.

If a customer has a pending account, you can switch the primary email between unconfirmed emails as well.

Adding and removing emails

You can add and remove emails from most accounts, but not under certain conditions, such as when the customer is also a staff member at a business on Perkville.

Troubleshooting missing points or widespread access issues

When a customer reports missing points, first review their profile's transaction history and confirm the qualifying activity, date, and location. If no qualifying transaction was recorded, check whether the source POS, membership, or booking system supplied it to Perkville. See Automating your program using Perkville's API for integration considerations.

If multiple customers report missing points, login problems, or inaccessible balances at the same time, do not begin by manually adjusting every account. Instead:

  1. Check whether the reports affect one location, integration, or a larger group of customers.

  2. Record the start time and timezone, affected locations, approximate number of reports, and exact error message or symptom.

  3. Collect two or three representative customer examples and the relevant activity timestamps or external transaction identifiers. Share personal data only through approved support channels.

  4. Confirm whether the underlying POS or membership system recorded the activity and whether any integration configuration recently changed.

  5. Contact Perkville Support at support@perkville.com with the collected information. Indicate clearly if the issue is affecting many customers or preventing access to the program.

Avoid repeatedly replaying transactions or making mass point adjustments before the cause is established, as this could create duplicate awards. For individual questions about program rules or reward eligibility, the customer's business remains the first point of contact.

Last updated

Was this helpful?