Wallet Pass Design: How to Build a Loyalty Card Customers Use
Wallet Pass Design: How to Build a Loyalty Card Customers Use ! Customer presenting a digital loyalty pass A good wallet pass design does three things: it shows the one number the customer cares about (stamps or points) at a glance, it scans on the first try at your counter, and it gives the customer a reason to open it again.

Wallet Pass Design: How to Build a Loyalty Card Customers Use

A good wallet pass design does three things: it shows the one number the customer cares about (stamps or points) at a glance, it scans on the first try at your counter, and it gives the customer a reason to open it again. Everything else is decoration. This guide walks through how to lay out a loyalty pass for Apple Wallet and Google Wallet, what each platform lets you change, and how to use notifications without annoying people, with the Dutch consent rules in mind.
TL;DR
- Use the store-card style for loyalty on Apple Wallet and show the current balance on the front. Keep front fields brief and move terms to the back.
- Both platforms render the core fields in a fixed way. Your branding comes from colors, logo, imagery and wording, not from free-form layout.
- Test the barcode or QR code under real counter conditions: glare, a cracked screen, low brightness.
- Time and location relevance can bring the pass to the lock screen, but only with accurate data and an opt-in for marketing messages.
- In the Netherlands, direct marketing needs an active opt-in and an easy way to object or withdraw.
Table of Contents
- What a loyalty wallet pass is, and what you can design
- Designing the front of the pass
- Showing stamps, points, rewards and terms
- Apple Wallet: specifics worth knowing
- Google Wallet: specifics worth knowing
- Designing for the scan
- Notifications that bring people back without annoying them
- Privacy and consent in the Netherlands
- Try it on your own business
- A pre-launch checklist
- FAQ
- Sources
What a loyalty wallet pass is, and what you can design
A wallet pass is a small digital card stored in the customer’s phone. It sits next to their bank cards and boarding passes, so there is nothing to download and nothing to forget at home. For a salon, café or shop, that means the stamp card is always in the pocket where the customer already looks.
You do not get a blank canvas. Apple and Google each define pass styles with fixed zones, and your job is to fill those zones well. Apple uses the storeCard style for loyalty cards, while its generic style suits things like gym membership cards. Google’s documentation says predefined fields are rendered consistently, and that templates can arrange user-specific values such as points, balances, tiers and barcodes alongside programme-level information.
That constraint is good news. Customers recognize the layout instantly, and you spend your effort on what matters: the content of each field.
What you control
| Element | What you decide |
|---|---|
| Brand colors | Background and text colors that stay readable in bright light |
| Logo and imagery | A simple logo, plus a strip or hero image where the style allows it |
| Fields | Which values appear on the front and which go on the back |
| Barcode or QR code | The code type and the fallback text |
| Messages | What you send when the card changes |
| Relevance | Locations and times that surface the pass |
Designing the front of the pass
The front is read in about two seconds, usually while a customer is also holding a coffee or a bag. Design for that moment.
Put one number first
For a loyalty card, the question is always “how close am I to my reward?” Apple recommends showing the current balance on a store-card pass. Make that the most prominent element: “7 of 10 stamps” or “120 points”.
Apple also explains the hierarchy. Header fields are highly salient and are the only fields visible when passes are stacked in the wallet. Primary fields are prominent, and secondary and auxiliary fields carry less weight. So:
- Header: the balance or the reward status, since this is what shows when the pass is stacked.
- Primary: the headline of the card, such as your business name or the reward goal.
- Secondary and auxiliary: the customer’s first name, member since, or the next reward.
- Back: everything else.
If you design for Apple’s newer poster-style generic pass, the limits are tight: up to four primary fields and two footer fields, plus up to two Featured Action links. Four fields is plenty for a loyalty card. If you feel cramped, you are probably putting terms on the front.
Keep copy short
Apple’s guidance is to keep front fields brief and prioritize the most important information. In practice, aim for labels of one or two words and values of a few characters. “Stamps 7/10” works. “You currently have collected seven stamps toward your next free coffee” does not.
The same discipline applies to content in general. If you want a broader read on making copy easy to scan and act on, this conversion optimization playbook covers the principles, even though it is written for web pages rather than passes.
Pick colors for a bright counter
Your customers will show the pass outdoors, at a till under spotlights, or in a dim salon. Choose high contrast between text and background. A pale pastel with white text looks lovely on a designer’s monitor and disappears in sunlight. Test with the phone at low and high brightness before you go live.
Showing stamps, points, rewards and terms
This is where most passes are won or lost, and where platform documentation says the least, so these are design principles we apply rather than platform rules.
Stamps. Show a count and a goal together: “6 / 10”. If your card uses a stamp image strip, make sure the number is also in a text field, so it remains readable on the lock screen, on a smartwatch and for screen readers. Keep the reward goal constant. Changing it mid-card confuses people and creates arguments at the counter.
Points. Points work when the conversion is obvious. If a customer cannot work out what 120 points buys, they will stop looking. Show the next reward threshold next to the balance, for example “Next reward at 150”.
Rewards. Name the reward concretely: “Free haircut wash” or “Free filter coffee”, not “special gift”. When a reward is earned, change the pass so it is unmistakable: a different header value such as “Reward ready”, and a message that appears on the lock screen.
Redemption terms. Put them on the back, in plain sentences:
- What counts as a stamp (one per visit, one per purchase over a minimum amount).
- How long stamps or rewards stay valid.
- Whether rewards combine with other offers.
- Who to contact, with an address, phone number or email.
Apple’s guidance supports this split: longer terms and contact details belong on the back, while the front stays brief. Write the terms as you would explain them to a customer across the counter, and keep them consistent with what your staff say.
Apple Wallet: specifics worth knowing
Barcode types. Apple Wallet supports QR, PDF417, Aztec, Code128, Code 39, Codabar, EAN-13 and Interleaved 2 of 5 barcodes. For a stamp card scanned by your own staff, a QR code is the simplest choice because any phone camera or cheap scanner reads it.
The barcode is an ID, not the data. Apple notes that a barcode commonly holds a unique ID linked to server records, which you can use to update a balance, void a coupon or confirm validity. That is how a digital stamp card works: the code identifies the customer, and your system stores the stamps. It also means a screenshot of the pass cannot be used to “add” stamps by itself.
Fallback text. Apple lets you add alternative text that shows a code the staff can enter manually if the barcode cannot be scanned. Always set it. A cracked screen at the busiest hour of the week is exactly when you need it.
Updates. When a customer earns a stamp, the pass should change without them doing anything. Apple’s mechanism is that server push notifications prompt the device to query your server for changes and fetch the updated pass. Your loyalty platform handles this for you, but it is worth knowing why the pass can update in seconds.
For a closer look at how adding and issuing works on iPhone, see our guide on Apple Wallet loyalty cards.

Google Wallet: specifics worth knowing
Google Wallet’s model separates two layers. Class-level data holds information shared across users, and object-level data holds user-specific details. Combined, they create a personalized pass: your programme name, logo and rules sit at class level, while each customer’s stamps and name sit at object level. Design your class once, carefully, because every customer’s card inherits it.

Google recommends keeping supplementary information in lower sections or in features such as messages and links, so the main pass stays uncluttered. That matches the Apple advice to move detail to the back. On generic passes, text modules let you add extra titled blocks of text, which is a good home for terms and opening hours.
Google Wallet also supports rotating barcodes, which change periodically as a security feature and work as an alternative to NFC Smart Tap. For a café stamp card you rarely need that. For a high-value prepaid balance, it is worth considering.
Our Google Wallet loyalty card setup guide walks through the business side, and the Apple Wallet vs Google Wallet comparison explains how the two differ for customers.
Designing for the scan
A beautiful pass that does not scan costs you more than an ugly one that does. Apple’s guidance is to test the barcode in real-world scanning conditions, and that deserves a checklist:
- Scan with the scanner your staff actually use, not only your own phone.
- Test at minimum and maximum screen brightness.
- Test in the position the customer will hold the phone: at a till, over a counter, at arm’s length.
- Leave quiet space around the code and do not place text over it.
- Try a dirty or scratched screen. It will happen.
On the business side, give each scanner a clear job. A QR code that staff scan after payment keeps stamping consistent, and it prevents customers from collecting stamps without a purchase. If you want the mechanics, read how QR code stamp cards work.
Notifications that bring people back without annoying them
The wallet’s strongest advantage over a paper card is that it can speak first. Apple says passes can use time and location relevance to appear on the lock screen. A pass can contain up to ten relevant locations, and Apple warns against manipulating relevance with inaccurate data. For a business with one shop, that means setting the real address; for several branches, setting each real address and nothing else.
Good messages share a pattern:
- They are about the customer’s card. “You are one stamp away from a free coffee” is useful. “Big sale!” is an ad.
- They are rare. If a customer sees a message every day, they will remove the pass, and then you lose the stamps, the lock-screen presence and the relationship.
- They have a reason to be now. A birthday reward, a reward about to expire, a quiet Tuesday afternoon offer for customers who usually come on Tuesdays.
- They are short. The lock screen cuts long text.
A cadence that works for most small businesses is a message when a reward is earned, a reminder before something expires, and an occasional offer. That is three types, not three per week.
Privacy and consent in the Netherlands
A push message that promotes your business is direct marketing, and Dutch businesses need to design for that from the start. This is general information, not legal advice; for your specific setup, ask your own privacy adviser or check with the Dutch Data Protection Authority.
The Dutch government’s GDPR guide says consent for direct marketing must be freely given, specific and informed, with an active opt-in, and it warns against bundling consent with other things. The same guide says organizations must tell people the specific purposes of processing and that consent can always be withdrawn.
The Dutch Data Protection Authority adds that people may always object to the use of their data for direct marketing, and once they do, you may not send them advertising.
What this means for your pass design:
- Ask for notification consent separately from the sign-up for the card itself, with an unticked box or an explicit tap.
- State in one line what you will send and how often.
- Put privacy contact details and how to opt out on the back of the pass.
- Record when and how each customer opted in.
- Honor an objection immediately, and keep the card working for stamps.
A customer can always keep the card for the stamps and decline the offers. Designing it that way is both compliant and good for trust.
Our view: design the pass around the return visit
We build loyalty passes for salons, cafés and shops, and the pattern we see is that a pass succeeds when the owner treats it as a conversation, not a coupon. The card is in the customer’s wallet, so there is no app to download and no plastic to forget. That removes the biggest friction of traditional loyalty programs.
Our approach is to keep the card simple: your brand colors, a clear stamp count, a reward the customer actually wants. Then we add the one thing paper cannot do, which is a timely push notification that reminds a customer you exist right when a visit makes sense. Instant stamping by QR code, automated review requests and an analytics dashboard are designed to make the whole loop easy for your team.
We also stand behind the idea with a results guarantee: if retention does not measurably increase, we refund. We would rather you judge the pass by whether people come back than by how it looks in a mock-up.
erenmette
Try it on your own business
If you would rather not build passes from developer documentation, Beepify gives you customizable reward cards for Apple Wallet and Google Wallet, QR code stamping, push notifications, location-based and birthday messages, and automated review requests. Plans start with Starter at €45 per month or €540 per year, Professional is €86.67 per month or €1,040 per year, and Multi-Location is €207.50 per month or €2,490 per year. Extra scanners cost €5 per month each and extra locations €25 per month each. Enterprise is priced on request. See the details on the pricing page.

Want to see a pass on your own phone first? Try the Beepify demo and look at how a card behaves before you design yours.
A pre-launch checklist
Before your pass goes in front of customers, run through this list:
- The front shows the balance in the header and nothing that needs more than two seconds to read.
- Colors have strong contrast at both brightness extremes.
- The reward is named concretely and the goal is fixed.
- Terms, validity and contact details are on the back.
- The QR code scans with your actual scanners, in your actual lighting.
- Fallback text is set for manual entry.
- Relevant locations are real and accurate.
- Notification consent is separate, specific and easy to withdraw.
- Staff know how to explain the card in one sentence and how to handle a failed scan.
If you are also deciding between a wallet card and a dedicated app, our comparison of a loyalty card app versus Apple and Google Wallet explains what changes for your customers. For the wider programme around the card, the seven-step loyalty programme guide covers rewards, rules and launch.
FAQ
Can I fully customize the layout of an Apple or Google Wallet pass?
No. Both platforms define pass styles with fixed zones, and Google notes that predefined fields are rendered consistently. You customize colors, logo, imagery, the text in each field and what goes on the back. That is enough to make the card recognizably yours.
Which pass style should a loyalty card use on Apple Wallet?
Apple uses the store-card style for loyalty cards, and it recommends showing the current balance on it. The generic style is better suited to things like gym membership cards. For a stamp card, choose the store card and show the stamp count in a header or primary field.
What if a customer’s QR code will not scan?
Set alternative text on the pass so staff can enter the code manually. Apple supports this fallback for exactly that case. Also test your scanners under real conditions in advance, since glare and low brightness cause most failures.
Do I need consent to send push notifications from a loyalty pass in the Netherlands?
For marketing messages, yes. Dutch guidance requires an active, specific and informed opt-in that can be withdrawn at any time, and people may object to direct marketing whenever they like. Keep the card itself working for stamps even if a customer declines offers.
Sources
- Wallet Developer Guide: Pass Design and Creation
- Creating a Poster Generic Pass
- Wallet Developer Guide: Updating a Pass
- Getting Started with Apple Wallet
- Customize Google Wallet Passes
- REST Resource: genericobject
- Rotating Barcodes | Generic pass
- Handleiding Algemene verordening gegevensbescherming
- Recht van bezwaar | Autoriteit Persoonsgegevens
Recommended
Try it yourself?
Create your own digital stamp card in 5 minutes. No app needed, cancel monthly.
Pick your industry and see how it worksRelated articles
Stocard Replacement: What the End of Stocard Means for Your Loyalty Card
Stocard shut down and Klarna is the replacement, but not everyone moved. Here is why your own wallet pass beats a borrowed app, and how to set one up.
9 min read
Pedicure client retention: how clients come back every 6 to 8 weeks on their own
Pedicure client retention comes down to rhythm. See how clients return every six to eight weeks with simple booking habits, timely reminders, and small rewards.
9 min read
Best loyalty program for a small business: how to choose with six questions
The best loyalty program for a small business is the one customers get without explaining. Choose between a stamp card, points, levels, or membership with six questions.
10 min read