O que é o formato de ficheiro PKPASS?
Arquivos com a extensão .pkpass contêm diferentes tipos de dados empacotados com compressão ZIP, incluindo ingressos do dia a dia, cartões de embarque, cupons, cartões de membro, IDs de estudante, cartões de fidelidade e cartões de crédito ou débito que funcionam com o Apple Pay.
Em um dispositivo móvel, os passes são exibidos como códigos de barras em formatos como Aztec, PDF417, QR ou Code 128 (1D).
Informações adicionais
Este formato foi introduzido em 2012 pela Apple para o aplicativo Passbook - renomeado para Apple Wallet no iOS 9 (2015). Ele também pode ser aberto por outros programas em diferentes plataformas.
Internamente, um pacote .pkpass é um arquivo ZIP contendo vários arquivos obrigatórios:
pass.json- os dados principais do passe: tipo, campos de exibição, cores e URLsmanifest.json- dicionário JSON de somas de verificação SHA-1 para cada arquivo incluídosignature- uma assinatura PKCS#7 destacada gerada com um certificado de ID de Tipo de Passe emitido pela Apple- ativos de imagem como
icon.png,logo.pngestrip.png
Arquivos .pkpass podem ser distribuídos de diferentes maneiras - dentro de aplicativos, sites, plataformas sociais, via SMS, MMS, e-mail e códigos QR ou códigos de barras.
Segurança e proteção
RISCO: LOWArquivos PKPASS são assinados criptograficamente com um certificado emitido pela Apple e contêm apenas dados e imagens - sem código executável - portanto, não podem infectar um dispositivo. O Wallet rejeita passes cuja assinatura não seja validada. O risco real é a privacidade: o código de barras de um passe codifica seus dados de reserva/ingresso, portanto, não compartilhe arquivos de passe ou capturas de tela publicamente e tenha cuidado ao enviar cartões de embarque para sites de conversão online.
Detalhes do formato
em resumoNOME COMPLETOApple Wallet Pass (formerly Passbook)
DESENVOLVEDORApple Inc.desde 2012 (iOS 6, as Passbook; app renamed Wallet in iOS 9, 2015)
CATEGORIAArquivos de Dados
TIPO MIMEapplication/vnd.apple.pkpass
TIPOPacote de passe assinado digitalmente baseado em ZIP (JSON + imagens + assinatura PKCS#7)
PADRÃOAberto · livre de royalties
MAGIC BYTES · ASSINATURA DO ARQUIVO
OFFSET
00010203
HEX
504B0304
ASCII
PK··
Idêntico a qualquer ZIP; distingue-se pelos arquivos internos pass.json + manifest.json + signature
Programas que abrem arquivos PKPASS
Windows1 app
7-Zip
Código aberto Clique com o botão direito → Abrir arquivo (é um ZIP): visualize o pass.json para detalhes e abra as imagens do código de barras - o suficiente para mostrar um ingresso em uma emergência. 
macOS1 app
Pass Viewer (built-in)
Integrado Clique duas vezes no .pkpass - o Visualizador de Passes do macOS o pré-visualiza e oferece «Adicionar ao Wallet» via seu iPhone/iCloud. 
Android3 apps
PassWallet
Freemium Instale, abra o anexo .pkpass e escolha o PassWallet; ele armazena e exibe o código de barras para digitalização.
WalletPasses
Gratuito Instale, abra o arquivo .pkpass com o WalletPasses; ele importa automaticamente os passes encontrados no dispositivo.
Pass2U Wallet
Freemium Abra o .pkpass com o Pass2U; também pode reconstruir passes a partir de códigos de barras/PDF e sincronizar com a nuvem.
iOS1 app
Apple Wallet
Integrado Toque no anexo .pkpass (Mail, Safari, Mensagens) → a visualização é aberta → toque em Adicionar. Integrado ao iOS desde o iOS 6. Detalhes técnicos
especificação profunda| Formato de contêiner | Arquivo ZIP; magic bytes 50 4B 03 04 („PK” cabeçalho de arquivo local) |
| Arquivos internos obrigatórios | pass.json, manifest.json, signature e pelo menos uma imagem de ícone |
| Descritor de passe | pass.json - define o tipo de passe, campos de exibição, cores, tipo de código de barras e URLs de serviço web |
| Manifesto de integridade do arquivo | manifest.json - dicionário JSON de somas de verificação SHA-1 para cada arquivo no pacote |
| Assinatura digital | Assinatura PKCS#7 destacada (arquivo chamado signature), assinada com um certificado de ID de Tipo de Passe emitido pela Apple |
| Autoridade de certificação | Apple Developer Program; um certificado de ID de Tipo de Passe é necessário para gerar assinaturas válidas |
| Tipo MIME | application/vnd.apple.pkpass |
| Formatos de código de barras suportados | Aztec, PDF417, QR Code, Code 128 (1D) |
| Tipos de passe | boardingPass, coupon, eventTicket, generic, storeCard (definidos no pass.json) |
| Ativos de imagem | Arquivos PNG: icon.png, logo.png, strip.png, thumbnail.png, background.png; variantes Retina em @2x e @3x |
| Suporte NFC | Carga útil NFC opcional para aproximação sem contato; requer uma autorização da Apple concedida ao emissor |
| Canais de distribuição | Anexo de e-mail, download em site, entrega no aplicativo, AirDrop, SMS/MMS, leitura de código QR |
| Pacote multi-passe | Vários passes podem ser empacotados juntos como um arquivo .pkpasses (também baseado em ZIP) |
| Suporte de plataforma | Nativo no iOS e macOS (Apple Wallet); suporte para Android via aplicativos de terceiros como PassWallet e Pass2U Wallet |
| Lançado | 2012 (iOS 6, as Passbook; app renamed Wallet in iOS 9, 2015) |
| Padrão aberto | Sim · livre de royalties |
| Especificação | developer.apple.com |
Conversões de PKPASS
Possível
.PKPASS .ZIPGUIA
Sim - um arquivo .pkpass é internamente um arquivo ZIP; copie o arquivo, renomeie a extensão para .zip e…
Como converter
.PKPASS .PDFGUIA
Sim - um .pkpass pode ser convertido para PDF abrindo-o em um visualizador de passes e imprimindo para um…
Como converter
.PKPASS .JPGGUIA
Yes - the images inside a .pkpass file can be extracted and saved as JPG, or you can screenshot the pass…
Como converter
.PKPASS .PNGGUIA
Sim - imagens PNG já estão empacotadas dentro de cada arquivo .pkpass; renomeie uma cópia para .zip, abra-a…
Como converter
Perguntas e Respostas da Comunidade
perguntado por usuáriosAinda não há perguntas - seja o primeiro a perguntar sobre arquivos PKPASS.
Perguntas frequentes
Como abro um arquivo PKPASS no Android?
O Android não possui suporte integrado. Instale o PassWallet, WalletPasses ou Pass2U Wallet da Google Play e, em seguida, abra o anexo .pkpass com esse aplicativo - ele armazena o ingresso e exibe o código de barras digitalizável.
Posso adicionar um PKPASS ao Google Wallet?
Não diretamente - o Google Wallet usa seu próprio formato de passe e não importa arquivos .pkpass. Use um aplicativo de passes de terceiros ou verifique se o emissor oferece um botão «Adicionar ao Google Wallet» em vez disso.
Como converto um PKPASS para PDF para imprimir meu ingresso?
Abra o passe no Wallet ou em um aplicativo de passes e imprima/salve como PDF, ou renomeie o arquivo para .zip e imprima o código de barras extraído com os detalhes do pass.json. Verifique se o local ou a companhia aérea aceita códigos de barras impressos.
Por que meu PKPASS não abre no iPhone?
Geralmente, o passe está expirado, malformado ou sua assinatura é inválida - o Wallet recusa silenciosamente tais passes. Baixe novamente do link ou e-mail do emissor; certifique-se também de estar tocando nele no Mail ou Safari, não em um visualizador de terceiros.
O que há dentro de um arquivo PKPASS?
É um ZIP contendo pass.json (dados do ingresso e carga útil do código de barras), imagens de ícone/logotipo, manifest.json com hashes de arquivo e uma assinatura digital do emissor do passe.
Posso editar um arquivo PKPASS?
Você pode editar o pass.json após descompactar, mas o passe não será mais instalado no Wallet - a assinatura não corresponderá. Apenas o emissor (com seu certificado de passe da Apple) pode produzir passes válidos.
Referências
1Apple Developer - Wallet Passes documentationdeveloper.apple.com
2Apple Developer - Building a Pass (bundle layout, manifest, signature)developer.apple.com
