Come funziona l'installazione intelligente del pass
Aggiungere una carta fedeltà, un biglietto per eventi, una tessera associativa o un coupon al proprio smartphone richiede meno di 10 secondi e non necessita del download di alcuna app di terze parti. Quando apre un link intelligente di Passinstance, il backend rileva il sistema operativo del dispositivo e La indirizza a un pacchetto .pkpass di Apple Wallet (firmato con il Pass Type ID bundleId dell'esercente) oppure a un JWT di salvataggio Google Wallet firmato con RS256.
Endpoint di distribuzione intelligente
Passinstance eroga i flussi di installazione per i titolari del pass attraverso tre pattern di route pubbliche gestiti da Download Page API e Public Download Page:
| Pattern di route | Metodo | Scopo |
|---|---|---|
/d/:slug | GET | Link breve personalizzato per SMS, locandine QR e campagne email. Esegue il rilevamento automatico del sistema operativo e il passaggio al wallet. |
/download/:slug | GET | Pagina PassFlow di download esplicita che mostra l'anteprima del pass, il tema del brand e i pulsanti Aggiungi al Wallet specifici per piattaforma. |
/s/:token | GET | Link con token di accesso firmato crittograficamente per singolo titolare, con scadenza opzionale (downloadUntil) e verifiche tramite PIN. |
Guida passo passo per i titolari del pass
1. Su iPhone e Apple Watch (Apple Wallet)
-
1
Tocchi il link personale del pass in modo che si apra in Safari (se ha toccato il link all'interno di Instagram, TikTok o LinkedIn, tocchi l'icona del browser nell'angolo in basso a destra per aprirlo nella versione nativa di Safari).
-
2
Tocchi Aggiungi a Apple Wallet: iOS riconosce immediatamente il pacchetto
application/vnd.apple.pkpasse apre la schermata nativa di anteprima del pass. -
3
Tocchi Aggiungi nell'angolo in alto a destra della schermata di anteprima.
-
4
Sincronizzazione con Apple Watch: se indossa un Apple Watch abbinato, iOS sincronizza automaticamente i pass idonei nell'app Wallet al polso.
-
5
Accesso rapido: faccia doppio clic sul tasto laterale dell'iPhone in qualsiasi momento per richiamare il pass salvato alla cassa o all'ingresso dell'evento.
2. Su Android (Google Wallet)
-
1
Apra il link del pass in Google Chrome o nel browser Android predefinito.
-
2
Tocchi Aggiungi a Google Wallet: si aprirà la schermata di salvataggio autenticata di Google (
https://pay.google.com/gp/v/save/<jwt>). -
3
Verifichi che l'Account Google mostrato nella parte superiore della finestra corrisponda all'account con cui ha effettuato l'accesso nell'app Google Wallet dello smartphone, quindi tocchi Aggiungi a Wallet.
-
4
Tocchi Visualizza nel Wallet per mostrare immediatamente il codice a barre o il pass NFC contactless.
3. Apertura del link di un pass su computer portatile o desktop
I computer desktop non eseguono nativamente Apple Wallet o Google Wallet. Quando apre un link /d/:slug o /s/:token su macOS o Windows:
{
"detectedPlatform": "DESKTOP",
"handoffMode": "QR_CODE_LANDING_PAGE",
"qrTargetUrl": "https://wallet.yourbrand.com/s/eyJhbGciOiJIUzI1Ni...",
"instructions": "Scan this QR code with your iPhone or Android camera to add the pass directly to your phone."
}
Inquadri il codice QR sullo schermo con la fotocamera del Suo iPhone o smartphone Android e tocchi il banner che appare per completare l'installazione sul telefono.
Importante: Alcuni emittenti proteggono le carte VIP di alto valore o i badge aziendali tramite il vincolo a un singolo dispositivo (
limitToOneActivePerPass: true) o un PIN di download. Se richiesto, inserisca il PIN inviato via email o SMS prima di toccare Aggiungi al Wallet.
Ha difficoltà a installare la Sua carta? Consulti Risolvere i problemi del wallet oppure scopra come ritrovare una carta esistente in Trovare o recuperare il proprio pass.
