Points
Reliez les achats admissibles aux règles d’acquisition et affichez le solde obtenu.
Pour les développeurs
Connectez la fidélité à vos systèmes existants.
Intégrez Fair Loyalty à votre site, caisse ou application via l’API. Conservez votre expérience et reliez achats admissibles, progression et récompenses à un programme de fidélité.
La compatibilité dépend de l’accès API de votre système et des opérations Fair Loyalty disponibles.
Du système existant au résultat fidélité
Flux de référence. Validez les endpoints et autorisations de votre compte avant l’implémentation.
- 01Site, caisse ou application
- 02Adaptateur sur votre serveur
- 03API Fair Loyalty
- 04Progression et récompenses
Choisissez l’expérience. Gardez votre technologie.
Connectez les mécaniques adaptées. Vérifiez opérations et règles avec le contrat API actuel.
Tampons
Enregistrez visites ou achats admissibles et montrez la progression vers un objectif.
Récompenses
Consultez les récompenses admissibles et reliez l’utilisation au paiement après autorisation.
Cartes membres
Reliez l’identité client au compte fidélité et présentez sa carte numérique.
Construire autour de votre parcours client
Sites et e-commerce
Connectez inscriptions et commandes admissibles. Affichez la progression dans l’espace client existant.
Caisse et paiement
Utilisez un adaptateur pour les événements compatibles. Reliez achats, remboursements et identification aux opérations documentées.
Applications et portails
Présentez soldes et récompenses dans votre interface via des requêtes serveur autorisées.
Une frontière claire entre votre système et la fidélité
Gardez les identifiants sur votre serveur. L’adaptateur traduit les événements en requêtes documentées et renvoie le résultat à votre interface.
Correspondance illustrative · pas une requête API
{
"source": "pos",
"event": "purchase.completed",
"business_reference": "morrow-cafe",
"member_reference": "member-0084",
"purchase": {
"amount": 24,
"currency": "QAR"
},
"external_transaction_reference": "sale-0026"
}Préparer une intégration fiable
Protéger les identifiants
Ne mettez aucun secret dans le navigateur ou l’application. Limitez l’accès au commerce et aux opérations nécessaires.
Relier les identités
Définissez les correspondances clients, commerces, établissements et transactions externes.
Gérer les doublons
Choisissez une déduplication documentée et confirmez l’idempotence avant de réessayer.
Vérifier les annulations
Vérifiez remboursements et annulations pour préserver une progression correcte.
Tester tout le parcours
Testez inscription, acquisition, actualisation et utilisation avec des comptes autorisés.
Observer les résultats
Surveillez erreurs et rapprochement sans journaliser inutilement données personnelles ou secrets.
Ressources développeurs
Commencez par les guides disponibles. Référence API et exemples seront reliés ici une fois configurés.
Guide de configuration
Comprendre le programme avant de relier les transactions.
Guide du personnel
Découvrir identification, achats et utilisations en caisse.
IA et accès autorisé
Explorer les parcours agents et les autorisations.
Référence APIBientôt
Exemples d’intégrationBientôt
Catalogue webhooksBientôt
Questions d’intégration
Peut-on connecter n’importe quel système existant ?
Les systèmes disposant d’API, événements ou connecteurs adaptés peuvent être reliés via un adaptateur. Un système fermé peut nécessiter son fournisseur. La compatibilité dépend des opérations disponibles.
Dois-je remplacer ma caisse ou mon site ?
Vous pouvez conserver votre interface. Votre serveur ou middleware relie les événements compatibles à l’API fidélité.
L’exemple est-il exécutable ?
Non. Il illustre l’architecture sans définir endpoint, authentification ou contrat de requête publié. Utilisez le contrat API actuel.
Intégrez la fidélité à votre expérience actuelle.
Partagez votre système et les opérations nécessaires. Validez le contrat API, puis implémentez et testez l’adaptateur.
Parler de l’intégration ↗