Skip to content
SmartPages Docs

Notifications

Pass push notifications are an excellent way to reach your pass holders. They can be a cheap and effective alternative to other solutions.

Prerequisites

The issuer the API key belongs to needs to fulfill the following requirements:

  • Have an active billing account
  • Good account standing
  • Pass Notifications add-on is enabled
  • REST API Notification add-on is enabled

Notification lifecycle

Notification’s path from you to your customer notification_flow.png

If there are multiple instances of the pass on different devices, notification will be sent to each one of them, considering notification SENT if it was sent to at least one device and DELIVERED if it was delivered to at least one device.

Notification status

  • QUEUED - Notification is put into SmartPages queue
  • SENT - Notification was successfully sent to Apple Notification Service or Google Wallet API for at least one pass instance
  • DELIVERED - Notification was delivered to at least one pass instance (Only for Apple Devices)
  • NO_ANSWER - There was an error when trying to send notification to Apple Notification Service or Google Wallet API

Unfortunately, Google Wallet API does not provide any way to track notification delivery. Notification is considered successful upon reaching SENT status for passes stored in Google Wallet.

notification_lifecycle_aw.png Status sequence for Apple Wallet push notifications

notification_lifecycle_gw.png Status sequence for Google Wallet push notifications

Examples

Apple Wallet

aw_notification_look.png iPhone lock screen aw_pass_backside_last_notification.png Pass back side

Google Wallet

Coming soon