Comment connecter KdoFid à votre logiciel Lightspeed **Lightspeed est l'un des logiciels de caisse les plus utilisés par les commerces de proximité en Europe. En le connectant à KdoFid, vous auto...
Lightspeed est l'un des logiciels de caisse les plus utilisés par les commerces de proximité en Europe. En le connectant à KdoFid, vous automatisez entièrement la gestion de vos points de fidélité : chaque vente enregistrée dans Lightspeed crédite instantanément les points correspondants sur la carte de votre client. Ce guide vous accompagne pas à pas dans cette intégration.
Temps estimé : 20 à 30 minutes
Sommaire
- Prérequis
- Étape 1 : Générer votre clé API KdoFid
- Étape 2 : Récupérer vos identifiants Lightspeed
- Étape 3 : Configurer l'intégration dans KdoFid
- Étape 4 : Paramétrer la règle de crédit de points
- Étape 5 : Tester la connexion
- Problèmes fréquents et solutions
- Conclusion
Prérequis
Avant de commencer la connexion entre KdoFid et Lightspeed, assurez-vous de disposer de :
- Un compte KdoFid actif avec une offre Pro ou Enterprise
- Un compte Lightspeed actif (Lightspeed Retail ou Lightspeed Restaurant)
- Un accès administrateur sur les deux plateformes
- Votre programme de fidélité KdoFid déjà créé et actif
- Une connexion internet stable pendant toute la procédure
Version Lightspeed compatible : KdoFid est compatible avec Lightspeed Retail (toutes versions) et Lightspeed Restaurant (version 3 et ultérieure). Si vous utilisez l'ancienne interface Lightspeed (avant 2022), certains écrans peuvent différer légèrement de ce guide.
Étape 1 : Générer votre clé API KdoFid
Si vous n'avez pas encore de clé API KdoFid, vous devez en créer une spécifiquement pour Lightspeed.
Dans votre tableau de bord KdoFid :
- Connectez-vous à app.kdofid.fr
- Allez dans Paramètres > API et intégrations
- Cliquez sur "Créer une clé API"
- Nommez-la explicitement :
Lightspeed - [Nom de votre commerce] - Choisissez l'environnement "Production (live)"
- Cochez les permissions suivantes :
- transactions:write
- customers:read
- customers:write
- rewards:read
- rewards:write
- Cliquez sur "Générer la clé"
Copiez immédiatement la clé affichée et conservez-la — elle ne sera affichée qu'une seule fois.
Notez également votre identifiant de commerce KdoFid (Merchant ID), visible sur cette même page dans la section "Informations de l'API". Il se présente sous la forme : merchant_xxxxxxxxxxxxxxxx.
Étape 2 : Récupérer vos identifiants Lightspeed
Pour permettre à KdoFid de recevoir les données de ventes depuis Lightspeed, vous devez créer un accès API dans votre back-office Lightspeed.
Connexion au back-office Lightspeed :
- Connectez-vous à votre interface Lightspeed sur retail.lightspeedhq.com ou restaurant.lightspeedhq.com
- Dans le menu de navigation, allez dans "Configuration" (ou "Settings" si votre interface est en anglais)
- Descendez jusqu'à la section "API" ou "Intégrations tierces"
- Cliquez sur "Créer un accès API" ou "New API Key"
Remplissez le formulaire Lightspeed :
- Nom de l'application :
KdoFid Fidélité - Type d'accès : Read/Write
- Portée (Scope) : Sélectionnez au minimum :
- Sales (lecture des ventes)
- Customers (lecture et écriture clients)
- Products (lecture des produits, optionnel)
- Validez la création et notez les informations affichées :
- Client ID (ou Account ID)
- Client Secret (ou API Key)
- Account URL (URL spécifique à votre compte Lightspeed)
Attention : Ces identifiants Lightspeed sont sensibles et ne doivent jamais être partagés. Stockez-les dans le même endroit sécurisé que votre clé API KdoFid.
Étape 3 : Configurer l'intégration dans KdoFid
Maintenant que vous disposez des identifiants des deux plateformes, il est temps de configurer l'intégration depuis le tableau de bord KdoFid.
Depuis votre tableau de bord KdoFid :
- Allez dans Paramètres > API et intégrations
- Dans la section "Intégrations prêtes à l'emploi", repérez la carte "Lightspeed"
- Cliquez sur "Connecter Lightspeed"
Un assistant de configuration en 3 étapes s'ouvre :
Assistant — Étape A : Authentification Lightspeed
Renseignez les champs suivants avec les informations récupérées à l'étape 2 :
- Client ID Lightspeed : collez votre identifiant
- Client Secret Lightspeed : collez votre secret
- URL de compte Lightspeed : collez l'URL de votre compte
Cliquez sur "Tester la connexion Lightspeed". KdoFid tente d'établir la connexion. Si le test réussit, un message vert confirme : "Connexion Lightspeed établie avec succès". Si une erreur apparaît, vérifiez les identifiants saisis.
Assistant — Étape B : Authentification KdoFid
Cette étape est automatique — KdoFid utilise la clé API associée à votre session. Vérifiez simplement que le bon programme de fidélité est sélectionné dans la liste déroulante "Programme à connecter".
Assistant — Étape C : Mappage des données
Cette étape définit comment les données de Lightspeed sont interprétées par KdoFid :
- Identification client : Comment KdoFid reconnaît le client dans Lightspeed ?
- Par numéro de téléphone (recommandé si vous saisissez les numéros dans Lightspeed)
- Par adresse email
- Par numéro de carte de fidélité (si vous utilisez des cartes physiques)
- Données de vente : Quelle information de la vente Lightspeed sert à calculer les points ?
- Montant HT (hors taxes)
- Montant TTC (toutes taxes comprises — recommandé)
- Nombre d'articles (pour les commerces à points par article)
Sélectionnez vos préférences et cliquez sur "Suivant".
Étape 4 : Paramétrer la règle de crédit de points
Cette étape détermine combien de points un client gagne par euro dépensé (ou par article acheté) dans votre commerce.
Sur la page "Règles de points" de l'assistant :
Règle de base :
- Saisissez le nombre de points accordés pour chaque euro dépensé
- Exemple :
1 point par euroou10 points par euro(selon votre programme)
Montant minimum de transaction :
- Définissez un montant minimum en dessous duquel aucun point n'est accordé
- Recommandé : entre 2€ et 5€ pour éviter les micro-transactions
Exclusions (optionnel) :
- Catégories de produits exclues du calcul des points (tabac, timbres, etc.)
- Ces exclusions se basent sur les catégories que vous avez créées dans Lightspeed
Arrondi des points :
- Choisissez si les points sont calculés à la valeur plancher (ex: 1,8€ = 1 point) ou arrondie (ex: 1,8€ = 2 points)
Cliquez sur "Enregistrer les règles" puis sur "Finaliser la connexion".
KdoFid confirme l'activation : La carte Lightspeed dans votre page d'intégrations affiche désormais le statut "Connecté" (indicateur vert) avec la date de connexion et le nombre de transactions synchronisées.
Étape 5 : Tester la connexion
Avant de mettre la connexion en service auprès de vos clients, effectuez un test complet avec une transaction fictive.
Test depuis Lightspeed :
- Dans votre logiciel Lightspeed, ouvrez une session de caisse
- Créez une vente test avec un client de test (créez un client fictif si nécessaire)
- Finalisez la vente avec un montant quelconque (exemple : 10€)
Vérification dans KdoFid :
- Depuis votre tableau de bord KdoFid, allez dans Clients
- Recherchez le client de test par son email ou numéro de téléphone
- Consultez son Historique de points — la transaction Lightspeed doit apparaître dans les 30 secondes avec le bon nombre de points crédités
Vérification des logs d'intégration :
En cas de doute, consultez les logs de synchronisation :
- Allez dans Paramètres > API et intégrations > Lightspeed
- Cliquez sur l'onglet "Logs de synchronisation"
- La dernière transaction doit apparaître avec le statut "Succès"
Si le test est concluant, votre intégration est opérationnelle. Informez votre équipe de la nouvelle procédure : à chaque passage en caisse, le logiciel Lightspeed transmet automatiquement la vente à KdoFid qui crédite les points sur la carte du client.
Problèmes fréquents et solutions
Q: La connexion Lightspeed teste avec succès mais les points ne sont pas crédités lors des vraies ventes.
R: Ce problème survient souvent lorsque le client n'est pas associé à la vente dans Lightspeed. Vérifiez que votre équipe de caisse sélectionne bien le client dans Lightspeed avant de finaliser chaque vente. Sans client associé à la transaction, KdoFid ne peut pas identifier à qui créditer les points. Consultez la procédure de vente recommandée dans le guide de formation KdoFid pour le personnel de caisse, disponible depuis Paramètres > Ressources formation.
Q: Les points crédités ne correspondent pas aux montants des achats.
R: Vérifiez la règle de calcul configurée à l'étape 4. Depuis Paramètres > API et intégrations > Lightspeed > Règles, contrôlez que le bon champ de montant est utilisé (TTC ou HT) et que le ratio points/euro correspond à votre programme. Une incohérence peut aussi venir d'une différence de devise si votre compte Lightspeed est configuré dans une devise différente de l'euro.
Q: La connexion était fonctionnelle et s'est subitement interrompue.
R: Les tokens d'accès Lightspeed expirent périodiquement (généralement tous les 90 jours). KdoFid renouvelle normalement ces tokens automatiquement, mais une erreur peut survenir en cas de changement de mot de passe Lightspeed ou de révocation des droits API. Depuis Paramètres > API et intégrations > Lightspeed, cliquez sur "Reconnecter" et suivez de nouveau l'assistant d'authentification pour réinitialiser la connexion.
Conclusion
Votre programme de fidélité KdoFid est maintenant synchronisé avec Lightspeed. À chaque vente enregistrée dans votre logiciel de caisse, les points sont crédités automatiquement et instantanément sur la carte de fidélité de votre client — sans aucune action supplémentaire de votre part ni de votre équipe.
Cette automatisation présente un double avantage : elle élimine les erreurs de saisie manuelle et elle garantit que 100% de vos transactions participent à votre programme de fidélité, sans aucun oubli. C'est une des forces majeures de KdoFid pour les commerces de proximité équipés de Lightspeed.
Pensez à former brièvement vos collaborateurs à la procédure de caisse mise à jour : ils doivent désormais systématiquement associer le client à la vente dans Lightspeed pour que les points soient correctement attribués.
Prêt à lancer votre programme de fidélité ?
Article mis à jour le 2026-03-01. Catégorie : Guides pratiques. Temps de lecture : 10 min.