Passbook Treatment form
Completing the Passbook Details tab

Use the various mini-tabs in the Passbook Details tab to configure and preview different elements of the pass. The system automatically updates the Preview pane as you make changes to the configurations in the mini-tabs.

For specific details on the various elements involved in pass creation (such as images, fields, and bar codes), refer to the Pass Design and Creation chapter of Apple’s Passbook Programming Guide.

General

Use the General tab to configure the following general settings for the pass:

Key Code

Description

Visual Elements

For each field below, use to launch the Image Viewer, from where you can search for and select the desired image.

Colors

For each field below, either directly enter the hex code for the color or click the color square (next to the input box) to launch the Color Picker.

Pass Header

Use the Pass Header tab to configure the following settings related to the pass header.

Header Visual Appearance

Header Fields

Use this section to add fields to display in the pass header. You can configure a maximum of three fields for the header. Header fields are the only fields that are visible when the pass is stacked with other passes in the Passbook app. Use these fields sparingly to show only the most vital pass information.

See Configuring pass fields for details on configuration options for pass fields.

Primary

Use the Primary tab to configure the primary field for the pass. This field typically contains the most important pass information and displays prominently on the pass.

See Configuring pass fields for details on configuration options for pass fields.

Secondary

Use the Secondary tab to configure the secondary fields for the pass. You can configure a maximum of four secondary fields. Secondary fields are less prominent than the primary field and typically display in a smaller font size. Specify secondary fields in the order of their importance.

See Configuring pass fields for details on configuration options for pass fields.

Auxiliary

Use the Auxiliary tab to configure additional fields to display on the pass. You can configure a maximum of four auxiliary fields. If secondary fields are present, they will take precedence over auxiliary fields.

In most cases, coupons and generic passes can have a maximum of four secondary and auxiliary fields, combined.

See Configuring pass fields for details on configuration options for pass fields.

Barcode

Use the Barcode tab to specify the barcode configuration for the pass. Select Yes, include a barcode to include a barcode in the pass.

Next, select the kind of barcode to use. Choose from the following barcode formats:

• Aztec
• Quick Response (QR) code
• Portable Data file (PDF) 417

Next, select what should happen when the barcode is scanned. Choose from the following behaviors:

• Yes, automatically register a positive response when scanned - Select this option to have the system record a positive response for the Offer through which this pass is delivered.
• No, I want to customize the data of the barcode and a response will be captured elsewhere - Select this option to specify the data to be stored in the barcode. Enter the desired data in the input field.
  The barcode format determines the amount of data that the barcode can contain. Refer to the official documentation for each of these formats for more details on their data limits.
  In this scenario, no response is captured as part of scanning the barcode. Response capture (if needed) must be handled in a different part of the process.

You can also choose to specify a user-friendly text message that will display with the barcode. This field can be used to display human-readable information (such as coupon codes or membership numbers). This is particularly useful if the pass can be used at places where a barcode scanner might not be available.

Finally, some barcode scanners require the data encapsulated in the barcode to be encoded. You can specify the encoding to use or use the default encoding (ISO 8859-1).

Relevance

Use the Relevance tab to configure locations at which this pass will be relevant. You can specify up to ten locations. When a holder of this pass is at (or within) one of the specified locations, the specified notification message is displayed on the holder’s device.

Field	Description
Geofence	Select the Geofence rule containing the desired location information.
Latitude	Specify the latitude of the desired location.
Longitude	Specify the longitude of the desired location.
Notification Message	Enter the message to display on the pass holder’s device when the holder is at/within the specified location.

For each location, either select a Geofence rule or specify the latitude and longitude.

Back

Use the Back tab to configure fields to display on the back of the pass. You can specify up to twenty fields for the back of the pass. Use back fields to specify fields that are too long for the front of the pass (e.g. terms and conditions) or any other additional information that may be helpful for pass holders.

See Configuring pass fields for details on configuration options for pass fields.

Pass Design and Creation chapter of Apple’s Passbook Programming Guide About Geofences

About Passbook Treatments