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
Pénztáros egy kávézó POS-termináljánál és egy ügyfél hűségprogramos QR-kóddal
POSmost

Hűségkártya beolvasva – 10% kedvezmény érvényesítve

A kassza beolvassa a hűségkódot, és maga alkalmazza az eredményt.

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. 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. 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. 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. 4

    Üzenetek a személyzetnek

    Minden válasz kész üzeneteket tartalmaz a személyzet számára, a vállalkozása nyelvén.

BonusQR APIOAS 3.0
POSOlvassa be az ügyfél kódját a kasszánál, és kapja vissza, mi a kassza teendője.
GET/api/pos/configA hűségprogram beállításai a kasszához
POST/api/pos/scanKód beolvasása a kasszánál
Request body application/json
{ "code": "12345", "bill_amount": 12.50 }
Responses
200completedinput_requiredvoucher3failed
{
  "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": []
}
POST/api/pos/scan/{scan_id}Számlaösszeg vagy tételszám megadása
POST/api/pos/scan/{scan_id}/cancelFüggőben lévő beolvasás visszavonása

POS-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élKasszaBonusQR
  1. ÜgyfélKasszaFelmutatja a hűségprogramos QR-kódját
  2. KasszaBonusQRElküldi a beolvasott kódotPOST /api/pos/scan
  3. BonusQRKasszaHa kell, rákérdez a számla összegéreinput_required
  4. KasszaBonusQRMegadja az ügyfél által fizetendő összegetPOST /api/pos/scan/{scan_id}
  5. BonusQRKasszaKedvezményt, jutalmakat és üzeneteket küld visszacompleted
  6. KasszaÉrvényesíti a kedvezményt, és lezárja az eladást
  7. 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.

Kávézómost

Bélyegzőkártya – a kassza elküldi a tételek számát

Fodrászatmost

Fix kedvezmény – százalék a számlából

Étteremmost

Cashback – a jóváírás összegszerű kedvezményként fizeti a számlát

Pékségmost

Jutalomkupon – fizetéskor beváltva

Edzőteremmost

Pontok – katalógusbeli jutalom beváltása a kasszánál

Üzletmost

Jutalom a költésért – a számla beleszámít a következő kuponba

POS-érintőképernyő és QR-olvasó, amely egy ügyfél hűségkódját olvassa beREST API

Való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
vs.

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.