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

Trovare o recuperare il tuo pass

Individua una tessera salvata nell'app Wallet o richiedi un nuovo link di recupero dopo aver cambiato telefono.

In questa guida

Individuare un pass già salvato sullo smartphone

Prima di richiedere un link sostitutivo, verifichi se il pass è già memorizzato nell'app wallet del Suo telefono:

In Apple Wallet (iPhone)

  1. 1
    Apra l'app preinstallata Wallet.
  2. 2
    Scorra sotto le carte di credito e di debito principali: le carte fedeltà, le tessere associative, i coupon e i biglietti per eventi sono raggruppati nella sezione inferiore.
  3. 3
    Controlli i biglietti nascosti o scaduti: se la data di un evento è trascorsa o non ha utilizzato la carta di recente, iOS potrebbe spostarla nell'elenco compresso in fondo alla schermata. Scorra fino in fondo e tocchi Mostra biglietti scaduti (può toccare Mostra su qualsiasi pass per riportarlo nell'elenco principale).

In Google Wallet (Android)

  1. 1
    Apra l'app Google Wallet e scorra sotto i metodi di pagamento.
  2. 2
    Tocchi l'icona Cerca oppure controlli Pass scaduti in fondo all'elenco dei pass.
  3. 3
    Tocchi l'icona del profilo nell'angolo in alto a destra per verificare di visualizzare lo stesso Account Google utilizzato al momento del salvataggio del pass.
FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
RECUPERO SELF-SERVICE DEL PASS
FASE 01
1
IL TITOLARE RICHIEDE IL RECUPERO (/d/:slug, /download/:slug o /f/:slug)
Inserisce l'indirizzo email o il numero di telefono registrato nel modulo
Chiama POST/d/:slug/request-recovery { emailOrPhone }
FASE 02
2
RICERCA ISOLATA PER TENANT E PROTEZIONE ANTI-ENUMERAZIONE
Cerca i record Pass attivi corrispondenti al modello e ai recapiti
Restituisce sempre una risposta HTTP 200 uniforme per evitare l'enumerazione
FASE 03
3
NUOVO INVIO DEL LINK FIRMATO E TRASFERIMENTO DISPOSITIVO
Invia via email un nuovo link /s/:token firmato
La reinstallazione preserva punti, timbri, livello e saldo prepagato esistenti

Recupero self-service dopo il cambio dello smartphone

Se è passato a un nuovo smartphone, ha ripristinato il dispositivo o ha eliminato accidentalmente il pass, i Suoi punti fedeltà, i timbri e il saldo associativo rimangono al sicuro sui server di Passinstance.

Metodo 1: riaprire l'email o l'SMS di conferma originale

Cerchi nella casella di posta elettronica o nei messaggi SMS la comunicazione originale inviata dall'esercente. Toccando il link Aggiungi al Wallet (/s/:token o /d/:slug) sul nuovo telefono, scaricherà il pass attivo mantenendo intatto il saldo corrente.

Metodo 2: richiedere un link di recupero (POST /d/:slug/request-recovery)

Quando un esercente abilita il recupero self-service sulla propria pagina pubblica di download o PassFlow (Public Pass Recovery API su /d/:slug, /download/:slug o /f/:slug), i titolari del pass possono richiedere il reinvio istantaneo del link:

Percorso EndpointMetodoAutenticazioneFunzionalità
/d/:slug/request-recoveryPOSTPubblico (Limitato a 5/min)Cerca un pass esistente tramite emailOrPhone e invia via email un nuovo link di installazione firmato /s/:token.
/s/:tokenGETToken firmatoInstalla il pass recuperato (firmato con bundleId su iOS) sul nuovo dispositivo del cliente.

Payload della richiesta:

JSON
{
  "emailOrPhone": "member@example.com"
}

Risposta (200 OK — Sicura contro l'enumerazione):

JSON
{
  "success": true,
  "message": "If an active pass matches the provided email address, a recovery link has been sent."
}

Come limitToOneActivePerPass gestisce la sostituzione del dispositivo

Alcuni club associativi e programmi VIP configurano limitToOneActivePerPass: true sul proprio modello per impedire la condivisione non autorizzata del link tra più persone.

Importante: Se il Suo pass è protetto dal vincolo a un singolo dispositivo (limitToOneActivePerPass: true) e acquista un nuovo telefono, elimini prima il pass dal vecchio dispositivo (operazione che avvia una chiamata automatica di annullamento della registrazione DELETE /v1/devices/... su iOS o un callback del su Android) in modo da liberare immediatamente il posto disponibile. Se il vecchio telefono è stato smarrito o danneggiato, contatti l'azienda emittente affinché un amministratore possa reimpostare la registrazione del dispositivo o inviarLe nuovamente il link di accesso personale.

Ha bisogno di aggiornare o rimuovere prima una vecchia carta? Legga Aggiornare o rimuovere un pass oppure risolva eventuali errori in Risolvere i problemi del wallet.

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.