> For the complete documentation index, see [llms.txt](https://docs.av-scripts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.av-scripts.com/laptop-pack/business/loyalty-cards.md).

# 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.

<figure><img src="/files/VJPGuaTBtQZr6yVy5R9n" alt=""><figcaption></figcaption></figure>

#### Loyalty Programs (Business App)

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

<figure><img src="/files/aUtUrvQvBrn5ibLGjfk3" alt=""><figcaption></figcaption></figure>

#### **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) |

<figure><img src="/files/ERHtiOqy6IBmlHi3Dzed" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/xywNBbA2MeulPHKy6esM" alt=""><figcaption></figcaption></figure>

**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.

{% hint style="warning" %}
Deleting a program with cards still in circulation means those customers can no longer redeem them. Consider deactivating instead.
{% endhint %}

#### 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

<figure><img src="/files/MvO8Q9a7zZjBzBjNOLAE" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2D6UBv7nlvdb2IxddBsQ" alt=""><figcaption></figcaption></figure>

#### Printing a Loyalty Card

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

<figure><img src="/files/9jBtSzhjWNoMMMzkleOO" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Dnw39vI1bOIsnFr7C0uY" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/UbZXUE12JMZslT90QRxq" alt=""><figcaption></figcaption></figure>

* 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.

<figure><img src="/files/XOv4nULD0GSerQ8qbrgY" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OUZjLMjIcxplR0vS1gqf" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="/files/eqRbbaQ2c3oYb8TKEoFE" alt=""><figcaption></figcaption></figure>

* 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

<figure><img src="/files/dKpS1FzSif90iieThPaR" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/hDpFLd4N9USb5vSHinaX" alt=""><figcaption></figcaption></figure>