Apple Wallet (.pkpass) Inspector & Emulator
Inspect, debug, and repair Apple Wallet pass packages (.pkpass). Pixel-perfect emulator for boarding passes, event tickets, store cards, coupons, and generic passes with 1-click SHA-1 fix and Google Wallet export.
| File | Manifest Hash | Actual Hash | Integrity Status |
|---|
Why iOS Silently Drops .pkpass Files
When creating digital passes, iOS rarely shows descriptive error popups — it silently fails to open the pass. Here are the top failure reasons caught by this inspector:
⚠️ manifest.json SHA-1 Desync
Modifying dates, colors, or barcode messages in pass.json without recomputing its SHA-1 checksum in manifest.json causes iOS to reject the archive immediately as corrupt or tampered.
🕒 Floating Dates Missing Timezones
iOS strictly requires all expirationDate and relevantDate strings to follow full ISO 8601 formatting with an explicit timezone offset (e.g. 2026-08-23T14:30:00+02:00 or Z). Floating dates without timezones are rejected.
🖼️ Missing Required Assets & Retina Icons
Apple Wallet requires icon.png and icon@2x.png (58x58 px) for lock screen notifications. Missing icon files or incorrect aspect ratios will prevent the pass from installing.
📱 Barcode Format & Encoding Errors
Using unsupported encoding headers or invalid format constants causes iOS barcode rendering failures. Standard encoding should always be utf-8 or iso-8859-1.
Frequently Asked Questions
What is inside an Apple Wallet .pkpass file?
A .pkpass file is a standard ZIP archive containing pass.json (field layouts, colors, dates, barcodes), manifest.json (SHA-1 checksum dictionary of all files), signature (PKCS#7 signature from Apple Developer), and PNG image assets (icon, logo, strip, thumbnail).
Can I test and preview .pkpass files on Android, Windows, or Linux?
Yes! This tool provides a 100% client-side pixel-perfect web emulator that renders Apple Wallet boarding passes, concert tickets, loyalty cards, coupons, and generic passes directly in any modern browser.
How does the 'Fix & Re-pack' feature work?
If you edit pass.json or fix broken files, clicking 'Fix & Re-pack' recalculates the SHA-1 checksum for every file in the package, regenerates a valid manifest.json, and downloads a clean, verified .pkpass ZIP bundle.
Is my ticket or boarding pass uploaded to your server?
No. All ZIP decompression, SHA-1 cryptographic hashing, PKCS#7 certificate parsing, and canvas/SVG barcode rendering take place 100% locally inside your web browser. Zero ticket data is ever uploaded or stored.