# 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="/files/I9FjvVJ4dkvg9ItAs9SP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/F6GYRQO6rylgRNbNnTTi" 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="/files/8Uynccv0ZVUaAtbApmcW" 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="/files/PBW6UDFGKOLqSwfKztWU" 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="/files/yOLNRwkA3Fc9uAvfHti9" 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="/files/B5wj0SHmPCSRwBl4DZhl" 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="/files/n91QAC042mRH0mqFdho6" alt="" width="375"><figcaption></figcaption></figure>

2. Click "Add"

<figure><img src="/files/5UZhEg5zTq81j8uNhaKP" alt="" width="375"><figcaption></figcaption></figure>

3. Pass is saved for future use.

<figure><img src="/files/O6NLC4XzwQlGpUJe2vqs" 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="/files/dOzPAeO6pmtc50o6hhUf" alt="" width="297"><figcaption></figcaption></figure>

<figure><img src="/files/H5d6SZqRE8vrgCc0oyKU" 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](/customers/generate-customer-qr-code/google-wallet-notifications-guide.md)
* [Apple Wallet loyalty pass](/customers/generate-customer-qr-code/apple-wallet-loyalty-pass.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.joy.so/customers/generate-customer-qr-code/google-wallet-loyalty-pass-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.