Collegate la cassa al vostro programma fedeltà
BonusQR funziona da solo con lo scanner sul telefono. Se volete che anche la cassa gestisca la fedeltà, il fornitore del vostro sistema di cassa può collegarla tramite la nostra REST API documentata – la cassa scansiona il codice del cliente, applica lo sconto e riscatta i premi in un solo passaggio.
- REST API documentata
- Sconti e premi direttamente in cassa
- Facoltativa: BonusQR funziona anche senza

Carta fedeltà scansionata – sconto del 10% applicato
Che cos’è l’integrazione del programma fedeltà con la cassa?
L’integrazione con la cassa mette in comunicazione il vostro sistema di cassa con il programma fedeltà. Invece di scansionare con un’app separata, il personale scansiona alla cassa il codice QR fedeltà del cliente e la cassa applica ciò che prevede il programma.
Per questo BonusQR offre una REST API. La cassa invia il codice scansionato e, se serve, l’importo dello scontrino. BonusQR risponde con cosa fare – applicare uno sconto in percentuale o in importo, riscattare un coupon o un premio a punti – più messaggi già pronti per il personale.
L’integrazione è facoltativa e si realizza come progetto su misura con il fornitore del vostro sistema di cassa. Le chiavi API sono rilasciate da BonusQR e l’integrazione ha un preventivo a parte.
Cosa riceve la vostra cassa da una sola scansione
Uno sguardo alla documentazione API interattiva con cui il fornitore del vostro sistema di cassa collega la cassa.
- 1
Riconoscere il cliente
La cassa scansiona il codice QR fedeltà e riceve il nome del cliente, il numero di visita e i saldi.
- 2
Applicare sconti
Gli sconti in percentuale o in importo tornano come azioni che la cassa applica al conto.
- 3
Riscattare premi
Coupon, premi a punti e pagamenti con il credito cashback si riscattano direttamente alla cassa.
- 4
Messaggi per il personale
Ogni risposta include messaggi pronti per il personale nella lingua della vostra attività.
/api/pos/configImpostazioni del programma fedeltà per la cassa/api/pos/scanScansionare un codice alla cassa{ "code": "12345", "bill_amount": 12.50 }Responses{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "Giulia Rossi",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "Iscritti al club fedeltà"
}],
"messages": [{ 4
"level": "warning",
"title": "Sconto 10%",
"lines": ["Da scalare dal conto."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}Inviare l’importo dello scontrino o il numero di articoli/api/pos/scan/{scan_id}/cancelAnnullare una scansione in sospesoIl fornitore del vostro sistema di cassa ha a disposizione la documentazione API interattiva e una cassa demo su cui provare l’integrazione.
Come funziona l’integrazione
Ecco come si svolge un acquisto con la cassa collegata.
- ClienteCassaMostra il suo codice QR fedeltà
- CassaBonusQRInvia il codice scansionato
POST /api/pos/scan - BonusQRCassaSe serve, chiede l’importo dello scontrino
input_required - CassaBonusQRRisponde con l’importo pagato dal cliente
POST /api/pos/scan/{scan_id} - BonusQRCassaRestituisce sconto, premi e messaggi per il personale
completed - CassaApplica lo sconto e chiude la vendita
- BonusQRClienteVede timbri, punti e premi nell’app
L’integrazione è progettata perché la fedeltà non blocchi mai un pagamento: se BonusQR non risponde, la vendita prosegue.
Senza integrazione, il personale scansiona semplicemente con un telefono o un tablet – BonusQR funziona in modo del tutto autonomo.
Funziona con ogni programma fedeltà
L’API riconosce tutti i programmi della vostra offerta. Per esempio:
I premi guadagnati alla cassa compaiono nell’app del cliente per la visita successiva.
Tessera a timbri – la cassa invia il numero di articoli
Sconto fisso – una percentuale sul conto
Cashback – il credito paga il conto come sconto in importo
Coupon premio – riscattato al pagamento
Punti – un premio del catalogo riscattato alla cassa
Premio per la spesa – lo scontrino conta per il prossimo coupon
REST APIPensata per il pagamento vero e proprio
La cassa scansiona al momento del pagamento. Se a BonusQR serve altro – l’importo dello scontrino o il numero di articoli – lo chiede e la cassa risponde. Una scansione in sospeso si può annullare e la vendita non viene mai bloccata.
- Stati chiari: completata, dati richiesti, non riuscita
- Le scansioni in sospeso si possono annullare
- Importi nella valuta della vostra attività
- Fino a 60 richieste al minuto per chiave
Integrazione con la cassa vs scanner BonusQR
Funzionano entrambi. Scegliete ciò che si adatta al vostro bancone.
Integrazione con la cassa
- Attivazione
- Un progetto su misura con il fornitore della cassa
- Dove scansiona il personale
- Alla cassa
- Sconti
- Applicati in automatico dalla cassa
- Prezzo
- Preventivo a parte
Scanner BonusQR
- Attivazione
- Pronto in pochi minuti
- Dove scansiona il personale
- Su telefono, tablet o scanner da banco
- Sconti
- Mostrati al personale, che li applica
- Prezzo
- Incluso in ogni piano
Domande sull’integrazione con la cassa
Cosa chiedono più spesso titolari e fornitori di sistemi di cassa.
Serve l’integrazione con la cassa per usare BonusQR?
No. BonusQR funziona in modo del tutto autonomo: il personale scansiona i codici dei clienti con un telefono, un tablet o uno scanner da banco. L’integrazione è facoltativa.
Quali sistemi di cassa si possono collegare?
Qualsiasi sistema il cui fornitore sia in grado di chiamare una REST API. BonusQR non ha plugin pronti per specifici registratori di cassa: il vostro fornitore effettua il collegamento con la nostra documentazione.
Quanto costa l’integrazione?
È un progetto su misura, quindi ha un preventivo a parte. Scriveteci e prepareremo un’offerta insieme al fornitore del vostro sistema di cassa.
Come otteniamo le chiavi API?
Le rilascia BonusQR su richiesta. Una chiave può essere limitata a una sola sede della vostra attività.
Cosa riceve la cassa dopo una scansione?
Il nome del cliente, il numero di visita e i saldi, le azioni da applicare – uno sconto in percentuale o in importo, un coupon o un premio a punti –, i premi guadagnati e messaggi pronti per il personale.
E se alla cassa servono altre informazioni?
BonusQR le chiede – per esempio l’importo dello scontrino o il numero di articoli – e la cassa risponde. Una scansione in sospeso si può anche annullare.
Esiste una documentazione?
Sì. È disponibile una documentazione API interattiva, insieme a una cassa demo che il vostro fornitore può usare per i test.
E per i negozi online?
Per WooCommerce e Shopify ci sono integrazioni pronte nel piano Basic.
Volete la fedeltà direttamente alla cassa?
Diteci quale sistema di cassa usate e prepareremo un’offerta per l’integrazione.