Documentation
- Getting Started
- Create a template
- Create passes
- Pass functionality
- Google Wallet
- Push Notifications and Updates
- Updating passes (and sending push notifications)
- About Wallet Push Notifications
- Sending an update to a single pass
- Updating all passes of a template
- Segmentation using Saved Searches
- Sending a message as Push Notification
- Testing Push Notifications
- Location based notifications – troubleshooting
- Troubleshooting Push Notifications on Android
- Sending Wallet passes
- Analytics
- Integrating third party systems
- Certificates
- Smart Scan App
- Selling passes
- NFC Passes
- White Labeling
- Users and permissions
- Pass Bundles
Certificates
Technically
Technically certificates are used for two purposes – the first one is to sign the Wallet passes itself which allows the Wallet app to check the integrity of the files as well as making sure that the issuer of the certificate is authorised to issue passes.
The second purpose is to encrypt connections to the Apple Push Notification Service (APNS) which allows Apple to determine if the Push Notification should be sent at all and to know what pass needs to be updated (alongside an identifier that is transmitted).
Logically (what do users see?)
Passes are grouped by their certificate
Passes that share a certificate also share their icon for Push Notifications
If passes share the same certificate, the icon of the first pass that has been saved on the phone will be used in push notifications. Be especially careful about this when you’re distributing passes that use different icons. In this case the push notifications of the pass that is stored after the first one will always display the icon of the pass that has been saved first.
When should you use a new certificate?
You should use a new certificate if the pass has its very own purpose e.g. it is for a completely different enterprise or it just should use a different icon image.
What happens if a certificate has expired?
Your users won’t be able to save the pass on their phone anymore and you can’t deliver push notifications to them. We’ll notify you about expiring certificates via email long before the expiration date in order to ensure you have enough time to update the certificate. After a certificate was updated, everything will be working again.