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.
Aggiornare il pass e gestire le notifiche sulla schermata di blocco
Su iPhone (Apple Wallet)
-
1
Apra l'app Wallet e tocchi il Suo pass.
-
2
Tocchi il pulsante
...(Altro / Dettagli biglietto) nell'angolo in alto a destra per ispezionare il retro del pass. -
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
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
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
Apra l'app Google Wallet e selezioni il Suo pass.
-
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 Endpoint | Metodo | Chiamante | Descrizione |
|---|---|---|---|
/v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumber | DELETE | Apple PassKit | Invocato automaticamente da iOS quando un titolare tocca Rimuovi biglietto in Apple Wallet (passTypeIdentifier = bundleId Apple). |
/api/v1/wallet/callback | POST | Google Wallet | Webhook invocato da Google Cloud (eventType: "del") quando un utente rimuove un pass su Android. |
/email/unsubscribe/:token | POST / GET | Client Email / Utente | POST elabora lo standard RFC 8058 List-Unsubscribe=One-Click; GET reindirizza in modo sicuro all'interfaccia delle preferenze senza modificare lo stato. |
/email/preferences/:token | GET | Browser del titolare | Apre 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)
{
"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 (
installedDevicesdiminuisce), 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.
