Skip to content
Torna al blog

Accredito immediato dei punti fedeltà alla cassa (POS): architettura Wallet in tempo reale

Collega la convalida allo scanner, l'aggiornamento del saldo e le notifiche del Wallet in un flusso fluido in cassa su Apple Wallet e Google Wallet.

Passinstance Team
Passinstance Team

Wallet pass platform team

2026-08-165 min di lettura
Immagine di copertina per Accredito immediato dei punti fedeltà alla cassa (POS): architettura Wallet in tempo reale

I programmi fedeltà perdono slancio quando i saldi si aggiornano in ritardo. Se un cliente completa un acquisto e i punti compaiono ore dopo — o peggio, la mattina seguente via e-mail — si spezza il collegamento immediato tra spesa e ricompensa.

Con i pass per Apple Wallet e Google Wallet, l'esperienza resta continua: la cassa legge il codice del pass, il registratore conferma l'operazione e il telefono mostra l'aggiornamento del saldo sulla schermata di blocco prima ancora che il cliente lasci il bancone.

Questa guida illustra architettura tecnica, requisiti dei lettori ottici, schemi visivi dinamici e flussi di integrazione API per aggiornare puntualmente i punti alla cassa su Apple Wallet e Google Wallet.


1. Psicologia del rinforzo immediato

Nel retail fisico e nella ristorazione, il coinvolgimento si rafforza tramite feedback rapido:

  1. 1
    Ciclo di riscontro immediato: Vedere il saldo salire da 500 → 550 punti rafforza il valore percepito del programma subito dopo l'acquisto.
  2. 2
    Zero attrito: Il cliente non deve aprire un'app dedicata, attendere un codice di verifica esterno o accedere a un portale web. Il pass vive nativamente in Apple Wallet o Google Wallet ed è richiamabile con un doppio clic sul tasto laterale.
  3. 3
    Valore sempre visibile: Aggiornare i saldi subito dopo la transazione mantiene alta l'attenzione senza attendere elaborazioni notturne o timbri su carta.

2. Architettura POS end-to-end in tempo reale

Consegnare aggiornamenti puntuali richiede un'architettura a eventi che colleghi la lettura alla cassa con Apple APNs e gli aggiornamenti di Google Wallet.

Sequenza di aggiornamento in cassa

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
FLUSSO ARCHITETTURALE
ATTORI DI SISTEMA COINVOLTI
P1 Smartphone Client (Pass Wallet)
P2 Cassa / Scanner (Point of Sale)
P3 Motore Passinstance (Cloud API)
P4 APNs / Google Wallet Services
FASE 1 RICHIESTA / AZIONE Scansione Barcode/QR
FASE 2 RICHIESTA / AZIONE POST/mechanics/redeem
FASE 3 RICHIESTA / AZIONE Aggiorna punti e livello
FASE 4 RICHIESTA / AZIONE Invio aggiornamento pass
FASE 5 RISPOSTA 200 OK + Nuovo stato
FASE 6 RISPOSTA Aggiornamento pass e avviso nativo su schermo
›
"Lumora Home: +50 punti guadagnati. Saldo: 550"
  1. 1
    Acquisizione: Il cliente presenta il pass in Apple Wallet o Google Wallet. Il lettore 2D da banco decodifica il payload del codice a barre (ad esempio l'UUID cliente o ID socio).
  2. 2
    Invio della transazione: Il terminale POS trasmette l'evento a Passinstance con ID transazione, totale carrello, articoli e punto vendita.
  3. 3
    Motore regole e livelli: L'API Passinstance verifica l'evento, applica eventuali moltiplicatori di punti (es. 2x su categorie promozionali) e valuta l'avanzamento di livello.
  4. 4
    Invio aggiornamento Wallet: Passinstance invia una notifica Apple Push Notification (APNs) ai dispositivi iOS e un aggiornamento REST Google Wallet ai dispositivi Android.
  5. 5
    Aggiornamento sul dispositivo: Il sistema operativo scarica il .pkpass o il JSON Google Wallet aggiornato, aggiorna il saldo visibile e mostra l'avviso su schermata di blocco:

> Lumora Home Rewards > Punti accreditati: +50 punti guadagnati. Il tuo saldo è ora 550.


3. Progressione visiva dinamica dei livelli

Un pass statico viene presto trascurato. I pass dinamici aggiornano il proprio aspetto in base ai progressi del cliente e allo stato VIP.

Transizioni visive di stato

Elemento / LivelloLivello BaseLivello Oro VIPLivello Platino Elite
Colore testata#1b2d3c (Blu navy)#D4AF37 (Oro satinato)#020E25 (Ardesia notte)
Immagine stripLogo minimal del brandGrafica oro metallizzatoGrafica olografica platino
Campo saldo240 pt1.250 pt4.800 pt
Vantaggio attivoRaccolta standardMoltiplicatore 1,25x + Spedizione gratisMoltiplicatore 2,0x + Assistenza dedicata
Formato codiceQR Code / Aztec / PDF417QR Code / Aztec / PDF417 (NFC opzionale su hardware compatibile)QR Code / Aztec / PDF417 (NFC opzionale su hardware compatibile)

Quando un cliente supera la soglia in cassa, Passinstance aggiorna dinamicamente colori, immagini strip ed etichette del livello sul pass.


4. Configurazione hardware e scanner consigliati

Non tutti i lettori leggono allo stesso modo lo schermo di uno smartphone: servono lettori ottici 2D a immagine tarati per superfici in vetro riflettenti.

Buone pratiche hardware

  1. 1
    Tipologia di scanner:

- Consigliati: Scanner imager ottici 2D (Zebra DS9308, Honeywell Genesis 7580g, Datalogic Magellan). - Da evitare: Vecchi lettori laser 1D (il fascio laser rimbalza sul vetro del display e non decodifica i display).

  1. 2
    Luminosità e contrasto:

- Apple Wallet alza automaticamente al massimo la luminosità quando apri un pass. - Usa codici a barre monocromatici ad alto contrasto (nero su fondo bianco) per una lettura affidabile al primo passaggio.

  1. 3
    Resilienza alle interruzioni di rete:

- In caso di momentanea assenza di connessione in negozio, il POS può accodare localmente gli eventi fedeltà e inviarli a Passinstance appena la rete torna disponibile.


5. Schema di integrazione API REST

Collegare gli aggiornamenti punti in tempo reale al tuo POS o backend e-commerce richiede una sola chiamata autenticata:

Endpoint di accredito punti

BASH
curl -X POST https://api.passinstance.com/api/v1/mechanics/redeem \
  -H "X-API-Key: pi_live_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{
    "passId": "pass_99847291",
    "mechanicId": "mech_loyalty_points",
    "action": "EARN",
    "amount": 50,
    "referenceId": "TXN_8849204"
  }'

Risposta di esempio

JSON
{
  "status": "APPLIED",
  "passId": "pass_99847291",
  "balance": 550,
  "tier": "Signature Tier",
  "updatedAt": "2026-08-16T15:42:01.120Z"
}

6. Indicatori chiave da monitorare

Per valutare l'andamento del programma fedeltà alla cassa, osserva questi indicatori nella dashboard e nei report del POS:

  • Visibilità consegna aggiornamenti: Verifica che le richieste di aggiornamento APNs e Google Wallet vengano completate correttamente dopo la scansione in cassa.
  • Tasso di scansione in cassa: Quota di transazioni alla cassa in cui il cliente presenta il proprio pass Wallet.
  • Tasso di ritorno nello stesso mese: Frequenza con cui i clienti tornano entro 30 giorni dall'aggiornamento del saldo.
  • Ritenzione del pass: Quota di pass emessi che rimangono attivi nei wallet dei clienti nel tempo.

Conclusione e passi successivi

Gli aggiornamenti puntuali dei punti trasformano i pass fedeltà in un collegamento concreto tra cassa e smartphone. Abbinando lettori ottici 2D alle meccaniche e alle API di Passinstance, il tuo team retail riduce la dipendenza dalle tessere in plastica e costruisce un flusso ripetibile per i clienti.

Pronto ad attivare la fedeltà Wallet nei tuoi negozi? Consulta la Documentazione API REST oppure richiedi un confronto con il nostro team tecnico.

Demo interattiva dal vivo
Apple Wallet e Google Wallet

Prova un vero pass Wallet sul tuo smartphone

Prova in prima persona come funzionano i pass digitali. Scansiona con la fotocamera o tocca qui sotto per aggiungere il pass in Apple Wallet o Google Wallet.

Artisan RoastersCafé & F&B
Test QR code for Artisan Roasters

Scansiona con la fotocamera

Correlato in questo argomento

Fedeltà, carte a timbri e offerte

Apri hub di argomenti

Pronto a lanciare il tuo programma di carte wallet?

Crea il tuo account, progetta il tuo modello di carta e testa carta reali direttamente in Apple Wallet e Google Wallet.