This guide covers everything you need to know about setting up and running loyalty programs for your coffee shop.Documentation Index
Fetch the complete documentation index at: https://docs.petakopi.my/llms.txt
Use this file to discover all available pages before exploring further.
New here? Start with the Quick Start guide to get your first program running in minutes.
Setting up a loyalty program
Create and manage loyalty programs from the Manage menu in the petakopi.my mobile app. (See the Quick Start guide for the end-to-end walkthrough.)Go to Manage
Open the petakopi.my app, tap Home, then “Manage”, pick your shop from the list, and tap Loyalty.
Create a new program
Tap “New Program” and fill in the details:
- Program name — e.g. “Buy 10 Get 1 Free”
- Stamps required — How many stamps to complete the card (1–10)
- Expiration days — How long cards stay valid (default: 365 days)
- Terms & conditions — What the reward is and any rules
- Active — Toggle on to allow customers to enroll
Skip or customize card appearance
The form includes a Card Appearance section where you can customize wallet card colors. The defaults work well — you can always come back to customize later. See Customizing card appearance below.
Editing a loyalty program
You can edit your loyalty program from the Manage panel. However, once customers have active cards, some fields are locked to protect their progress:| Field | Editable? | Notes |
|---|---|---|
| Program name | Yes | Updates Apple Wallet passes immediately; Google Wallet updates on next stamp or new card |
| Terms & conditions | Yes | Updates appear on wallet passes after the next stamp |
| Expiration days | Yes | Only affects newly issued cards, not existing ones |
| Active status | Yes | Only controls whether new customers can enroll |
| Stamps required | No | Changing this would unfairly affect customers’ progress toward their reward |
Customizing card appearance
You can customize how your loyalty card looks in Apple Wallet and Google Wallet. This is available when creating a new program or editing an existing one. Customize the following colors with a live wallet preview:- Background color — Main card background color
- Text color (Apple only) — Text color on the card
- Stamp area color (Apple only) — Color behind the stamp grid
Apple Wallet cards update immediately after saving. Google Wallet cards reflect changes on the next stamp or when a new card is created.
Scanning stamps
Scan customer loyalty cards using the petakopi.my mobile app.Scan the customer's QR code
Point your camera at the customer’s loyalty card QR code. The customer can show their QR code from:
- The petakopi.my website or app on their phone
- Apple Wallet or Google Wallet
Award stamps
Select the number of stamps to award and tap “Add Stamps”. You’ll see a confirmation once the stamps have been added.
Managing cards
From the Manage panel, you can:- View enrolled customers — See who has added your loyalty card
- Activity log — Track all stamp and redemption activity
- View individual cards — See the stamp count for each customer
Messaging loyalty card holders
You can send messages to customers who hold your loyalty cards. This is useful for announcing promotions, new menu items, or special events. Messages are sent as notifications to your loyalty card holders through the petakopi.my app and website.