What is the Wallet Pass?
The Wallet Pass is a digital loyalty card your customers add to Apple Wallet or Google Wallet. It shows their live points balance, VIP tier, and how many rewards they have ready to redeem, and it updates on its own every time they earn or spend. If your program runs on store credit, the balance on the pass is shown as an amount of money instead of points.
Because the pass lives on the lock screen, it keeps your programme in front of customers without an email or an app. You can also send push notifications to pass holders, and surface a message when they walk near one of your stores.
Wallet Pass is available by speaking to Mage through live chat or by emailing [email protected]. Until it has been switched on for your store, you will not see Wallet Pass in the Mage Loyalty menu.
Enabling the Wallet Pass
From your Shopify admin, open the Mage Loyalty app.
In the left menu, click Wallet Pass.
On the overview page, click Customise to open the pass builder.
At the top of the builder, toggle Wallet Pass on.
Click Save.
The toggle alone does not save the change. Always click Save before leaving the builder.
Designing your pass
The pass builder has a live preview on the right and two tabs on the left: Design and Settings. Use the Apple and Google toggle above the preview to check how the pass looks on each platform.
Design tab
Setting | What it controls |
Push icon | The small icon shown next to your push notifications. Square PNG, 90 x 90 px. |
VIP tier styling | Optional. Give each VIP tier its own artwork and colours. Off uses a single design for everyone. |
Pass artwork | Your Apple logo, Google logo, and the banner image shown across the top of the pass. |
Colours | The pass background (theme) colour and the text colour. |
Labels | Rename the stat labels (Balance, Tier, Rewards, Member, Member since). The values stay dynamic. |
Back of pass | Text blocks shown on the back of the pass. Emails and phone numbers become tappable. |
Pass links | Buttons on the back of the pass that link customers to your store, rewards page, or any URL. |
Settings tab
Program name - the name shown on the front and back of the pass and used as the brand name in automated pushes, up to 40 characters. Leave it blank to use your store name.
Barcode - choose what the QR code on the pass encodes: the customer's referral share link, or their email for POS lookup. Referral share link uses the customer's Basic Referrals link. If the customer has no referral link yet, the QR code holds their customer ID instead.
Pass messaging - the welcome message shown in the pass's "Latest update" field when a customer first adds the pass.
Click Save when you are done. Design changes apply to every pass automatically, so existing pass holders pick them up too.
Getting the pass onto customers' phones
Once the pass is enabled, there are two ways to distribute it.
Add to Wallet link
On the Wallet Pass overview page you will find an Add to Wallet link. Click Copy and share it anywhere: an email, an SMS, a thank-you page, or a link in your store. When a customer opens it, we detect their phone and offer the right pass for Apple or Google.
Customers need to be logged in to their store account to add the pass from this link. If they are not logged in, the page asks them to log in first.
Below the link there is a QR code that opens the same link when scanned. Click Download SVG or Download PNG to use it in store or in print.
Account Sidebar
If you use the Mage Account Sidebar, customers can add the pass straight from there. This needs the Mage Loyalty app embed enabled on your live theme.
Tip
Passes update automatically as customers earn and redeem points, so there is nothing to re-send. Once a customer has the pass, it stays current on its own.
What's next
Push Campaigns - send a one-off push notification to your pass holders. See: Wallet Pass Push Campaigns.
Location Pushes - surface a message when a customer is near one of your stores. See: Location-Triggered Push Notifications.
Still need help? Reach out to the Mage Loyalty team through our live chat support.