I pass nel wallet

Oltre al biglietto nell'e-mail di conferma, il Suo visitatore può mettere il suo biglietto in Apple Wallet o Google Wallet. Per molte persone è l'unico posto in cui all'ingresso riescono ancora a ritrovarlo. Questo articolo spiega che cosa sono quei wallet, perché un pass funziona meglio di un pdf, e che cosa va impostato una volta per tutte perché i pulsanti funzionino.

Che cos'è un wallet?

Ogni telefono moderno ha un'app portafoglio integrata. Su un iPhone si chiama Wallet (l'icona con le tesserine colorate), su un dispositivo Android Google Wallet. È lo stesso posto in cui le persone conservano la carta d'imbarco per l'aereo, la tessera fedeltà del supermercato, l'abbonamento del treno e a volte la carta di pagamento.

Non deve installare quell'app: c'è già. Un "pass nel wallet" è semplicemente una tesserina che si aggiunge. In questo caso: il biglietto per il Suo evento, con sopra il nome della Sua organizzazione.

Il visitatore deve toccarlo una volta da solo. Lei non deve fare nulla — i pulsanti sono già nell'e-mail e nella pagina di conferma.

Perché un pass funziona meglio di un pdf

Un pdf in una casella di posta sembra la stessa cosa, ma all'ingresso la differenza è grande.

Un pass nel wallet	Un pdf nell'e-mail
Poco prima del Suo evento compare da solo sulla schermata di blocco	Deve ricercare l'e-mail
Un tocco e lo schermo diventa automaticamente più luminoso	La luminosità la alza da sé, oppure se ne dimentica
Funziona senza internet, il pass è nel telefono	Un pdf che deve ancora scaricarsi in un tendone affollato non ce la fa
Sta fra le carte d'imbarco e le tessere fedeltà, sempre nello stesso posto	Sta da qualche parte in una casella con altre trecento e-mail

Quella seconda riga è quella che all'ingresso si nota più spesso. Apple e Google alzano la luminosità dello schermo non appena viene mostrato il codice QR, e uno schermo luminoso si scansiona quasi sempre al primo colpo.

Che cosa Le serve prima di cominciare

• Nulla per ogni ordine: i pulsanti compaiono da soli su ogni biglietto valido.
• Una volta per tutte, a livello centrale: un account presso Apple e presso Google, più il certificato Apple. Veda "Che cosa va impostato una volta per tutte" qui sotto.
• Un visitatore con uno smartphone. Chi non ce l'ha stampa semplicemente il suo biglietto; si scansiona altrettanto bene.
• Per il manifesto e i pulsanti che stanno sotto: la formula Start o superiore. Con la formula gratuita i Suoi pass continuano a funzionare come hanno sempre funzionato.

---

Che cosa vede il visitatore

Nell'e-mail di conferma e nella pagina del biglietto ci sono due pulsanti: Aggiungi ad Apple Wallet e Aggiungi a Google Wallet. Un tocco e il pass è nel telefono, con il nome della Sua organizzazione, il prodotto, la sede e — quando c'è — la fascia oraria.

Gli stessi pulsanti sono nella pagina di conferma che il Suo visitatore vede dopo il pagamento:

E sono anche nell'e-mail stessa, così che chi ha chiuso la finestra possa accedervi più tardi:

Che cosa c'è sul pass

Sul fronte	Sul retro
Il prodotto, la sede e la fascia oraria o il giorno di validità	L'indirizzo della sede
Il codice QR	Il Suo riferimento d'ordine e il nome dell'emittente
	Il Suo testo sul retro, e i dati che non ha messo sul fronte, come il nome del visitatore

Che cosa va sul fronte lo sceglie Lei; veda "Cosa va sul fronte" più avanti.

Su un iPhone si gira un pass toccando i tre puntini in alto a destra. Utile da sapere quando un visitatore chiede al telefono dove sta l'indirizzo.

Attenzione: un normale biglietto e un abbonamento annuale ricevono di proposito un tipo di pass diverso. Un biglietto appartiene a una data e dopo quel giorno scivola ordinatamente indietro nel wallet. Un abbonamento annuale resta in primo piano per tutta la stagione, perché al Suo visitatore serve ogni volta. Veda Abbonamenti annuali.

---

Il biglietto come manifesto

Su un iPhone recente il biglietto non è più una tesserina ma un manifesto: la foto del Suo evento riempie quasi tutto lo schermo, i dati stanno sopra, e sotto compare una fila di pulsanti.

Succede da solo. È un unico biglietto che cresce insieme al telefono del Suo visitatore — un iPhone recente ne mostra di più, uno più vecchio mostra la tessera di sempre. Non deve impostare nulla a parte, e non c'è nulla che possa rompersi.

A partire da quale formula? Il manifesto, la guida alla sede, le date in arrivo e i pulsanti in alto appartengono alla formula Start e superiori. Con la formula gratuita i Suoi pass continuano a funzionare come hanno sempre funzionato: stesso codice QR, stessi campi, altrettanto validi all'ingresso. Veda La Sua formula, le Sue fatture e la sospensione.

Su un iPhone con iOS 18 o più recente

È quello che oggi vede la maggior parte dei visitatori:

• la foto del Suo evento su quasi tutto lo schermo, con la data, l'ora, la sala e il nome del Suo visitatore sopra;
• «porte aperte alle …», quando indica quanti minuti prima dell'inizio fa entrare;
• una fila di pulsanti sotto il pass: Come arrivare, Parcheggio, Accessibilità, Trasporto pubblico, Ordinare da mangiare e Cosa può portare con sé. Ogni pulsante compare solo se ha compilato qualcosa per quel punto;
• il pass compare da solo sulla schermata di blocco quando il Suo visitatore si avvicina alla Sua sede. Per questo la sede deve avere i suoi due numeri sulla mappa — veda qui sotto.

Su un iPhone con iOS 26 o più recente

Se il Suo visitatore ha un abbonamento annuale o una serie — un abbonamento, un festival di tre giorni, un corso di otto serate —, le date in arrivo stanno sul pass stesso. Non deve quindi più cercare quando è atteso la volta successiva.

Su un iPhone con iOS 27 o più recente

In cima al pass si aggiungono due pulsanti: Come arrivare e Vedi l'ordine. Non saranno mai più di due; quel limite viene da Apple e non da noi.

Su un iPhone più vecchio (iOS 17 e precedenti)

Mostra il biglietto di sempre: il Suo colore, il Suo logo, i dati e il codice QR. Non si perde nulla e non si rompe nulla — il telefono lascia semplicemente fuori quello che non conosce ancora.

Non deve quindi creare un secondo biglietto per i dispositivi più vecchi, e non deve mai chiedere al Suo visitatore che iPhone ha.

Su un dispositivo Android (Google Wallet)

Google mostra gli stessi dati, dove ha un posto per loro: l'immagine in cima al pass, la sala, la data e l'ora, e in fondo al pass i link della Sua guida alla sede.

La fila di pulsanti di Apple, Google non la conosce. Non è un'impostazione messa male: quel modo di mostrare le cose lì semplicemente non esiste. Quello che compila viene comunque riportato — sta solo da un'altra parte.

---

Che cosa compila Lei, e dove

Tutto quello che segue è facoltativo. Lo compila una volta e poi finisce su ogni biglietto che vende.

Prodotti → un prodotto → sezione Immagine e apertura porte

Quella sezione è chiusa; la apra con un clic.

• Locandina di questo evento. Una foto verticale funziona meglio: è la forma di uno schermo di telefono. Una foto orizzontale viene ritagliata.
• Apertura porte, in minuti prima dell'inizio. Se qui scrive 30 per uno spettacolo delle 20.00, il Suo visitatore legge «porte aperte alle 19.30».

Per un abbonamento annuale e per un buono regalo la sezione non c'è: quei due non valgono per un singolo momento, quindi un manifesto e un orario delle porte lì non dicono nulla.

Sedi → una sede

Nella sezione La sede:

• Foto del luogo. La facciata, la sala, il terreno. Subentra quando il prodotto stesso non ha un manifesto.
• Ingresso, come deve comparire sul pass: «Porta A», «Ingresso laterale».
• Latitudine e Longitudine: i due numeri che indicano il Suo posto sulla carta del mondo. Non deve cercarli Lei — il pulsante Cerca le coordinate li ricava dal Suo indirizzo. Sono loro a dare il pulsante Come arrivare, e a far comparire il pass da solo sulla schermata di blocco.

Nella sezione Guida alla sede (anch'essa chiusa): Telefono, E-mail, Sito web, Accessibilità, Parcheggio, Trasporto pubblico, Ordinare da mangiare e Cosa si può portare dentro. Ogni campo che compila diventa un pulsante sotto il pass.

Impostazioni → Organizzazione → scheda Pass wallet

Qui mette quello che vale per tutti i Suoi eventi insieme:

• nella sezione Biglietti locandina: Immagine per il biglietto locandina, usata quando né un prodotto né una sede hanno una foto, e Apertura porte come valore predefinito per chi non vuole compilarlo prodotto per prodotto;
• nella sezione Guida alla sede: gli stessi link per tutte le Sue sedi insieme (Sito web, Accessibilità, Parcheggio, Trasporto pubblico, Ordinare da mangiare e Cosa si può portare dentro; telefono ed e-mail si compilano per ogni sede). Una sede che ne compila uno per conto suo ha la meglio su quello dell'organizzazione.

Quale foto vince

Tre posti possono fornire un'immagine, e arrivano nel loro turno in quest'ordine:

1. la locandina del prodotto;
2. altrimenti la foto del luogo della sede;
3. altrimenti l'immagine per il biglietto locandina in Pass wallet, e se è vuota la Sua immagine d'atmosfera nello stesso punto.

Se non c'è una foto da nessuna parte, il Suo visitatore riceve il biglietto di sempre invece del manifesto. Non è un errore e non è un guasto: senza immagine non c'è manifesto da fare, e una tessera curata è meglio di un manifesto con sopra un rettangolo grigio.

Lo stesso ordine vale per l'orario delle porte e per i link della Sua guida alla sede: vince il più preciso.

Un campo vuoto non dà un pulsante

Se non compila una pagina del parcheggio, sul pass non c'è nemmeno un pulsante Parcheggio. È voluto.

Un pulsante che non porta da nessuna parte è peggio di nessun pulsante: il Suo visitatore lo tocca mentre è in fila, trova una pagina vuota, e telefona a Lei. Meglio quindi compilare bene tre campi che otto a metà.

---

Prima di tutto questo

Se vuole dedicarci poco tempo, faccia queste tre cose. Sono quelle che rendono di più:

1. Una foto verticale per ogni evento. Senza foto niente manifesto; con una foto il biglietto diventa un manifesto sullo schermo del Suo visitatore.
2. Il Suo indirizzo con i due numeri della mappa. Un clic sul pulsante che li cerca. Così ha il pulsante Come arrivare, e il pass che compare da solo sulla schermata di blocco quando il Suo visitatore è nei paraggi.
3. L'orario delle porte. Un numero, e il Suo visitatore sa quando può venire. È quello che Le risparmia la maggior parte delle telefonate della sera stessa.

---

Che cosa spiega a un visitatore al telefono

Questa conversazione la fa più spesso di quanto pensi. Un copione che funziona:

1. "Ha un iPhone o un dispositivo Android?" — così sa quale dei due pulsanti gli serve.
2. "Apra l'e-mail di conferma che ha ricevuto da noi. Scorra in basso finché vede il biglietto."
3. "Sotto il biglietto ci sono due pulsanti. Tocchi Aggiungi ad Apple Wallet" (oppure Google Wallet).
4. "Compare un'anteprima della tesserina. Tocchi in alto a destra su Aggiungi."
5. "Fatto. Da adesso lo ritrova nella Sua app Wallet, e il giorno stesso compare da solo sulla Sua schermata di blocco."

Se non lo vuole, o se non ci riesce: lasci perdere. Il biglietto nell'e-mail funziona altrettanto bene, e un foglio stampato è la scansione più rapida di tutte.

---

Il codice QR è lo stesso

Sul pass c'è esattamente lo stesso codice del normale biglietto. L'app di scansione non deve quindi sapere nulla dei wallet: vede semplicemente un altro biglietto valido.

È anche la ragione per cui non ci si mette mano: chi modificasse il codice sul pass renderebbe inutilizzabile ogni pass già presente in un telefono.

In pratica significa anche che il Suo visitatore può tranquillamente avere sia il pass sia il biglietto cartaceo. È un solo biglietto con un solo codice; chi lo presenta due volte, la seconda volta riceve "doppio".

---

Un biglietto che non è più valido

Un biglietto annullato o rimborsato non riceve più un pass, e un pass esistente smette di funzionare. Altrimenti resterebbe nel telefono di qualcuno che ha già riavuto i suoi soldi un QR dall'aria valida.

Con un abbonamento annuale c'è un'eccezione voluta. Una tessera disdetta o bloccata non riceve più un pass. Una tessera semplicemente scaduta sì: quella resta nel telefono come promemoria del fatto che va rinnovata, e all'ingresso la scansione la respinge con "fuori dal periodo". È una risposta più chiara di un pass sparito all'improvviso.

---

Che cosa va impostato una volta per tutte

I pass nel wallet richiedono un account presso Apple e presso Google. È lavoro a livello di piattaforma — viene impostato centralmente e non per ogni organizzazione. Finché non è impostato, funziona tutto tranne i due pulsanti wallet, e chi ci clicca riceve un messaggio chiaro invece di un mezzo pass.

Per Apple è compreso un certificato che scade ogni anno. Un certificato è una specie di sigillo digitale con cui Apple può verificare che un pass provenga davvero dall'emittente. Se scade, i pass esistenti continuano a funzionare ma non ne vengono più creati di nuovi.

Attenzione: è quindi esattamente il tipo di guasto di cui ci si accorge soltanto quando telefona un visitatore. Se da Lei il pulsante non funziona più mentre il mese scorso funzionava, ce lo segnali subito invece di aspettare — è quasi sempre questo.

---

Dare forma alla Sua tessera

La tessera di un visitatore è spesso l'unica cosa che di Lei resta sul suo telefono, per mesi, fra la carta bancaria e il biglietto del treno. Può quindi disegnarla Lei stesso, in Impostazioni → Organizzazione → scheda Pass wallet.

Tutto in quella scheda può restare vuoto. Se non compila nulla, la tessera segue il Suo colore e il logo del Suo negozio dalla scheda Identità visiva — e in mancanza di quelli i colori della piattaforma. Non deve fare nulla per avere una tessera curata.

I colori

Tre colori, e ognuno fa qualcosa di diverso:

Colore	Dove si trova
Sfondo	tutta la superficie della tessera
Testo	i valori: la data, il nome, il prodotto
Etichette	le piccole parole sopra ogni valore

Nell'anteprima in fondo alla scheda compare un avviso quando una combinazione ha troppo poco contrasto, con il numero accanto. Quel numero va da 1 (due volte lo stesso colore) a 21 (nero su bianco); sotto 4,5 il testo piccolo diventa faticoso. Tenga presente che una tessera si legge in fila, su un telefono con la luminosità bassa e il sole addosso.

Faccia soprattutto attenzione alle etichette: sono piccole, quindi hanno bisogno di più contrasto del testo stesso — esattamente il contrario di quello che quasi tutti danno per scontato.

Non la fermiamo. Una tessera nei Suoi colori che noi troviamo brutta è una Sua scelta; di una tessera che nessuno riesce a leggere preferiamo averglielo detto.

Logo e immagine d'atmosfera

Carica un solo logo; noi ne ricaviamo i sei file che Apple e Google chiedono ciascuno per conto proprio. Apple lo mette in alto sulla tessera e lo usa come icona sulla schermata di blocco, Google ne ritaglia un logo rotondo.

A cosa fare attenzione:

• un png con sfondo trasparente. Il logo poggia direttamente sul colore di sfondo. Un png con un rettangolo bianco attorno dà un francobollo bianco su una tessera colorata — il classico. L'anteprima in fondo alla scheda la avvisa;
• almeno 480 pixel di larghezza, altrimenti risulta sfocato su uno schermo nitido;
• al massimo 2 MB. I file più grandi vengono rifiutati.

L'immagine d'atmosfera è facoltativa: una foto larga sopra i dati, circa 3 a 1 e almeno 1125 pixel di larghezza. Se la lascia vuota ottiene una tessera a tinta unita — spesso più sobria. Una foto del Suo edificio o della Sua sala funziona di solito meglio di una foto con del testo sopra: la tessera viene ritagliata e il testo resta mezzo tagliato.

Un svg non va bene. Apple accetta solo png, e li facciamo noi a partire dal Suo caricamento. Se ha soltanto un logo svg, lo esporti una volta come png.

I testi

Nome sul pass è il nome così come compare in alto. Apple lo mostra piccolo e lo tronca; se il Suo nome ufficiale è lungo ("Regio Circolo di Storia Locale ODV"), metta qui quello breve. Il Suo nome in fattura non cambia.

Testo sul retro sono informazioni pratiche che il visitatore porta con sé: come entrare, dove parcheggiare, che un biglietto non è rimborsabile. Lo compila per lingua. Se ha compilato solo il neerlandese, un visitatore francofono riceverà quel testo neerlandese — meglio di un retro vuoto.

Cosa va sul fronte

Per tipo di tessera — biglietto, biglietto con fascia oraria, abbonamento annuale, buono regalo — sceglie quali dati il visitatore vede senza girare la tessera: data e ora, nome del titolare, tipo di biglietto, sede.

Due cose da sapere:

1. l'ordine conta. Il primo campo compare in grande, i due successivi su una riga sotto, il resto piccolo. Più di tre sul fronte non stanno in una larghezza di schermo;
2. quello che non sceglie non sparisce. Passa sul retro della tessera. Una scelta infelice non fa quindi mai perdere un indirizzo.

Di base il prodotto sta in testa. Per un biglietto con fascia oraria seguono subito dopo data e ora, prima della sede — è quello che si cerca stando in fila.

Prima vedere, poi salvare

In fondo alla scheda, in Ecco come apparirà, c'è un'anteprima dal vivo: la versione Apple e la versione Google, che si muovono mentre compila. Con Mostra come sceglie quale tipo di tessera sta guardando. Le due piattaforme fanno davvero qualcosa di diverso con lo stesso colore, quindi le guardi entrambe.

L'anteprima resta un'approssimazione — Apple e Google disegnano la tessera vera con i loro font. Per averla in mano, clicchi su Invia un pass di prova al mio indirizzo e-mail. Riceve una mail all'indirizzo con cui ha effettuato l'accesso, con gli stessi due pulsanti del Suo visitatore. La apra sul Suo telefono: il pass ha il Suo design e dati inventati. Il codice non dà accesso: all'ingresso viene rifiutato.

Il pass di prova porta il design così come è salvato. Salvi prima, invii dopo.

Abbonamenti annuali e buoni regalo

Un abbonamento annuale e un buono regalo possono stare nel wallet allo stesso modo, con lo stesso design. Un buono regalo mostra sempre il suo saldo in alto, qualunque altra cosa scelga: è l'unica ragione per cui si apre un buono.

Un buono bloccato non riceve più una tessera. Uno vuoto o scaduto sì — può restare nel telefono, e alla cassa "questo buono è esaurito" è una risposta più chiara di una tessera sparita all'improvviso.

Il denaro sul biglietto

Se lavora con un saldo consumazioni al bar, quel saldo si trova sul pass stesso. Il Suo visitatore apre il suo biglietto e vede quanto c'è ancora sopra — senza app e senza fare login.

Si aggiorna da sé: ogni volta che viene ricaricato, speso o rimborsato, il pass nel telefono si aggiorna. Lei non deve fare nulla.

Se non c'è nulla sopra, o se la Sua organizzazione non lavora con il saldo, la riga non compare proprio. Un pass che mostra "€ 0,00" mentre non c'è nulla da comprarci è più confuso di un pass senza quella riga.

Veda Saldo consumazioni al bar per come ricaricare, addebitare e rimborsare.

Errori frequenti

• Offrire al Suo visitatore il pulsante wallet come unica strada. Non tutti hanno uno smartphone, e non tutti vogliono usarlo. Il biglietto nell'e-mail e su carta resta altrettanto valido.
• Credere che un pass sia qualcosa di diverso da un biglietto. È lo stesso codice. Presentarlo due volte dà due volte lo stesso esito.
• Inoltrare un pass a qualcun altro. Tecnicamente si può, ma resta un solo codice: chi si presenta all'ingresso per secondo non entra.
• Aspettare a segnalare quando il pulsante smette di funzionare. Di norma è il certificato Apple scaduto annualmente, e lo risolviamo noi.
• Eliminare il pass dopo una modifica dell'ordine. Non è necessario; un biglietto diventato non valido viene comunque respinto all'ingresso.

---

E se …

E se il pulsante wallet non fa nulla?

Due possibilità. O il biglietto non è più valido — annullato o rimborsato — e in quel caso il pulsante non deve fare nulla. Oppure l'impostazione centrale non è a posto, ad esempio perché il certificato Apple è scaduto. Il Suo visitatore riceve in quel caso un messaggio e non una pagina rotta. Ce lo faccia sapere; nel frattempo il biglietto nell'e-mail funziona normalmente.

E se il visitatore ha eliminato per sbaglio il suo pass?

Gli faccia riaprire l'e-mail di conferma e toccare di nuovo il pulsante. Riceve indietro lo stesso pass, non un secondo. Se non trova più l'e-mail, reinvii la conferma dall'ordine.

E se all'ingresso non c'è internet?

Il pass è nel telefono e non ha bisogno di connessione per essere mostrato. Anche la Sua app di scansione continua a funzionare offline. Veda App di scansione e personale addetto.

E se qualcuno ha un dispositivo Android senza Google Wallet?

Capita sui dispositivi più economici e su quelli senza servizi Google. In quel caso usi il normale biglietto nell'e-mail, oppure lo stampi. Non si perde nulla: il codice è lo stesso.

E se lo schermo del visitatore è troppo scuro?

Un pass nel wallet alza da solo la luminosità non appena viene mostrato il QR. Se non lo fa, probabilmente è aperto un pdf o uno screenshot invece del pass. Gli chieda di aprire l'app Wallet.

---

Domande frequenti

Il mio visitatore deve installare un'app? No. Wallet è già su ogni iPhone e Google Wallet su praticamente ogni dispositivo Android. Si aggiunge soltanto una tesserina.

Costa qualcosa in più al mio visitatore o a me? No. È compreso nel biglietto.

Posso modificare il pass in seguito? La veste grafica sì, nella scheda Pass wallet; i nuovi pass la adottano. Il contenuto segue il biglietto. Se cambia qualcosa nell'ordine, ci contatti piuttosto che provare da solo: il codice sul pass non deve mai cambiare, perché altrimenti si rompono tutti i pass già presenti in un telefono.

Funziona anche su uno smartwatch? I pass in Apple Wallet di norma compaiono anche su un Apple Watch abbinato. Non possiamo garantirlo per ogni dispositivo — all'ingresso non ci conti quindi e consideri il telefono la via normale.

Il pass resta dopo l'evento? Sì, finché il Suo visitatore non lo elimina. Un pass biglietto dopo la data scivola indietro nell'elenco; un abbonamento annuale resta in primo piano finché il suo periodo non è finito.