Apple Wallet Pass Notifications

Send automatic push notifications to your customers through their Apple Wallet loyalty pass — no separate app required.

This feature requires the Advanced plan or above

Overview

Once your customers add their loyalty pass to Apple Wallet, you can send them real-time push notifications whenever key loyalty events happen. This helps you:

• Re-engage customers passively — alerts appear on their iPhone lock screen without needing any app open

• Confirm activity instantly — your customers know their points were counted or rewards were applied

• Drive tier motivation — celebrate upgrades and nudge customers to act before a downgrade

---

Requirements

• Joy plan: Advanced or above

• Your Apple Wallet Pass must be enabled and saved in Joy admin

• You must manually turn on each notification type (all are off by default)

• Your customer must have added their loyalty pass to Apple Wallet

---

How to set up

Step 1: Go to Apple Wallet Pass Setting

Go to Customers → Generate digital loyalty pass

Choose Apple Wallet

Step 2: Open Notification Settings

Go to Notifications tab

You'll see a list of 5 notification types. Each shows its current status (Active badge if on) and a Turn on / Turn off button.

Step 3: Configure each notification

Click any notification row to expand it and edit the message body.

Notification type	Triggers when	Required variables
Earn rewards	Your customer earns points from any activity	{{rewards}}
Redeem rewards	Your customer redeems points for a reward	{{points}}, {{program}}, {{balance}}
Tier upgrade	Your customer moves up to a higher VIP tier	{{oldTier}}, {{newTier}}
Tier downgrade	Your customer drops to a lower VIP tier (e.g. after a refund)	{{oldTier}}, {{newTier}}
Points expiring	Your customer's points are about to expire	{{balance}}

Each notification has a Notification body field with a default message pre-filled. You can edit the text freely — just keep the required variables (shown below the text field) so Joy can fill in the correct values for each customer.

Example — Earn rewards (default):

You earned {{rewards}}. Visit our store to see rewards you can redeem

Step 4: Turn on and save

Click Turn on for each notification type you want active, then hit Save at the top of the page.

---

Your customer's experience

When a qualifying event occurs (e.g. your customer places an order and earns points), Joy automatically:

1. Detects the loyalty event

2. Sends a silent push to Apple's notification service (APNs)

3. Your customer's iPhone fetches the updated pass

4. A lock screen notification appears with your customized message

Tapping the notification opens their loyalty pass directly in Apple Wallet with the latest points and tier info.

---

FAQ

Do my customers need to do anything after adding the pass? No. As long as they've added the loyalty pass to Apple Wallet and have Wallet notifications enabled on their iPhone, they'll receive alerts automatically.

Why isn't a customer receiving notifications? Ask them to check: iPhone Settings → Notifications → Wallet and make sure notifications are allowed. Also confirm they've actually added the pass (not just viewed it).

What if I turn on a notification but haven't finished setting up the pass? Notifications won't send until your Apple Wallet Pass is fully configured and enabled. Set up the pass first under Customers → Loyalty Pass → Apple Wallet → Settings tab.