Skip to content
PassMaker

Field guide

Apple Wallet passes, explained from the bytes up.

Practical references for building, signing, validating, and troubleshooting real PKPass files—written from the same rules exercised by PassMaker’s tools.

01Getting started

How to create an Apple Wallet pass

A practical end-to-end guide to designing, packaging, signing, testing, and distributing a real Apple Wallet pass.

8 min readRead guide
02pass.json

pass.json reference with working examples

Understand required keys, pass styles, fields, colors, barcodes, relevance, and common pass.json validation failures.

10 min readRead guide
03Signing

How to sign a .pkpass file correctly

A focused guide to Pass Type ID certificates, manifest hashing, detached PKCS#7 signatures, WWDR certificates, and final packaging.

9 min readRead guide
04Troubleshooting

Fix “Safari cannot download this file” for PKPass

Diagnose the common packaging, signature, MIME type, redirect, and certificate problems that prevent Apple Wallet passes from installing.

7 min readRead guide
05Certificates

WWDR G4 certificate troubleshooting for PKPass

Understand the Apple WWDR intermediate, identify stale chains, and fix PKPass verification failures involving certificate dates or identity.

7 min readRead guide
06Barcodes

Apple Wallet barcode formats and compatibility

Choose between QR, PDF417, Aztec, and Code 128, set message encodings, and design barcodes that scan reliably from an iPhone display.

8 min readRead guide
07Packaging

PKPass manifest and package structure explained

Learn exactly what belongs inside a .pkpass archive, how manifest hashes work, and why wrapper folders and stale assets break validation.

8 min readRead guide
08Semantics

Apple Wallet semantic tags for boarding passes and events

Use structured semantic information while preserving compatible visible fields across Wallet versions and pass layouts.

9 min readRead guide

Or let the app do it

Every step here, handled on iPhone.

Fields, artwork, manifest digests, PKCS#7 signing and Add to Wallet — without a signing environment or a build script.

Get PassMaker