Diese Anleitung zeigt dir Schritt für Schritt, wie du die Lightspeed K-Series Integration einrichtest, um BON BON Gutscheine in deiner Kasse zu akzeptieren. Wenn du Fragen hast, melde dich gerne bei uns. Wir helfen dir jederzeit weiter.
Damit du BON BON mit deinem Lightspeed-Kassensystem verbinden kannst, müssen einige Voraussetzungen erfüllt sein. Halte die folgenden Informationen und Zugänge bereit.
Lightspeed-Kassensystem + Business-ID
Du benötigst das Lightspeed Restaurant POS Kassensystem der K-Series, Zugang zu deinem Backoffice sowie deine Lightspeed Business-ID.
Dein Partner-Account
Du benötigst ein aktives BON BON Partnerkonto.
.png)
Kontakt zum Lightspeed Support
Für die erstmalige Konfiguration benötigst du außerdem den Lightspeed Support.
Um die Verbindung zu aktivieren, muss eine Hintergrundbenachrichtigung (Webhook) von Lightspeed eingerichtet werden. Bitte sende dafür die folgende E-Mail an das Lightspeed Support-Team und setze uns in CC.
An: k-series.support@lightspeedhq.com
CC: partner@bon-bon.de
Betreff: Konfiguration für die Integration mit dem BON BON Gutscheinsystem
Hallo Lightspeed Support Team,
wir bitten Sie höflich, die folgende Konfiguration für unser Konto einzurichten:
Unternehmensname: [Ihr Unternehmensname]
Business ID: [Ihre Business ID]
Bitte fügen Sie eine neue Real Time Notification mit den folgenden Einstellungen für jeden Standort hinzu:
Code: bonbon
URL: https://api.bon-bon-stage.de/v1/lightspeed/notification
Condition language: criteria
Condition: this.notificationType=='CLOSE'
Vielen Dank und beste Grüße,
[Ihr Name]
Hinweis:
Ersetze die Informationen in Klammern durch deine tatsächlichen Lightspeed-Daten. In der Regel richtet der Lightspeed-Support die Verbindung innerhalb von 1–2 Tagen ein. Wenn es besonders dringend ist, kannst du dich auch telefonisch an den Lightspeed-Support wenden.
Bitte aktiviere die Integration über dein Lightspeed Backoffice. Klicke hierfür auf den roten Button „Bei Lightspeed einloggen und Schnittstelle freischalten“.
Der Link in deinem Konto führt dich direkt zum Lightspeed-Login. Nachdem du den Zugriff erteilt hast, wirst du automatisch zu deinem BON BON-Konto zurückgeleitet.
Sobald der Lightspeed-Support bestätigt hat, dass die Real Time Notification eingerichtet wurde, kannst du mit der Konfiguration deines Lightspeed Backoffice fortfahren, um BON BON Gutscheine über dein Kassensystem einzulösen.
Erstelle in deinem Lightspeed Backoffice eine neue Zahlungsart mit den folgenden Einstellungen:
Zahlungsart-Typ: Andere Zahlungsart
Code: bonbon (Es ist zwingend erforderlich, dass der Code exakt "bonbon" lautet)
Name: BON BON Gutschein
Die Zahlungsart „BON BON Gutschein“ darf nicht als regulärer manueller Zahlungs-Button auf deiner Kasse erscheinen. Um sie auszublenden, öffne deine Kassenkonfiguration, navigiere zum Reiter „Zahlungen“ und klicke auf die Zahlungsart „BON BON Gutschein“.
Der Hintergrund wird grau. Das bedeutet, dass die Zahlungsart nicht mehr unter den regulären Zahlungsoptionen angezeigt wird. Vergiss nicht, anschließend oben rechts auf „Speichern“ zu klicken.
Wenn Sie mehrere Standorte in Lightspeed haben, müssen Sie diesen und den folgenden Schritt für jeden Standort durchführen.
Erstellen Sie unter Konfiguration → Einstellungen → Web-Extensions eine neue Web-Extension mit den folgenden Details:
Gehen Sie zu Menü-Management → Menüs und fügen Sie eine neue Hauptansicht oder einen Button für Ihre Gutscheine hinzu. Fügen Sie einen neuen "Web Extension"-Button hinzu und wählen Sie die gerade erstellte "BON BON Gutscheine" Web-Extension aus. Passen Sie die Farben an, um den Button gut sichtbar zu machen.
Aktualisiere alle deine Kassengeräte, damit sie die neueste Konfiguration laden.
Nach Abschluss der Konfiguration wird dringend empfohlen, das Setup zu testen, um einen reibungslosen Ablauf zu gewährleisten. Wenn Sie mehrere Standorte haben, führen Sie bitte an jedem Standort einen Test durch.
Um den Einlösevorgang zu testen, folge diesen Schritten:
Öffne abschließend den Standard-Zahlungsbildschirm deiner Kasse und überprüfe, ob die Zahlungsart „BON BON Gutschein“ vollständig aus den regulären Zahlungsoptionen ausgeblendet ist.
Für weitere Fragen kontaktieren Sie uns: partner@bon-bon.de
Die BON BON Integration ist aktuell für Lightspeed Restaurant POS K-Series ausgelegt.
Du benötigst Lightspeed Restaurant POS K-Series, einen BON BON Partner-Account, Zugriff auf dein Lightspeed Backoffice und deine Lightspeed Business ID.
Prüfe, ob die BON BON Web-Extension dem richtigen Kassenmenü zugeordnet ist. Aktualisiere anschließend die Konfiguration auf deinen Kassengeräten.
Kein Problem: Du kannst den Gutscheincode alternativ manuell eingeben und die Einlösung darüber starten.
Prüfe, ob die Zahlungsart „BON BON Gutschein“ korrekt angelegt wurde. Wichtig: Der Code der Zahlungsart muss exakt bonbon lauten.
Bei mehreren Standorten müssen die entsprechenden Einstellungen für jeden Standort vorgenommen werden. Prüfe insbesondere Web-Extension und Standortkonfiguration.
Bei einer korrekt eingerichteten Integration sollte das Gutscheinguthaben nach der Stornierung wiederhergestellt werden. Prüfe anschließend das Guthaben bzw. die Aktivität im BON BON Partner-Account.
Ja. Ist das Gutscheinguthaben höher als der Rechnungsbetrag, wird nur der benötigte Betrag eingelöst. Das restliche Guthaben bleibt auf dem Gutschein erhalten.
Das verfügbare Gutscheinguthaben wird verwendet. Den noch offenen Rechnungsbetrag kannst du anschließend über eine andere Zahlungsart kassieren.
Bearbeitete Einlösungen kannst du in deinem BON BON Partner-Account unter „Letzte Aktivitäten“ nachvollziehen.
Ja. Bei mehreren Standorten müssen bestimmte Einrichtungsschritte allerdings für jeden Standort durchgeführt werden.
Bitte senden Sie die folgende E-Mail an das Lightspeed Support-Team (k-series.support@lightspeedhq.com) und setzen Sie uns (partner@bon-bon.de) in CC.
Betreff: Konfiguration für die Integration mit dem BON BON Gutscheinsystem
Nachricht:
Hallo Lightspeed Support Team,
Wir bitten Sie höflich, die folgende Konfiguration für unser Konto einzurichten:
Unternehmensname: [Ihr Unternehmensname]
Business ID: [Ihre Business ID]
Bitte fügen Sie eine neue Real Time Notification mit den folgenden Einstellungen für jeden Standort hinzu:
Code: bonbon
URL: https://api.bon-bon-stage.de/v1/lightspeed/notification
Condition language: criteria
Condition: this.notificationType=='CLOSE'
Vielen Dank und beste Grüße,
[Ihr Name]
Hinweis: Ersetzen Sie die Informationen in Klammern durch Ihre tatsächlichen Lightspeed-Daten. In der Regel erledigt der Lightspeed-Support diese Einrichtung innerhalb von 1-2 Tagen. Wenn es dringend ist, können Sie dort auch anrufen.
Ja, das würde ich unbedingt machen. Löse einen Testgutschein ein, schließe die Bestellung ab und prüfe anschließend im BON BON Account, ob das Guthaben korrekt reduziert wurde. Storniere danach die Bestellung und kontrolliere, ob das Guthaben wiederhergestellt wurde.
