Skip to content
Guida del Centro assistenza · Aiuto per i titolari di pass
3 min di letturaVerificato 2026-11-16

Aggiornare o rimuovere un pass

Abilita gli aggiornamenti automatici, aggiorna manualmente il saldo, silenzia notifiche o rimuovi il pass.

In questa guida

Come funzionano gli aggiornamenti automatici dei pass e la telemetria di rimozione

Una volta aggiunto un pass ad Apple Wallet o Google Wallet, questo rimane connesso a Passinstance in modo che il saldo punti, il conteggio dei timbri, gli avanzamenti di livello e le modifiche ai gate degli eventi si aggiornino automaticamente senza necessità di scaricare una nuova carta. Quando rimuove un pass dallo smartphone, l'app del wallet informa il backend di interrompere l'invio degli aggiornamenti.

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
PROTOCOLLO DI AGGIORNAMENTO E RIMOZIONE DAL WALLET
FASE 01 AGGIORNAMENTO DEL PASS ATTIVO
iOS: Push silenzioso APNs {}l'iPhone chiama GET/v1/passes/:bundleId/:serial
Android: Passinstance aggiorna walletobjects tramite API REST Google Wallet
FASE 02 IL TITOLARE RIMUOVE IL PASS DAL DISPOSITIVO
Apple Wallet invia: DELETE/v1/devices/:deviceId/registrations/:type/:serial
Google Wallet invia: POST/api/v1/wallet/callback (eventType: "del")
Il pass passa a Removed from Wallets (inactiveDeviceRegistrations)
FASE 03 PREFERENZE EMAIL E MARKETING (Email Preferences API)
Disiscrizione One-Click RFC 8058: POST/email/unsubscribe/:token
Redirect preferenze nel browser: GET/email/unsubscribe/:token
Portale preferenze self-service: /email/preferences/:token

Aggiornare il pass e gestire le notifiche sulla schermata di blocco

Su iPhone (Apple Wallet)

  1. 1
    Apra l'app Wallet e tocchi il Suo pass.
  2. 2
    Tocchi il pulsante ... (Altro / Dettagli biglietto) nell'angolo in alto a destra per ispezionare il retro del pass.
  3. 3
    Verifichi gli Aggiornamenti automatici: si assicuri che l'opzione Aggiornamenti automatici sia ATTIVA, in modo che la carta si aggiorni in background ogni volta che accumula punti o timbri.
  4. 4
    Aggiornamento manuale (Pull-to-Refresh): se il telefono era in modalità Uso in aereo o aveva scarso segnale alla cassa, scorra delicatamente verso il basso nella schermata Dettagli biglietto per forzare un aggiornamento immediato da GET /v1/passes/:passTypeIdentifier/:serialNumber.
  5. 5
    Silenziare i banner sulla schermata di blocco: se desidera conservare il pass in Apple Wallet ma disattivare le notifiche sulla schermata di blocco, disattivi l'opzione Consenti notifiche nella schermata dei dettagli del pass.

Su Android (Google Wallet)

  1. 1
    Apra l'app Google Wallet e selezioni il Suo pass.
  2. 2
    Tocchi il menu ⋮ (tre puntini) nell'angolo in alto a destra per visualizzare i dettagli del pass e attivare o disattivare Mostra notifiche per questo pass.

Rimuovere un pass e gestire le preferenze di comunicazione

Quando elimina un pass dal wallet o annulla l'iscrizione alle email delle campagne, Passinstance elabora la modifica di stato attraverso i seguenti endpoint:

Percorso EndpointMetodoChiamanteDescrizione
/v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumberDELETEApple PassKitInvocato automaticamente da iOS quando un titolare tocca Rimuovi biglietto in Apple Wallet (passTypeIdentifier = bundleId Apple).
/api/v1/wallet/callbackPOSTGoogle WalletWebhook invocato da Google Cloud (eventType: "del") quando un utente rimuove un pass su Android.
/email/unsubscribe/:tokenPOST / GETClient Email / UtentePOST elabora lo standard RFC 8058 List-Unsubscribe=One-Click; GET reindirizza in modo sicuro all'interfaccia delle preferenze senza modificare lo stato.
/email/preferences/:tokenGETBrowser del titolareApre il centro preferenze di comunicazione self-service per il controllo granulare del consenso email (alias /preferences/:token).

Come rimuovere una carta dallo smartphone

  • Apple Wallet: apra il pass → tocchi ... (in alto a destra) → tocchi Rimuovi biglietto → confermi Rimuovi.
  • Google Wallet: apra il pass → tocchi ⋮ (in alto a destra) → tocchi Rimuovi → confermi Rimuovi.

Esempio: callback di rimozione di Google Wallet (POST /api/v1/wallet/callback)

JSON
{
  "signature": "MEYCIQDa9...",
  "intermediateSigningKey": { "signedKey": "..." },
  "protocolVersion": "ECv2SigningOnly",
  "signedMessage": "{\"ISSUER_ID\":\"3388000000012345678\",\"OBJECT_ID\":\"3388000000012345678.pass_99102\",\"EVENT_TYPE\":\"del\",\"NONCE\":\"7b8a9c10\"}"
}

Importante: La rimozione di un pass da Apple Wallet o Google Wallet elimina la carta dallo smartphone e interrompe le notifiche push sulla schermata di blocco (installedDevices diminuisce), ma non cancella il Suo account associativo sottostante presso l'esercente. Per esercitare i diritti di cancellazione previsti dal GDPR, contatti l'azienda emittente o consulti Privacy dei dati e GDPR.

Ha bisogno di ripristinare una carta eliminata per errore? Segua i passaggi indicati in Trovare o recuperare il proprio pass.

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.