Cos'è un file pkpass? Come funzionano i pass di Apple Wallet

Può capitarti di trovare un file che termina in .pkpass allegato all'email di una prenotazione, oppure un sito potrebbe scaricarne uno quando tocchi "Aggiungi a Apple Wallet". Ma cos'è un file pkpass? È il formato che Apple Wallet usa per ogni carta d'imbarco, biglietto per eventi, carta fedeltà e coupon che aggiungi. In questo articolo vediamo cosa contiene, come aprirlo su iPhone, perché non si può modificare e quali opzioni hai quando il tuo biglietto arriva solo in PDF.

Cos'è davvero un file .pkpass

Un file .pkpass è un pass di Wallet completo, racchiuso in un unico file. Il nome deriva da PassKit, il framework di Apple per i pass. All'interno è un archivio ZIP con un'estensione diversa. Di solito i siti lo inviano con il tipo application/vnd.apple.pkpass, così Safari sa che deve passarlo a Wallet invece di salvarlo come download.

Un pass non è un'immagine del tuo biglietto. Sono dati strutturati: campi con un'etichetta (come "Gate", "Posto" o "Numero di tessera"), il valore di un codice a barre, dei colori e qualche immagine. Wallet usa questi dati per disegnare il pass. Per questo i pass hanno un aspetto pulito e coerente, e per questo Wallet può fare cose che un PDF non può fare, come mostrare il pass sulla schermata di blocco vicino all'orario di partenza.

Cosa contiene un file pkpass

Se copi un file .pkpass su un computer, lo rinomini in .zip e lo apri, di solito trovi:

• pass.json: il pass vero e proprio. Contiene lo stile del pass, le etichette e i valori dei campi, il messaggio e il formato del codice a barre, i colori ed elementi facoltativi come una data o un luogo pertinenti.
• Immagini: un'icona, di solito un logo, e a volte un'immagine a striscia, una miniatura o uno sfondo. Spesso sono presenti in più risoluzioni per i diversi schermi.
• manifest.json: l'elenco di tutti i file del pass, ciascuno con un checksum (una breve impronta del suo contenuto).
• signature: una firma crittografica del manifest, creata con un certificato che Apple rilascia a chi crea il pass.

Guardare dentro non fa danni, ma non provare a rimettere insieme il file dopo averlo modificato. Nella prossima sezione vediamo perché non funzionerebbe.

Perché ogni pass deve essere firmato

Wallet accetta solo pass firmati con un certificato valido rilasciato da Apple. La firma copre il manifest, e il manifest copre ogni file. Se in pass.json cambia anche un solo carattere, i checksum non corrispondono più e Wallet rifiuta il pass.

Questo protegge te e chi emette il pass:

• Puoi avere la certezza che un pass non sia stato modificato dopo che chi l'ha creato lo ha firmato.
• Compagnie aeree e luoghi degli eventi sanno che i loro pass non possono essere modificati di nascosto dopo l'invio.
• Ogni pass è riconducibile al titolare di un certificato registrato presso Apple.

La chiave di firma è segreta. Deve restare su un server controllato da chi crea il pass. Non può essere inserita in un'app, perché chiunque potrebbe estrarla. Per questo qualsiasi app che crea pass di Wallet, comprese le app di chi emette i biglietti e le app per creare pass, ha bisogno di un server per firmarli.

C'è un'eccezione recente per i pass che crei tu. Con iOS 27, secondo Apple, puoi modificare alcuni campi e cambiare l'aspetto di un pass creato con la funzione Crea un pass di Wallet. I biglietti firmati da una compagnia aerea o da un organizzatore restano comunque non modificabili.

Come aprire un file .pkpass su iPhone

Di solito non devi fare niente di particolare. In Mail, Messaggi, Safari e nella maggior parte delle app, toccando un file .pkpass si apre l'anteprima di Wallet.

1. Tocca l'allegato, il link o il pulsante "Aggiungi a Apple Wallet".
2. Controlla l'anteprima: nome, data, posto, volo o numero di tessera.
3. Tocca Aggiungi nell'angolo in alto.
4. Apri l'app Wallet per trovare il pass. Se hai un Apple Watch abbinato, secondo Apple il pass viene aggiunto automaticamente anche al suo Wallet.

Se hai salvato il file in File, toccandolo lì dovresti vedere la stessa anteprima. Se non succede nulla o compare un errore, scarica di nuovo il file dall'email o dal sito originale. Se continua a non funzionare, chiedi un nuovo pass a chi l'ha emesso.

Gli stili dei pass e cosa cambiano

Ogni pass ha uno stile, impostato in pass.json, che ne determina il layout e parte delle funzioni:

• Carta d'imbarco: voli, treni, autobus e traghetti, con partenza, destinazione e l'icona del mezzo di trasporto.
• Biglietto per eventi: concerti, partite, teatro, conferenze.
• Carta fedeltà: tessere fedeltà, della palestra, della biblioteca e associative.
• Coupon: offerte e sconti.
• Generico: tutto ciò che non rientra negli altri.

Un pass può anche includere una data o un luogo pertinenti. In quel caso Wallet può suggerire il pass sulla schermata di blocco in quel momento o in quel posto. L'esempio di Apple è una carta d'imbarco che compare vicino all'orario di partenza.

I codici a barre dentro un pass

Il codice a barre non è salvato come immagine. pass.json contiene il messaggio e il formato del codice, e Wallet disegna il codice da sé. Fino a iOS 26, Wallet può mostrare quattro formati: QR, PDF417, Aztec e Code 128. Da iOS 27, la documentazione per sviluppatori di Apple aggiunge Code 39, Codabar, EAN-13 e ITF. UPC-A non è nell'elenco di Apple. Un pass può anche indicare un codice a barre di riserva, così gli iPhone meno recenti mostrano un formato che supportano.

Questo conta per i pass fatti in casa. Quando il codice a barre di una carta fedeltà è in un formato che Wallet non può mostrare, un'app per creare pass può ricodificare lo stesso numero in un altro formato. Molti lettori lo leggono comunque, ma alcune casse accettano solo il formato originale. Prova un pass del genere prima di farci affidamento.

Pass statici e pass che si aggiornano

Un pass di una compagnia aerea o di un organizzatore può includere l'indirizzo di un servizio web. Grazie a questo, chi lo emette può inviare una nuova versione del pass quando qualcosa cambia, come il gate, il posto o l'orario. Wallet sostituisce il vecchio pass e può mostrare una notifica.

I pass senza questo collegamento sono statici: restano esattamente come sono stati creati. La maggior parte dei pass fatti in casa è statica, quindi non mostra ritardi, cambi di gate o cancellazioni. Verifica sempre queste informazioni con la compagnia aerea, la compagnia ferroviaria o l'organizzatore.

Alcuni biglietti non arrivano affatto come file pkpass. Un codice a barre che ruota o si anima ogni pochi secondi nell'app di un organizzatore è progettato per non poter essere copiato. Uno screenshot, o un pass creato a partire da esso, non verrà letto. Per questi biglietti usa l'app dell'organizzatore e porta un documento d'identità se le regole del biglietto lo richiedono.

Quando non c'è nessun file .pkpass

Molti biglietti e tessere non arrivano mai come pass. Potresti ricevere un PDF, un codice a barre in un'email o una tessera di plastica. Ecco le opzioni, a partire da quelle ufficiali:

1. Cerca l'opzione di chi ha emesso il biglietto. Apple consiglia di cercare "Aggiungi a Apple Wallet" in un'app, un'email, un messaggio o una pagina web. Se non c'è, Apple suggerisce di chiedere a chi l'ha emesso se supporta Wallet. Le app delle compagnie aeree e degli organizzatori spesso aggiungono il pass al posto tuo.
2. Usa Crea un pass di Wallet (iOS 27). In Wallet, tocca Aggiungi carta → Crea un pass. Poi crea il pass manualmente partendo da un modello standard, associativo o per eventi, oppure crealo da una foto o da uno screenshot di un codice a barre. Il metodo con la foto richiede un iPhone 15 Pro o successivo con Apple Intelligence. Apple descrive questa funzione come utile per cose come le tessere della biblioteca e della palestra che hanno un codice a barre ma nessun pass digitale.
3. Usa un'app per creare pass. Queste app leggono il tuo biglietto e creano per te un .pkpass firmato. Kardin è un esempio. È adatta a un biglietto che esiste solo in PDF, o a un iPhone senza Apple Intelligence. Condividi il PDF o una foto con Kardin da Mail, File o Foto, oppure scansiona il codice a barre con la fotocamera. Kardin legge la prima pagina di un PDF sul tuo iPhone e decodifica il codice a barre nel suo formato originale quando è QR, PDF417, Aztec o Code 128. Poi compila i campi per un pass di volo, treno, autobus, evento o tessera. Controlli e modifichi ogni campo in una schermata di revisione prima di toccare Aggiungi a Apple Wallet. L'estrazione può perdere dei dettagli se il testo è disordinato o piccolo, quindi controlla con attenzione la schermata di revisione.

Per la procedura completa passo per passo, leggi come aggiungere un biglietto PDF ad Apple Wallet. Se sei all'ingresso proprio ora, leggi cosa fare quando il tuo biglietto PDF non ha il pulsante di Apple Wallet.

Quanto alla privacy, dato che ogni pass deve essere firmato su un server, alcuni dati devono per forza lasciare il telefono. Con Kardin, i tuoi file e le tue foto vengono letti sull'iPhone e non vengono mai caricati. Al server di Kardin, per la firma, arriva solo il contenuto del pass: i campi, il valore e il formato del codice a barre, i colori e la data. Il server rimanda subito indietro il pass firmato e non lo conserva. Trovi i dettagli nella pagina sulla sicurezza.

Un file pkpass è sicuro?

Un file .pkpass contiene solo dati e immagini. Non può eseguire codice sul telefono, e Wallet mostra sempre un'anteprima prima di aggiungere qualcosa. Conviene comunque pensare a cosa contiene il pass:

• I pass in Wallet si possono aprire senza Face ID né codice, e si sincronizzano sugli altri tuoi dispositivi tramite iCloud.
• Per questo non inserire mai numeri di carte bancarie, PIN, password, codici di sicurezza bancari o dati di documenti d'identità in un pass creato da un'app di terze parti.
• Elimina i pass che non ti servono più. In Wallet, tocca il pass, poi il pulsante Altro, e rimuovilo.

In breve

• Un file .pkpass è un pacchetto ZIP con i dati del pass (pass.json), le immagini, un elenco di checksum e una firma rilasciata da Apple.
• Toccalo in Mail, Messaggi, Safari o File, controlla l'anteprima e tocca Aggiungi.
• Qualsiasi modifica invalida la firma, quindi per correggere un pass devi ottenerne o crearne uno nuovo.
• I pass di chi emette il biglietto possono aggiornarsi da soli. Quelli fatti in casa di solito sono statici, e i codici a barre che ruotano non possono diventare pass.
• Nessun pass? Cerca prima il pulsante di chi ha emesso il biglietto, poi Crea un pass di Wallet su iOS 27, poi un'app per creare pass come Kardin per PDF e foto.