Skip to content
Guida interattiva a configurazione e distribuzione

Lancia il tuo primo programma Wallet

Crea, testa e distribuisci la tua prima carta Apple Wallet o Google Wallet con una guida chiara passo dopo passo.

6
Fasi di onboarding
6
Meccaniche delle carte
Apple WalletGoogle Wallet
Apple e Google
Piattaforme Wallet
Percorso di onboarding in 6 fasi

Il tuo percorso completo dalla configurazione alla distribuzione

Segui queste sei fasi sequenziali dalla preparazione del workspace fino alla distribuzione ai clienti. Salta a qualsiasi fase o segna le fasi completate.

0 / 6 fasi segnate come completate
01
Fase 1 di 6

Prepara il tuo workspace

Verifica le impostazioni del workspace, le credenziali di firma Wallet, i permessi del team e gli smartphone fisici di test prima di creare il primo modello.

Prerequisiti prima di iniziare questa fase

  • Account workspace attivo su Passinstance Studio (qualsiasi indirizzo e-mail valido è accettato)
  • Certificato Apple Demo ed Emittente Google Wallet gestito inclusi per test immediati (oppure il tuo certificato Apple .cer per la produzione)
  • Permessi di ruolo Proprietario Workspace, Admin o Editor Modelli
  • Un iPhone fisico (Apple Wallet) o smartphone Android (Google Wallet) per il test su dispositivo

Istruzioni passo dopo passo

  1. 1

    Verifica l'identità del workspace e le impostazioni aziendali

    Apri Impostazioni account in Passinstance Studio per confermare ragione sociale, fuso orario predefinito e ambiente del workspace.

  2. 2

    Verifica le credenziali demo o collega i certificati di produzione

    Ogni nuovo workspace include un Certificato Apple Demo e un Emittente Google Wallet gestito per testare subito sullo smartphone. Prima del lancio pubblico, carica il certificato Apple Pass Type ID (.cer) in Impostazioni → Wallet (o Strumenti sviluppatore → Certificati).

  3. 3

    Conferma i ruoli del team e i permessi dello Scanner

    Assicurati che i collaboratori che progettano modelli, emettono carte o usano lo Scanner abbiano il ruolo workspace adeguato assegnato.

  4. 4

    Prepara un dispositivo di test iOS e/o Android reale

    Tieni a portata di mano un iPhone con Apple Wallet e/o un dispositivo Android con Google Wallet connesso e pronto per scansionare il primo QR code di prova.

Risultato atteso

Il tuo workspace dispone di credenziali di firma Wallet attive (sandbox o produzione) ed è pronto per creare e testare un modello.

Focus UI ingrandito1 / 3
Elementi chiave dell'interfaccia

Template Settings — Firma e ID esterni (Ingrandito)

Controlla stato certificato di firma, ordinamento Wallet, stato Published e regole di unicità External ID.

Dettagli pratici e comportamento delle piattaforme
  • Ogni nuovo workspace attiva automaticamente un Certificato Apple Demo e un Emittente Google Wallet gestito per installare subito pass di test reali su iOS e Android senza attendere l'approvazione Apple Developer.
  • La pubblicazione in produzione su Apple Wallet richiede la generazione di un CSR in Strumenti sviluppatore → Certificati (o Impostazioni → Wallet), il rilascio in Apple Developer e l'upload del file .cer.
  • Ogni workspace isola modelli, carte clienti, certificati e analisi entro il proprio perimetro tenant.
Risoluzione dei problemi in questa fase

La pubblicazione o la creazione della carta di test è bloccata da un avviso sul certificato

Apri Impostazioni → Wallet (o Strumenti sviluppatore → Certificati) in Studio, controlla lo stato del Certificato Apple Demo o carica un file .cer valido e verifica l'emittente Google Wallet.

Un membro del team non riesce a modificare i modelli o accedere alle impostazioni Scanner

Chiedi a un Proprietario Workspace o Admin di verificare Membri del team e permessi e assegnare l'accesso Editor o Operatore Scanner.

02
Fase 2 di 6

Progetta la tua carta

Seleziona la struttura della carta, configura colori e campi, definisci gli attributi dinamici del cliente e abbina la meccanica di business.

Prerequisiti prima di iniziare questa fase

  • Workspace preparato (Fase 1)
  • Logo del brand ed eventuali grafiche strip/sfondo (formato PNG consigliato)
  • Scelta chiara del caso d'uso della carta (Fedeltà, Timbri, Coupon, Eventi o Valore memorizzato)

Istruzioni passo dopo passo

  1. 1

    Crea un modello dalla Galleria, da zero, con l'IA o da importazione .pkpass

    In Modelli, clicca Nuovo modello per partire da un preset curato, da un layout vuoto, da un prompt guidato con l'IA oppure da un pacchetto .pkpass/JSON esistente.

  2. 2

    Configura tipo di carta, colori, immagini e campi fronte/retro

    Imposta Nome modello, Ente emittente, Descrizione carta, colori RGB conformi WCAG, logo/strip e i campi Intestazione, Principale, Secondari/Piè di pagina, Ausiliari e Retro previsti dal tipo di carta selezionato.

  3. 3

    Definisci gli attributi dinamici del cliente

    Aggiungi proprietà personalizzate (come firstName, lastName, email, customerId o tier) e collegale ai campi della carta con {key}.

  4. 4

    Seleziona e configura meccanica della carta e regole di validazione

    Scegli tra tutte le 6 meccaniche Studio — Carta a timbri, Riscatto timbri, Valore memorizzato, Punti e livelli, Validazione giornaliera o Estendi scadenza — e imposta incrementi, premi o soglie.

Risultato atteso

Il modello mostra un'anteprima live fedele di Apple Wallet e Google Wallet con segnaposto dinamici e regole di business configurate.

Focus UI ingrandito1 / 9
Elementi chiave dell'interfaccia

Menu di creazione nuovo modello (Zoom)

Inizia da un modello vuoto, scegli un preset dalla Galleria modelli, duplica un modello esistente o avvia Crea con IA.

Modello dati

Come interagiscono Tipo di carta, Modello, Meccanica, Attributo e Carta emessa

1

Tipo di carta

Definisce la struttura di base del layout e gli spazi per i campi in Apple Wallet e Google Wallet.

Carta fedeltà, Coupon, Biglietto evento, Pass generico o Carta d'imbarco.
2

Modello (Template)

La tua matrice riutilizzabile con brand, testi fissi, segnaposto dinamici e regole.

Modello «Fedeltà Grand Café VIP» in Passinstance Studio.
3

Meccanica della carta

Il motore di regole di business che stabilisce come scansioni o modifiche aggiornano la carta.

Carta a timbri (8 timbri = 1 premio) o Punti e livelli (Argento → Oro).
4

Attributo dinamico

Una variabile specifica del cliente collegata a un campo del modello.

{firstName} o {points}.
5

Carta emessa

Una singola istanza firmata crittograficamente e generata per un cliente specifico.

Carta #PI-9482 installata nell'Apple Wallet di Anna.
Selettore interattivo di meccaniche

Scegli e confronta la meccanica della tua carta

Vedi nell'editor dei modelli
Meccanica della cartaTessera timbri

Carta a timbri

Tessera punti digitale in cui ogni acquisto o scansione valida aggiunge un timbro fino al raggiungimento del premio.

Scopri le carte a timbri
Problema di business risolto
Sostituisce le tessere cartacee con timbri digitali a prova di frode aggiornati in tempo reale a ogni visita.
Esempio di caso d'uso
Esempio: Raccogli 8 timbri caffè per ottenere 1 bevanda omaggio.
Configurazione richiesta
Griglia timbri (3–5 colonne), icona timbro (PNG 720 × 720 px), soglia premio e intervallo anti-duplicato opzionale.
Requisiti di validazione
Il personale scansiona il QR code con Passinstance Scanner (o tramite API di cassa) per aggiungere o riscattare i timbri.
Aggiornamento nel Wallet
Apple Wallet e Google Wallet aggiornano immediatamente la striscia visiva dei timbri e il contatore tramite push.
Limitazioni note
Ogni modello supporta una meccanica attiva; le modifiche alla griglia aggiornano il layout alla successiva sincronizzazione Wallet.
Dettagli pratici e comportamento delle piattaforme
  • Apple Wallet serializza i colori come rgb(r, g, b) e Passinstance adatta automaticamente i gruppi di campi fronte e retro al tipo di carta scelto (Generica, Store Card, Coupon, Biglietto evento o Carta d'imbarco).
  • Google Wallet blocca il tipo di classe sottostante dopo la prima emissione; scegli con attenzione il tipo di carta prima di pubblicare.
  • Le Proprietà personalizzate definite sul modello generano automaticamente i campi di input nella creazione singola, nei moduli di registrazione PassFlow e nelle intestazioni dell'importazione CSV di massa.
Risoluzione dei problemi in questa fase

Un segnaposto dinamico come {firstName} viene stampato testualmente sulla carta

Verifica che la chiave dell'attributo esista in Proprietà personalizzate nell'Editor modelli e che il nome coincida esattamente rispettando maiuscole e minuscole.

I testi o le etichette sulla strip risultano poco leggibili nell'anteprima della carta

Regola Colore di sfondo, Colore etichette e Colore valori nella scheda Branding oppure attiva la regolazione automatica del contrasto del testo.

03
Fase 3 di 6

Pubblica ed emetti una carta di test

Verifica la checklist nell'editor, pubblica la versione attiva del modello e genera una prima carta di test con valori realistici.

Prerequisiti prima di iniziare questa fase

  • Layout del modello, attributi e meccanica completati (Fase 2)
  • Tutti i campi obbligatori validi con verifiche di idoneità verdi

Istruzioni passo dopo passo

  1. 1

    Esamina la validazione Editor e la checklist di lancio in Panoramica

    Conferma nell'Editor modelli che Nome modello, Ente emittente e Descrizione risultino validi e controlla la scheda a 3 punti (Configurazione, Design Wallet e Meccaniche) in Panoramica modello.

  2. 2

    Salva le modifiche in bozza e clicca Pubblica modello

    Clicca Salva per memorizzare lo stato dell'editor, poi clicca Pubblica affinché il modello passi ad Attivo e diventi disponibile per l'emissione delle carte.

  3. 3

    Apri Azioni rapide → Crea una carta singola

    Dalla pagina Panoramica modello, avvia la finestra di creazione singola e inserisci valori cliente realistici per ogni attributo.

  4. 4

    Verifica la generazione della carta e gli identificativi univoci

    Conferma che la nuova carta compaia nella tabella Carte con un ID univoco, il payload QR/codice a barre generato e lo stato iniziale.

Risultato atteso

Nell'elenco Carte del tuo modello è presente una carta di test firmata con URL di installazione attivo e codice QR pronto per la verifica su smartphone.

Focus UI ingrandito1 / 3
Elementi chiave dell'interfaccia

Checklist di pubblicazione — Configurazione completata (Zoom)

Verifica che Certificato di firma, Regole di convalida e Pagina di download mostrino tutti «Ready» (3 su 3 completati) prima di emettere i pass.

Confronto tra le azioni chiave

Cosa fanno realmente Salva bozza, Pubblica modello ed Emetti carta

1. Bozza in Studio

Salva bozza

Salva le modifiche grafiche e gli attributi all'interno dell'Editor modelli.

Nessun impatto sulle carte attive. Non è possibile emettere carte da una bozza non pubblicata.

Mentre perfezioni colori, immagini e campi prima della revisione finale.

2. Modello attivo

Pubblica modello

Verifica i campi obbligatori, attiva la versione del modello e sincronizza il layout con i Wallet installati.

Abilita l'emissione di nuove carte e invia gli aggiornamenti grafici alle carte già installate.

Quando la checklist di pubblicazione è verde e sei pronto a emettere carte.

3. Istanza cliente

Emetti carta

Genera un record firmato univoco, un token QR/codice a barre e un URL di installazione dedicato.

Crea una carta installabile in Apple Wallet (.pkpass) e Google Wallet per quel destinatario.

Per carte di test singole, moduli PassFlow, importazioni CSV o chiamate API.

Dettagli pratici e comportamento delle piattaforme
  • Salvare una bozza non modifica mai le carte già emesse ai clienti; solo la pubblicazione rende attive le modifiche del modello per le nuove carte e per la sincronizzazione live sui Wallet.
  • Ogni carta emessa riceve un numero seriale crittografico univoco e un token di convalida del codice a barre anche quando due clienti hanno lo stesso nome visualizzato.
  • Puoi emettere carte di test interne illimitate ed eliminarle o archiviarle prima di avviare la distribuzione ai clienti.
Risoluzione dei problemi in questa fase

Il pulsante Pubblica è disabilitato nell'Editor modelli

Compila eventuali campi obbligatori mancanti (Nome modello, Ente emittente o Descrizione) segnalati nell'Editor modelli, salva la bozza e clicca Pubblica.

Nella finestra Crea carta manca un campo cliente previsto

Torna in Editor modelli → Proprietà personalizzate, aggiungi l'attributo e ripubblica il modello.

04
Fase 4 di 6

Testa l'esperienza nel Wallet

Installa la carta di test su un iPhone e/o smartphone Android reale, verifica il layout e convalida la scansione codice a barre/NFC.

Prerequisiti prima di iniziare questa fase

  • Carta di test emessa con link di download o codice QR attivo (Fase 3)
  • iPhone fisico (Safari/Fotocamera) e/o dispositivo Android (Chrome/Google Wallet)

Istruzioni passo dopo passo

  1. 1

    Scansiona il codice QR della carta di test sullo smartphone

    Apri l'anteprima o il link di download della carta sul telefono e tocca Aggiungi ad Apple Wallet o Aggiungi a Google Wallet.

  2. 2

    Verifica layout frontale, campi sul retro e codice a barre

    Controlla allineamento del logo, ritaglio dell'immagine strip, valori dinamici del cliente, link sul retro della carta e nitidezza di QR/codice a barre sullo schermo del dispositivo reale.

  3. 3

    Esegui una scansione di prova con Passinstance Scanner (se la validazione è attiva)

    Apri Passinstance Scanner (Web Scanner, app iOS o profilo Scanner configurato) e scansiona il codice QR per verificare le regole di timbri, punti, saldo o check-in.

  4. 4

    Conferma l'aggiornamento push Wallet in tempo reale sul telefono

    Verifica che la carta del cliente si aggiorni automaticamente in Apple Wallet o Google Wallet entro pochi secondi dalla scansione o dalla modifica in dashboard.

Risultato atteso

La carta si installa senza errori su iOS e Android, supera la scansione e riflette in tempo reale gli aggiornamenti di saldo/stato su schermata di blocco e dentro il Wallet.

Focus UI ingrandito1 / 5
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.

Apple Wallet

Apple Wallet (.pkpass su iPhone e Apple Watch)

Verifica l'allineamento dei campi intestazione/principali/secondari, il contrasto RGB, i link sul retro della carta e le notifiche APNs di aggiornamento su schermata di blocco.

Google Wallet

Google Wallet (JWT firmato su Android)

Verifica il ridimensionamento delle grafiche hero/strip, i moduli di testo strutturati, il rendering del codice a barre e la sincronizzazione push REST di Google Wallet.

Disponibilità e requisiti dello Scanner

Come convalidare le carte per dispositivo e quando è richiesto il test Scanner

Passinstance Scanner
Accesso immediato da browser

Web Scanner (browser desktop e mobile)

Subito disponibile per ogni workspace con accesso alla fotocamera. Ideale per test rapidi di onboarding e per laptop o tablet alla reception.

App nativa iOS

Passinstance Scanner per iPhone e iPad

Scaricabile su iOS per scansioni ottiche rapide di QR/codici a barre e flussi di convalida dello staff in cassa.

Setup richiesto

Profilo di configurazione Scanner

In Panoramica modello → Scanner, crea una configurazione Scanner per definire quale modalità di scansione (Aggiungi timbro, Aggiungi punti, Riscatta o Check-In) usano gli operatori.

Provisioning Android

APK Android e hardware enterprise

Distribuisci su terminali POS Android dedicati o palmari Sunmi/Zebra? Contatta il nostro team per il provisioning dell'APK gestito.

Quando è facoltativo

Quando il test con Scanner non è necessario

Se la tua carta è un badge socio statico, un biglietto da visita digitale o una carta informativa aggiornata via API/Dashboard senza check-in fisici tramite scansione, puoi saltare la configurazione dello Scanner.

Dettagli pratici e comportamento delle piattaforme
  • I file Apple Wallet (.pkpass) si aprono nativamente in Safari e Mail su iOS; sui browser desktop, Passinstance mostra una pagina con codice QR scansionabile.
  • Le carte Google Wallet richiedono che l'utente abbia effettuato l'accesso a un account Google su Android o web e si sincronizzano automaticamente nell'app Google Wallet.
  • Se la tua carta è solo informativa (es. tessera VIP statica senza regole di check-in), puoi saltare i test con lo scanner e verificare gli aggiornamenti direttamente dalla tabella Carte in Studio.
Risoluzione dei problemi in questa fase

Apple Wallet o Google Wallet non mostra subito i punti o i timbri aggiornati

Verifica la connettività del dispositivo, controlla che il modello sia stato pubblicato dopo le modifiche ai campi e trascina verso il basso per aggiornare la carta (o controlla Aggiornamenti automatici sul retro su iOS).

Lo Scanner segnala «Carta non valida» o «Intervallo di attesa regola attivo»

Conferma che il profilo Scanner sia collegato allo stesso workspace/modello e verifica se è attiva una finestra di Validazione giornaliera o anti-doppia scansione.

05
Fase 5 di 6

Distribuisci le tue carte

Scegli il canale di consegna più adatto al tuo pubblico e distribuisci le carte tramite link pubblici, moduli PassFlow, import CSV o Sendouts.

Prerequisiti prima di iniziare questa fase

  • Modello pubblicato e carta di test verificata (Fasi 3–4)
  • Modalità di accesso alla distribuzione selezionata (Pubblica vs. Riservata)

Istruzioni passo dopo passo

  1. 1

    Configura Distribuzione e controlli di accesso sul modello

    In Panoramica modello → Distribuzione, imposta se i link sono Pubblici o Riservati, configura le date di scadenza e gli eventuali limiti massimi di emissione.

  2. 2

    Seleziona il metodo di distribuzione principale

    Scegli Pagine di download o PassFlow per l'auto-registrazione, Carta singola per emissioni VIP 1-a-1 oppure Importazione CSV di massa + Sendouts per liste CRM esistenti.

  3. 3

    Mappa gli attributi e testa prima un piccolo lotto pilota

    Quando importi un CSV o avvii un invio e-mail/SMS, mappa le colonne alle Proprietà personalizzate ed esegui prima un invio verso 2–3 indirizzi interni.

  4. 4

    Lancia il tuo canale di distribuzione o la campagna

    Condividi il tuo QR/URL pubblico, incorpora PassFlow sul sito oppure avvia il job Sendout in uscita dal Delivery Center.

Risultato atteso

I clienti ricevono il link personalizzato o il codice QR della propria carta, aprono la pagina PassFlow ottimizzata per il dispositivo e aggiungono la carta ad Apple Wallet o Google Wallet in un tocco.

Focus UI ingrandito1 / 4
Elementi chiave dell'interfaccia

Limiti di emissione e controlli di accesso (Zoom)

Configura emissione illimitata o limitata, canali di accesso, routing Wallet e protezioni come il blocco del nuovo download dopo l'attivazione e la deduplicazione dei destinatari.

Flusso di consegna end-to-end

Come viaggia una carta da Passinstance allo smartphone del cliente

  1. Tappa 101

    Emissione record della carta

    Passinstance crea un'istanza della carta tramite Carta singola, modulo PassFlow, importazione CSV o API REST.

  2. Tappa 202

    Generazione URL di installazione univoco

    Ogni carta riceve un URL di installazione con rilevamento dispositivo e un codice QR legati al proprio token crittografico.

  3. Tappa 303

    Consegna tramite canale

    Condividi il link tramite i Sendouts di Passinstance (e-mail/SMS), il tuo CRM, un pulsante sul sito web o un poster QR stampato.

  4. Tappa 404

    Il cliente apre PassFlow

    PassFlow rileva automaticamente iOS, Android o Desktop (con overlay guidato PassTour opzionale).

  5. Tappa 505

    Aggiunta ad Apple / Google Wallet

    Il cliente tocca Aggiungi al Wallet; la carta si installa sullo smartphone e si registra per ricevere aggiornamenti push live.

Selettore interattivo di distribuzione

Confronta i 6 modi per consegnare le carte ai clienti

Seleziona qui sotto un metodo di consegna per verificare prerequisiti, campi cliente richiesti, passaggi di configurazione ed esperienza utente.

Link self-service / QR

Pagine di download pubbliche

Leggi la guida alle Pagine di download

Quando usarlo

Ideale per campagne promozionali aperte, poster QR in negozio, link in bio sui social e banner sul sito web dove chiunque può richiedere una carta.

Prerequisiti

Modello pubblicato con Distribuzione pubblica abilitata.

Campi cliente richiesti

Nessun dato cliente preesistente richiesto prima di condividere l'URL.

Configurazione passo dopo passo

Apri Panoramica modello → Distribuzione → Abilita link pubblico, copia l'URL o scarica il codice QR stampabile.

Esperienza attesa del cliente

Il cliente scansiona il QR o clicca il link, atterra sulla tua pagina brandizzata e tocca Aggiungi ad Apple Wallet o Google Wallet.

Dettagli pratici e comportamento delle piattaforme
  • L'importazione CSV di massa crea i record delle carte e gli URL univoci di download nel workspace; non invia e-mail automaticamente finché non avvii una campagna Sendout.
  • Le Pagine di download pubbliche e i moduli PassFlow possono abilitare opzionalmente gli overlay guidati PassTour per mostrare ai nuovi utenti come toccare Aggiungi e dove si trovano le offerte sul retro della carta.
  • L'e-mail è obbligatoria solo per campagne e-mail in uscita o verifica OTP via e-mail; consegna SMS, poster QR e link di download diretti funzionano anche senza e-mail.
Risoluzione dei problemi in questa fase

L'importazione CSV fallisce o salta alcune righe durante il caricamento

Assicurati che il file sia codificato in UTF-8, che le intestazioni delle colonne corrispondano alle Proprietà personalizzate del modello e che i campi di contatto richiesti siano compilati.

I clienti segnalano che un link condiviso mostra «Distribuzione chiusa»

Controlla Panoramica modello → Controlli distribuzione per verificare che la distribuzione sia attiva, che la data di scadenza non sia trascorsa e che il limite massimo di carte non sia stato raggiunto.

06
Fase 6 di 6

Monitora e gestisci

Monitora l'adozione Wallet in tempo reale, filtra i segmenti di titolari, invia aggiornamenti o notifiche push live e gestisci l'operatività.

Prerequisiti prima di iniziare questa fase

  • Carte distribuite attivamente nei Wallet dei clienti (Fase 5)
  • Accesso a Dashboard Studio, Analisi del modello e Registro attività

Istruzioni passo dopo passo

  1. 1

    Monitora i tassi di carte Emesse vs. Installate vs. Rimosse

    Consulta le schede Pass Health in Dashboard e la scheda Analisi del modello per seguire conversione alle installazioni, dispositivi attivi e ripartizione iOS vs. Android.

  2. 2

    Filtra i titolari e consulta il Registro attività

    Usa i Filtri avanzati nell'elenco Carte per segmentare i titolari per stato, livello meccanica, saldo o tag e verifica ogni scansione o aggiornamento nel Registro attività.

  3. 3

    Invia aggiornamenti live a singole carte o interi segmenti

    Modifica gli attributi di un titolare, esegui un'azione in blocco oppure pubblica un aggiornamento del modello per inviare nuovi saldi, livelli o messaggi promozionali ai Wallet installati.

  4. 4

    Consulta il Centro assistenza o Contatta il supporto in caso di escalation

    Consulta le 10 aree del Centro assistenza per guide tecniche approfondite, documentazione API/Webhook oppure contatta il Supporto Passinstance indicando l'ID della carta interessata.

Risultato atteso

Hai piena visibilità su adozione nei Wallet, scansioni di riscatto e aggiornamenti del ciclo di vita cliente per l'intero programma attivo.

Focus UI ingrandito1 / 5
Elementi chiave dell'interfaccia

Dashboard Workspace — KPI e Trend live (Ingrandito)

A sistema avviato, monitora Active in Wallets, Removed, Not Installed insieme alle curve di creazione e registrazione.

Dettagli pratici e comportamento delle piattaforme
  • La fatturazione e le metriche di utilizzo attivo di Passinstance conteggiano le registrazioni Wallet attive (carte attualmente installate sui dispositivi dei clienti), non il numero grezzo di righe CSV importate.
  • Quando un cliente elimina una carta da Apple Wallet o Google Wallet, la piattaforma riceve un callback di deregistrazione e aggiorna lo stato della carta su Rimossa.
  • Gli sviluppatori possono automatizzare tutte le operazioni delle Fasi 3–6 tramite l'API REST Passinstance e i Webhook firmati (/docs).
Risoluzione dei problemi in questa fase

Il numero di carte emesse è alto, ma le installazioni nel Wallet restano basse

Attiva gli overlay guidati PassTour su PassFlow e assicurati che il pulsante nelle e-mail o negli SMS apra il link direttamente nel browser mobile del cliente.

Serve revocare o sostituire la carta compromessa di un cliente

Apri il record della carta in Studio → Carte, imposta lo stato su Annullata/Scaduta oppure eliminala, quindi emetti un nuovo link sostitutivo per il cliente.

Autoverifica pre-lancioChecklist manuale salvata nel browser — non ispeziona i dati live del workspace

Pronto per il lancio?

Verifica questi sette punti di controllo osservabili su una carta di test reale prima di inviare le carte ai clienti.

0 / 7 verificati

Regola d'oro operativa

Testa e valida sempre una carta reale prima di lanciare una campagna di distribuzione.

Guida Studio IA in Evidenza

Creare Pass Wallet con l’IA: Prompt, Importazione e Firma

Usa ChatGPT, Claude o Gemini per generare pacchetti .pkpass non firmati, rilevare automaticamente i segnaposto dinamici in Studio e firmare i pass in sicurezza al momento dell’emissione.

Guida onboarding in evidenza

PassTour: Overlay guidati per Aggiungi a Wallet e primo utilizzo

Scopri perché le guide temporanee prevengono dubbi durante l'aggiunta, mostrano dove trovare le offerte e come configurare Fase 1 e Fase 2.

Guida Fedeltà In Evidenza

Regole di progressione: Punti, livelli e upgrade automatici

Scopri perché i livelli su modello singolo eliminano i template duplicati e come impostare soglie, contrasti WCAG, grafiche Wallet e notifiche push.

Guida Timbri in evidenza

Regole di raccolta timbri: griglie, protezioni e premi

Scopri perché le regole timbri sostituiscono gli export manuali e come configurare validazione, griglie 3-5 colonne, icone 720 x 720 px e blocco scansioni duplicate.

Orientamento interattivo dell'area di lavoro

Esplora l'interfaccia di Passinstance Studio

Fai clic sui marker numerati nelle viste ingrandite qui sotto per esaminare i controlli e saltare direttamente alla fase di onboarding corrispondente.

Focus UI ingrandito
Elementi chiave dell'interfaccia

Dashboard Workspace — KPI Wallet e Trend live

Monitora installazioni attive nei Wallet, rimozioni, pass in attesa e curve di emissione e registrazione a 30 giorni.

Tutte le 10 aree · 94 guide

Sfoglia per argomento

Esplora guide pratiche, documentazione tecnica e soluzioni ai problemi più comuni.

94 guide corrispondono al filtro
Area 28 guide2

2. Soluzioni e casi d'uso

Scopri come impiegare le tessere Wallet digitali nelle diverse attività.

Area 315 guide9

3. Creazione e gestione pass

Progetta, emetti, organizza e mantieni aggiornati i tuoi pass digitali.

Area 410 guide3

4. Distribuzione e coinvolgimento

Consegna i pass ai clienti e mantieni i loro Wallet sempre aggiornati.

Area 66 guide3

6. Validazione e riscatto

Convalida i pass, gestisci i check-in e registra le transazioni premio.

Area 710 guide

7. Integrazioni e automazione

Collega Passinstance ai tuoi sistemi esistenti e automatizza i flussi.

Area 85 guide3

8. Analisi e report

Monitora le prestazioni, traccia le attività e analizza l'uso dei pass.

Area 916 guide

9. Account e gestione aziendale

Gestisci organizzazione, utenti, abbonamento e impostazioni fiscali.

Area 107 guide1

10. Aiuto e supporto

Trova risposte rapide, risolvi problemi e contatta l'assistenza.

Domande frequenti

Domande frequenti

No per i flussi self-service. La registrazione account accetta qualsiasi indirizzo e-mail valido, mentre pagine di download pubbliche, codici QR e link PassFlow consentono l'installazione senza dati preliminari. E-mail o telefono servono solo per Sendouts via e-mail/SMS o verifica OTP opzionale.

Sì. Ogni nuovo workspace include automaticamente un certificato Apple demo e un emittente Google Wallet gestito per testare subito su smartphone. Prima del lancio pubblico, carica il tuo certificato Apple Pass Type ID (.cer) in Impostazioni → Wallet (o Strumenti sviluppatore → Certificati).

Esplora per argomento

Guide di implementazione Wallet per caso d'uso

Passa direttamente dalle fasi di configurazione alle guide dettagliate, alla documentazione API e ai casi d'uso adatti al tuo programma.

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.