📥Push Notification Delivery Troubleshooting

Below are the most common causes of push delivery issues across iOS and Android. Ensuring the correct notification permissions and device settings usually resolves the problem

iOS (Apple Wallet) — Common Reasons & Fixes

1. The card is not installed in Apple Wallet

Only customers with Card Status: Installed can receive push messages. Go to the Customers menu and verify the status.

If the status is Not Installed, resend their unique card link and ask them to install the card.

2. “Do Not Disturb” or Focus Mode is enabled

If Focus or Do Not Disturb is on, push notifications may not appear.

Ask the customer to:

• Turn off Do Not Disturb / Focus Mode

• Re-test receiving notifications

3. Wallet notifications are disabled

iOS must allow notifications for the Wallet app.

Ask the customer to check: Settings → Notifications → Wallet → Allow Notifications

If disabled, push messages will not be displayed.

4. Automatic Updates are turned off

Apple Wallet requires Automatic Updates to process push messages.

Customers should:

1. Open Wallet

2. Tap the card

3. Tap the three dots (…)

4. Go to Pass Details

5. Turn Automatic Updates on

Android (Google Wallet) — Common Reasons & Fixes

1. Wallet notifications are disabled

For Google Wallet cards, the app must have permission to show notifications.

Ask the customer to check:

• Google Wallet notification settings → Allow Notifications

❗ Google only displays up to three push notifications per day on the lock screen. This is a Google limitation.

2. Notifications are disabled inside the loyalty card

Google Wallet has a card-level notification toggle. If it’s off, the device will not receive pass updates.

Ask the customer to:

1. Open Google Wallet / G Pay

2. Tap their Loyalty Card

3. Tap the three dots (…) → Details / Pass Details

4. Enable Get notifications for this loyalty card

This must be switched ON

Android (PWA Cards) — Common Reasons & Fixes

1. Push notifications are disabled on the pass

For PWA-based cards:

• Open the card

• Go to Settings on the back of the card

• Ensure Notifications are enabled

2. Browser notifications are blocked

PWA push notifications require the browser to allow them.

Ask the customer to verify:

• Browser → Site Settings → Notifications → Allow

❗ Not all browsers support push notifications. We recommend using Chrome for reliable delivery.