# Apple Wallet Loyalty Pass

{% hint style="info" %}
This feature is available for **Advanced** plan.
{% endhint %}

### Overview

Apple Wallet integration allows customers to save their loyalty QR code directly to their iPhone's Wallet app. At POS checkout, customers simply show their Apple Wallet pass, and staff can scan the QR code to instantly access their loyalty information and apply rewards.

### Setting up Apple Wallet

#### 1. Generate the pass

1. Go to **Customers** in Joy Loyalty
2. Select a customer
3. Click **More actions** → **Generate pass wallet**
4. Choose **Apple Wallet**

<figure><img src="/files/9Qor7zFlpo6rZBIRQZPA" alt=""><figcaption></figcaption></figure>

#### 2. Customize the pass design

Configure your loyalty pass appearance:

| Setting         | What to customize                         |
| --------------- | ----------------------------------------- |
| **Logo**        | Upload your brand logo                    |
| **Colors**      | Background color, text color              |
| **Fields**      | Customer name, points balance, tier level |
| **Header text** | Pass title (e.g., "VIP Member Card")      |
| **Footer text** | Additional information or terms           |

#### 3. Enable the feature

1. Toggle **Apple Wallet** to **On**
2. Click **Save**
3. The option will now appear for customers

#### 4. Add the loyalty pass block (if needed)

If customers don't see the Apple Wallet option:

1. Go to **Embedded Content** → **Account Page**
2. Add **Loyalty Pass** block
3. Click **Edit in Theme Editor**
4. Position the block on your account page
5. Save changes

<figure><img src="/files/fHfYmTmyYRaMnDR6RImY" alt=""><figcaption></figcaption></figure>

### How customers add to Apple Wallet

#### Step 1: Access loyalty pass

* Log into their account on your store
* Navigate to the loyalty section
* Find the "Loyalty Pass" block

<figure><img src="/files/40nFIEUmkUn34pMOJHOy" alt=""><figcaption></figcaption></figure>

#### Step 2: Scan QR code

* Use iPhone camera to scan the displayed QR code
* Or tap "Add to Apple Wallet" button (if available)

#### Step 3: Add to Wallet

* iPhone opens the pass preview
* Tap "Add" in the top right
* Pass is now saved in Apple Wallet

#### Step 4: Use at checkout

* Open Apple Wallet on iPhone
* Select your store's loyalty pass
* Show QR code to staff for scanning at POS

<figure><img src="/files/MsWUhm9czLpHNBQgqvja" alt=""><figcaption></figcaption></figure>

### Using at POS

#### For staff:

1. Customer opens Apple Wallet and shows loyalty pass
2. Scan the QR code with POS scanner
3. Customer information loads automatically
4. Points balance and available rewards display
5. Apply rewards and complete transaction

### FAQs

**Do customers need the Joy Loyalty app?** No, they only need access to your website and an iPhone with Apple Wallet.

**Does it work with all iPhones?** Works with iPhone 6 and later running iOS 12 or higher.

**Can customers have both Apple and Google Wallet passes?** Yes, if they have devices for both platforms.

**Does the pass update automatically?** Yes, points and tier information update in real-time.

**What if a customer loses their phone?** They can remove the pass from Apple Wallet remotely and regenerate a new one from their account.

**Can I disable it for specific customers?** Yes, you can manage pass generation per customer in the admin.


---

# 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/apple-wallet-loyalty-pass.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.