Guida

Google Wallet e Apple Wallet per attività: pass, pulsanti, notifiche e requisiti

Google Wallet e Apple Wallet sono i portafogli digitali già presenti sugli smartphone Android e sull'iPhone. Oltre alle carte di pagamento, conservano i pass delle attività: tessere fedeltà, coupon, carte regalo o biglietti. In questa guida vediamo quali tipi di pass esistono, come li aggiunge un cliente, come si aggiornano, cosa richiede ogni piattaforma per emetterli e quando conviene affidarsi a una piattaforma.

Cos'è un pass di Wallet

Un pass è una tessera digitale che vive nel portafoglio del telefono. Porta il logo dell'attività, alcuni dati del cliente (il nome, i timbri) e quasi sempre un QR da scansionare alla cassa.

Il cliente non installa niente. Lo dice Apple nella sua guida per iniziare con Wallet: si può aggiungere un pass senza installare l'app collegata, oppure un pass che non ha nessuna app alle spalle.

Tipi di pass su ogni piattaforma

Le due piattaforme classificano i pass in base all'uso:

UsoGoogle WalletApple Wallet
Fedeltà o puntiLoyalty CardsStore cards
CouponOffersCoupons
Carta regaloGift CardsStore cards
Altri casiGeneric PassGeneric passes

In Apple, le store card raggruppano tessere fedeltà, tessere sconto, tessere a punti e carte regalo (Apple Wallet per sviluppatori). Google consiglia il pass generico quando il tuo caso non rientra nei tipi previsti (panoramica di Google Wallet). Per una caffetteria o una panetteria, la scelta abituale è la tessera fedeltà, che funziona come una tessera a timbri digitale.

Come aggiunge un pass il cliente

Tutto parte da un link. Toccandolo, il telefono mostra il pass e un pulsante per salvarlo. Il link può arrivare così:

  • Un QR stampato sul bancone.
  • Il pulsante di Google Wallet o il badge di Apple Wallet sul tuo sito o in un'email.
  • Un SMS o un altro messaggio.

Per i pass fedeltà Apple elenca l'app, gli App Clip, gli SMS, le email, i tag NFC e i codici QR (pass fedeltà di Apple). Su Google, il link contiene un token firmato (JWT) e il salvataggio può partire solo da un account Google con accesso effettuato (emettere pass via web, email o SMS).

Come si aggiorna il pass dopo un acquisto

Il pass resta collegato al server dell'attività. Quando il cassiere aggiunge un timbro, il dato cambia sul server e il portafoglio riceve la versione nuova.

Su Apple, il telefono registra il pass sul tuo server con un identificativo e un token. Quando c'è una modifica, il tuo server invia una notifica vuota tramite il servizio di Apple (APNs) e il telefono chiede il pass aggiornato. In produzione serve HTTPS (servizio web per aggiornare i pass). Su Google, l'attività modifica il pass tramite l'API e la modifica compare nel portafoglio.

Esempio con dati ipotetici: Anna compra un caffè, il cassiere scansiona il suo codice e la sua tessera passa da 4 a 5 timbri. Quando riapre il portafoglio, vede i 5 timbri.

Le notifiche e i loro limiti

Nella sua pagina sulle notifiche push, Google fissa a ottobre 2026 un massimo di 3 messaggi che generano una notifica in 24 ore, e un altro massimo di 3 aggiornamenti che la generano nello stesso periodo. Solo alcuni campi fanno scattare un avviso quando cambiano, il cliente deve avere le notifiche attive e Google può ridurre la tua quota se ritiene che tu stia facendo spam.

Apple consente un messaggio di modifica per campo, del tipo «Hai già 6 timbri». Le sue linee guida di design per Wallet chiedono di usarlo solo quando la persona ha bisogno di saperlo e mai per il marketing. Avvisare che la tessera è completa ha senso; la promo del giorno invece resta fuori. Per farli tornare senza stancarli, guarda come far tornare i tuoi clienti.

Cosa ti serve per emettere pass in autonomia

Google Wallet

  1. Creare un account emittente dell'API di Google Wallet e, se non sviluppi per Android, un account Google Cloud (tessere fedeltà in Google Wallet).
  2. L'account nasce in modalità demo: emette pass solo agli utenti con ruolo di amministratore o sviluppatore, o ad account di prova, con l'etichetta «[TEST ONLY]».
  3. Per emettere pass a qualsiasi utente, completi il profilo dell'attività, crei almeno una classe di pass e chiedi l'accesso alla pubblicazione nella console Google Pay & Wallet. Il team di Google Wallet esamina la richiesta (accesso alla pubblicazione).

Apple Wallet

  1. Essere iscritto all'Apple Developer Program. A ottobre 2026, la pagina del programma indica «$99 annual membership».
  2. Firmare ogni pass con un certificato rilasciato da Apple. Se scade, i pass già installati continuano a funzionare, ma non puoi firmare pass nuovi né inviare aggiornamenti. Se viene revocato, smettono di funzionare correttamente (Apple, iniziare con Wallet).
  3. Mettere in piedi il server con HTTPS che registra i telefoni e invia gli aggiornamenti.

Per leggere il pass avvicinando l'iPhone a un lettore NFC servono un altro certificato e terminali certificati, secondo la pagina di Apple sui pass fedeltà. In un piccolo bancone, il cassiere può scansionare il QR con un cellulare.

Regole di marchio per i pulsanti

Google impone i suoi pulsanti ufficiali: esistono solo in nero, non se ne possono cambiare il carattere, il colore o il raggio degli angoli, devono essere alti almeno 48 dp e avere 8 dp di spazio libero intorno. Se non esiste una versione nella tua lingua, si usa quella in inglese.

Apple impone i suoi badge ufficiali: SVG per web ed email, EPS per gli stampati con QR, senza ruotarli né animarli. Il badge resta in secondo piano rispetto al tuo marchio, e in un'email conviene spiegare come aprirlo sull'iPhone, perché il cliente potrebbe leggerla dal computer.

Privacy

Su Apple, iCloud copia i pass su tutti i dispositivi dell'utente (Apple, iniziare con Wallet). Mostra sul pass solo quello che serve per servire il cliente: nome di battesimo e timbri bastano.

Nella registrazione, chiedi solo i dati che userai, spiega perché li conservi e verifica la legge sui dati personali del tuo paese.

Costruirlo da te o usare una piattaforma

Farlo in autonomia significa due integrazioni, la revisione di Google, l'iscrizione e i certificati di Apple, un server per gli aggiornamenti e una versione web per chi non usa Wallet. Ha senso se hai già un team di sviluppo e un'app tua.

Per un locale con uno o due banconi di solito conviene una piattaforma. Club Card, per esempio, fornisce la tessera a timbri su Google Wallet e Apple Wallet con il marchio dell'attività, e chi non usa Wallet la apre dal browser (prezzi). Se hai una caffetteria, la guida al programma fedeltà per caffetterie porta tutto questo nella pratica di ogni giorno.

Domande frequenti

Il cliente deve scaricare un'app per salvare un pass?

No. Apple indica che si può aggiungere un pass senza installare l'app dell'attività, e su Google si salva da un link con l'account Google aperto.

Quante notifiche posso inviare con Google Wallet?

A ottobre 2026, fino a 3 messaggi e 3 aggiornamenti che generano una notifica in 24 ore. Se superi il limite, l'API risponde con un errore di quota.

Google Wallet funziona nel mio paese?

L'elenco dei paesi di Google comprende, a ottobre 2026, Argentina, Messico, Cile, Colombia, Perù e Uruguay, tra gli altri. Alcuni pass sono disponibili solo in certi paesi o su certi dispositivi, quindi prova il tuo prima di stampare il QR.

Fonti

Vuoi il club per la tua attività?

Tessera a timbri su Google e Apple Wallet con il tuo marchio, pannello e CRM a USD 30 al mese.