Skip to content
GUIDA STUDIO STAMP PASS

Regole di raccolta timbri: tessere automatiche in Apple Wallet e Google Wallet

Sostituisci le tessere cartacee e le grafiche statiche con griglie timbri dinamiche, blocco scansioni duplicate, icone 720 × 720 px e cicli premio automatici.

Da 1 a 50 timbri per ciclo
Cooldown anti-duplicato in minuti
Griglie automatiche a 3 / 4 / 5 colonne
Reimposta, mantieni completo o nuovo ciclo
Simulatore interattivo timbri
Apple Wallet4 × 2CR-00124 · 2030-12-31
Dopo il completamento del premioCicli completati: 0
Banner Apple Wallet composto a ogni scansione

PERCHÉ SERVONO REGOLE TIMBRI

Perché carte cartacee e grafiche statiche non scalano

Le regole Stamp Pass uniscono calcolo delle scansioni, composizione grafica, limiti giornalieri e cicli premio in un unico modello verificabile senza esportazioni manuali.

01

Le tessere di carta si perdono o vengono dimenticate prima del premio

Le tessere fisiche restano nei portafogli mentre i timbri a inchiostro non offrono storico, controllo anti-duplicato né notifiche push.

02

Creare immagini separate per 1/8, 2/8 fino a 8/8 timbri non scala

Senza composizione dinamica, cambiare icona o modificare il numero di caselle richiede di riesportare manualmente ogni stato.

03

Scansioni senza limiti causano doppi timbri e premi bloccati

Senza limite giornaliero, cooldown anti-duplicato e gestione post-premio, il personale può timbrare due volte o bloccare tessere piene.

Senza regole timbri automatizzate
  • Le grafiche statiche richiedono esportazioni manuali per ogni modifica
  • Nessuna protezione contro doppie scansioni QR ravvicinate in cassa
  • Gestione manuale per azzerare la tessera o avviare un nuovo ciclo
  • Tessere scollegate senza aggiornamenti sulla schermata di blocco
Con le regole Stamp Pass di Passinstance
  • Il compositore server genera live timbri attivi, vuoti e casella premio
  • Griglia configurabile a 3, 4 o 5 colonne con controllo forma e contrasto
  • Protezione anti-duplicato (minuti), tetto massimo e limite giornaliero inclusi
  • Gestione automatica post-premio: azzera, mantieni completa o nuovo ciclo

MECCANICA RACCOLTA E PREMI

Tre modalità di validazione e tre chiusure di ciclo

Che tu aggiunga timbri alla cassa, scali pacchetti prepagati o aggiorni via webhook POS, le regole applicano l'intero ciclo.

Più comune

Aggiungi timbri

Ogni scansione valida incrementa il saldo di Timbri per validazione fino al raggiungimento del traguardo.

STAMP_CARD_ADD
Modalità riscatto

Deduci timbri

Ogni lettura sottrae timbri dal saldo accumulato o prepagato bloccando eventuali discese sotto zero.

STAMP_CARD_DEDUCT
Manuale / API

Nessuna modifica automatica

La scansione verifica il pass senza alterare il saldo; gli aggiornamenti avvengono tramite Studio o integrazione API.

NO_AUTOMATIC_CHANGE

Dopo il completamento del premio

Azzera timbri

Al riscatto del premio la tessera torna a zero timbri così il cliente riprende la raccolta sullo stesso pass.

Mantieni completata

Lascia tutte le caselle piene e segna il pass come completato, ideale per sfide singole o raccolte a edizione limitata.

Avvia nuovo ciclo

Inizia subito un nuovo ciclo di raccolta dopo il completamento registrando ogni ciclo concluso nel registro.

CONFIGURAZIONE PASSO PASSO

Come configurare le regole timbri in Passinstance Studio

Segui questi sei passaggi in Stamp Pass -> Regole raccolta timbri ed esamina entrambe le schede Studio.

1

Apri Stamp Pass -> Regole raccolta timbri

In Passinstance Studio apri Punti e livelli -> Stamp Pass (su Store Card, Coupon o Event Ticket con strip) per gestire Raccolta e premi, Wallet e asset e Impostazioni avanzate.

2

Scegli validazione e soglie obiettivo

Seleziona Aggiungi, Deduci o Nessuna modifica automatica, quindi imposta Timbri richiesti (1–50), Valore iniziale e Timbri per validazione.

3

Imposta premio e azione post-completamento

Inserisci nome e descrizione del premio e scegli Azzera timbri, Mantieni completata o Avvia nuovo ciclo.

4

Personalizza la griglia in Wallet e asset

Imposta 3, 4 o 5 colonne, dimensione timbro (36px–72px), allineamento (Sinistra, Centro, Destra, Auto) e adattamento sfondi.

5

Carica icone opzionali timbro e premio (720 × 720 px)

Carica PNG/SVG trasparenti per i timbri raccolti e la casella premio finale, oppure usa le icone predefinite di Studio.

6

Attiva le protezioni avanzate e testa dal vivo

Abilita il blocco del massimo, il limite giornaliero e il cooldown anti-duplicato (5 min predefiniti) prima di pubblicare.

DENTRO PASSINSTANCE STUDIO

Raccolta e premi — validazione, obiettivo e comportamento post-premio

1 / 2
Vista dashboard1 / 2
Elementi chiave dell'interfaccia

Raccolta e premi — validazione, obiettivo e comportamento post-premio

Imposta la modalità di scansione, gli 8 timbri richiesti, i campi premio e l'azione post-completamento con anteprima immediata.

ANTEPRIMA REALE SU DISPOSITIVO

Un'unica configurazione timbri, renderizzata in modo impeccabile in Apple Wallet e Google Wallet

Carica le icone dei timbri una sola volta in Studio. Passinstance genera automaticamente la fascia superiore su iPhone e il grafico hero su Android ad ogni scansione.

Carta timbri Apple Wallet

iOS · PassKit

Mostra il banner composto con i timbri sopra l'ID membro e la data di scadenza insieme a un codice QR ad alta nitidezza.

Composizione banner superiore StoreCardAggiornamento immediato tramite APNs

Carta timbri Google Wallet

Android · Loyalty API

Posiziona in alto il codice QR, il contatore dei timbri, l'ID membro e la validità, abbinati al pannello timbri nella parte inferiore.

Sincronizzazione grafica dei timbri in bassoCodice QR e contatore subito visibili

PROTEZIONI E IMPOSTAZIONI AVANZATE

Protezione scansioni, limiti visivi e controllo saldo

Espandi Impostazioni avanzate per prevenire abusi in cassa mantenendo la grafica uniforme su Apple Wallet e Google Wallet.

Intervallo 1–50 timbri

Non superare i timbri richiesti

Blocca le scansioni oltre il limite configurato (`MAXIMUM_EXCEEDED`) mantenendo pulita la griglia nel Wallet.

Predefinito: 1 / giorno

Controllo validazioni giornaliere

Mantieni disattivato per limitare a 1 timbro al giorno oppure abilita più letture quotidiane per bar ad alta frequenza.

Predefinito: 5 minuti

Finestra anti-duplicato

Pausa configurabile in minuti (5 minuti predefiniti) che blocca scansioni accidentali ravvicinate dello stesso pass.

3 / 4 / 5 colonne

Compositore deterministico banner Wallet

Calcola automaticamente le coordinate di slot attivi, vuoti e premio finale su Apple Wallet e Google Wallet.

Controlli layout fini

Controllo fine di forma, spazio e posizione

Regola forma (cerchio, quadrato, arrotondato), spaziatura (2–24px), separazione sfondo (0–60%) e posizione premio.

Protezione saldo atomica

Controllo saldo in modalità detrazione

In modalità Deduci timbri, le scansioni con saldo insufficiente vengono respinte in sicurezza con `INSUFFICIENT_BALANCE`.

DOMANDE FREQUENTI

FAQ sulle regole di raccolta timbri

Quanti timbri supporta un Passinstance Stamp Pass?

Da 1 a 50 timbri per ciclo (`Timbri richiesti`) e da 1 a 10 timbri per scansione, distribuiti su 3, 4 o 5 colonne in Studio.

Quali tipi di pass supportano icone e griglie di timbri?

Le strip visive sono supportate da Store Card, Coupon ed Event Ticket su Apple Wallet e Google Wallet.

È obbligatorio caricare icone personalizzate di timbro e premio?

No, entrambi i file sono opzionali (consigliato PNG/SVG trasparente 720 × 720 px). Senza caricamento, Studio genera icone predefinite.

Qual è la differenza tra Azzera timbri, Mantieni completata e Avvia nuovo ciclo?

Azzera riporta la tessera al valore iniziale al riscatto; Mantieni completata la lascia piena e chiusa; Avvia nuovo ciclo apre subito una nuova raccolta.

Come impedisce Passinstance la doppia timbratura in cassa?

La protezione scansioni duplicate blocca letture ripetute per i minuti impostati (5 min di default), affiancata dal blocco giornaliero opzionale.

Crea il tuo Stamp Pass in Passinstance Studio

Inizia gratis, personalizza griglie 3/4/5 e icone 720 × 720 px e prova subito le scansioni su Apple Wallet e Google Wallet.