FAQ intégration
Général
Otonum envoie-t-il automatiquement des notifications aux Membres ?
Oui. Après le traitement d'un événement achat, Otonum notifie le Membre par email ou notification push selon les paramètres de votre programme. Si votre système envoie aussi des notifications, désactivez l'un des deux pour éviter les doublons.
Dois-je interroger le statut de la tâche après chaque achat ?
Non. Pour la grande majorité des intégrations, vous soumettez l'achat, recevez un taskId et laissez Otonum traiter en arrière-plan. L'interrogation n'est pertinente que si votre interface doit afficher le montant de la récompense gagnée immédiatement après la caisse. Consultez Statut des tâches.
Puis-je utiliser la même clé API pour toutes mes applications ?
Non. La clé API donne accès à l'application de votre tenant pour laquelle elle à été générée.
Membres & Enrollment
Que faire si un Membre perd son code personnel ?
Vous pouvez récupérer le code personnel d'un Membre à tout moment en utilisant son email ou son numéro de téléphone via l'endpoint de recherche.
Un Membre peut-il être inscrit dans plusieurs programmes ?
Oui. Un Membre peut être inscrit dans les programmes de plusieurs tenants indépendamment. Chaque enrollment produit un wallet séparé avec son propre solde.
Que se passe-t-il si j'essaie d'inscrire un Membre déjà inscrit ?
L'API retourne 409 CUSTOMER_ALREADY_EXISTS. Traitez cela comme un succès. le Membre est déjà dans votre programme. Récupérez son profil pour obtenir son code personnel.
Quelle langue dois-je transmettre lors de l'enrollment ?
Transmettez la langue préférée du Membre (ex. fr, en). Otonum l'utilise pour envoyer les notifications dans la langue appropriée.
Achats & Récompenses
Un même achat peut-il être soumis deux fois ?
Non. La reference est votre clé de déduplication. Soumettre la même référence une deuxième fois retourne 409 DUPLICATE_REFERENCE. C'est intentionnel. cela protège les Membres contre les doubles récompenses lors des nouvelles tentatives réseau.
Que se passe-t-il si aucune campagne n'est active lors de la soumission d'un achat ?
L'achat est enregistré avec succès et un taskId est retourné. Aucune récompense n'est accordée, mais il n'y a pas d'erreur. Le solde du Membre n'est pas affecté.
Plusieurs campagnes ont correspondu au même achat. est-ce correct ?
Oui. Otonum évalue toutes les campagnes actives pour l'application et le trigger. Toutes les campagnes dont les règles sont satisfaites accordent leurs récompenses. Le Membre cumule les bénéfices de chaque campagne applicable simultanément.
Ma transaction a été annulée. que se passe-t-il avec les récompenses déjà créditées ?
Otonum crée un ajustement négatif (PointAdjustment) pour récupérer les récompenses. Le solde du Membre peut temporairement devenir négatif. C'est un comportement attendu. Consultez Transactions.
Bons d'achat
Que se passe-t-il si un bon est partiellement utilisé ?
Le montant résiduel génère automatiquement un nouveau bon qui hérite de la date d'expiration du bon original. Vous n'avez pas besoin de gérer cela manuellement.
Un Membre peut-il utiliser un bon dans le magasin d'un autre partenaire ?
Non. Les bons sont limités au tenant qui les a émis.
Technique
Quel en-tête transporte la clé API ?
x-api-secret. Incluez-le sur chaque requête.
Quelle est la limite de débit ?
10 requêtes par seconde par clé API. Dépasser cette limite retourne 429 Too Many Requests. Implémentez un backoff exponentiel. Consultez Bonnes pratiques.
Y a-t-il des endpoints différents par région ?
Non. Tous les endpoints sont identiques quelle que soit la région. La devise correcte et les règles réglementaires sont appliquées côté serveur selon la configuration de votre tenant.
Voir aussi
- Bonnes pratiques. Sécurité, limitation de débit et résilience
- Codes d'erreur. Référence complète des codes d'erreur
- Guide d'intégration. Flux de caisse complet