# Aggiungere una tessera fedeltà al portafoglio del telefono

> Quasi nessun negozio ha creato una carta per il portafoglio, quindi il pulsante non esiste. Cosa funziona su iPhone e Android, e cosa vuole la cassa.

Source: https://apps.swtlm.com/it/blog/add-a-loyalty-card-to-your-phone-wallet · TLM Apps — focused mobile apps from a team of engineers.
Published: 2026-08-06 · Updated: 2026-08-06 · TLM Software Design

Di solito il pulsante «Aggiungi al portafoglio» non c'è, perché una carta del
portafoglio deve essere creata e firmata da chi ha emesso la tessera, e quasi
nessun bar, palestra o supermercato l'ha mai fatta. Quello che funziona è
trasformare la tessera in una carta per conto tuo: su iPhone una carta firmata
che finisce in Apple Wallet, su Android un'app che conserva il codice a barre e
lo mostra a tutto schermo. Il dettaglio che decide se la cassa lo legge è il
*formato* del codice, non il numero.

## Perché il pulsante non c'è

Apple Wallet non conserva fotografie di tessere: conserva file `.pkpass`,
piccoli pacchetti firmati che contengono il contenuto del codice a barre, il suo
formato, i campi da mostrare e un certificato che prova chi li ha fatti. La
firma è tutto il punto: è quello che impedisce a chiunque di generarsi una carta
d'imbarco.

La conseguenza è immediata. Se la catena sotto casa non si è mai registrata come
emittente di carte, non c'è nessuna carta da aggiungere, e nessuna impostazione
di Apple Wallet cambierà la cosa. Google Wallet funziona allo stesso modo per i
programmi fedeltà dei partner.

La domanda pratica quindi non è «come aggiungo questa tessera» ma «chi me la
trasforma in una carta».

## Che cosa serve davvero a un lettore

È la parte che manca in quasi tutte le guide, ed è quella che decide se resterai
in cassa a riaprire un'app.

**Il formato giusto.** Un codice a barre non è un numero: è un numero codificato
in una simbologia precisa. I codici a strisce lunghi delle tessere fedeltà sono
di solito Code 128 o Code 39, i codici dei prodotti sono EAN-13, quelli quadrati
sono QR o Aztec. Le stesse cifre nella simbologia sbagliata producono un codice
che sembra plausibile e non si legge come niente.

**Dimensione e contrasto sufficienti.** Una carta mostra il codice da solo,
grande, nero su bianco. La foto della tessera intera mostra un codice a barre di
due centimetri con un logo accanto, alla luminosità che il telefono aveva in
quel momento.

**Uno schermo che il lettore sappia leggere.** I lettori a fotocamera — il vetro
piatto delle casse dei supermercati — leggono benissimo gli schermi. I lettori
laser a pistola non leggono uno schermo a nessuna luminosità, perché lavorano
sulla luce laser riflessa. Quando alla cassa ti dicono «con i telefoni non
funziona», di solito il motivo è questo, e non è qualcosa che un'app possa
risolvere.

Entrambi i portafogli alzano da soli la luminosità dello schermo quando apri una
carta. Un'app che si limita a mostrare un'immagine può non farlo. Se un codice
non passa, la luminosità al massimo è la prima cosa da provare, e funziona più
spesso di quanto dovrebbe.

## Su iPhone

1. **Controlla se il negozio pubblica già una carta.** Se esiste, il pulsante
   «Aggiungi a Apple Wallet» sta nella loro app o in fondo a una ricevuta via
   e-mail. È sempre l'opzione migliore: una carta vera aggiorna il saldo da sé.
2. **Altrimenti generane una.** Un'app che legge la tessera e produce un
   `.pkpass` firmato mette la carta in Wallet come si deve: sulla schermata di
   blocco, nell'elenco del doppio clic, in ordine con tutto il resto.
3. **La prima volta confronta il codice con la tessera**, prima di farci
   affidamento. Metti a confronto le cifre stampate sotto il codice originale
   con quelle sotto il codice generato.

## Su Android

Google Wallet accetta le tessere fedeltà dei programmi partner, e sono molte
meno delle tessere fedeltà che esistono. Per tutto il resto, quello che funziona
in cassa è un'app che conserva il codice e lo mostra a tutto schermo con la
luminosità alzata.

È meno elegante di un portafoglio di sistema, ed è funzionalmente identico nel
momento della scansione. Quello che perdi è l'accesso dalla schermata di blocco
e la comparsa automatica; quello che ti resta è un codice che si legge.

## Che cosa una carta generata non farà

Vale la pena saperlo prima di sostituire una pila di plastica con uno schermo.

**Non aggiornerà il proprio saldo.** A una carta vera, emessa dal negozio, si
può spingere un nuovo totale di punti, una nuova scadenza, una nuova offerta.
Una carta generata da una foto è un'istantanea del codice a barre: il codice
continua a funzionare, perché il codice non è altro che il tuo numero di conto,
ma i punti stampati sopra restano fermi al momento in cui l'hai creata. Per una
tessera fedeltà di solito non è un problema, perché la cassa recupera il saldo
dal numero. Per qualsiasi cosa il cui valore cambia, invece lo è.

**Non sopravvivrà a una riemissione della tessera.** Tessera nuova, numero
nuovo, carta nuova.

**Non è una carta di pagamento.** Nessuno dei due portafogli ti lascerà
generarne una, e niente che richieda il chip o la banda magnetica si riproduce
dalla fotografia del fronte. Quel confine è deliberato su entrambe le
piattaforme, ed è lo stesso istinto che sta dietro tutto quello che trovi nella
[pagina Strumenti](https://apps.swtlm.com/it/tools): fare bene una cosa sola invece di fare male quella
accanto.

**Non sarà benvenuta ovunque.** Certi programmi fedeltà scrivono nelle proprie
condizioni che la tessera è loro e non si può copiare. In pratica nessuno si
scandalizza per un codice a barre su uno schermo, ma un abbonamento a un museo o
un titolo di viaggio nominativo sono un'altra faccenda rispetto alla tessera dei
caffè.

## Come inserire il numero senza digitarlo

Digitare sedici cifre da una tessera consumata è il punto in cui la cosa va
storta. La strada veloce è una foto: punti la fotocamera sulla tessera e lasci
che sia l'app a leggere sia le cifre sia la simbologia dal codice a barre
stampato.

[AI Wallet Pass](https://apps.swtlm.com/ai-wallet-pass) è quello che abbiamo costruito per questo
passaggio. Fotografi la tessera, l'app ne estrae il numero e il formato del
codice a barre e produce una carta firmata per Apple Wallet su iOS, oppure la
conserva nel proprio portafoglio su Android.

Un dettaglio va detto per esteso, perché è esattamente la cosa da verificare in
qualsiasi app di questo tipo: leggere la tessera richiede un server, dato che il
modello di estrazione non gira sul telefono. **Il contenuto del codice a barre,
invece, resta sul dispositivo** — il servizio di estrazione riceve soltanto una
foto con il codice oscurato, e il numero non gli arriva mai. L'unica eccezione,
stretta, è la chiamata di firma, che ha bisogno del numero per il tempo
necessario ad assemblare la carta firmata e non lo scrive da nessuna parte. È un
vincolo imposto dalla forma dell'interfaccia, non una promessa dentro
un'informativa sulla privacy, ed è proprio questa la differenza su cui conviene
fare domande.

Tre tessere al mese sono gratis, non c'è nessun abbonamento, e la scheda nella
[pagina Strumenti](https://apps.swtlm.com/it/tools) lo dice prima che tu installi qualsiasi cosa.

La scansione è l'unica cosa che l'app non sa fare offline, e la sua scheda lo
dice: l'estrazione semantica è una chiamata a un server. La decodifica del
codice a barre avviene invece sul dispositivo, ed è per questo che il numero non
ha bisogno di viaggiare; su quanto liberamente venga usata la parola «offline»
sulle schede in generale, vedi
[giochi offline per bambini](https://apps.swtlm.com/it/blog/offline-games-for-kids).
Il resto degli strumenti che facciamo è nella [pagina Strumenti](https://apps.swtlm.com/it/tools); e se
stai valutando come si paga un'app prima di installarla,
[quanto costa davvero l'abbonamento a un rompicapo](https://apps.swtlm.com/it/blog/what-a-puzzle-game-subscription-costs)
illustra i tre modelli e come distinguerli su una scheda.

## Frequently asked questions

**Perché non posso aggiungere la mia tessera fedeltà direttamente ad Apple Wallet?**

Perché una carta del portafoglio deve essere creata e firmata crittograficamente da chi la emette, e quasi nessun negozio ne ha mai fatta una. Apple Wallet non ha alcun modo di accettare una carta che nessun emittente ha mai pubblicato.

**Alla cassa funziona una foto della tessera?**

A volte, e in modo inaffidabile. I lettori laser a pistola non leggono uno schermo per niente; quelli a fotocamera di solito ci riescono, se il codice è grande, nitido e alla massima luminosità. La foto della tessera intera raramente è una di queste tre cose.

**Android ha un equivalente di Apple Wallet?**

Google Wallet accetta le tessere fedeltà, ma solo dai programmi partner che le pubblicano. Per tutto il resto, quello che funziona davvero in cassa è un'app che conserva il codice a barre e lo mostra a tutto schermo.

**Di quale formato di codice a barre ho bisogno?**

Quello stampato sulla tessera. I più comuni sono Code 128 e Code 39 per i codici a strisce lunghi, EAN-13 per quelli in stile prodotto da supermercato, e QR o Aztec per i codici quadrati. Un numero inserito nel formato sbagliato non si legge.

**Il numero della tessera viene mandato da qualche parte?**

Dipende dall'app, ed è l'unica cosa che vale la pena verificare. Leggere la tessera può richiedere un server; conservarla e mostrarla no. Il contenuto del codice a barre, una volta che esiste, non dovrebbe mai avere bisogno di lasciare il dispositivo.