Best practices
Currently limits their push notifications to 3 per day per pass, if you go over this quota, the passholder will not receive a push notification on their lock screen, but it will update the “Latest Update” on the back of the pass.
We suggest limiting the maximum number of notifications per day per pass to 3
Sending Notifications
If sending notifications to an individual pass, use our Send Notification endpoint. If you wish to send notification alongside a pass update, you can do so using our Update Pass or Update loyalty balance endpointsIncluding a link in the notification
When including a link in the notification, the link will be opened when the user taps the notification. However, the format of a clickable link is different for each platform. We offer a simple solution to generate a clickable link for both platforms.Include a valid URL in your notification.“Visit https://www.passentry.com for more!”
or “Visit passentry.com for more!”In order to make the link clickable, the user must press and hold the notification until the link is highlighted.Apple does not support HTML tags in notifications, but autodetects the link and makes it clickable.
Using PassEntry’s link generator As the device type is not always known, we offer a simple solution to generate a clickable link for both platforms. To create a link, enclose the link text in brackets (e.g., [this link]) and then follow it immediately with the URL in parentheses (e.g., (https://passentry.com)).
Visit [this link](https://passentry.com) for more!
We will automatically generate the correct link for the platform.
Make sure to always send a test message to verify that the link is clickable and working as expected.
Visit [this link](https://passentry.com) for more!
will be displayed as:
Apple: Visit https://passentry.com for more!
Google: Visit this link for more!
Troubleshooting
Apple
If you are having issues receiving push notifications on your iOS device, please check the following:-
Ensure that you have enabled push notifications for the specific pass by toggling
Automatic Updates
andAllow Notifications
. These options are enabled by default on the Wallet. - Notifications are usually displayed in real time, however, when sending a large number of notifications to a single pass, Apple will sometimes rate limit the notifications, which will result in the notification delivery being delayed. Although quite common during development or testing, this will not typically happen in live environments, as most passes will not usually be sending more than 10 notifications per day.
-
For geofence notifications, please ensure that Location Services are enabled for the Apple Wallet.
Settings -> Privacy & Security -> Location Services -> Wallet
-
To force an update to the pass, you can drag and pull down on the pass from the back of the pass. This will force any new notifications to be displayed, regardless of notification permissions or rate limits.
-
Ensure notification permissions are enabled for the Google Wallet. This is enabled by default.
- Google wallet notifications are not displayed in real time, as the Google Wallet has a less frequent update cycle than Apple Wallet. It usually takes between 10 seconds and 2 minutes for it to show up as a lock screen notification. To force an update, you can close and reopen the Google Wallet app.
-
Google does not include the link text in the notification, it instead displays a generic “New Message” text, alongside the pass template logo icon.
-
Google rate limits notifications to 3 per day per pass, if you go over this quota, the passholder will not receive a push notification on their lock screen, but it will display an “Important Message” update from within the wallet, as well as updating the
Latest Update
field on the pass. -
If you’re still unable to receive Google Wallet notifications, your Google Wallet may be set to a different Google account than the one with the pass that you are trying to send notifications to.
This is common for individuals with multiple emails on their device, such as work and personal accounts.
To switch accounts you can tap the profile icon in the top right corner of the Google Wallet app, or swipe through the account icons vertically to switch between them.