# Google Wallet Loyalty Pass

Help customers save their loyalty pass to Google Wallet so they can identify and redeem faster at checkout.

{% hint style="info" %}
**Plan requirement:** Google Wallet is available on **Advanced** (or higher).
{% endhint %}

## Overview

Google Wallet in Joy lets customers:

* Save a digital loyalty pass on their Android phone
* Access loyalty identity quickly without opening account pages every time
* Use a QR-based identification flow that is faster and more consistent in POS scenarios

This is especially useful for stores with in-store traffic, repeat customers, and staff-assisted checkout.

## Before you start

Make sure you have:

* A Joy store on **Advanced** plan or higher
* Access to **Joy admin**
* Access to **Shopify Theme Editor** (or customer account block settings)

## Step 1: Open Google Wallet settings in Joy

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-146eb01fd3fe9a8f2c88dc0c85f242baebb550ce%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-09a987da81129cf99e33c7ab074154a7621b4811%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

1. In Joy admin, go to **Customers > More actions > Generate digital loyalty pass**
2. Open **Google wallet**.
3. In the page header, turn wallet status **On**.

## Step 2: Configure Wallet pass in the Settings tab

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-a1be1dc27119ed4fed66b70f1e1fbb6ba6c51302%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

In **Settings**, configure pass structure and branding:

* Program identity (name/logo/header)
* Card fields and display rows
* Pass visuals (colors/images where available)

Best practices:

* Keep labels short and clear
* Prioritize scan-time information (for example: points, tier, member identity)
* Keep contrast high for readability on mobile screens

## Step 3: Save configuration

Click **Save** after updates.

Joy stores your wallet class configuration and enables Google Wallet linkage for the shop.

## Step 4: Display wallet entry on storefront/customer account

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-acb1cd5a3ab329b7d0459f54455aa9d75d3db3d8%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

After setup, expose wallet action to customers:

1. In Google wallet page, click **Enable** from the in-app banner (or open theme editor manually).
2. In Shopify Theme Editor, add/enable block:
   * **Joy: Loyalty Pass Wallet**

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-25a56df36c60789a285a3d3c9cb690268e73a30d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Save theme.

This makes **Add to Google Wallet** visible on supported customer surfaces (customer account or loyalty page, depending on theme setup).

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-af71dc575b269c1c89362e1e2ddbbcef5302e4dc%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Step 5: Customer adds pass to Google Wallet

Typical customer flow:

1. Customer logs in to account/loyalty page.
2. Clicks **Add to Google Wallet**.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-51c4aef74023179ff9f9bbcc677fb024714328dc%2F1000014112.jpg?alt=media" alt="" width="375"><figcaption></figcaption></figure>

2. Click "Add"

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-d0fb6d7d0ef5d51a44f78a999afef79a3d707bb3%2F1000014115.jpg?alt=media" alt="" width="375"><figcaption></figcaption></figure>

3. Pass is saved for future use.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-5902ff2b561e49019817e00ef69d80b87c4ea7e2%2F1000014116.jpg?alt=media" alt="" width="375"><figcaption></figcaption></figure>

## Customer experience after adding pass

Once **added:**

* Customer opens Google Wallet and accesses the loyalty pass directly
* Customers show the QR code for the staff
* Staff scan QR code, Joy automatically detect customers
* QR identification at checkout is faster than manual lookup

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-40ef5baff846c6c9ae64c51336ac69aca1620566%2Fimage.png?alt=media" alt="" width="297"><figcaption></figcaption></figure>

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-0c703c99d31734057206520d561473f7ec7702a4%2F1000014118.jpg?alt=media" alt="" width="375"><figcaption></figcaption></figure>

## FAQ

### I enabled settings, but customers cannot see “Add to Google Wallet”

Check:

* Store is on Advanced (or higher)
* Google wallet status is **On**
* **Joy: Loyalty Pass Wallet** block is enabled in the correct surface
* Customer is active and visible in loyalty flow

### Can customers get QR before adding pass?

Best experience is after pass is added. Before that, QR availability depends on surface and configuration.

### Does Joy support both Apple Wallet and Google Wallet?

Yes. Both are supported, but setup/configuration is separate per wallet type.

## Related guides

* [Google Wallet notifications in Joy Loyalty](https://help.joy.so/customers/generate-customer-qr-code/google-wallet-notifications-guide)
* [Apple Wallet loyalty pass](https://help.joy.so/customers/generate-customer-qr-code/apple-wallet-loyalty-pass)