Wallet

The User Manual has moved! For the most up-to-date information, please visit our new site at docs.antavo.com.
We're committed to providing you with the best resources, and our new site offers an enhanced experience with the latest documentation. Thank you for your understanding and continued support.

Antavo’s Wallet module provides a frictionless way to boost the loyalty program with offline experiences. Loyalty passes include a barcode or QR code for identification. Customers can download the passes on their mobile devices and use them to collect points or redeem their rewards in your offline stores and events.

Mobile passes can be used as customers’ loyalty membership cards, or coupons and tickets that they earn through your loyalty program. To do this, a POS system is needed to be implemented that enables sales associates to scan the barcode or QR code on the pass, which is stored in an app on the customer’s mobile device.

Apple Passes are stored in customers’ Apple Wallets, which are only available for iOS. However, Google Pay, which stores Google Passes, is available for both Android and iOS. You can choose to provide customers with only one type of pass, or both.

Antavo grants early access to pass update and notification features, that are currently going through a refinement process to make sure the module provides an all-around solution. In case you have any questions about the related settings, please contact the Antavo Service Desk.

Find the module configuration page by clicking the wallet icon in the sidebar. The page will open to the collection of passes you have already set up, showing the following information:

  • Name of the pass

  • Pass type – coupon, membership of event type

  • Status – active, inactive, or draft

Creating a new pass

Pass setup starts with the Pass editor, which you can use to select the pass colors and relevant images, and enter text on the mobile passes. Build an unlimited number of pass designs to save and use later on any pass type.

The easy-to-use WYSIWYG editor helps you get an instant view of how your modifications affect the end result for both Apple and Google Passes. Use the selector on the top of the page to change between views and applicable settings.

  • Click ‘Create new pass’ on the sidebar to start building a new pass

Type selection

  • Select the type of pass you want to create

    • Coupons
      Passes can be used to reward customers with coupon delights that they can use to get discounts when making a purchase in your physical stores.
      Learn more about how to assign a pass template to coupon rewards here.
      There are two ways you can reward your customers with a discount coupon:

      • Claimable rewards
        After customers spend their points on the membership site to redeem coupon rewards.

      • Surprise and delight benefits
        Unlike claimable rewards, instant rewards are not visible on the membership site. Instead of spending their points to claim a reward, you can surprise your customers with benefits if they complete specific actions, by setting up a rule in Antavo’s Workflows editor with a Reward claim action node.
        Alternatively, you can use an Assign pass action node as well without a reward being assigned, but this can only issue a static coupon, meaning that the same coupon code will be displayed for every customer’s pass.
        When using a surprise and delight solution, it’s especially important to notify the customer of the new reward through a workflow that will trigger the email message from your provider’s system.

    • Membership pass
      The membership pass can also be used as a digital loyalty card. It identifies the customer by their ID and lets them earn points in your physical stores by making purchases or checking in at an offline location. When the customer enrolls in the loyalty program we automatically send an email with a barcode or QR code that represents their unique customer ID. You can add the membership pass to the registration email sent by your own email provider as well. The membership pass can also be displayed on the membership site so customers can log in to find and download their own passes anytime.

    • Event pass
      Event passes behave and work the same way as coupons, but function as guaranteed entry into a specified offline event. Please note that coupon and event passes can only be assigned to Coupon types of rewards. This means that both coupons and event rewards should be set up as coupon-type rewards in the Reward editor.
      On the top edge of Apple Passes, coupons have a perforated edge, membership passes are flat, while event ticket passes have a small cutout.

  • Tick the checkbox to enable Apple Wallet

  • Tick the checkbox to enable Google Pay

  • Select user group(s)
    In case you use the User group module and enabled the Pass templates entity in the settings, you need to assign a group to the template. Unauthorized users will not be able to access the pass template in the Backoffice.

  • Click ‘Select’ at the bottom of the page to continue

Pass Template

Template of the Apple Wallet

Basic information
  • Variant group id
    Add the template to a variant group by selecting a previously added group or by entering a new group ID. This enables workflows to look up a pass based on the variant group and switch the template of an assigned pass to another template within the same variant group if necessary. (eg. switching the template of the membership pass when the customer upgrades from Silver membership tier to Gold membership tier)

  • Name
    Enter the administrative name of the pass template that appears in the Backoffice.

  • Organization name
    This name will appear in the header of the push notifications sent to the customers' mobile devices.
    This setting is useful if you use the Multi-accounts module and want to clarify which account the current pass update belongs to.

Colors
  • Choose a background color

  • Select a label color
    This will be the color of the label texts of the fields on the front of the pass, except for the primary fields. For Apple passes, the label for primary fields can be changed using the foreground color.

  • Select a foreground color
    This will be the color of all texts other than labels on the front of the pass.

Assets and Retina assets
  • Upload an icon
    The icon image is displayed along with push notifications and lock-screen notifications.

  • Upload your logo
    The logo image is displayed in the top left corner of the pass.

  • Upload the strip image
    The strip image is displayed under the logo and the header field, behind the primary fields as a background image. The image will be center-cropped if it is too large.

For Apple passes, it’s also possible to upload retina (HiDpi) images to improve the visual quality of passes. It depends on the resolution of the customer’s mobile device if the standard or the retina assets are displayed.
While uploading standard assets is mandatory, adding retina assets is optional.

Asset size requirements:

Asset

Standard resolution asset size

Retina resolution asset size

Asset

Standard resolution asset size

Retina resolution asset size

Icon image

90×90 pixels

180×180 pixels

Logo image

160×50 pixels

320×100 pixels

Strip image

375×123 pixels

750×246 pixels

  • Click the ‘Next’ button at the bottom of the page to continue

Template of the Google Pay

Basic information
  • Variant group id
    Add the template to a variant group by selecting a previously added group or by entering a new group ID. This enables workflows to look up a pass based on the variant group and switch the template of an assigned pass to another template within the same variant group if necessary. (eg. switching the template of the membership pass when the customer upgrades from Silver membership tier to Gold membership tier)

  • Name
    Enter the administrative name of the pass template that appears in the Backoffice.

  • Organization name
    This name will appear in the header of the push notifications sent to the customers' mobile devices.
    This setting is useful if you use the Multi-accounts module and want to clarify which account the current pass update belongs to.

Tier information

available for Membership passes only

  • Tier Label
    The designation for the tier displayed above the actual tier, for example, Tier Status or Tier.

  • Tier
    Insert the variable specifing the name of the customer's current tier status in the applicable tier structure.

You can create tier structures and specifiy tier statuses in the Tiers module.

Messages and contact information

available for Membership passes only

  • Message
    Add the array of personalized messages displayed in the app.

  • Text modules
    Enter general text content you’d like to share.

  • Links 
    Add links to your pass.

Colors
  • Choose a background color

Assets
  • Upload an icon
    The icon image is displayed along with push notifications and lock-screen notifications.

  • Upload your logo
    The logo image is displayed in the top left corner of the pass.

  • Upload the strip image
    The strip image is displayed under the logo and the header field, behind the primary fields as a background image. The image will be center-cropped if it is too large.

Asset size requirements:

Asset

Asset size

Asset

Asset size

Logo image

660×660 pixels minimum

Strip image

1032×336 pixels minimum

  • Click the ‘Next’ button at the bottom of the page to continue

Pass content

Content of the Apple Wallet Passes

Header

  • Add logo text
    The text will appear on the logo image

Apple Wallet Fields

  • Header fields

  • Primary fields

  • Secondary fields

  • Auxiliary fields

  • Back fields

You can flip it over to see the backside by clicking on the preview pass. Since space is limited on the front side, you need to be brief, however, the back of the pass is scrollable, which allows you to add a great deal of extra information. The back fields are used to define helpful details like Terms of Use or customer service contact info.

In general, an Apple pass can have up to 3 header fields, 1 primary field, up to 4 secondary fields, and up to 4 auxiliary fields, however, the maximum number of combined secondary and auxiliary fields is 4. The number of back fields is unlimited.

Please note that the number of fields displayed on the pass also depends on the length of the text in each field. If the text is too long, some fields might not be displayed.

Each type of field has the following settings to define:

  • Label of the field

  • Value of the field
    In addition to general text, you can include expressions, for example, the customer’s {} current level or{} a number of points.

  • Change message
    Enter the text for the notification which will appear on the customer’s screen when the field gets updated.

If you would like to remove a field, just click the close icon on the right-hand side of the corresponding field.

Basic information
  • Add a description
    The description is visible on the back side of the Apple Pass.

  • Select the relevant date – for Event-type passes only
    Date and time when the pass becomes relevant (eg. the start time of an event).

Barcode
  • Select the type of code
    You can choose the barcode or QR code format.

  • Add the code content
    You can add general text, a URL, or customer and coupon properties.
    Please note, that no pass is assigned if the barcode content is empty.

  • Enter alternative text
    This text will appear under the code.

Content of the Google Pay Pass

Basic information
  • Merchant name
    Enter the name of the brand.

  • Offer title - for Coupon- and Event-type passes only
    Enter the name of the coupon.

  • Balance - for Coupon-type passes only
    The value of the coupon.

  • Program name - for Membership-type passes only
    Enter the name of the program that the pass allows the customer to participate in.

  • Loyalty points label and balance - for Membership-type passes only

  • Secondary loyalty points label and balance - for Membership-type passes only

Offer information

for Coupon- and Event-type passes only

  • Offer provider
    Enter the name of the brand that provides the coupon.

  • Details
    Provide every detail you’d like to add about the offer.

  • Disclaimer
    In case you need to add terms and conditions, enter them here.

Member information

for Membership-type passes only

  • Member name label and member name

  • Membership ID label and ID

Messages and contact information
  • Messages
    Add the array of personalized messages displayed in the app.

  • Text modules
    Enter general text content you’d like to share.

  • Links 
    Add links to your pass.

Offer expiration - for Event-type passes only
  • Start date and end date
    Select the timeframe when the pass can be used to check in at the event.

Barcode
  • Select the type of code
    You can choose a barcode or QR code format.

  • Add the code content
    You can add general text, a URL, or customer and coupon properties.

  • Enter alternative text
    This text will appear under the code.

Once the content settings of the Google Pass and/or Apple pass are finalized, click ‘Next’ at the bottom of the page.

Notifications early access

Push notifications

The beta version includes push notifications that are delivered as wallet notifications displayed on the lock screen.

Tick the box to enable push notifications. These can be triggered using Antavo's Workflows module by adding a Push notification action node.

Please note, that the push notifications services have to be configured by an Antavo administrator to make the beta version of push notifications operational. If you can see an alert on the top of the page referring to a missing service configuration, please contact us by submitting a ticket through the Antavo Service Desk.

Locations

  • Locations

    • Select locations from the dropdown list that should trigger a push notification
      Learn how to add locations under the Locations section of this manual.

    • Click the ‘Add location’ button

    • Add the text of the message in the field that appears

  • Trigger distance
    Enter the distance of the location where the notification should be triggered.

Beacons deprecated

  • Beacons

    • Select the beacons that should trigger notifications
      Learn more about how to add beacons and the content of the beacon-triggered notification under the Beacons section of this manual.

    • Click the ‘Add beacon’ button

    • Add the text of the message in the field that appears

Overview

Before saving the newly created pass, a final preview shows what customers will see on their mobile phones. If you’d like to make changes, navigate back to any stage of the pass setup. If you’re satisfied with the end result, click the ‘Create’ button at the bottom of the page.

The new pass will immediately appear in the list on the ‘Passes’ page.

Activate the pass

After saving for the first time, the status of the new pass is ‘draft’. You can activate the pass right away using the ‘Set active’ button on the upper right-hand side of the setup page and confirm the activation in the dialog that subsequently appears.

If you want to call off an active pass, you can do so by clicking the ‘Set inactive’ button. This will change the status of the pass to ‘inactive’, which means it appears only in listed on the module configuration page in the Backoffice.

Locations early access

The beta version provides the Locations tab that lists the previously saved locations serving as references to send location-triggered push notifications.

To add a new location:

  • Click the ‘Add new location’ button on the sidebar

  • Add the name of the location

  • Enter the location coordinates, or use the search field to define the location

  • Click the Save button

Beacons deprecated

In addition to location-based notifications, you can use beacons to trigger push messages. Beacons are Bluetooth devices that retain a field around themselves transmitting that they are there. When a mobile enters this field and Bluetooth is enabled on the customer’s phone, the pass can pick up on that and display a notification associated with the field.

To add a new beacon:

  • Enter the unique name of the beacon

  • Add the major identifier of the beacon

  • Add the miner identifier of the beacon

  • Enter the Proximity UUID 

  • Add the unique identifier of the beacon

  • Enter the text of the push notification that the beacon should trigger – the text will be displayed on the lock screen when the pass is currently relevant.

Settings

Template settings

  • Select the default membership pass template from the dropdown menu.

Apple developer settings

Before you start using Apple Passes in your loyalty program, fill in the details of your Apple Developer Certificate.

  • Select the update service type

  • Add your Team Identifier

  • Add your Pass Type Identifier

  • Add the name of your certificate

  • Add the password you specified when generating the certificate.

Google developer settings

In case you’d like to use the Google Pay passes, please enter the following Google credentials.

  • Project identifier

  • Private key identifier

  • Private key

  • Client email

  • Client ID

General Settings

  • Define the time period when the tokens of pass download links are valid after the links are generated (eg. +2 days).

API

The customers/customer_id/wallet API endpoint is able to return the pass download link and the download deep link* so that you can display the pass on the membership site.
However this data is not included in the response by default, please make sure you tick the checkbox(es) if you need Antavo to provide this information in the API response.

* available for iframe users only

Pass emails

Both the Membership pass and Reward pass email can be customized with Antavo’s email editor, which you can find in the ‘Settings’ menu:

  • Navigate to the ‘Settings' page of the Antavo Backoffice.

  • Click on ‘Emails’ on the left side of the page.

  • Search for the ‘Membership pass email’ to customize the membership pass email, or the ‘Pass email’ to customize the reward pass email.

  • Click on the hamburger button and select the ‘Edit’ option.

  • Edit all the texts using our WYSIWYG editor by clicking on the content of the email.

  • Use our built-in HTML and CSS editor for further customization.

You can send a test email to yourself to see how the email will look from a loyalty member’s perspective. To do so, click the hamburger button on the ‘Emails’ page and select the ‘Test send’ option.

© Copyright 2022 Antavo Ltd.