Koppel je kassa aan je loyaliteitsprogramma
BonusQR werkt zelfstandig met een telefoon als scanner. Wil je dat je kassa ook de loyaliteit afhandelt, dan kan je kassaleverancier die koppelen via onze gedocumenteerde REST API – de kassa scant de code van de klant, verrekent de korting en wisselt beloningen in, in één stap.
- Gedocumenteerde REST API
- Kortingen en beloningen aan de kassa
- Optioneel – BonusQR werkt ook zonder

Klantenkaart gescand – 10% korting verrekend
Wat is een kassakoppeling voor loyaliteit?
Met een kassakoppeling communiceert je kassa met je loyaliteitsprogramma. In plaats van in een aparte app te scannen, scant je personeel de QR-code van de klantenkaart aan de kassa en verwerkt de kassa wat het programma oplevert.
BonusQR biedt hiervoor een REST API. De kassa stuurt de gescande code en zo nodig het bedrag van de rekening. BonusQR antwoordt wat er moet gebeuren – een korting in procenten of als vast bedrag verrekenen, een coupon of puntenbeloning inwisselen – plus kant-en-klare meldingen voor het personeel.
De koppeling is optioneel en wordt als maatwerkproject met je kassaleverancier opgezet. API-sleutels worden door BonusQR uitgegeven en voor de koppeling krijg je een aparte offerte.
Wat je kassa krijgt uit één scan
Een kijkje in de interactieve API-documentatie waarmee je kassaleverancier je kassa koppelt.
- 1
De klant herkennen
De kassa scant de QR-code van de klantenkaart en krijgt de naam, het bezoeknummer en de saldi van de klant.
- 2
Kortingen verrekenen
Kortingen in procenten of als vast bedrag komen terug als acties die de kassa op de rekening toepast.
- 3
Beloningen inwisselen
Coupons, puntenbeloningen en betalen met cashbacktegoed worden direct aan de kassa ingewisseld.
- 4
Meldingen voor het personeel
Elk antwoord bevat kant-en-klare meldingen voor het personeel in de taal van je zaak.
/api/pos/configInstellingen van het loyaliteitsprogramma voor de kassa/api/pos/scanEen code scannen aan de kassa{ "code": "12345", "bill_amount": 12.50 }Responses{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "Sanne de Vries",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "Leden van de klantenclub"
}],
"messages": [{ 4
"level": "warning",
"title": "10% korting",
"lines": ["Verreken die op de rekening."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}Bedrag van de rekening of aantal artikelen doorgeven/api/pos/scan/{scan_id}/cancelEen openstaande scan annulerenJe kassaleverancier krijgt interactieve API-documentatie en een demokassa om de koppeling op te testen.
Zo werkt de koppeling
Zo verloopt één aankoop met een gekoppelde kassa.
- KlantKassaLaat de QR-code van de klantenkaart zien
- KassaBonusQRStuurt de gescande code
POST /api/pos/scan - BonusQRKassaVraagt zo nodig het bedrag
input_required - KassaBonusQRAntwoordt met het bedrag dat de klant betaalt
POST /api/pos/scan/{scan_id} - BonusQRKassaGeeft korting, beloningen en meldingen terug
completed - KassaVerrekent de korting en rondt de verkoop af
- BonusQRKlantZiet stempels, punten en beloningen in de app
De koppeling is zo ontworpen dat loyaliteit een betaling nooit ophoudt: antwoordt BonusQR niet, dan gaat de verkoop gewoon door.
Zonder koppeling scant je personeel gewoon met een telefoon of tablet – BonusQR werkt volledig zelfstandig.
Werkt met elk loyaliteitsprogramma
De API begrijpt alle programma’s in je aanbod. Bijvoorbeeld:
Beloningen die aan de kassa zijn verdiend, verschijnen voor het volgende bezoek in de app van de klant.
Stempelkaart – de kassa stuurt het aantal artikelen
Vaste korting – een percentage van de rekening
Cashback – het tegoed betaalt de rekening als korting op het bedrag
Beloningscoupon – ingewisseld bij het afrekenen
Punten – een beloning uit de catalogus, ingewisseld aan de kassa
Beloning op basis van besteding – de rekening telt mee voor de volgende coupon
REST APIGemaakt voor het echte afrekenen
De kassa scant bij het afrekenen. Heeft BonusQR meer nodig – het bedrag van de rekening of het aantal artikelen – dan vraagt het daarom en antwoordt de kassa. Een openstaande scan kan worden geannuleerd, en de verkoop wordt nooit geblokkeerd.
- Duidelijke statussen: voltooid, invoer vereist, mislukt
- Openstaande scans kunnen worden geannuleerd
- Bedragen in de valuta van je zaak
- Tot 60 verzoeken per minuut per sleutel
Kassakoppeling vs. de BonusQR-scanner
Beide werken. Kies wat bij je toonbank past.
Kassakoppeling
- Inrichting
- Maatwerkproject met je kassaleverancier
- Waar het personeel scant
- Aan de kassa
- Kortingen
- Automatisch verrekend door de kassa
- Prijs
- Aparte offerte
BonusQR-scanner
- Inrichting
- Klaar in een paar minuten
- Waar het personeel scant
- Met een telefoon, tablet of toonbankscanner
- Kortingen
- Getoond aan het personeel, dat ze verrekent
- Prijs
- Inbegrepen in elk abonnement
Vragen over de kassakoppeling
Wat ondernemers en kassaleveranciers het vaakst vragen.
Heb ik een kassakoppeling nodig om BonusQR te gebruiken?
Nee. BonusQR werkt volledig zelfstandig – je personeel scant de codes van klanten met een telefoon, tablet of toonbankscanner. De koppeling is optioneel.
Welke kassasystemen kunnen worden gekoppeld?
Elk systeem waarvan de leverancier een REST API kan aanroepen. BonusQR heeft geen kant-en-klare plug-ins voor specifieke kassa’s; je leverancier koppelt met behulp van onze documentatie.
Wat kost de koppeling?
Het is een maatwerkproject, dus je krijgt een aparte offerte. Schrijf ons en we stellen die samen met je kassaleverancier op.
Hoe krijgen we API-sleutels?
BonusQR geeft ze op aanvraag uit. Een sleutel kan worden beperkt tot één vestiging van je zaak.
Wat krijgt de kassa terug na een scan?
De naam, het bezoeknummer en de saldi van de klant, de acties die moeten worden toegepast – een korting in procenten of als vast bedrag, een coupon of een puntenbeloning –, de verdiende beloningen en kant-en-klare meldingen voor het personeel.
Wat als de kassa meer informatie nodig heeft?
Dan vraagt BonusQR daarom – bijvoorbeeld het bedrag van de rekening of het aantal artikelen – en antwoordt de kassa. Een openstaande scan kan ook worden geannuleerd.
Is er documentatie?
Ja. Er is interactieve API-documentatie, samen met een demokassa die je leverancier kan gebruiken om te testen.
En webshops?
Voor WooCommerce en Shopify zijn er kant-en-klare integraties in het Basic-abonnement.
Loyaliteit direct aan je kassa?
Laat ons weten welke kassa je gebruikt en we maken een offerte voor de koppeling.