BON BON mit Lightspeed verbinden

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.

Voraussetzungen:

Das brauchst du für
die Aktivierung

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.

  • Kontakt zum Lightspeed Support
    Für die erstmalige Konfiguration benötigst du außerdem den Lightspeed Support.

1. Konfiguration durch 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.

Set-up:
Erste Aktivierung im Lightspeed Backoffice

1. Aktivierung

Bitte aktiviere die Integration über dein Lightspeed Backoffice. Klicke hierfür auf den roten Button „Bei Lightspeed einloggen und Schnittstelle freischalten“.

2. Zugriffserteilung

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.

2. Konfigurationen im Lightspeed Backoffice

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.

2.1 Eine neue Zahlungsart hinzufügen

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

2.2 Neue Zahlungsart auf der Kasse ausblenden

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.

2.3 Web-Extension hinzufügen

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:

  • Name: BON BON Gutscheine
  • URL: [Sie erhalten diese URL von BON BON oder sobald Sie in Ihrem Konto eingeloggt sind]
  • Einen JavaScript-Kontext für die geladene Seite bereitstellen: Ja

2.4 Web-Extension mit dem Menü verknüpfen

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.

2.5 Kassengeräte neu konfigurieren

Aktualisiere alle deine Kassengeräte, damit sie die neueste Konfiguration laden.

3. Die Integration testen

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.

3.1 Eine Einlösung testen

Um den Einlösevorgang zu testen, folge diesen Schritten:

  1. Verwende einen Test-Gutschein, den du von deinem BON BON Account Manager erhalten hast.
  2. Öffne die BON BON Web-Extension an deiner Kasse, löse den Test-Gutschein für eine Bestellung ein und schließe die Bestellung ab.
  3. Überprüfe dein BON BON Dashboard, um sicherzustellen, dass das Gutscheinguthaben erfolgreich abgezogen wurde.
  4. Storniere die Testbestellung an deiner Kasse.
  5. Prüfe anschließend dein BON BON Dashboard erneut, um sicherzustellen, dass das Gutscheinguthaben vollständig wiederhergestellt wurde.

Ö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

Welche Lightspeed-Version unterstützt BON BON?

BON BON ist aktuell mit Lightspeed Restaurant POS K-Series kompatibel.

Was kostet die BON BON Schnittstelle für Lightspeed?

Für die BON BON Integration fallen für Lightspeed-Kunden keine zusätzlichen Schnittstellenkosten an.

Was benötige ich für die Einrichtung?

Du benötigst Lightspeed Restaurant POS K-Series, einen BON BON Partner-Account, Zugriff auf dein Lightspeed Backoffice und deine Lightspeed Business ID.

Ich nutze Lightspeed, aber noch kein BON BON. Was muss ich tun?

Registriere dein Restaurant zunächst bei BON BON. Anschließend kann die Lightspeed-Integration für deinen Account freigeschaltet und eingerichtet werden.

Ich nutze BON BON bereits. Wie aktiviere ich die Lightspeed-Schnittstelle?

Wenn du bereits BON BON Partner bist, kannst du direkt mit der Einrichtung starten. Folge dafür unserer Schritt-für-Schritt-Anleitung zur Lightspeed-Integration.

Wie verbinde ich BON BON mit Lightspeed?

Die Einrichtung erfolgt in wenigen Schritten. BON BON wird für deinen Account freigeschaltet und anschließend mit deiner Lightspeed-Kasse verbunden. Die vollständige Einrichtung findest du oben in dieser Anleitung.

Kann ich BON BON mit mehreren Lightspeed-Standorten nutzen?

Ja. BON BON kann auch mit mehreren Standorten genutzt werden. Die erforderliche Konfiguration muss dabei für die jeweiligen Standorte eingerichtet werden.

Muss ich nach der Einrichtung etwas testen?

Ja. Führe nach der Einrichtung eine Testeinlösung durch. Prüfe anschließend in deinem BON BON Partner-Account, ob der Gutschein korrekt verbucht wurde. Teste danach auch eine Stornierung und kontrolliere, ob das Guthaben wiederhergestellt wurde.

Wie löst mein Team anschließend Gutscheine ein?

BON BON wird beim Bezahlvorgang direkt in Lightspeed geöffnet. Der Gutscheincode kann gescannt oder eingegeben und der gewünschte Betrag eingelöst werden.
Gutschein in Lightspeed einlösen – Schritt für Schritt

BON BON wird in Lightspeed nicht angezeigt. Was kann ich tun?

Prüfe zunächst, ob die BON BON Web-Extension dem richtigen Kassenmenü zugeordnet und die Konfiguration auf deinen Kassengeräten aktualisiert wurde. Besteht das Problem weiterhin, hilft dir unser Support unter partner@bon-bon.de weiter.

Der QR-Code lässt sich nicht scannen. Kann ich den Gutschein trotzdem einlösen?

Ja. Du kannst den Gutscheincode alternativ manuell eingeben und die Einlösung darüber starten.

Wo kann ich überprüfen, ob die Integration funktioniert?

Einlösungen kannst du in deinem BON BON Partner-Account unter „Letzte Aktivitäten“ nachvollziehen.