Jump to content

PKPASS

From Wikipedia, the free encyclopedia
PKPASS
Filename extensions
.pkpass,[1] .pkpasses
Internet media type
  • application/vnd.apple.pkpass
  • application/vnd.apple.pkpasses
Developed byApple
Extended fromZIP

PKPASS is a file format for storage and exchange of digital passes developed by Apple for its Wallet application. Passes can replace physical paper or plastic cards, like a payment card, boarding pass, loyalty card or coupon.[2] The format specification has been published online[2] and this allowed for compatible implementations to be developed for other platforms like Android,[3] Windows[4] and Linux.[5]

Characteristics

[edit]

The file is a ZIP archive with a filename extension .pkpass containing a set of digitally signed files describing the digital pass. Multiple .pkpass files can be further combined into a single ZIP archive with an extension of .pkpasses in order to combine several digital passes for ease of distribution.

The file contents of a sample PKPASS file might look like this:

  • icon.png
  • icon@2x.png
  • pass.json
  • manifest.json
  • signature
  • en.lproj/
    • logo.png
    • logo@2x.png
    • pass.strings
  • ru.lproj/
    • logo.png
    • logo@2x.png
    • pass.strings

icon.png is the digital pass icon. logo.png is displayed at the top left of the rendered pass.

Localized resources - like images and strings - are stored in subfolders named like this: <language_identifier>-<region_identifier>.lproj

The file pass.json is a JSON formatted dictionary describing the digital pass.

manifest.json contains a JSON dictionary containing SHA-1 hashes for all files except the manifest itself and the signature.

signature contains a PKCS #7 signature of the manifest file thus effectively signing all files in the bundle.

References

[edit]
  1. ^ "PKPASS file documentation". Retrieved 2023-07-21.
  2. ^ a b "PassKit Package Format Reference". Apple Inc. Retrieved 2021-10-25.
  3. ^ "Google Play: Search results for "pkpass"". Retrieved 2021-10-25.
  4. ^ "Windows store: Search results for "pkpass"". Microsoft. Retrieved 2021-10-25.
  5. ^ "Flathub store: Search results for "pkpass"". Retrieved 2023-06-21.
[edit]