Wallet Pass Details: Google

Overview

The Google tab is used to configure this Google Wallet Pass for use on Android devices. 

The layout of the content for a Wallet Pass on an android device varies depending on the Wallet Pass type. Click a Wallet Pass type below to see a mockup showing the different components for each Wallet Pass type.

The layout of a Loyalty Wallet Pass on an android device is as follows:



The layout of an Offer on an android device is as follows:

As you configure the various options and sections of the Wallet Pass, the platform displays a preview rendering of the Wallet Pass contents. Due to the wide variety of devices and form factors, the preview is intended only to give you some sense of where a particular element will display, and is not meant to be an accurate visual representation.

Dynamic Content

Every element of the Wallet Pass, including labels and values, can be dynamically populated using Content Tokens. These Content Tokens can reference any Member Attribute, or pull in attributes from other Loyalty assets, such as Offers, Gift Cards, and Punch Cards. You can also use Lookup Tables to look up the value of a Content Token based on any Member Attribute. 

Features

The features available on the Google tab are described below.  

 Configure Barcode

To configure the Barcode component on an Apple Wallet Pass: 

  1. Select the Barcode tab.

  2. In the "Barcode Value" field, enter either a fixed number (which could be applicable for a coupon), or use personalized values using a Content Token. To use a fixed number, simply type it in. To use a Content Token, type "@." The platform displays a list of the Content Tokens defined in your account. From this list, select the desired Content Token. The platform inserts the selected Content Token. 

  3. From the "Format" drop-down menu, select the Barcode format: QR Code, PDF 417, Aztec, or Code 128. The preview rendering on the right is refreshed. 

  4. In the "Alt Text" field, optionally enter the alt text value for the barcode image.

  5. Click save changes. 

 Configure Colors and Images

The Colors & Images tab lets you configure the overall appearance of the Wallet Pass. 

  1. Select the Colors & Images tab.

  2. The Colors section allows you to customize the look and feel of the Wallet Pass by the colors used. For each color listed, either enter the desired hexadecimal color value, or click into the field and select the desired color from the color picker. The rendering of the Wallet Pass on the right is refreshed. 

  3. The Images section allows you to select the images used for the different components of the Wallet Pass. For each image listed, click choose file, then navigate to and select the desired image file (recommended image dimensions are listed). Click upload. The rendering of the Wallet Pass on the right is refreshed.

  4. Click save changes. 

Configure Front Content

The front contains the main content you want to present to your Member. This content should be formatted to fit the standard display configuration for the selected Wallet Pass type, as depicted above. 

To configure the content for the front of the Wallet Pass:

  1. Click the Front Content tab.

  2. In the "Program Name" field enter, the Program Name value. 

  3. The other features displayed will vary depending on the Wallet Pass type.

  • Offer: In the "Offer Title" section, enter the name of the Offer in the "Value" field.

  • Loyalty: In the "Loyalty Points" section, enter the text label of the point value in the "Label" field. In the "Value" field, enter the function to retrieve the Member's points from the desired point metric. Optionally expand the "Secondary Loyalty Points" section, and enter the "Label" and "Value." 

  1. Click save changes. 

Configure Details

To configure the Details section of the Wallet Pass:

  1. Click the Details tab.

  2. In the Account Name section, in the "Label" field, enter a text label for the account name. If you leave this section blank, the platform defaults to "Member Name."

  3. In the "Value" field, to use a Content Token, type "@." The platform displays a list of the Content Tokens defined in your account. From this list, select the desired Content Token you want to use to populate the account name. 

  4. In the Account ID section, in the "Label" field, enter a text label for the account ID. 

  5. In the "Value" field, to use a Content Token, type "@." The platform displays a list of the Content Tokens defined in your account. From this list, select the desired Content Token you want to use to populate the account ID. 

  6. Optionally, if you have more content you want to display on the Wallet Pass, click add new section. 

  7. From the "Type" drop-down menu, select one of the following:

  • Fixed Text: Allows you to enter a static text string, such as legal terms and conditions. This text string can optionally contain hyperlinks using simple HTML. 

  • Stores / Locations: Leverage the platform's geolocation features to dynamic populate this section. 

  • Custom: Select a Content Source (the desired Content Source must first be added to this Wallet Pass on the Advanced Options tab). 

  1. In the "Header" field, enter the header name for this section.

  2. The Template field allows you to either enter a text string, or to enter code using the Liquid coding syntax. For additional help on creating Liquid templates, a "Templating Guide" link is displayed within the Back Content section. This guide provides code samples to support several different use cases, such as listing valid Offers, or displaying the balance of a gift card. 

  3. Click save changes. 

To add links to the Wallet Pass:

  1. Click the Links tab.

  2. Click add new link. 

  3. Enter the URI and description.

  4. Repeat the above steps as needed to add more links.

  5. Click save changes. 

Test Wallet Pass

To test a Google Wallet Pass:

  1. Click the Test Preview tab.

  2. From the "Test Member" drop-down menu, select the desired test Member.

  3. The system will generate a button to Add to Google Wallet; click the button.

  4. A confirmation window will display - click Add.

  5. An alert will appear indicating "This is a mock success". Wallet Pass has been saved to Google Pay.

  6. Click on View Offer to view the Pass Configuration (this will open a new tab in your browser to view the Pass).

 Validate Configuration

The platform allows you to validate the Google configuration properties by testing it against a Member in your Loyalty database.

  1. Click validate. The "Validate Wallet Pass" pop-up window is displayed.

  2. Click into the "Member" field and begin typing the Member's name (three characters minimum). The platform displays a list of matching Members. Optionally, you can limit the Members returned in this search by checking only with integration ids and / or only test members. 

  3. Select the desired Member from the list.

  4. Click validate.

  5. The platform displays the results of the validation test. The results are displayed as a checklist of items that must be correctly defined per Google's requirements. 

 Prohibit Sharing Capability in Android and Google Wallet

You can configure your Wallet Pass to prohibit sharing. Specifically, this configuration setting prevents members from sharing their Loyalty card with non-members in Android and Google Wallet.

Enable flag multipleDevicesAndHoldersAllowedStatus that identifies whether multiple users and devices will save the same pass. 

For Android devices, you can configure pass sharing through three distinct permission levels:

Multiple Holders (Unrestricted Sharing):

  • Allows multiple users to access the pass on different devices
  • Ideal for promotional passes or general-access memberships
  • Provides maximum flexibility for pass distribution

One User All Devices (Single User, Multiple Devices):

  • Restricts pass access to a single user account
  • Allows that user to access the pass across all their devices
  • Recommended for personal membership passes or loyalty programs

One User One Device (Restricted Access - Not Available):

  • Intended for use by select Google partners in limited circumstances
  • Please select either MULTIPLE_HOLDERS or ONE_USER_ALL_DEVICES for your pass configuration

                                      

Note: This setting is a preventative measure only from within the Wallet App and does not prevent a user from sharing a pass in other ways, such as a screen print.