> For the complete documentation index, see [llms.txt](https://help.joy.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.joy.so/customers/generate-customer-qr-code/apple-wallet-loyalty-pass.md).
# 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**
#### 2. Customize the pass design
Configure how your loyalty pass looks and exactly what information it shows. Beyond colors and logo, you control which fields appear and what they say.
{% hint style="info" %}
These settings apply to **every customer's pass** across your store — not to a single customer. When you save, existing passes re-generate automatically to match. Customer-specific fields (points, tier, name…) still show each customer's own values.
{% endhint %}
| Setting | What to customize |
| ---------------- | -------------------------------------------------------------------------- |
| **Logo** | Upload your brand logo |
| **Logo text** | Optional text beside the logo — toggle on/off; leave off to hide it |
| **Colors** | Background color, text color |
| **Pass name** | The pass title/description (replaces the old fixed "Joy Loyalty") |
| **Field groups** | Toggle each group — Header, Primary, Secondary, Auxiliary — on or off |
| **Field values** | Pick a customer variable (points, tier, name…) or a fixed **Custom value** |
| **Field labels** | Optional — leave a label blank to show only the value |
**Fine-tuning individual fields**
* **Toggle field groups:** turn off any of Header / Primary / Secondary / Auxiliary and that whole group is left off the pass.
* **Custom value:** in a field's dropdown, choose **Custom value** to enter your own fixed text instead of a customer variable — handy for a tagline, hotline, or store note.
* **Optional labels:** leave a field's label empty to show just the value on one line. A label with an empty value still shows the label.
* **Empty fields are skipped:** if both label and value are empty, the field simply doesn't appear.
{% hint style="warning" %}
**Logo and font sizes can't be changed.** Apple (and Google) enforce the font size, image size, and placement on wallet passes — there's no setting for these. To make text stand out, place that field in the **Primary** group. For a larger visual, upload a **horizontal** logo or use a strip image.
{% endhint %}
#### 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
### 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
#### 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
### 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://help.joy.so/customers/generate-customer-qr-code/apple-wallet-loyalty-pass.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.