1. Onboarding del Negoziante

Il successo del circuito dipende dalla corretta configurazione iniziale del punto vendita.

1

Registrazione e Verifica

Il merchant si registra come "Negozio". Deve inserire la P.IVA o il nome commerciale reale per la fatturazione e il riconoscimento utente.

2

Definizione Ratio Punti

È cruciale impostare il pointsRate (es. 1€ = 1 punto). Una volta impostato, si consiglia di non variarlo per non confondere i clienti storici.

3

Caricamento Catalogo

Inserire almeno 3 premi con soglie diverse: Entry Level (basso punteggio), Medium, e Premium (alto punteggio) per mantenere alto l'interesse.

2. Procedura di Erogazione Punti

Regola d'oro: L'erogazione dei punti deve avvenire contestualmente al pagamento per evitare contestazioni.

Il processo operativo standard in cassa è:

  • Il cassiere apre lo scanner e inquadra il QR del cliente (presente nella home del cliente).
  • Inserimento dell'importo speso. L'app calcola automaticamente i punti in base al ratio predefinito.
  • Conferma visiva: Entrambi i dispositivi (Negoziante e Cliente) mostrano l'animazione di avvenuto accredito.

2.b Integrazione Gestionali di Cassa (Solo Piano PRO)

Risparmio di tempo: L'erogazione può essere completamente automatizzata se il tuo negozio usa un software gestionale o CRM compatibile con le nostre API.

Per collegare il gestionale a FidelityApp:

  1. Assicurati di avere il Piano PRO attivo.
  2. Apri FidelityApp, vai nella scheda Configurazione (icona ingranaggio) e scorri fino alla sezione "Integrazione API".
  3. Clicca su "Genera API Key". Apparirà un codice segreto che inizia con sk_live_....
  4. Copia questa chiave e incollala nelle impostazioni del tuo software gestionale di cassa.
  5. Da quel momento, quando un cliente paga, basterà inserire o scansionare il suo codice cliente direttamente dal PC di cassa, e FidelityApp si aggiornerà da sola.
Nota di sicurezza: Non inviare mai l'API Key a persone non fidate. Chiunque abbia questa chiave può assegnare punti a nome del tuo negozio.

3. Procedura di Riscatto Premi

Attenzione: Non consegnare mai il premio fisico prima di aver scansionato il codice di riscatto (RWD-XXXX).

Azione Cliente

"Vorrei riscattare il premio X"

Il cliente clicca su "Riscatta" nella sua app. I punti vengono scalati e compare un QR Code temporaneo di validazione.

Azione Negoziante

"Certo, scansiono il codice..."

Il merchant scansiona il QR del cliente. Se l'app dà il via libera ("Successo"), il merchant consegna l'oggetto o eroga lo sconto.

4. Prevenzione Frodi

FidelityApp implementa diversi livelli di protezione:

Timeout Riscatto: I codici di riscatto scadono dopo 15 minuti. Se non convalidati, i punti tornano al cliente (o vengono persi secondo policy).

Anti-Screenshot: I QR code contengono metadati temporali. Uno screenshot di ieri non funzionerà oggi.

Audit Log: Ogni transazione è tracciata. Se un merchant sospetta abusi, può scaricare il CSV e verificare l'ID cliente specifico.

5. Risoluzione Problemi Comuni

Problema Causa Probabile Soluzione Operativa
QR non scansiona Luminosità bassa o riflessi Chiedere al cliente di alzare la luminosità (usare tasto dedicato).
Punti non aggiornati Connessione internet assente Attendere il ritorno del segnale; Firestore sincronizzerà in background.
Premio non disponibile Stock terminato Il merchant deve disattivare il premio dalla dashboard premi.