Torna al blogGenerale

Cosa cambia un’API per un programma fedeltà

Con l’API di Fideliya, sul piano Enterprise a partire da 99,99 € al mese, la tua cassa fa il lavoro della fedeltà mentre il cliente paga: registra la visita o i punti, iscrive un nuovo cliente dalla tua cassa e prende un pagamento con carta regalo, mentre la tessera si aggiorna da sola nel suo Apple Wallet o Google Wallet.

La tua cassa registra la visita mentre il cliente paga, iscrive i nuovi clienti e prende le carte regalo: cosa fa oggi l’API di Fideliya.

Di Zakaria Fahim · 22 ottobre 2026 · 6 min di lettura

La tua cassa vede già ogni cliente abituale che torna: è lì che paga. Con l’API di Fideliya, quel momento può fare anche il lavoro della fedeltà. La visita o i punti vengono registrati al pagamento, la tessera nel suo Apple Wallet o Google Wallet si aggiorna da sola, e il tuo team ha una cosa in meno da ricordare quando il banco è pieno.

Una tessera fedeltà arriva in Apple Wallet e Google Wallet, senza nulla da installare.

Tre cose che cambiano al tuo banco

La tua cassa registra la visita mentre il cliente paga

L’API registra una scansione esattamente come lo scanner di Fideliya: una visita, punti aggiunti o tolti, o un premio usato. Valgono le stesse regole. I punti oltre l’obiettivo, o una sottrazione oltre il saldo, vengono rifiutati invece che arrotondati, e una seconda visita pochi minuti dopo la prima aspetta una conferma, come lo scanner chiede "stessa visita o nuova visita?". La tessera del cliente si aggiorna sul suo telefono, come dopo qualsiasi scansione.

Nuovi clienti dalla tua cassa

La tua cassa può iscrivere un cliente a una delle tue tessere con il suo nome e la sua email, come fa il modulo al banco. Vale il limite di clienti del tuo piano, e un’email già presente su quella tessera viene rifiutata, così nessuno compare due volte.

Carte regalo pagate alla cassa

Un cliente paga con una carta regalo Fideliya e la tua cassa scala l’importo dal saldo: mai più del saldo, con il tuo numero di scontrino conservato accanto al pagamento. La carta regalo nel suo wallet mostra quanto resta, e lui riceve la sua ricevuta. Il tuo sistema può anche emettere una carta regalo, che arriva via email a chi la riceve.

Cos’altro legge e fa l’API

  • Le letture. Il tuo account, le tue tessere, i tuoi clienti con i loro saldi, le scansioni, le tue sedi, gli inviti, le carte regalo con ogni pagamento preso da esse, e i numeri che la tua pagina Statistiche mostra per gli stessi giorni, calcolati con lo stesso codice.
  • I messaggi ai tuoi clienti. Un messaggio ai titolari di una tessera viene prima visualizzato in anteprima, e non parte nulla finché non lo confermi; uno programmato si può annullare. Ricevi una notifica e un’email che indicano la chiave che l’ha inviato.

Chi lo configura, e con cosa

Il tuo sviluppatore, o l’azienda che ti fornisce la cassa, la collega una volta. Crea una chiave nella dashboard di Fideliya e sceglie cosa può fare; prendere pagamenti con carta regalo è un permesso a parte. Tutto ciò che serve è nella documentazione per sviluppatori: ogni operazione nel riferimento dell’API, con il significato di ogni errore.

La tua cassa si collega se può chiamare un’API o ricevere webhook. È l’unica domanda da fare a chi te la fornisce.

Nell’altra direzione: i webhook

L’API sono i tuoi sistemi che parlano con Fideliya. I webhook sono Fideliya che avvisa i tuoi sistemi, nel momento stesso, che un cliente si è iscritto, una tessera è stata scansionata, un premio è stato raggiunto o una carta regalo è stata spesa. Gli eventi e cosa costruirci sopra sono in i webhook del programma fedeltà, e l’elenco completo nella documentazione dei webhook.

Quanto costa, e cosa notano i tuoi clienti

L’API e i webhook sono inclusi nel piano Enterprise: a partire da 99,99 € al mese, o 79,99 € al mese con pagamento annuale, con clienti e sedi illimitati, 10 posti per il team e 10 messaggi ai tuoi clienti al mese. La vista del titolare su una cassa collegata è su collegare Fideliya al tuo punto vendita, e ogni piano nella pagina dei prezzi.

I tuoi clienti notano una sola cosa: la loro tessera è aggiornata nel momento in cui pagano. La tengono in Apple Wallet o Google Wallet, senza app da scaricare né account o password da creare.

Domande frequenti

La mia cassa può aggiungere i punti fedeltà quando il cliente paga?

Sì, se la tua cassa può chiamare un’API. Sul piano Enterprise di Fideliya registra la visita o i punti al momento del pagamento, con le stesse regole dello scanner, e la tessera si aggiorna da sola nell’Apple Wallet o nel Google Wallet del cliente.

Fideliya funziona con la mia cassa?

Funziona con una cassa che può chiamare un’API o ricevere webhook. Il tuo sviluppatore, o l’azienda che ti fornisce la cassa, la collega una volta con una chiave creata nella dashboard di Fideliya, seguendo la documentazione per sviluppatori.

Quale piano include l’API di Fideliya?

Il piano Enterprise di Fideliya, a partire da 99,99 € al mese o 79,99 € al mese con pagamento annuale. Include anche i webhook, clienti e sedi illimitati e 10 posti per il team.

I miei clienti possono pagare con una carta regalo alla mia cassa?

Sì. La tua cassa scala l’importo dal saldo della carta regalo Fideliya, mai più di quanto contiene, e conserva il tuo numero di scontrino con il pagamento. La carta regalo nel wallet del cliente mostra quanto resta.

Mi serve uno sviluppatore per usare l’API?

Ti serve qualcuno che sappia collegare la tua cassa: il tuo sviluppatore o l’azienda che te la fornisce. Crea una chiave nella dashboard di Fideliya, e la documentazione per sviluppatori descrive ogni operazione e ogni errore.

Con l’API posso anche togliere punti a un cliente?

Sì, con le stesse regole dello scanner di Fideliya: la tua cassa aggiunge o toglie punti, e una sottrazione oltre il saldo viene rifiutata invece che arrotondata. La tessera del cliente si aggiorna sul suo telefono, come dopo qualsiasi scansione.

La mia cassa può iscrivere un nuovo cliente alla tessera?

Sì. Con l’API di Fideliya la tua cassa iscrive un cliente a una delle tue tessere con il suo nome e la sua email, come fa il modulo al banco. Vale il limite di clienti del tuo piano, e un’email già presente su quella tessera viene rifiutata, così nessuno compare due volte.

La tua tessera fedeltà, pronta in cinque minuti

Nessuna carta di credito. Se i tuoi clienti abituali non si iscrivono, non paghi niente.

Prova gratis per 14 giorni

See a pass in your wallet in ten seconds

Confronta Fideliya con le alternativeCalcola il ritorno
Add to Apple WalletAdd to Google Wallet
© 2026 Fideliya. All rights reserved.
Cosa cambia un’API per un programma fedeltà — Fideliya Blog