Identité client
Vue d'ensemble
Dans Otonum, chaque personne participant au programme de fidélité d'un partenaire est représentée par un enregistrement membre lié à son adresse courriel et/ou son numéro de téléphone, et auquel est attribué un code personnel lors de l'inscription.
Email et téléphone comme identifiants
Un membre peut être identifié par son email, son numéro de téléphone, ou les deux, selon ce qu'il a fourni à l'inscription. Otonum accepte l'un ou l'autre pour les recherches. Votre intégration doit stocker les identifiants fournis par le membre et les transmettre de manière cohérente.
Code personnel
Le code personnel est un identifiant court et lisible (ex. PC_JEAN2026) généré par Otonum lors de l'inscription. Le membre le présente à la caisse, sur une carte de fidélité, dans une application, ou saisi manuellement.
Le code personnel est la clé de référence pour toutes les opérations transactionnelles : soumission d'achats, récupération de soldes et création de bons d'achat utilisent tous ce code.
Le code personnel est généré par Otonum. Vous ne pouvez pas le choisir. Récupérez-le depuis la réponse d'enrollment et stockez-le dans votre système. Sans lui, vous ne pouvez pas soumettre de transactions pour ce membre.
Récupérer un code personnel par email :
Consultez la Référence API pour la route de recherche et le format des paramètres.
Solde client
Le solde d'un membre représente les récompenses disponibles à l'échange. Otonum le détaille en quatre champs :
| Champ | Description |
|---|---|
balance | Points/Cashback actuellement disponible pour l'échange |
balanceCashValue | Equivalent en cash de la balance |
totalEarned | Montant cumulé gagné depuis l'inscription |
totalRedeemed | Montant cumulé appliqué aux achats |
totalReserved | Montant bloqué dans un bon actif, en attente d'utilisation |
Le montant totalReserved est temporairement indisponible. Il est engagé dans un bon qui sera soit utilisé lors de l'échange, soit automatiquement retourné au balance si le bon expire sans être utilisé après 30 jours.
Récupérer le solde d'un membre :
Consultez la Référence API pour les paramètres de récupération du solde.
Points importants
- Un membre est toujours rattaché à un tenant. La même adresse email peut être inscrite dans les programmes de plusieurs partenaires indépendamment.
- Chaque membre possède un wallet par marchand. Les soldes ne sont jamais partagés entre tenants.
- L'inscription requiert au minimum : email ou téléphone, prénom, nom et langue (pour les notifications).
Voir aussi
- Programme de fidélité : mécanismes de points et cashback
- Wallet & isolation par marchand : comment les soldes sont isolés par tenant
- Guide d'intégration : flux de caisse complet