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 - Shows the QR code type you configure, such as a referral link or Customer ID for Shopify POS
Quick action links - Direct access to your store, plus any reward, referral, or custom links you’ve configured
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 a mobile device, they can see an option to “Add to Wallet” if wallet passes are enabled and your account widget is set to show the wallet pass section. 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.
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 after the customer’s balance changes. Updates usually appear without the customer needing to manually refresh the pass.
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, if enabled
Refer Friends - Easy sharing to earn referral rewards, if referrals are enabled
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:
Customer tags - Customers with an active wallet pass are tagged as Rivo Active Wallet Pass in Shopify.
Shopify metafields - When Shopify sync is enabled, Rivo syncs whether the customer is an active wallet pass subscriber.
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 Shopify tag, synced customer data, 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, refer, or open custom links depending on your setup
Scannable - Easy to scan the configured QR code, such as a referral link or Customer ID for Shopify POS
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.
What if a customer deleted their Apple Wallet pass or cannot access it?
Ask the customer to sign in to their store account on their phone, then add the pass again from the account widget or the wallet pass page. If they are on desktop, they can scan the wallet pass page QR code with their phone.
In Rivo, open the customer profile to check whether an active wallet pass is currently connected. If an active pass is shown, you can send a test notification from the customer profile to confirm the pass can still receive updates.
There is not a merchant-side button to manually attach a wallet pass to a customer’s device. If the customer still cannot add or open the pass after signing in and using the wallet pass page, contact Rivo support with the customer’s email address and the device type they are using.
Can customers have multiple wallet passes?
Each customer account has one active wallet pass connection at a time. If they add a new pass, Rivo uses the latest connected pass as the active pass.
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 after balance changes, such as earning or redeeming points or credits. 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.