PASSBOOK has been added to the list of supported ticket media. It is available through the following delivery modes: electronic ticket and mobile ticket. SecuTix recommends enabling the electronic delivery mode instead of relying only on print@home (eticket) or mobile delivery. The electronic mode provides greater flexibility because one or more ticket media can be activated at any time: print@home (eticket), mobile PDF, and PASSBOOK.
As a best practice, enable all three media and create the appropriate templates so users can benefit from the best possible service.
PASSBOOK is natively supported only on iPhone and iPod touch devices running iOS 6 or later. iPads and Android devices do not natively support this format.
Once added to the user’s WALLET, PASSBOOK tickets are also automatically available on Apple Watch.
Recommendation
Use the electronic delivery mode as the primary configuration, then activate print@home PDF, mobile PDF, and PASSBOOK as needed.
Adding a template
First, add a PASSBOOK template in the Institution context under Tools > Templates. You can either import an existing template or create a new one.
When creating a new template, select the base template named passbook and assign it a name.
No passbook option in the list?
If the base template passbook does not appear, contact your SecuTix project manager or SecuTix Support. This usually means the feature has not yet been enabled for your institution in ELCADMIN.
Once the template has been created, open it and generate a test PASSBOOK ticket using the print icon.
If the ticket does not generate correctly
Please contact SecuTix Support.
To test a PASSBOOK ticket (file extension .pkpass), send it by email to an iPhone or iPod touch and open the attachment. The ticket is displayed after tapping the attached file if the pass is valid.
Template configuration
Field restrictions in the editor
Do not move, delete, rename, or add fields in the template. Fields are predefined and must never be structurally modified, except for their values. If you do not want a field to appear, simply make it invisible.
This applies only to the following text fields: block_label, block_value, header_label, header_value, owner_label, owner_value, price_label, price_value, row_label, row_value, seat_label, seat_value, site_label, site_value.
Items in the template editor are not displayed exactly as they appear in the final PASSBOOK result. This is due to limitations in the template editor. To verify the rendering, generate the pass directly from the editor and open the resulting .pkpass file on a supported mobile device.
Do not add formatting inside field values. For example, do not enter formatted HTML such as <i style="color:green">Pass</i> in a field.
Field names reflect the meaning defined by Apple, such as price_value. However, you may place any content you want in these fields. Even if you use a field for a different purpose, do not rename it.
To configure field colors, use the settings field rather than style values.
For dimensions and PASSBOOK behavior, always refer to Apple’s official documentation: PassKit Programming Guide.
Available fields
Field | Default value / recommended size | Description |
|---|---|---|
background.png | Recommended size: 180 x 220 | Background image of the ticket. |
barcode_message | ${tkt_barcode;min=14} | Ticket code generated in the barcode (format: PKBarcodeFormatQR, encoding: iso-8859-1). Keep the default value in this field. |
block_label | Label of the block field in the auxiliary fields section, below the secondary fields. | |
block_value | ${phs_block} | Value of the block field in the auxiliary fields section, below the secondary fields. |
description | ${prd_publicDescription} | Ticket description. Ideally, start with the ticket type (gift voucher, admission, visit) followed by short additional information. This text is used by VoiceOver for accessibility. |
header_label | ${prf_startDate;format=dd.MM.yy} | Header field label shown to the right of the logo text, typically used for the date. |
header_value | ${prf_startTime;format=HH:mm} | Header field value shown to the right of the logo text, typically used for t |