Torna al blogGenerale

Tessera fedeltà nel Wallet: 20 domande

Una tessera fedeltà nel Wallet è un file che il cliente tiene in Apple Wallet o Google Wallet senza installare app, aggiornato dal server di chi la emette: con Fideliya la emetti anche dal piano Gratis, per 20 clienti. Apple chiama questo stile storeCard; Google lo costruisce con una classe e un oggetto.

Come funziona davvero una tessera fedeltà in Apple Wallet e Google Wallet: venti risposte prese dalla documentazione per sviluppatori di Apple e Google.

Di Zakaria Fahim · 22 ottobre 2026 · 10 min di lettura

Ogni domanda qui sotto ha una risposta pubblicata da Apple o da Google, così sai esattamente come si comporta una tessera fedeltà nel Wallet prima di metterla nel telefono dei tuoi clienti. Con Fideliya quella tessera la emetti anche dal piano Gratis, per 20 clienti. Le venti risposte vengono dalla guida di Apple per gli sviluppatori del Wallet e dalla documentazione di Google Wallet, lette il 5 settembre 2026, con la pagina precisa di ciascuna indicata nella nota delle fonti di questo articolo.

Alcune risposte parlano di Fideliya e non delle piattaforme, e lo dicono. Tutto il resto è quello che la piattaforma dichiara di sé.

DomandaApple WalletGoogle Wallet
Stile per la fedeltàstoreCardClasse fedeltà più oggetto fedeltà
Come la aggiunge il clienteMail o Safari, application/vnd.apple.pkpassUn link con un JWT firmato
Come si aggiornaIl tuo servizio web più una push su HTTPSAggiornamento della classe o dell’oggetto tramite API
Limite ai messaggiNon indicato come numero3 messaggi con notifica push in 24 ore
Promessa di consegnaLe push non sono garantiteL’utente deve avere le notifiche attive
App di accompagnamentoLe tessere non dovrebbero richiederne unaI link funzionano sul web, nelle email e negli SMS
La tua tessera fedeltà, sul loro telefono.

Cos’è una tessera fedeltà nel Wallet?

Apple descrive i contenuti del Wallet come la versione digitale di informazioni che altrimenti starebbero su piccoli pezzi di carta o di plastica, e scrive che possono contenere immagini e un codice a barre ed essere aggiornati con notifiche push. La tecnologia ha tre parti: un formato di pacchetto, un’API di servizio web per gli aggiornamenti e un’API con cui le app leggono il Wallet.

Quale stile di Apple corrisponde a una tessera fedeltà?

La storeCard. Apple scrive che la chiave storeCard è adatta a tessere fedeltà, tessere sconto, tessere a punti e carte regalo. Gli altri quattro stili sono carte d’imbarco, coupon, biglietti per eventi e documenti generici, e Apple cita come esempi generici le tessere della palestra e gli abbonamenti della metro con un credito.

Il cliente ha bisogno di un’app?

No. Apple scrive che non serve avere installata la tua app per aggiungere le tue tessere al Wallet, e aggiunge che le tessere non dovrebbero richiedere un’app di accompagnamento. È la posizione della piattaforma, non uno slogan di un fornitore, ed è il motivo per cui ci si iscrive a una tessera nel Wallet in cassa senza scaricare niente.

Come aggiunge la tessera un cliente con iPhone?

Da Mail o da Safari. Apple scrive che entrambi supportano le tessere da iOS 6 e macOS v10.8.2, che su iOS le aggiungono direttamente al Wallet e che su macOS usano iCloud per aggiungerle ai dispositivi iOS dell’utente. Tutti e due si aspettano il tipo MIME application/vnd.apple.pkpass.

Come aggiunge la tessera un cliente con Android?

Con un link Aggiungi a Google Wallet. Google scrive che il link è un URL generato al momento che contiene un JSON Web Token codificato e firmato, nella forma pay.google.com/gp/v/save seguita dal token, e che funziona ovunque funzioni un collegamento: siti web, email e SMS.

Un JWT firmato che descrive la tessera. Google scrive che la lunghezza sicura di un JWT codificato è di 1.800 caratteri, consiglia di presentare il link come pulsante Aggiungi a Google Wallet dove si possono usare immagini con collegamento, e precisa che il salvataggio può partire solo da un utente collegato con il suo account Google.

Il cliente deve approvare la tessera?

Sì. Apple scrive che aggiungere tessere al Wallet richiede un permesso esplicito e che l’utente deve sempre vedere e approvare la tessera prima che venga aggiunta. Su nessuna delle due piattaforme esiste un’installazione silenziosa: una tessera non può arrivare su un telefono che non l’ha chiesta.

Come si aggiorna una tessera dopo l’emissione?

Apple descrive un servizio web sul server di chi emette la tessera, raggiunto su HTTPS, a cui i dispositivi si registrano dopo l’installazione. Quando la tessera cambia, il server manda una notifica push ai dispositivi registrati, e il dispositivo scarica la nuova versione e la confronta con quella che aveva.

Le notifiche del Wallet arrivano sempre?

No, ed è la frase più utile di tutti e due i documenti. Apple scrive che le notifiche push non sono garantite e che più notifiche dalla stessa fonte vengono unite in una sola. Google scrive che gli utenti devono avere le notifiche attive perché le loro tessere le ricevano.

Quanti messaggi può inviare una tessera Google Wallet?

Google indica un massimo di 3 messaggi che fanno partire una notifica push in 24 ore, e descrive TEXT_AND_NOTIFY come il tipo di messaggio che aggiunge un testo ai dettagli della tessera e fa partire la notifica. Le notifiche di aggiornamento su campi specifici hanno lo stesso tetto.

Cos’è un messaggio di modifica su una tessera Apple?

Un testo legato a un campo, mostrato quando il valore di quel campo cambia. Apple scrive che, se il valore è cambiato e il campo ha un messaggio di modifica, il dispositivo lo mostra, e avverte che questi messaggi interrompono l’utente e di solito vanno bene solo per informazioni urgenti.

Cosa non può mai cambiare su una tessera?

Due cose. Apple scrive che ogni campo di una tessera si può aggiornare tranne il token di autenticazione (authenticationToken) e il numero di serie (serialNumber), e sconsiglia in modo esplicito di cambiare il token in un aggiornamento, perché gli aggiornamenti non sono garantiti e alcuni dispositivi potrebbero avere ancora quello vecchio.

Cosa identifica una tessera in modo univoco?

Apple scrive che la combinazione di identificativo del tipo (passTypeIdentifier) e numero di serie identifica una tessera in modo univoco in tutto PassKit, e che due tessere dello stesso tipo con lo stesso numero di serie sono la stessa tessera anche se altre informazioni sono diverse. Per PassKit il numero di serie è opaco.

Quali codici a barre può usare una tessera Apple?

Apple indica PKBarcodeFormatQR, PKBarcodeFormatPDF417, PKBarcodeFormatAztec e PKBarcodeFormatCode128 come validi da iOS 9 in poi, quindi nessuno ha bisogno di un’alternativa. Nota anche che watchOS non supporta Code128, e che una tessera con il solo Code128 lì non mostra nessun codice.

Quanti campi entrano sul fronte?

Apple scrive che una tessera può avere in genere fino a tre campi di intestazione, un solo campo principale, fino a quattro campi secondari e fino a quattro ausiliari. Coupon, storeCard e documenti generici con un codice a barre quadrato ne portano fino a quattro tra secondari e ausiliari insieme. Il retro può avere tutti i campi che servono.

Quali immagini usa una storeCard?

Apple indica logo, icona e striscia per lo stile storeCard. Il logo sta in alto a sinistra accanto al testo del logo, con 160 per 50 punti a disposizione, e Apple nota che di solito dovrebbe essere più stretto. L’icona, mostrata sulla schermata di blocco e in Mail, misura 29 per 29 punti.

Una tessera può mostrarsi in più di una lingua?

Sì. Apple scrive che una tessera si localizza in tre modi: numeri e date nel formato locale, testi tradotti e immagini tradotte. Ogni lingua ha la sua cartella .lproj, e le immagini che non vanno tradotte stanno al livello principale della tessera.

Una tessera fedeltà può comparire vicino al locale?

Entro i limiti che Apple pubblica. Una tessera può avere fino a dieci luoghi pertinenti, ognuno con longitudine, latitudine e altitudine facoltativa, e fino a dieci UUID di beacon diversi. Apple scrive anche che una storeCard non supporta una data pertinente, quindi una tessera fedeltà non può farsi notare per orario come un biglietto per un evento.

Google pubblica il lato Android: fino a dieci sedi per tessera, una notifica per chi ha attivato le notifiche e la posizione precisa sempre attiva per Google Wallet, e una distanza decisa da Google. Fideliya compila entrambi dall’indirizzo che fissi per il tuo locale; quando mostrare la tessera lo decide il telefono, e il cliente può disattivarlo. Come funziona su ogni telefono è su la tessera sulla schermata di blocco.

Cosa sono la classe e l’oggetto di Google Wallet?

Google scrive che le tessere date agli utenti si creano combinando una classe e un oggetto. La classe è il modello che condividono tutti quelli che hanno quella tessera; l’oggetto è la tessera di una singola persona. Google offre un’API REST e un SDK Android per emetterle e gestirle.

Cosa serve a un’attività prima di emettere tessere?

Cinque cose, quattro per Apple e una per Google.

  1. Un identificativo del tipo di tessera che corrisponde al certificato di firma.
  2. Un identificativo del team che corrisponde al Team ID di quel certificato.
  3. Una firma PKCS #7 che includa il certificato intermedio WWDR.
  4. Un servizio web HTTPS, che Apple richiede per ogni comunicazione con la tessera.
  5. Un account emittente Google Wallet, e un JWT firmato per ogni link di salvataggio.

Fonti

Fideliya tiene tutte e cinque queste cose al posto tuo, ed è questa la differenza pratica tra emettere tessere in proprio e scegliere una piattaforma che le emette: tu porti un logo, un traguardo e un premio. Il confronto con la strada dell’app è su programma fedeltà senza app, il numero di timbri giusto su quanti timbri sulla tessera fedeltà, e cosa compare sulla schermata di blocco su notifiche e schermata di blocco.

Ogni risposta qui sopra viene da una di sette pagine originali, lette il 5 settembre 2026: i quattro capitoli della guida di Apple per gli sviluppatori del Wallet (la presentazione del Wallet, la progettazione delle tessere, la loro distribuzione e il loro aggiornamento) e, di Google, la panoramica sulle tessere fedeltà, la guida al pulsante Aggiungi a Google Wallet sul web e la guida Trigger Push Notifications. La nota delle fonti di questo articolo collega ogni domanda alla sua pagina. Su questa pagina non ci sono statistiche, prezzi o percentuali, e niente è dedotto dal materiale pubblicitario di un fornitore.

Il lato Apple è su tessera fedeltà Apple Wallet, quello Android su tessera fedeltà Google Wallet, e i piani sulla pagina dei prezzi. Il modo più rapido per vedere tutto questo sul tuo telefono è provarlo: attiva i 14 giorni di Pro, senza carta di credito, crea la tessera, stampa il codice QR per la cassa e aggiungila al tuo Wallet per prima.

Domande frequenti

Cos’è una tessera fedeltà nel Wallet?

Apple descrive i contenuti del Wallet come la versione digitale di informazioni che altrimenti starebbero su carta o plastica, con immagini e un codice a barre, aggiornabili con una notifica push. Una tessera Fideliya è esattamente questo: il cliente la tiene in Apple Wallet o Google Wallet e il locale la aggiorna dal proprio server.

Quale stile di Apple corrisponde a una tessera fedeltà?

La storeCard. Apple scrive che lo stile storeCard è adatto a tessere fedeltà, tessere sconto, tessere a punti e carte regalo. Fideliya emette la sua tessera come storeCard, ed è per questo che nel Wallet ha lo stile di una tessera di negozio e non quello di un biglietto.

Il cliente ha bisogno di un’app per usare una tessera nel Wallet?

No. Apple scrive che non serve avere installata la tua app per aggiungere tessere al Wallet, e che le tessere non dovrebbero richiedere un’app di accompagnamento. Fideliya è costruita su questo: il cliente aggiunge la tessera al Wallet che ha già sul telefono e non installa niente.

Come aggiunge la tessera un cliente con iPhone?

Da Mail o da Safari, che secondo Apple aggiungono le tessere al Wallet direttamente su iOS e si aspettano il tipo MIME application/vnd.apple.pkpass. Fideliya serve la sua tessera Apple con quel tipo MIME dalla pagina di iscrizione, quindi si apre e si aggiunge senza passaggi intermedi.

Come aggiunge la tessera un cliente con Android?

Con un link Aggiungi a Google Wallet, che Google descrive come un URL generato al momento che contiene un JSON Web Token codificato e firmato. Fideliya costruisce quel link su pay.google.com/gp/v/save per ogni cliente, così la stessa pagina di iscrizione funziona su Android e su iPhone.

Cos’è il link Aggiungi a Google Wallet?

Un JWT firmato dentro un URL. Google scrive che la lunghezza sicura di un JWT codificato è di 1.800 caratteri e che il salvataggio può partire solo da un utente collegato con il suo account Google. Fideliya firma quel token sul server, quindi il cliente tocca soltanto un pulsante.

Il cliente deve approvare l’aggiunta della tessera?

Sì. Apple richiede un permesso esplicito: l’utente deve sempre vedere e approvare la tessera prima che entri nel Wallet. Una tessera Fideliya quindi non può comparire in un Wallet senza che il cliente l’abbia guardata e abbia scelto di tenerla.

Come si aggiorna una tessera nel Wallet dopo l’emissione?

Apple descrive un servizio web sul tuo server più una notifica push inviata, su HTTPS, ai dispositivi registrati per quella tessera. Fideliya gestisce quel servizio, quindi una scansione in cassa aggiorna i timbri sulla tessera che il cliente ha in tasca senza che nessuno riapra niente.

Le notifiche del Wallet arrivano sempre?

No, e lo dicono tutte e due le piattaforme. Apple scrive che le notifiche push non sono garantite e che più notifiche dalla stessa fonte vengono unite in una. Google chiede che l’utente abbia le notifiche attive. Fideliya ti dice esattamente cosa è successo: Apple e Google hanno accettato il broadcast.

Quanti messaggi può inviare una tessera Google Wallet?

Google indica un massimo di 3 messaggi che fanno partire una notifica push in 24 ore. Fideliya resta ben dentro quel limite: il piano include un broadcast al mese con Gratis, tre con Pro e dieci con Enterprise, contati al mese e non al giorno.

Cos’è un messaggio di modifica su una tessera Apple?

Apple scrive che, se il valore di un campo cambia e il campo ha un messaggio di modifica, il dispositivo lo mostra, e avverte che questi messaggi interrompono l’utente e vanno usati di solito solo per informazioni urgenti. Fideliya segue questa misura e non attacca un messaggio a ogni campo.

Il numero di serie o il token di una tessera possono cambiare?

No. Apple scrive che ogni campo di una tessera si può aggiornare tranne il token di autenticazione e il numero di serie, e sconsiglia di cambiare il token perché alcuni dispositivi potrebbero avere ancora quello vecchio. Fideliya li tiene fissi per tutta la vita della tessera di un cliente.

Cosa identifica una tessera nel Wallet in modo univoco?

Apple scrive che la combinazione di identificativo del tipo e numero di serie identifica una tessera in modo univoco, e che due tessere dello stesso tipo con lo stesso numero di serie sono la stessa tessera. Fideliya assegna un numero di serie per ogni cliente iscritto, ed è così che una scansione trova la tessera giusta.

Quali codici a barre può usare una tessera Apple Wallet?

Apple indica QR, PDF417, Aztec e Code128 come validi da iOS 9 in poi, e nota che watchOS non supporta Code128. Fideliya usa PKBarcodeFormatQR, il formato letto dal maggior numero di lettori e quello che legge il suo Scanner nel browser.

Quanti campi entrano sul fronte di una tessera fedeltà?

Apple scrive che una tessera può avere in genere fino a tre campi di intestazione, un campo principale, fino a quattro secondari e fino a quattro ausiliari, e che le storeCard con codice a barre quadrato ne portano fino a quattro tra secondari e ausiliari insieme. Fideliya disegna la sua tessera dentro questi limiti.

Quali immagini usa una storeCard?

Apple indica logo, icona e striscia per lo stile storeCard, con 160 per 50 punti riservati al logo e 29 per 29 all’icona. Fideliya mette il logo e la copertina del locale proprio in quegli spazi, ed è per questo che un logo largo viene ritagliato e non rimpicciolito.

Una tessera può mostrarsi in più di una lingua?

Sì. Apple descrive la localizzazione con numeri e date nel formato locale, testi tradotti e immagini tradotte, ogni lingua nella sua cartella .lproj. Fideliya segue un’altra strada: scegli per la tua tessera una lingua tra italiano, inglese, francese, spagnolo e arabo, con l’arabo da destra a sinistra, e ogni etichetta è scritta in quella lingua.

Una tessera fedeltà può comparire sulla schermata di blocco vicino al locale?

Apple scrive che una tessera può avere fino a dieci luoghi pertinenti e che una storeCard non supporta una data pertinente. Google, per Android, prevede fino a dieci sedi per tessera e una notifica, a una distanza decisa da Google, per chi ha attivato notifiche e posizione precisa. Fideliya compila entrambi dall’indirizzo che fissi; quando mostrarla lo decide il telefono.

Che differenza c’è tra classe e oggetto in Google Wallet?

Google scrive che le tessere si creano combinando una classe e un oggetto: la classe è il modello condiviso da tutti i clienti, l’oggetto è la tessera di un singolo cliente. Fideliya crea una classe fedeltà per ogni tessera di un’attività e un oggetto fedeltà per ogni cliente iscritto.

Cosa serve a un’attività prima di poter emettere tessere?

Apple chiede un identificativo del tipo di tessera legato al certificato di firma, un identificativo del team, una firma PKCS #7 con il certificato intermedio WWDR e un servizio web HTTPS. Google chiede un account emittente e un JWT firmato. Fideliya tiene tutto questo al posto tuo: tu porti un logo e un premio, non dei certificati.

La tua tessera fedeltà, pronta in cinque minuti

Nessuna carta di credito. Se i tuoi clienti abituali non si iscrivono, non paghi niente.

Prova gratis per 14 giorni

See a pass in your wallet in ten seconds

Confronta Fideliya con le alternativeCalcola il ritorno
Add to Apple WalletAdd to Google Wallet
© 2026 Fideliya. All rights reserved.
Tessera fedeltà nel Wallet: 20 domande — Fideliya Blog