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

Aggiungere un pass al tuo Wallet

Guida utente per salvare la tessera su iPhone (Apple Wallet), Android (Google Wallet) o da PC tramite QR.

In questa guida

Guide visive interattive UI

Apri nella guida in 6 fasi

Esplora schermate reali della dashboard e dettagli ingranditi collegati a questa guida.

Focus UI ingrandito
Elementi chiave dell'interfaccia

Anteprima pass dal vivo Dual-Wallet (Zoom)

Passa tra Apple e Google nel pannello di anteprima per confermare grafica, formattazione del saldo, leggibilità del QR code e allineamento dei campi.

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.

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
ROUTING INTELLIGENTE DEL DOWNLOAD E TRASFERIMENTO AL WALLET
FASE 01 IL TITOLARE APRE LO SMART LINK (GET/d/:slug, /download/:slug o /s/:token)
Public Download Page verifica User-Agent e i controlli del token
FASE 02A STREAM APPLE WALLET
Trasmette ZIP firmato application/vnd. apple.pkpass
Sincronizza su Watch
FASE 02B REDIRECT JWT GOOGLE WALLET
Firma Object JWT RS256
Reindirizza a https:// pay.google.com/gp/v/save
Salva su Account Google
FASE 02C TRASFERIMENTO QR DESKTOP
Mostra una pagina di destinazione con codice QR scansiona- bile dallo smartphone

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 routeMetodoScopo
/d/:slugGETLink breve personalizzato per SMS, locandine QR e campagne email. Esegue il rilevamento automatico del sistema operativo e il passaggio al wallet.
/download/:slugGETPagina PassFlow di download esplicita che mostra l'anteprima del pass, il tema del brand e i pulsanti Aggiungi al Wallet specifici per piattaforma.
/s/:tokenGETLink 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. 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. 2
    Tocchi Aggiungi a Apple Wallet: iOS riconosce immediatamente il pacchetto application/vnd.apple.pkpass e apre la schermata nativa di anteprima del pass.
  3. 3
    Tocchi Aggiungi nell'angolo in alto a destra della schermata di anteprima.
  4. 4
    Sincronizzazione con Apple Watch: se indossa un Apple Watch abbinato, iOS sincronizza automaticamente i pass idonei nell'app Wallet al polso.
  5. 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. 1
    Apra il link del pass in Google Chrome o nel browser Android predefinito.
  2. 2
    Tocchi Aggiungi a Google Wallet: si aprirà la schermata di salvataggio autenticata di Google (https://pay.google.com/gp/v/save/<jwt>).
  3. 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. 4
    Tocchi Visualizza nel Wallet per mostrare immediatamente il codice a barre o il pass NFC contactless.

I computer desktop non eseguono nativamente Apple Wallet o Google Wallet. Quando apre un link /d/:slug o /s/:token su macOS o Windows:

JSON
{
  "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.

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.