Connectez votre caisse à votre programme de fidélité
BonusQR fonctionne seul, avec un téléphone comme scanner. Si vous voulez que votre caisse gère aussi la fidélité, votre fournisseur de caisse peut la connecter via notre API REST documentée : la caisse scanne le code du client, applique la remise et valide les récompenses en une seule étape.
- API REST documentée
- Remises et récompenses en caisse
- Facultatif : BonusQR fonctionne sans

Carte de fidélité scannée : remise de 10 % appliquée
Qu’est-ce qu’une intégration caisse pour la fidélité ?
Une intégration caisse permet à votre caisse de communiquer avec votre programme de fidélité. Au lieu de scanner dans une application séparée, le personnel scanne le QR code de fidélité du client à la caisse, et celle-ci applique ce que prévoit le programme.
BonusQR propose pour cela une API REST. La caisse envoie le code scanné et, si nécessaire, le montant de l’achat. BonusQR répond avec l’action à effectuer – appliquer une remise en pourcentage ou en montant, valider un coupon ou une récompense en points – ainsi que des messages prêts à afficher pour le personnel.
L’intégration est facultative et se met en place comme un projet sur mesure avec votre fournisseur de caisse. Les clés API sont délivrées par BonusQR et l’intégration fait l’objet d’un devis séparé.
Ce que votre caisse reçoit d’un seul scan
Un aperçu de la documentation interactive de l’API qu’utilise votre fournisseur de caisse pour connecter votre caisse.
- 1
Identifier le client
La caisse scanne le QR code de fidélité et reçoit le nom du client, son numéro de visite et ses soldes.
- 2
Appliquer les remises
Les remises en pourcentage ou en montant reviennent sous forme d’actions que la caisse applique à l’addition.
- 3
Valider les récompenses
Coupons, récompenses en points et paiement avec le crédit cashback sont validés directement en caisse.
- 4
Messages pour le personnel
Chaque réponse contient des messages prêts à afficher pour le personnel, dans la langue de votre établissement.
/api/pos/configConfiguration du programme de fidélité pour la caisse/api/pos/scanScanner un code à la caisse{ "code": "12345", "bill_amount": 12.50 }Responses{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "Marie Dubois",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "Membres du club fidélité"
}],
"messages": [{ 4
"level": "warning",
"title": "Remise de 10 %",
"lines": ["À déduire de l’addition."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}Envoyer le montant de l’achat ou le nombre d’articles/api/pos/scan/{scan_id}/cancelAnnuler un scan en attenteVotre fournisseur de caisse dispose d’une documentation interactive de l’API et d’une caisse de démonstration pour tester l’intégration.
Comment fonctionne l’intégration
Voici comment se déroule un achat avec une caisse connectée.
- ClientCaissePrésente son QR code de fidélité
- CaisseBonusQREnvoie le code scanné
POST /api/pos/scan - BonusQRCaisseDemande le montant si nécessaire
input_required - CaisseBonusQRRépond avec le montant payé par le client
POST /api/pos/scan/{scan_id} - BonusQRCaisseRenvoie remise, récompenses et messages pour le personnel
completed - CaisseApplique la remise et termine la vente
- BonusQRClientVoit tampons, points et récompenses dans l’application
L’intégration est conçue pour que la fidélité ne retarde jamais un paiement : si BonusQR ne répond pas, la vente continue.
Sans intégration, le personnel scanne simplement avec un téléphone ou une tablette : BonusQR fonctionne entièrement seul.
Compatible avec tous les programmes de fidélité
L’API comprend tous les programmes de votre offre. Par exemple :
Les récompenses gagnées en caisse apparaissent dans l’application du client pour sa prochaine visite.
Carte à tampons : la caisse envoie le nombre d’articles
Rabais fixe : un pourcentage déduit de l’addition
Cashback : le crédit règle l’addition sous forme de remise en montant
Coupon de récompense : validé au paiement
Points : une récompense du catalogue validée en caisse
Récompense pour le montant dépensé : l’achat compte pour le prochain coupon
REST APIConçu pour un vrai passage en caisse
La caisse scanne au moment du paiement. Si BonusQR a besoin de plus d’informations – le montant de l’achat ou le nombre d’articles –, il les demande et la caisse répond. Un scan en attente peut être annulé, et la vente n’est jamais bloquée.
- Statuts clairs : terminé, saisie requise, échec
- Les scans en attente peuvent être annulés
- Montants dans la devise de votre établissement
- Jusqu’à 60 requêtes par minute et par clé
Intégration caisse vs scanner BonusQR
Les deux fonctionnent. Choisissez ce qui convient à votre comptoir.
Intégration caisse
- Mise en place
- Un projet sur mesure avec votre fournisseur de caisse
- Où scanne le personnel
- À la caisse
- Remises
- Appliquées automatiquement par la caisse
- Prix
- Sur devis
Scanner BonusQR
- Mise en place
- Prêt en quelques minutes
- Où scanne le personnel
- Sur un téléphone, une tablette ou un scanner de comptoir
- Remises
- Affichées au personnel, qui les applique
- Prix
- Inclus dans tous les plans
Questions sur l’intégration caisse
Ce que demandent le plus souvent les commerçants et les fournisseurs de caisse.
Faut-il une intégration caisse pour utiliser BonusQR ?
Non. BonusQR fonctionne entièrement seul : le personnel scanne les codes des clients avec un téléphone, une tablette ou un scanner de comptoir. L’intégration est facultative.
Quels logiciels de caisse peuvent être connectés ?
Tout système dont le fournisseur peut appeler une API REST. BonusQR ne propose pas de plugins prêts à l’emploi pour des caisses précises ; votre fournisseur se connecte à l’aide de notre documentation.
Combien coûte l’intégration ?
C’est un projet sur mesure : il fait l’objet d’un devis séparé. Écrivez-nous et nous préparerons une offre avec votre fournisseur de caisse.
Comment obtenir des clés API ?
BonusQR les délivre sur demande. Une clé peut être limitée à un seul point de vente de votre établissement.
Que reçoit la caisse après un scan ?
Le nom du client, son numéro de visite et ses soldes, les actions à appliquer – une remise en pourcentage ou en montant, un coupon ou une récompense en points –, les récompenses gagnées et des messages prêts à afficher pour le personnel.
Et si la caisse a besoin de plus d’informations ?
BonusQR les demande – par exemple le montant de l’achat ou le nombre d’articles – et la caisse répond. Un scan en attente peut aussi être annulé.
Existe-t-il une documentation ?
Oui. Une documentation interactive de l’API est disponible, ainsi qu’une caisse de démonstration que votre fournisseur peut utiliser pour ses tests.
Et pour les boutiques en ligne ?
Pour WooCommerce et Shopify, des intégrations prêtes à l’emploi sont disponibles avec le plan Basic.
Vous voulez la fidélité directement à votre caisse ?
Indiquez-nous votre logiciel de caisse et nous préparerons une offre pour l’intégration.