Google Wallet passes
Give customers a loyalty card in Google Wallet that shows their live store-credit balance, name, and tier. It updates automatically every time they earn or spend, with a push notification on their phone.
Prerequisites
Customer account blocks active, since customers add the pass from their account profile (Customer account blocks).
Your logo and hero image hosted at HTTPS URLs (your Shopify Files uploads work).
Set up the pass
Go to DollarBack admin → Integrations, find the Google Wallet card, and click Configure.
Fill in the general fields:
Issuer name
Your business name, shown on the pass
255 characters
Program name
The loyalty program name, the pass's title
60 characters
Logo URL
Square logo shown on the pass
HTTPS URL, at least 660×660 px
Hero image URL
Wide banner across the pass
HTTPS URL, 1032×336 px
Background color
The pass's card color (defaults to green)
(none)
Write the notification texts. There are two notifications, one for Earned (credit) and one for Redeemed (debit) events, each with a Header (up to 35 characters) and Body (up to 300 characters). Both accept variables:
{amount}
The amount just earned or redeemed
{balance}
The customer's new balance
{programName}
Your program name
{customerName}
The customer's name
{tier}
The customer's current loyalty tier
Example earned body: You just earned {amount}! Your {programName} balance is now {balance}.
Google's wallet policy does not allow links in pass messages. Any URL you paste into a notification text is stripped before the message is sent. Keep the text self-contained.
Save. The pass is now offered to customers.
What the pass shows
The card displays your program and issuer name, the customer's live credit balance, their member name and tier, and a QR code carrying their customer ID, scannable at POS to look the customer up.
The pass currency follows the customer's resolved currency (their last order's presentment currency, falling back to their credit account, then your shop currency), so a customer who shops your store in EUR sees a EUR balance even if your shop currency is USD.
How customers add it
In their account, on the profile page's wallet block, the customer taps the Save to Google Wallet button. The link is signed and generated per customer, and each issued pass is tracked individually. On a phone, the pass lands straight in the Google Wallet app; from a desktop browser, Google prompts them to save it to their account.
Live updates and the notification quota
Every credit and debit updates the pass balance and pushes a notification using your Earned/Redeemed texts.
Google caps push-notifying updates at 3 per pass per 24 hours. Beyond that, the pass keeps updating silently: the balance stays correct, but no notification appears on the device until the 24-hour window resets. If a customer reports "wallet notifications stopped working" on a busy shopping day, it's this quota, not a bug. Broadcast messages to all pass holders count against each recipient's cap too.
Apple Wallet
Apple Wallet passes are not available yet; the Integrations page lists Apple Wallet as coming soon. Today, iPhone customers can still see their balance in the floating widget and account blocks; only the wallet pass itself is Google-only.
Verify it works
Sign in to your storefront as a test customer, open the account profile block, and add the pass to a real device.
Credit the customer (a test order or manual credit): within a few minutes the pass balance updates and the Earned notification arrives, assuming the pass is under its 3-push daily quota.
Common issues
The add-to-wallet button doesn't appear: the wallet block isn't active in the customer account editor; see Customer account blocks.
Images don't show on the pass: the logo/hero URLs must be HTTPS and publicly reachable, at the minimum sizes above.
Balance updates but no notification: the pass has hit Google's 3-push per 24h quota; updates continue silently.
A link in the notification text disappeared: URLs are stripped per Google policy.
Related articles
Last updated