# 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="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-01499de231b9670cebf1071aaaf6fcea0ea9c35b%2Fimage%20(549).png?alt=media" 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="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-d730df447ddbb1d73052b073089e1e53c3af0bc5%2Fimage%20(548).png?alt=media" 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="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-b6d73015cd5a9c5bd0a5c388351ca79c2c4ef811%2FDemo%20cosmo%20B%20Apple%20wallet.gif?alt=media" 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="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-1af51a1c4549b829c432306807b3ff46e014c16d%2FApple%20Wallet%20scan.gif?alt=media" 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.