Kösse össze pénztárgépét a hűségprogramjával
A BonusQR önállóan is működik egy telefonos beolvasóval. Ha azt szeretné, hogy a kassza a hűségprogramot is kezelje, POS-szállítója dokumentált REST API-nkon keresztül csatlakoztathatja – a kassza beolvassa az ügyfél kódját, érvényesíti a kedvezményt, és egy lépésben beváltja a jutalmakat.
- Dokumentált REST API
- Kedvezmények és jutalmak a kasszánál
- Opcionális – a BonusQR nélküle is működik

Hűségkártya beolvasva – 10% kedvezmény érvényesítve
Mi az a kasszaintegráció a hűségprogramhoz?
A kasszaintegráció lehetővé teszi, hogy a pénztárgép kommunikáljon a hűségprogrammal. A személyzet nem egy külön alkalmazásban olvas be, hanem a kasszánál olvassa be az ügyfél hűségprogramos QR-kódját, a kassza pedig érvényesíti, amit a program ad.
A BonusQR ehhez REST API-t kínál. A kassza elküldi a beolvasott kódot és – ha szükséges – a számla összegét. A BonusQR válaszában megmondja, mi a teendő – százalékos vagy összegszerű kedvezmény, kupon vagy pontjutalom beváltása –, és kész üzeneteket is küld a személyzetnek.
Az integráció opcionális, és egyedi projektként valósul meg az Ön POS-szállítójával. Az API-kulcsokat a BonusQR adja ki, az integrációról pedig külön árajánlatot készítünk.
Mit kap a kassza egyetlen beolvasásból
Részlet az interaktív API-dokumentációból, amely alapján POS-szállítója csatlakoztatja a kasszáját.
- 1
Azonosítja az ügyfelet
A kassza beolvassa a hűségprogramos QR-kódot, és megkapja az ügyfél nevét, a látogatás sorszámát és az egyenlegeit.
- 2
Kedvezményeket érvényesít
A százalékos vagy összegszerű kedvezmények műveletként érkeznek vissza, amelyeket a kassza alkalmaz a számlán.
- 3
Jutalmakat vált be
A kuponokat, a pontjutalmakat és a cashback-jóváírással történő fizetést közvetlenül a kasszánál váltják be.
- 4
Üzenetek a személyzetnek
Minden válasz kész üzeneteket tartalmaz a személyzet számára, a vállalkozása nyelvén.
/api/pos/configA hűségprogram beállításai a kasszához/api/pos/scanKód beolvasása a kasszánál{ "code": "12345", "bill_amount": 12.50 }Responses{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "Nagy Katalin",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "Hűségklub-tagok"
}],
"messages": [{ 4
"level": "warning",
"title": "10% kedvezmény",
"lines": ["Vonja le a számlából."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}Számlaösszeg vagy tételszám megadása/api/pos/scan/{scan_id}/cancelFüggőben lévő beolvasás visszavonásaPOS-szállítója interaktív API-dokumentációt és egy demókasszát kap, amelyen kipróbálhatja az integrációt.
Így működik az integráció
Így zajlik egy vásárlás csatlakoztatott kasszával.
- ÜgyfélKasszaFelmutatja a hűségprogramos QR-kódját
- KasszaBonusQRElküldi a beolvasott kódot
POST /api/pos/scan - BonusQRKasszaHa kell, rákérdez a számla összegére
input_required - KasszaBonusQRMegadja az ügyfél által fizetendő összeget
POST /api/pos/scan/{scan_id} - BonusQRKasszaKedvezményt, jutalmakat és üzeneteket küld vissza
completed - KasszaÉrvényesíti a kedvezményt, és lezárja az eladást
- BonusQRÜgyfélPecséteket, pontokat és jutalmakat lát az alkalmazásban
Az integrációt úgy terveztük, hogy a hűségprogram soha ne tartsa fel a fizetést: ha a BonusQR nem válaszol, az eladás folytatódik.
Integráció nélkül a személyzet egyszerűen telefonnal vagy tablettel olvas be – a BonusQR önállóan is teljes értékűen működik.
Minden hűségprogrammal működik
Az API az ajánlata összes programját érti. Például:
A kasszánál szerzett jutalmak a következő látogatásra megjelennek az ügyfél alkalmazásában.
Bélyegzőkártya – a kassza elküldi a tételek számát
Fix kedvezmény – százalék a számlából
Cashback – a jóváírás összegszerű kedvezményként fizeti a számlát
Jutalomkupon – fizetéskor beváltva
Pontok – katalógusbeli jutalom beváltása a kasszánál
Jutalom a költésért – a számla beleszámít a következő kuponba
REST APIValódi pénztári működésre tervezve
A kassza fizetéskor olvas be. Ha a BonusQR-nek több adatra van szüksége – a számla összegére vagy a tételek számára –, rákérdez, a kassza pedig válaszol. A függőben lévő beolvasás visszavonható, az eladást pedig sosem akasztja meg.
- Egyértelmű állapotok: kész, adat szükséges, sikertelen
- A függőben lévő beolvasások visszavonhatók
- Összegek a vállalkozása pénznemében
- Kulcsonként legfeljebb 60 kérés percenként
Kasszaintegráció vs. BonusQR-beolvasó
Mindkettő működik. Válassza azt, amelyik illik a pultjához.
Kassza- és POS-integráció
- Beállítás
- Egyedi projekt a POS-szállítójával
- Hol olvas be a személyzet
- A kasszánál
- Kedvezmények
- A kassza automatikusan érvényesíti
- Ár
- Egyedi árajánlat alapján
BonusQR-beolvasó
- Beállítás
- Percek alatt kész
- Hol olvas be a személyzet
- Telefonon, tableten vagy pultra helyezett olvasóval
- Kedvezmények
- A személyzet látja, és ő érvényesíti
- Ár
- Minden csomag tartalmazza
Kérdések a kasszaintegrációról
Amit a tulajdonosok és a POS-szállítók a leggyakrabban kérdeznek.
Szükségem van kasszaintegrációra a BonusQR használatához?
Nem. A BonusQR önállóan is teljes értékűen működik – a személyzet telefonnal, tablettel vagy pultra helyezett olvasóval olvassa be az ügyfelek kódját. Az integráció opcionális.
Mely POS-rendszerek csatlakoztathatók?
Bármely rendszer, amelynek szállítója REST API-t tud hívni. A BonusQR-nek nincsenek kész bővítményei konkrét pénztárgépekhez; a szállító a dokumentációnk alapján csatlakoztatja a rendszert.
Mennyibe kerül az integráció?
Egyedi projektről van szó, ezért külön árajánlatot készítünk. Írjon nekünk, és az Ön POS-szállítójával együtt elkészítjük az ajánlatot.
Hogyan kapunk API-kulcsokat?
A BonusQR kérésre adja ki őket. Egy kulcs korlátozható a vállalkozása egyetlen üzletére.
Mit kap vissza a kassza egy beolvasás után?
Az ügyfél nevét, a látogatás sorszámát és az egyenlegeit, az alkalmazandó műveleteket – százalékos vagy összegszerű kedvezményt, kupont vagy pontjutalmat –, a megszerzett jutalmakat, valamint kész üzeneteket a személyzetnek.
Mi van, ha a kasszának több adatra van szüksége?
A BonusQR bekéri – például a számla összegét vagy a tételek számát –, a kassza pedig megadja. A függőben lévő beolvasás vissza is vonható.
Van dokumentáció?
Igen. Interaktív API-dokumentáció áll rendelkezésre, valamint egy demókassza, amelyen a szállító tesztelhet.
És a webáruházak?
A WooCommerce-hez és a Shopifyhoz kész integrációk érhetők el a Basic csomagban.
Szeretné, ha a hűségprogram közvetlenül a kasszánál működne?
Írja meg, milyen POS-rendszert használ, és elkészítjük az ajánlatot az integrációra.