Skip to content

How wallet notifications work

What actually happens on an iPhone or Android phone when Leal sends a notification, why some customers don't see them, and what to check.

Leal doesn't send notifications through an app. It updates the loyalty pass in the customer's Apple Wallet or Google Wallet, and the phone shows the update on the lock screen. Knowing how that works explains almost every "why didn't my customer get it?" question.

The Latest update field#

Every Leal pass has a field called Latest update on the back (on Apple Wallet) or in the pass details (on Google Wallet). When a notification rule fires, Leal:

  1. writes your message into Latest update on that customer's pass
  2. tells Apple or Google that the pass has changed
  3. the customer's phone fetches the new pass and shows the message as a notification

The message stays on the pass afterwards, so a customer who swiped the notification away can still read it by opening the pass. It's replaced by the next message.

Apple Wallet#

When the pass changes, Leal sends a signal to the customer's iPhone, which downloads the updated pass. Because the Latest update text has changed, the iPhone shows it on the lock screen.

Note

The iPhone only announces a change it can see. If a new message is word for word the same as the one already on the pass, there's nothing new to show. Messages that include a changing value, such as {{ customer_card.stamps_count }}, avoid this.

Location-based messages work differently on iPhone. They're stored inside the pass, and the iPhone shows them on the lock screen on its own when the customer is near one of your locations. See location-based notifications.

Google Wallet#

Leal updates the pass through Google and sends your message with your store name as the title. Google shows it as a notification on the customer's Android phone and in the pass details.

Leal adds your store locations to Google Wallet passes too, but the custom location message is only used on Apple Wallet.

When a customer won't get a notification#

A notification can only arrive if all of these are true:

  • The pass is installed. On the customer's profile, the card shows a green Apple or Google badge. Not installed means there's no pass to update, so Leal doesn't send anything.
  • The rule is switched on and, if it's for one card, the customer holds that card.
  • The customer allows notifications for passes on their phone. Customers can turn these off for a pass in their wallet app, and Leal can't see or change that.
  • The phone is online. A phone that's off or offline gets the update when it reconnects.

If the pass shows the new stamp count but there was no notification, the update worked. The customer's notification settings probably hid the alert.

Only one message at a time#

A single scan can set off more than one rule, for example a stamp that is also the customer's first, and also earns a reward. Leal records each one, then updates the pass once. The pass shows the newest message.

Automated rules come first. If a Welcome, Stamps milestone, Reward available or Stamps streak rule fires for a stamp, your Stamp earned or Stamp redeemed message isn't sent for that same stamp, so the customer gets the more useful message instead of both.

Each message is sent once#

Leal remembers what it has sent so customers aren't sent the same thing twice by mistake. Some triggers only ever fire once for each card. See notification triggers for the details of each.

Gotchas#

  • Keep the system rules switched on. The Stamp earned and Stamp redeemed rules are also what tells the customer's wallet to fetch the new stamp count after a scan or a redemption. If you switch them off, the pass on the customer's phone isn't refreshed straight away after each stamp. If you'd rather not notify on every stamp, change the message instead of switching the rule off.
  • Manual stamp changes. When you correct a count on a customer's profile, Skip notifications is ticked by default, so the pass updates without a message. See adjusting stamps.
  • Deleting the pass. If a customer removes your pass from their wallet, they stop getting notifications. They can add it again from their original link, which you can find under Pass links on their profile.

Still stuck?

Our team answers every message. Contact support