(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.data-privacy-src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-P2BC6Q6N');

Help Center

Creating a Pass Template for a Coupon (Layout 2)

8 min read

Pass Template Builder Settings for a Coupon (Layout 2) #

Appearance

Customize the appearance for the coupon by adding strip images, logos, and background color.

Coupon Layout 2 Appearance Tab
Field Description
Offer Title Image/Logo Upload the offer title image or logo that will appear on the customer’s mobile wallet coupon. The logo will appear rounded in the top center of the Pass on Google Pay and will appear square/rectangular in the top left corner of the Pass on Apple Wallet. The minimum size for the logo is 660px by 660px. It is recommended to leave the logo with a full bleed background color and a 15% margin.
Card Issuer The name of the company/organization issuing coupons. The card issuer is displayed below the logo on Google Pay passes and to the right of the logo on Apple Wallet Passes. An ellipsis will be displayed if the card issuer name exceeds 20 characters. This field is required to generate coupons.
Strip Image The strip image is displayed as a banner across the center of the Pass for both Apple Wallet and Google Pay. The required image type is a PNG file. The recommended image size is 1032px by 336px. Use an image with a colored background for the best results.
Background Set a background color for the Pass. The format is #rrggbb, where rrggbb is a hex RGB triplet, such as #ffcc00. The background color is the same for every Pass.

Universal Fields #

Main Fields

These fields will appear on the front of the Pass for both Apple Wallet and Google Pay. You can have up to 4 main fields on coupon Passes called ‘Offer Title’.

Coupon layout 2 main fields
Field Description
Offer Title The ‘Offer Title’ describes the title of the offer, such as ‘20% Off Sales Items’. We require you to fill out this field to generate coupons.
Field 2-4: Custom Fields Choose which fields to display on the front of the Pass from the drop-down menu. If ‘Expiration’ is chosen from the menu, you must set the expiration date in the ‘Expiration’ tab. You can also check the box to display the time alongside the date on the front of the Pass. If ‘Account Name’ or ‘Account ID’ is selected from the menu, these fields will NOT appear on the back of the Pass for Apple or below the Pass for Google.

Expiration Fields

Coupon layout 2 expiration fields
Field Description
Set default expiration date time (Optional) Add an expiration date for all Passes that are installed for this Template. The timezone will be used as default, if not sent in the request when generating/updating passes via API.
Expire passes automatically after fixed duration Auto expire the pass by setting a fixed duration after which the pass gets expired automatically from the time of its first generation. If any specific expiration timestamp is set for the pass record, then these settings will be overridden by the pass record expiration timestamp.

Additional Fields

Coupon layout 2 additional fields 1
Coupon layout 2 additional fields 2
Coupon layout 2 additional fields 3
Coupon layout 2 additional fields 4
Field Description
Field 1: Offer Provider The company providing the offer or coupon. The label is a fixed value. This field is required to generate coupons.
Field 2: Offer Details Add details about the offer or instructions on how to redeem the coupon. This field allows line breaks. The label is a fixed value.
Field 3: Fine Print/Terms Add the fine print or terms for the offer/coupon. This field allows line breaks. The label is a fixed value.
Field 4, 5 & 6: Message 1, Message 2 & Message 3 These are optional fields to add messages on the back of the Pass for Apple Wallet or below the Pass for Google Pay. These fields allow line breaks.
Field 7: Text Module The recommended maximum length for the label is 35 characters to ensure the full string is displayed on smaller screens. The value of the Text Module is defined as an uninterrupted string. Recommended maximum length is 500 characters to ensure the full string is displayed on smaller screens. This field also allows line breaks.
Field 8: Info Module The recommended maximum length for the label is 30 characters to ensure the full string is displayed on smaller screens. The recommended maximum length for the value is 30 characters to ensure the full string is displayed on smaller screens.
Field 9: Home Page URI Add a link to the merchant’s website.
Field 10: Help URI Add a link to support or help information on the merchant’s website.
Field 11 & 12: Link 1 & 2 Add any link including a link to a telephone number, URL, email address, or specific location. Google Pay uses special icons to distinguish different types of URI’s for the fields that use links. To use an icon, select from the drop-down menu and enter the correct data.

Barcode Fields

Coupon layout 2 barcode fields
Field Description
Barcode Type Select the type of barcode you want to use on the Pass. Supported types include: QR Code, Code 128, Aztec, and PDF 417
Default Barcode Value Select the default barcode value that will appear if no value is passed in the API or if you have not selected ‘autogenerate barcode’
Autogenerate Barcode Check this box if you want to generate a random barcode value for your Passes.
Autogenerate Value Select the data type and data length (10-100 characters) of barcode you would like to autogenerate:Numeric OnlyAlphabet OnlyAlphanumeric
Preview Barcode Enter text in this box to preview how the barcode will be displayed on the actual Pass.

Apple Wallet Fields #

The fields listed in the ‘Apple Wallet Fields’ tab are only applicable to Apple Wallet Passes.

Coupon layout 2 Apple Wallet fields 1
Coupon layout 2 Apple Wallet fields 2
Field Description
Text Color Add any color to the text fields on Apple Passes only.
Icon Add an icon that will appear on your customer’s lock screen for Pass updates and notifications.
Description Add a description for blind and low vision users on Apple Passes.
Link to App Link an app to the Pass. The app will only appear on the back of Apple Wallet Passes
iBeacons – UUID, Major, and Minor Values, and Relevant Text Add up to 10 iBeacons for each Pass. Defining the UUID, Major, and Minor values are necessary for the iBeacon to work. Add relevant text that will appear on the customer’s screen when the iBeacon is detected in a range.

Google Pay Fields #

The fields listed in the ‘Google Pay Fields’ tab are only applicable to Google Pay Passes.

Coupon layout 2 GPay Fields
Field Description
Disable Expiry Notifications Check the ‘Disable Expiry Notifications for Google Wallet Pass’ if you do not want customers to receive a reminder that their coupons are expiring soon. Expiry notifications are typically sent to the Android device 48 hours before the coupon is set to expire.
Redemption Channel Choose how customers can redeem their coupons; in-store, online, both, or a temporary price reduction.
Additional Image If you choose to upload an additional image for Google Pay Passes, the image will appear below the Pass. The image will not appear anywhere on Apple Wallet Passes. You can preview how the additional image will appear by clicking ‘G Pay Preview’.
Additional Image Description Add a description for the additional image. The description will not appear on the Pass.

Relevance #

Coupon layout 2 relevance fields
Field Description
Relevant Address Add up to 10 GPS locations to display a message/notification on your customer’s lock screen when they are nearby.
Relevant Text for IOS This is the custom text that will appear when the device is within the boundaries of the relevant address.
Relevant Text for Android This is the fixed text that will appear when the device is within the boundaries of the relevant address. The text is defined by Google Pay and cannot be customized.

Advanced #

Coupon layout 2 advanced fields
Field Description
Disable Sharing Selecting this option will disable your customers from sharing the Pass on Apple Wallet or share the Pass install link on both Apple Wallet and Google Pay to another device.
Data Archive Settings These settings allow you to set a TTL (time to live) for each Pass. TTL settings can be set per Pass Template so that the value set for the TTL will get updated for each Pass depending on the events that occur.
Go to Top