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

Loyalty Cards

The Loyalty Cards system lets businesses reward returning customers with physical collectible cards. Customers accumulate visits to unlock a discount — all tracked automatically through the Business APP.

Creating Zone

  • First of all you need to create a new Loyalty Cards zone, where the business will be able to print the cards.

Loyalty Programs (Business App)

Programs are managed from Business App → Loyalty tab. Only players with the appropriate permission can create or modify programs.

Creating a Program

Field
Description

Name

Display name shown on the card and in menus

Image

URL for card image

Required Visits

How many cashier scans are needed to redeem

Discount

The reward amount

Discount Type

Percentage (e.g. 10%) or Flat (e.g. $5 off)

Max Prints

Optional cap on how many cards can ever be printed

Visit Cooldown

Minimum minutes between valid scans (default: 60= 1 hour)

Activating / Deactivating

Each program has an active toggle. Deactivating a program prevents new cards from being printed and blocks further scans on existing cards. It does not delete cards already in circulation.

Deleting a Program

Deleting a program removes it permanently from the database. Cards already printed for that program will return an inactive status when scanned.

Creating the Loyalty Card

  • As a Business Owner or Employee with the Products permission, go to Business APP > Products tab and register a new Product with Product Type as Loyalty Card

Printing a Loyalty Card

  • Head to your Loyalty Card zone to open the menu, select the promo you want to generate a card for.

  • Select the item you want to use as Loyalty Card and start crafting it

  • Once crafted you can use the item to display the image and promo on screen, tap the card to flip it and reveal the code.

Using the Loyalty Card

  • When paying for an order at the cashier, make sure to enter your Loyalty Card Code and click the Apply button to validate it.

  • Your visit will be registered to your card after payment approval, the code will enter a cooldown and can't be used during a certain period to avoid abuses.

  • You can use your Loyalty Card item to check your current visit count

  • When the needed amount of visits it's reached, the Loyalty Card promo will be automatically applied to your current order.

Last updated