> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarback-store-credit/integrations/google-wallet-passes.md).

# 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](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)).
* Your logo and hero image hosted at HTTPS URLs (your Shopify Files uploads work).

## Set up the pass

1. Go to **DollarBack admin → Integrations**, find the **Google Wallet** card, and click **Configure**.
2. Fill in the general fields:

| Field            | What it is                                 | Limit                          |
| ---------------- | ------------------------------------------ | ------------------------------ |
| 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)                         |

3. 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:

| Variable         | Renders as                          |
| ---------------- | ----------------------------------- |
| `{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}.`

{% hint style="warning" %}
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.
{% endhint %}

4. 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.

{% hint style="warning" %}
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.
{% endhint %}

## 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

1. Sign in to your storefront as a test customer, open the account profile block, and add the pass to a real device.
2. 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](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md).
* 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

* [Customer account blocks](/dollarback-store-credit/widgets-and-storefront/customer-account-blocks.md)
* [Widget map: what shows where](/dollarback-store-credit/widgets-and-storefront/widget-map-what-shows-where.md)
* [How customers spend their credit](/dollarback-store-credit/spending-store-credit-and-rewards/how-customers-spend-their-credit.md)
* [Loyalty tiers overview](/dollarback-store-credit/loyalty-tiers/loyalty-tiers-overview.md)