Introduction
Wallet Passes let your customers add their loyalty program information directly to their phone’s wallet app (Apple Wallet or Google Wallet). This convenient feature keeps their points balance, VIP status, and quick access links right at their fingertips.
What are Wallet Passes?
Wallet Passes are digital cards that customers can add to their mobile wallet apps. These passes display important loyalty information and provide quick access to your store, making it easier for customers to engage with your loyalty program.
What Customers See on Their Wallet Pass
Each wallet pass displays key information about the customer’s loyalty account:
Current points or store credit balance - Always up-to-date with their latest balance
Customer name - Personalized with their account information
VIP tier status - Shows their current membership level (if VIP tiers are enabled)
QR code for sharing - Customers can easily refer friends by sharing the QR code
Quick action links - Direct access to shop, redeem rewards, or refer friends
How Customers Get Their Wallet Pass
Customers can add their wallet pass to their device in several ways:
From Your Rivo Account Widget
When customers open the Rivo account widget on your website, they’ll see an option to “Add to Wallet” if wallet passes are enabled. This button will:
Automatically detect if they’re using an iPhone (Apple Wallet) or Android device (Google Wallet)
Generate their personalized wallet pass with current balance and information
Open their device’s wallet app to save the pass
From a Standalone Wallet Pass Page
You can also direct customers to a dedicated wallet pass page where they can:
On mobile devices - Tap a button to add the pass directly to their wallet
On desktop - Scan a QR code with their phone to download the pass
If not logged in - Sign in first to access their personalized pass
How to Test Wallet Passes
Use this quick workflow when setting up or QA-ing wallet passes:
In Rivo, go to Wallet Passes > Settings and make sure wallet passes are enabled.
Sign in as a test customer in your storefront account widget (mobile device recommended).
Tap Add to Wallet and confirm the pass opens in the correct wallet app:
iPhone: Apple Wallet
Android: Google Wallet
Confirm the pass shows expected data (balance, customer name, tier/referral details if configured).
(Optional) Set QR Code Type to Customer ID (POS Identification) and run a test scan in Shopify POS.
Make a points/credits change on the test customer and confirm the pass updates.
On desktop, customers cannot install directly. They can scan the wallet page QR code with their phone to continue on mobile.
Wallet Pass Features for Customers
Real-Time Balance Updates
Customer wallet passes automatically update to show their current points or store credit balance. When they earn points from a purchase or redeem rewards, their wallet pass reflects these changes without needing to manually refresh.
Quick Access Links
The back of each wallet pass contains helpful links that customers can tap:
Shop Now - Direct link to your store
Redeem Rewards - Quick access to use their points or credits
Refer Friends - Easy sharing to earn referral rewards
Custom links - Additional links you’ve configured (like social media or special pages)
Push Notifications
Customers with wallet passes can receive promotional notifications directly to their lock screen. These notifications might include:
Special offers and discounts
Bonus points events
VIP tier promotions
Loyalty program updates
📱 Note : Push notifications require customers to have added the wallet pass to their device and allow notifications from their wallet app.
Push Notification Campaigns
If you want to send a wallet pass message to a group of customers, use a push notification campaign.
How to Set Up a Campaign
Choose your message title and body
Select a Shopify customer segment
Pick when the campaign should send (using your shop’s timezone)
Choose whether to send to Apple Wallet users, Google Wallet users, or both
Campaigns are only sent to customers who both:
Match the segment you selected
Have an active wallet pass on the device type(s) you selected
Sending Behavior and Delivery Limits
To help prevent notification spam, wallet pass notifications include built-in limits:
The same campaign is not sent to the same customer twice
Each customer can receive up to 3 wallet pass push notifications in a 24-hour period
There is a short cooldown between notifications to the same customer
Campaign Lifecycle
Campaigns move through statuses so you can track progress:
Draft - Created but not sent yet
Scheduled - Waiting for the scheduled send time
Completed - Finished sending
Failed - Could not complete sending
After a campaign sends, you can review:
How many notifications were sent
Which customers received them
Total attributed sales from that campaign
Reporting Wallet Pass Adoption
You can report wallet pass adoption in a few practical ways:
Shopify customer segment - Rivo creates a segment named Rivo Active Wallet Pass Holders so you can see and use your wallet-pass audience.
Customer tags - Customers with an active wallet pass are tagged as Rivo Active Wallet Pass in Shopify.
Campaign reporting - Wallet pass push notification campaigns show sent counts, recipients, and attributed sales.
There is not a separate wallet-pass-only dashboard card for total adoption count at this time, so most merchants track adoption with the segment/tag and campaign results.
Benefits for Your Customers
Wallet passes make it easier for customers to stay engaged with your loyalty program:
Always accessible - No need to remember to open your website or app
Current information - Balance and status updates automatically
Quick actions - One-tap access to shop, redeem, or refer
Shareable - Easy to refer friends using the QR code
Notifications - Stay informed about special offers and promotions
Common Questions
Do wallet passes work on all devices?
Wallet passes work on iPhones with Apple Wallet and Android devices with Google Wallet. The system detects the customer’s device type and provides the appropriate pass format on mobile.
Desktop users can still start from the wallet pass page by scanning the QR code with their phone.
What happens if a customer gets a new phone?
Customers will need to add their wallet pass again on their new device. They can do this by visiting your loyalty widget or wallet pass page and following the same steps to add the pass.
Can customers have multiple wallet passes?
Each customer account can have one active Apple Wallet pass and one active Google Wallet pass. If they add a new pass on the same platform, it replaces the previous active pass on that platform.
Can customers re-add a pass after removing it?
Yes. Customers can return to your account widget or wallet pass page and add the pass again.
How often do wallet passes update?
Wallet passes update automatically when customers earn or redeem points, change VIP tiers, or when you send push notifications. Updates typically appear within a few minutes of the activity.
Can customers turn off push notifications?
Yes, customers can disable push notifications through their device’s wallet app settings or by removing the wallet pass entirely.