Wallet notifications

Wallet push notifications keep your pass holders informed directly on their phone. A loyalty balance update, a schedule change, an offer not to miss: as soon as you update a pass, your customer receives a notification and finds the latest information on their pass. 📲

info

Do not hesitate to contact your Actito contact person for support in setting up your Wallet notifications.

What is a Wallet notification?

A Wallet pass is not a static image. It is a living object that you can update at any time. A Wallet notification is simply the signal sent to the holder's phone when one of these updates takes place.

The principle is the same on both platforms: Wallet is first and foremost about updating passes. The notification is only the visible part of that update.

• On Apple, the notification appears on the holder's lock screen, as well as on the back of the pass.
• On Google, the holder receives a notification informing them of an update and redirecting them to their pass.

In both cases, the updated information remains available on the pass itself.

note

Sending a notification is still a choice. You can run a Wallet campaign without triggering a notification at all.

Step 1: add the notification field to the pass template

This field needs to be added in your pass template, at step 2, "Fields". It centralises the message that will be sent with your notifications.

1. In your pass template, add a new Pass Field.

2. The field must have these exact properties:

   • Type : Blob
   • Key: messageWithNotification
   • Default Value: leave it empty by inserting a single space

   

The messageWithNotification field then appears in your list of fields.

Step 2: configure the notification field

At step 3 of the template creation, "Design", you will now link this field to the display of your pass template. You only need to do this for Apple: on Google, the field is generated automatically.

1. In the Data tab of Apple Wallet, you need to add a field in back fields

2. Fill in the following values:

   • "Key": notification
   • "Label": leave it empty by inserting a single space
   • "Value": turn on "Use another value" and select messageWithNotification
   • "Change message": enter %@

   

3. Save the field.

caution

Always add this field at the end of your fields. Once created, you can move it if needed.

The %@ placeholder in "Change message" is what tells the pass to display the new content in the notification. Without it, the update would happen silently, with no visible notification.

Step 3: set the field in your personalisations

In your personalisations, set the messageWithNotification field to "Default value". This tells the pass which value to use for the notification.

Step 4: send a notification from a Wallet campaign

Once the pass template is configured, notifications are triggered from a Wallet campaign.

1. Create your Wallet campaign.
2. At the "Fields selection" step, select the messageWithNotification field, in the "Notification" section. This allows the campaign to update this field.

3. Write your message for each platform, in the "Notification" section:

   • Apple tab: up to 150 characters.

   

   • Google tab: up to 80 characters.

   

4. Check, test, then activate your campaign.

note

If you do not want to send a notification, you should not thick the messageWithNotification.

tip

On Apple, a notification message stays visible on the back of the pass until the next notification. We recommend including a validity date in your message, for example "-15% instant discount until 18/08", so that the pass holder stays correctly informed of the relevant period even after that date has passed.

Where do notifications appear?

Platform	Where the holder sees the notification
Apple	On the lock screen, then on the back of the pass
Google	A notification redirects to the pass, where the information is updated