# O que é um ficheiro pkpass? Como funcionam os passes do Apple Wallet

> Um ficheiro .pkpass é um passe assinado do Apple Wallet. Veja o que contém, como abri-lo no iPhone, porque não o pode editar e o que fazer quando não existe.

Published 2026-11-03 · https://kardin.app/pt-pt/blog/o-que-e-um-ficheiro-pkpass

**Um ficheiro .pkpass é um passe do Apple Wallet num único ficheiro. É um pacote comprimido que contém o texto, o código de barras, as cores e as imagens do passe, além de uma assinatura digital que comprova quem o criou. Quando abre um no iPhone, o Wallet mostra uma pré-visualização e um botão Adicionar. Não é possível editar um passe assinado sem o danificar.**

Pode encontrar um ficheiro terminado em .pkpass anexado a um e-mail de reserva, ou um site pode descarregar um quando toca em “Adicionar à Carteira”. Então, o que é um ficheiro pkpass? É o formato que o Apple Wallet usa para todos os cartões de embarque, bilhetes de eventos, cartões de fidelização e cupões que adiciona. Este artigo explica o que contém, como abri-lo no iPhone, porque não pode ser editado e que opções tem quando o seu bilhete só existe em PDF.

## O que é, afinal, um ficheiro .pkpass

Um ficheiro .pkpass é um passe completo do Wallet num único ficheiro. O nome vem de PassKit, a framework da Apple para passes. Por dentro, é um arquivo ZIP com outra extensão. Normalmente, os sites enviam-no com o tipo `application/vnd.apple.pkpass`, para que o Safari saiba que o deve entregar ao Wallet em vez de o guardar como descarga.

Um passe não é uma imagem do seu bilhete. São dados estruturados: campos com etiquetas (como “Porta”, “Lugar” ou “Número de sócio”), o valor de um código de barras, cores e algumas imagens. O Wallet usa esses dados para desenhar o passe. É por isso que os passes têm um aspeto limpo e uniforme, e é por isso que o Wallet consegue fazer coisas que um PDF não consegue, como mostrar o passe no ecrã bloqueado perto da hora de partida.

## O que há dentro de um ficheiro pkpass

Se copiar um ficheiro .pkpass para um computador, mudar a extensão para .zip e o abrir, normalmente vai encontrar:

- **pass.json**: o passe propriamente dito. Contém o estilo do passe, as etiquetas e os valores dos campos, a mensagem e o formato do código de barras, as cores e extras opcionais, como uma data ou uma localização relevante.
- **Imagens**: um ícone, normalmente um logótipo, e por vezes uma faixa, uma miniatura ou uma imagem de fundo. Muitas vezes, existem em mais do que uma resolução para ecrãs diferentes.
- **manifest.json**: uma lista de todos os ficheiros do passe, cada um com uma soma de verificação (uma espécie de impressão digital curta do seu conteúdo).
- **signature**: uma assinatura criptográfica do manifesto, feita com um certificado que a Apple emite para quem cria o passe.

Espreitar o conteúdo não faz mal nenhum, mas não tente voltar a montar o ficheiro depois de o alterar. A secção seguinte explica porque é que isso não funciona.

## Porque é que todos os passes têm de ser assinados

O Wallet só aceita um passe assinado com um certificado válido da Apple. A assinatura abrange o manifesto, e o manifesto abrange todos os ficheiros. Se um único carácter mudar no pass.json, as somas de verificação deixam de corresponder e o Wallet rejeita o passe.

Isto protege-o a si e ao emissor:

- Pode confiar que um passe não foi alterado desde que o seu criador o assinou.
- As companhias aéreas e os recintos sabem que os seus passes não podem ser editados às escondidas depois de enviados.
- Cada passe pode ser associado a um titular de certificado registado na Apple.

A chave de assinatura é secreta. Tem de ficar num servidor controlado por quem cria o passe. Não pode ser incluída numa aplicação, porque qualquer pessoa a poderia extrair. Por isso, qualquer aplicação que crie passes do Wallet, incluindo as aplicações dos emissores e as aplicações para criar passes, precisa de um servidor para os assinar.

Existe uma exceção mais recente para os passes que cria você mesmo. No iOS 27, a Apple indica que pode editar certos campos e mudar o aspeto de um passe criado com a funcionalidade Criar um passe do próprio Wallet. Os bilhetes assinados por uma companhia aérea ou por um organizador continuam a não poder ser editados.

## Como abrir um ficheiro .pkpass no iPhone

Normalmente, não precisa de fazer nada de especial. No Mail, no Mensagens, no Safari e na maioria das aplicações, tocar num ficheiro .pkpass abre a pré-visualização do Wallet.

1. Toque no anexo, na ligação ou no botão “Adicionar à Carteira”.
2. Verifique a pré-visualização: nome, data, lugar, número do voo ou número de sócio.
3. Toque em **Adicionar** no canto superior.
4. Abra a app Carteira para encontrar o passe. Se tiver um Apple Watch emparelhado, a Apple indica que o passe também é adicionado automaticamente à respetiva Carteira.

Se guardou o ficheiro na aplicação Ficheiros, tocar nele aí deve mostrar a mesma pré-visualização. Se nada acontecer, ou se aparecer um erro, descarregue o ficheiro novamente a partir do e-mail ou do site original. Se continuar a falhar, peça um novo passe ao emissor.

## Estilos de passe e o que mudam

Cada passe tem um estilo, definido no pass.json, que determina o seu aspeto e parte do que faz:

- **Cartão de embarque**: voos, comboios, autocarros e ferries, com origem, destino e um ícone do meio de transporte.
- **Bilhete de evento**: concertos, jogos, teatro, conferências.
- **Cartão de loja**: cartões de fidelização, do ginásio, da biblioteca e de sócio.
- **Cupão**: ofertas e descontos.
- **Genérico**: tudo o que não se encaixa nos outros.

Um passe também pode incluir uma data ou uma localização relevante. Quando inclui, o Wallet pode sugerir o passe no ecrã bloqueado por volta dessa hora ou nesse local. O exemplo da Apple é um cartão de embarque que aparece perto da hora de partida.

## Códigos de barras dentro de um passe

O código de barras não é guardado como imagem. O pass.json contém a mensagem e o formato do código de barras, e é o próprio Wallet que o desenha. Até ao iOS 26, o Wallet consegue mostrar quatro formatos: QR, PDF417, Aztec e Code 128. A partir do iOS 27, a documentação para programadores da Apple acrescenta Code 39, Codabar, EAN-13 e ITF. O UPC-A não consta da lista da Apple. Um passe também pode indicar um código de barras alternativo, para que os iPhone mais antigos mostrem um formato que suportam.

Isto é importante para os passes caseiros. Quando o código de barras de um cartão de fidelização está num formato que o Wallet não consegue mostrar, uma aplicação para criar passes pode recodificar o mesmo número noutro formato. Muitos leitores continuam a lê-lo, mas algumas caixas só aceitam o formato original. Teste um passe destes antes de contar com ele.

## Passes estáticos e passes que se atualizam

Um passe de uma companhia aérea ou de um organizador pode incluir o endereço de um serviço web. Com ele, o emissor pode enviar uma nova versão do passe quando algo muda, como a porta de embarque, o lugar ou a hora. O Wallet substitui o passe antigo e pode mostrar uma notificação.

Os passes sem essa ligação são estáticos: ficam exatamente como foram criados. A maioria dos passes caseiros é estática, por isso não mostram atrasos, mudanças de porta de embarque nem cancelamentos. Confirme sempre essas informações com a companhia aérea, a empresa ferroviária ou o organizador.

Alguns bilhetes nem sequer existem num ficheiro pkpass. Um código de barras que roda ou se anima a cada poucos segundos dentro da aplicação de um organizador foi concebido para não poder ser copiado. Uma captura de ecrã desse código, ou um passe criado a partir dele, não será lido. Use a aplicação do organizador para esses bilhetes e leve identificação se as regras do bilhete o exigirem.

## Quando não existe nenhum .pkpass

Muitos bilhetes e cartões nunca chegam sob a forma de passe. Pode receber um PDF, um código de barras num e-mail ou um cartão de plástico. As suas opções, começando pelas oficiais:

1. **Procure a opção do próprio emissor.** A Apple aconselha a procurar “Adicionar à Carteira” numa aplicação, e-mail, mensagem ou página web. Se não existir, a Apple sugere perguntar ao emissor se suporta o Wallet. As aplicações das companhias aéreas e dos organizadores muitas vezes adicionam o passe por si.
2. **Use a funcionalidade Criar um passe do Wallet (iOS 27).** No Wallet, toque em Adicionar cartão → Criar um passe. Depois, crie o passe manualmente a partir de um modelo padrão, de sócio ou de evento, ou crie-o a partir de uma fotografia ou captura de ecrã de um código de barras. O método da fotografia precisa de um iPhone 15 Pro ou posterior com Apple Intelligence. A Apple descreve esta funcionalidade como útil para coisas como cartões da biblioteca e do ginásio que têm código de barras mas não têm passe digital.
3. **Use uma aplicação para criar passes.** Estas aplicações leem o seu bilhete e criam um .pkpass assinado por si. O [Kardin](/) é um exemplo. É indicado para um bilhete que só existe em PDF, ou para um iPhone sem Apple Intelligence. Partilha o PDF ou uma fotografia com o Kardin a partir do Mail, do Ficheiros ou do Fotografias, ou lê o código de barras com a câmara. O Kardin lê a primeira página de um PDF no seu iPhone e descodifica o código de barras no formato original quando é QR, PDF417, Aztec ou Code 128. Depois, preenche os campos de um passe de voo, comboio, autocarro, evento ou cartão. Verifica e edita todos os campos num ecrã de revisão antes de tocar em Adicionar à Carteira. A extração pode falhar alguns dados em texto confuso ou pequeno, por isso verifique bem o ecrã de revisão.

Para o passo a passo completo, veja [como adicionar um bilhete em PDF ao Apple Wallet](/guides/add-pdf-to-apple-wallet). Se estiver neste momento à porta, veja [o que fazer quando o seu bilhete em PDF não tem botão do Apple Wallet](/scenarios/ticket-pdf-no-apple-wallet).

Quanto à privacidade: como todos os passes têm de ser assinados num servidor, alguns dados têm de sair do seu telemóvel. Com o Kardin, os seus ficheiros e fotografias são lidos no iPhone e nunca são carregados. Só o conteúdo do passe vai para o servidor do Kardin para ser assinado: os campos, o valor e o formato do código de barras, as cores e a data. O servidor devolve imediatamente o passe assinado e não o guarda. A [página de segurança](/security) tem os pormenores.

## Um ficheiro pkpass é seguro?

Um ficheiro .pkpass contém apenas dados e imagens. Não consegue executar código no seu telemóvel, e o Wallet mostra-lhe sempre uma pré-visualização antes de adicionar seja o que for. Ainda assim, pense no que o passe contém:

- Os passes no Wallet podem ser abertos sem Face ID nem código, e sincronizam com os seus outros dispositivos através de iCloud.
- Por isso, nunca coloque números de cartões bancários, PIN, palavras-passe, códigos de segurança bancários nem dados de documentos de identificação oficiais num passe criado por uma aplicação de terceiros.
- Apague os passes de que já não precisa. No Wallet, toque no passe, depois no botão Mais, e remova-o.

## Em resumo

- Um ficheiro .pkpass é um pacote ZIP com os dados do passe (pass.json), imagens, uma lista de somas de verificação e uma assinatura emitida pela Apple.
- Toque nele no Mail, no Mensagens, no Safari ou no Ficheiros, verifique a pré-visualização e toque em Adicionar.
- Alterar qualquer coisa danifica a assinatura, por isso corrigir um passe significa obter ou criar um novo.
- Os passes dos emissores podem atualizar-se sozinhos. Os passes caseiros são normalmente estáticos, e os códigos de barras rotativos não podem ser transformados em passes.
- Não tem passe? Procure primeiro o botão do emissor, depois a funcionalidade Criar um passe do Wallet no iOS 27 e, por fim, uma aplicação para criar passes como o Kardin, para PDF e fotografias.

## FAQ

### Posso abrir um ficheiro pkpass no Windows ou no Android?

Um ficheiro .pkpass é um formato da Apple, e é o Apple Wallet que o abre. No Windows, pode mudar a extensão de uma cópia para .zip e ver os ficheiros que contém, mas não verá um passe utilizável. No Android, depende das aplicações que tiver instaladas. A solução mais simples é pedir ao emissor uma versão feita para o seu telemóvel.

### Posso editar um ficheiro pkpass para corrigir um nome ou um lugar errado?

Não sem o danificar. Qualquer alteração invalida a assinatura e o Wallet recusa o passe. Peça ao emissor um passe corrigido. Se foi você que criou o passe, crie um novo com os dados certos e apague o antigo. Nunca altere o código de barras de um bilhete.

### Porque é que o iPhone diz que não consegue adicionar um passe?

Normalmente, significa que o ficheiro está danificado ou que a respetiva assinatura já não é válida, por exemplo porque o certificado do emissor caducou. Experimente descarregar o ficheiro novamente, diretamente a partir do e-mail ou do site original. Se continuar a falhar, contacte o emissor e peça um novo passe ou outra versão do bilhete.

### Posso enviar um ficheiro pkpass a outra pessoa?

Alguns passes têm um botão Partilhar no Wallet. Se não tiver, a Apple explica que o emissor não ativou a partilha. Um bilhete partilhado tem o mesmo código de barras que o seu, por isso não dá direito a uma entrada extra a ninguém. Muitos recintos só aceitam a primeira leitura. Para dar um bilhete a outra pessoa, use a opção de transferência do próprio organizador.

### Um passe no Apple Wallet funciona sem internet?

Sim. Depois de estar no Wallet, o passe abre e mostra o código de barras sem rede, o que dá jeito em estádios e aeroportos. As atualizações do passe, como uma mudança de porta de embarque, precisam de ligação, tal como adicionar um passe novo.