Qu'est-ce qu'une notification en temps réel ?
Une notification en temps réel, c'est le message que Lightspeed envoie à Badger dès qu'une vente s'ouvre, change ou se ferme, c'est ce qui permet à Badger de savoir qu'un client vient de passer en caisse.
Pourquoi c'est indispensable
Badger n'interroge pas votre caisse en continu : c'est Lightspeed qui prévient Badger à chaque fois qu'une vente s'ouvre, change ou se ferme. Ces messages s'appellent les notifications en temps réel.
Tant que les notifications ne sont pas activées pour votre établissement, la fenêtre Badger fonctionne normalement mais aucune vente encaissée ne donne de points. C'est la cause la plus fréquente d'un « ça ne marche pas » après une installation par ailleurs correcte.
Deux cas de figure
Badger essaie d'abord de tout faire seul, depuis votre tableau de bord.
Si votre intégration Lightspeed dispose des droits nécessaires, l'activation se fait automatiquement et vous n'avez rien à envoyer. Passez directement à la vérification en bas de page.
Si Lightspeed refuse — c'est fréquent, l'API concernée n'est pas ouverte à toutes les intégrations — votre tableau de bord indique que l'activation doit être faite à la main et affiche les valeurs à utiliser. C'est là que le message ci-dessous sert.
Le message à envoyer au support Lightspeed
Copiez le texte ci-dessous dans votre demande au support Lightspeed. Il est en anglais, langue de travail du support K-Series ; envoyez-le tel quel.
Une seule chose à compléter : votre businessLocationId, l'identifiant de votre établissement dans Lightspeed. Il est affiché dans le panneau Lightspeed de votre tableau de bord Badger, à côté de l'établissement associé.
Subject: Enable realtime notifications for our business location (Badger loyalty)
Hello,
We use Badger (getbadger.ch) as our loyalty programme, integrated with our Lightspeed K-Series account. Please enable realtime notifications for our business location, so that Badger is informed when a sale is closed.
Business location ID: [businessLocationId]
Endpoint to notify:
Content-Type: application/json
Notification types required (account realtime notifications): OPEN, UPDATE and CLOSE.
If an explicit event subscription is required on your side, please subscribe this location to the order DELIVERED event. Payment SUCCESS and Account CLOSED are sent automatically to subscribed locations.
No particular authentication is required on the endpoint. It accepts POST requests and answers 200 OK.
Thank you.
Si le support Lightspeed vous demande d'ajouter des identifiants (nom d'utilisateur et mot de passe) sur l'URL, ne les inventez pas : ils sont générés par Badger et affichés dans le panneau Lightspeed de votre tableau de bord. Contactez-nous, nous vous les transmettons.
Environnement de test
Si Badger vous a mis en place sur un environnement de test avant votre passage en production, l'URL n'est pas celle ci-dessus : utilisez celle que l'équipe Badger vous a communiquée. Une notification envoyée à la mauvaise adresse n'est jamais traitée.