Concepts
Comprenez les concepts fondamentaux de la plateforme Raba7ni et comment ils interagissent.
Entités Principales
Membres
Les membres sont vos clients qui participent à votre programme de fidélité. Chaque membre :
- Possède un email et/ou un numéro de téléphone unique
- Peut être associé à plusieurs cartes de fidélité
- Gagne et échange des points via des transactions
- Peut parrainer d'autres membres pour des points bonus
Cartes de Fidélité
Les cartes définissent vos programmes de fidélité. Chaque carte a :
- Règles de Points - Combien de points par unité monétaire dépensée
- Récompenses - Ce que les membres peuvent obtenir en échange de points
- Membres - Qui est inscrit à ce programme de fidélité
Transactions
Les transactions enregistrent l'activité des points :
| Type | Description | Effet sur les Points |
|---|---|---|
| Gain (Earn) | Points gagnés lors d'achats | + Points |
| Échange (Redeem) | Points utilisés pour des récompenses | - Points |
| Bonus | Points promotionnels ou de parrainage | + Points |
| Ajustement | Corrections manuelles par le personnel | +/- Points |
Flux API Typique
Valider le Membre
Vérifiez si un numéro de téléphone ou un email appartient à un membre existant de votre carte de fidélité.
Trouver ou Créer
Si le membre existe, récupérez ses données. Sinon, créez un nouveau membre avec vérification OTP.
Attribuer des Points
Créez une commande et attribuez des points en fonction du montant de l'achat selon les règles de gain de votre carte.
Gérer les Échanges
Traitez les demandes de réclamation lorsque les membres veulent échanger leurs points contre des récompenses.
Système de Parrainage
Les membres peuvent parrainer d'autres personnes en utilisant des codes de parrainage uniques :
- Parrain - Le membre existant qui partage son code
- Filleul - Le nouveau membre qui utilise le code
- Les deux parties reçoivent des points bonus lorsque le parrainage est complété
Points de Parrainage
Les points bonus pour le parrain et le filleul sont configurés par carte dans votre tableau de bord partenaire.