L’API Loyaltify permet à votre développeur de connecter Loyaltify à vos propres systèmes, comme une caisse, un outil de réservation ou votre site web. Par exemple, une caisse peut ajouter des points automatiquement après chaque vente, sans que votre équipe ait besoin de scanner la carte.
Ce guide s’adresse à vous et à votre développeur : où trouver votre clé API, où se trouve la documentation et ce qu’il est utile de savoir avant de commencer le développement.
💡 Bon à savoir : Cette fonctionnalité fait partie de la formule Advanced. Elle cesse de fonctionner si vous passez à une formule inférieure.
Trouver votre clé API
Dans Loyaltify, cliquez sur votre nom en haut à droite.
Allez dans Profil et copiez votre clé API.
Vous ne voyez pas de clé API sur votre compte Advanced ? Contactez l’assistance via le chat en direct et nous l’activerons pour vous.
⚠️ Traitez votre clé API comme un mot de passe. Ne la partagez qu’avec votre développeur, et ne la mettez jamais dans le code d’un site web ni dans un lien.
Consulter la documentation
La documentation complète de l’API se trouve sur api.loyaltify.io/api-docs. Quelques points que votre développeur doit connaître :
Envoyez la clé API dans l’en-tête
X-API-Keyavec chaque requête.Utilisez l’adresse de production,
api.loyaltify.io.Si vous ouvrez un point de terminaison dans votre navigateur, il affiche « Unauthorized ». C’est normal, car le navigateur n’envoie pas votre clé.
Ce que vous pouvez faire avec l’API
Inscrire des clients via l’un de vos formulaires d’inscription, par exemple depuis votre propre site web ou votre application. La réponse inclut les liens de la carte du client pour Apple Wallet et Google Wallet.
Rechercher des clients et leurs transactions, modifier leurs informations ou les supprimer.
Ajouter des tampons, des points ou du crédit, ou valider des récompenses avec une requête de scan, exactement comme votre équipe le fait dans l’application Store. Ce que vous envoyez dépend du type de carte.
Bon à savoir
Le QR code de chaque carte a toujours le même format :
lytf-, l’identifiant de votre commerce, puis l’identifiant du client. Une caisse peut le lire pour retrouver le bon client.Chaque client a deux identifiants : un identifiant client court (celui de sa carte et des webhooks) et un numéro interne utilisé par certaines requêtes de l’API. La documentation explique comment retrouver l’un à partir de l’autre.
Besoin de l’identifiant de votre commerce ? Contactez l’assistance via le chat en direct.
Plusieurs sites ou caisses peuvent tous utiliser la même clé API.
Vous voulez savoir quand quelque chose se produit ? Utilisez les Webhooks pour recevoir un message chaque fois qu’un client s’inscrit ou cumule des points.
💡 Vous souhaitez que nous le développions ? Nous développons aussi des intégrations sur mesure, sur devis séparé. Contactez-nous via le chat en direct en précisant le système que vous utilisez et ce que vous souhaitez obtenir.
Besoin d’aide ?
Nous sommes là pour vous aider !
Si vous avez des questions sur l’API, contactez-nous via le chat en direct dans Loyaltify, ou utilisez le bouton de chat en bas à droite de cette page. Notre équipe se fera un plaisir de vous aider.