BonusQR works on its own with a phone scanner. If you want your till to handle loyalty too, your POS supplier can connect it through our documented REST API – the till scans the customer’s code, applies the discount and redeems rewards in one step.
Loyalty card scanned – 10% discount applied
A POS loyalty integration lets your cash register talk to your loyalty program. Instead of scanning in a separate app, staff scan the customer’s loyalty QR code at the till and the register applies what the program gives.
BonusQR offers a REST API for this. The till sends the scanned code and, if needed, the bill amount. BonusQR replies with what to do – apply a percentage or amount discount, redeem a coupon or a points reward – plus ready-made messages for staff.
The integration is optional and is set up as a custom project with your POS supplier. API keys are issued by BonusQR and the integration is quoted separately.
A look at the interactive API documentation your POS supplier uses to connect your till.
The till scans the loyalty QR code and gets the customer’s name, visit number and balances.
Percentage or amount discounts come back as actions the till applies to the bill.
Coupons, points rewards and payment with cashback credit are redeemed right at the till.
Every reply includes ready-made messages for staff in your business’s language.
/api/pos/configLoyalty program set-up for the till/api/pos/scanScan a code at the till{ "code": "12345", "bill_amount": 12.50 }{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "Jane Miller",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "Loyalty club members"
}],
"messages": [{ 4
"level": "warning",
"title": "Discount 10 %",
"lines": ["Take it off the bill."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}Send the bill amount or the number of items/api/pos/scan/{scan_id}/cancelCancel a scan that is waiting for inputYour POS supplier gets interactive API documentation and a reference till to try the integration on.
This is how a single purchase goes with a connected till.
POST /api/pos/scaninput_requiredPOST /api/pos/scan/{scan_id}completedThe integration is designed so loyalty never holds up a payment: if BonusQR doesn’t answer, the sale goes on.
Without an integration, staff simply scan with a phone or tablet – BonusQR works fully on its own.
The API understands all the programs in your offer. For example:
Rewards earned at the till appear in the customer’s app for their next visit.
Stamp card – the till sends the number of items
Fixed discount – a percentage off the bill
Cashback – credit pays the bill as an amount discount
Reward coupon – redeemed at payment
Points – a reward from the catalogue redeemed at the till
Reward for Spend – the bill counts toward the next coupon
REST APIThe till scans at payment time. If BonusQR needs more – the bill amount or the number of items – it asks and the till answers. A pending scan can be cancelled, and the sale is never blocked.
Both work. Choose what fits your counter.
What owners and POS suppliers ask most often.
No. BonusQR works fully on its own – staff scan customers’ codes with a phone, tablet or counter scanner. The integration is optional.
Any system whose supplier can call a REST API. BonusQR has no ready-made plugins for specific cash registers; your supplier connects using our documentation.
It is a custom project, so it is quoted separately. Write to us and we will prepare an offer together with your POS supplier.
BonusQR issues them on request. A key can be limited to one venue of your business.
The customer’s name, visit number and balances, the actions to apply – a percentage or amount discount, a coupon or a points reward – the rewards earned, and ready-made messages for staff.
BonusQR asks for it – for example the bill amount or the number of items – and the till answers. A pending scan can also be cancelled.
Yes. Interactive API documentation is available, together with a demo till your supplier can use for testing.
For WooCommerce and Shopify there are ready-made integrations on the Basic plan.
Tell us which POS you use and we will prepare an offer for the integration.
