Règles Métier de Fidélité

1.1 Principes Fondamentaux

• Universalité 1 recoin = 0,20€ partout dans le système
• Flexibilité Choix entre cashback bancaire ou dépense commerçant
• Transparence Calculs et conversions clairement affichés
• Équité Mêmes règles pour tous les utilisateurs
• Sécurité Système anti-fraude et traçabilité complète
• Deux systèmes de cashback Bancaire (taux global selon palier client) + Établissement (taux par-partenaire, configurable par le partenaire)

2.1 Acquisition des Points

2.1.1 Ratio de Base

Recoins gagnés = Montant achat TTC × 5

2.1.2 Taux de Cashback Commerçant

Le montant de points crédités dépend du taux de cashback défini par chaque commerçant partenaire.

2.1.3 Crédit Automatique

• Détection automatique de la transaction via la solution bancaire
• Crédit des points sous 24-48h ouvrées
• Notification push envoyée à l'utilisateur
• Traçabilité complète dans l'historique

2.2 Validité et Expiration

2.2.1 Durée de Validité

2.2.2 Méthode de Dépense

2.2.3 Notifications d'Expiration (si activée)

2.3 Plafond et Limitations

2.3.1 Plafond de Points

• L'utilisateur peut accumuler autant de points qu'il le souhaite
• Seule limitation : expiration automatique après N mois (si activée par l'administrateur)
• Pas de seuil maximum journalier, hebdomadaire ou mensuel

2.3.2 Limitations Sécurité (Anti-Fraude)

• Détection d'anomalies Alertes automatiques sur comportements suspects
• Traitement asynchrone des virements Virements traités de manière asynchrone via Stripe. Pas de validation manuelle.
• Blocage temporaire Compte suspendu en cas de suspicion de fraude

3.1 Cashback Bancaire

3.1.1 Ratio de Conversion

Montant virement = Recoins × 0,20

3.1.2 Conditions de Demande

• Seuil minimum : 10,00€ obligatoires
• Pas de maximum : L'utilisateur peut convertir tout son solde
• Conversion partielle : Possible de ne convertir qu'une partie
• Fréquence : Aucune limitation sur le nombre de demandes
• Gratuit : Aucun frais de traitement

3.1.3 Processus de Virement

1. 1

   Demande

   L'utilisateur sélectionne le nombre de points à convertir

2. 2

   Validation

   Vérification IBAN + solde de points

3. 3

   Blocage

   Les points sont immédiatement bloqués (non utilisables)

4. 4

   Traitement

   Dispatch asynchrone via Stripe (pas de validation manuelle)

   Traitement automatique
5. 5

   Virement

   Crédit sur le compte bancaire de l'utilisateur

6. 6

   Notification

   Confirmation de virement effectué

3.1.4 Annulation

• Annulation possible tant que le statut est "En attente"
• Une fois en "En cours de traitement", annulation impossible
• En cas d'annulation, les points sont immédiatement débloqués

3.2 Cashback Commerçant (QR Code)

3.2.1 Ratio de Conversion

Valeur dépensable = Recoins × 0,20

3.2.2 Génération du QR Code

1. 1

   Saisie du montant

   L'utilisateur indique le nombre de points à dépenser

2. 2

   Vérification solde

   Le système vérifie la disponibilité des points

3. 3

   Blocage immédiat

   Les points sont réservés (non utilisables ailleurs)

4. 4

   Génération QR

   Code unique avec signature cryptographique

5. 5

   Affichage

   QR code plein écran + compteur à rebours 15 minutes

   ⏱️ 15 minutes
6. 6

   Expiration

   Après 15 minutes, code invalide + points débloqués automatiquement

3.2.3 Contenu du QR Code

Le QR code contient (format JSON signé) :

• ID utilisateur (crypté)
• Montant en points
• Timestamp de génération
• ID transaction unique
• Signature HMAC-SHA256

3.2.4 Scan et Validation Commerçant

1. 1

   Le commerçant scanne le QR code via son dashboard

2. 2

   Le système vérifie : validité, signature, expiration, usage unique

3. 3

   Si valide : débit instantané des points du compte client

4. 4

   Enregistrement de la transaction

5. 5

   Confirmation visuelle + sonore pour le commerçant

6. 6

   Notification push envoyée au client

3.2.5 Règles de Sécurité QR Code

4.1 Structure des Paliers

4.2 Calcul du Palier

• Cashback bancaire : palier basé sur vos points lifetime totaux sur la plateforme (identique chez tous les partenaires). Seuils : Bronze (0), Silver (350), Gold (700), Diamant (1 000).
• Cashback établissement : palier basé sur vos recoins accumulés chez ce partenaire. Seuils paramétrables par chaque partenaire.
• Taux configurables : tous les taux (bancaire ET établissement) sont paramétrables par l'admin système et, pour les établissements, par le partenaire lui-même (pack_65).
• Période glissante : Transactions des 365 derniers jours (système établissement)
• Recalcul quotidien : Mise à jour automatique chaque nuit à 2h00

4.2.1 Exemple de Seuils

4.2.2 Exemple de Calcul

4.3 Avantages par Palier

• Bonus cashback Multiplication du taux de cashback de base
• Offres exclusives Promotions réservées aux paliers supérieurs
• Support prioritaire À partir de Gold
• Badge visuel Affichage du palier dans l'app

4.4 Notifications

• Passage palier supérieur : Notification push + email de félicitations
• Proche du palier suivant : "Plus que 150€ pour atteindre Diamant !"
• Risque de descente : Alerté si risque de perdre un palier dans les 30 jours

5.1 Scénario 1 : Achat et Crédit de Points

1. 1

   Paiement

   Thomas paie avec son compte bancaire OpenBanking lié à REWAPP

2. 2

   Détection

   Transaction détectée automatiquement sous 24-48h

3. 3

   Calcul cashback (mode établissement)

   85€ × 5% (taux restaurant) = 4,25€

4. 4

   Points crédités

   4,25€ ÷ 0,20 = 21 recoins (arrondi)

5. 5

   Notification

   "Vous avez gagné 21 recoins chez Chez Luigi !"

5.2 Scénario 2 : Utilisation QR Code

1. 1

   Sophie ouvre l'app et clique sur "Générer QR Code"

2. 2

   Sophie saisit 200 points (valeur : 40€)

3. 3

   QR code généré, compteur 15 minutes commence

4. 4

   Le boulanger scanne le QR code en 15 secondes

5. 5

   Validation instantanée, 200 points débités

6. 6

   Notification : "Paiement de 200 points validé"

Résultat : Solde Sophie : 600 points restants

5.3 Scénario 3 : Demande de Virement

1. 1

   Paul clique sur "Demander un virement"

2. 2

   Paul saisit 1 000 points → montant affiché : 200€

3. 3

   Vérification IBAN (pré-rempli)

4. 4

   Confirmation et blocage des 1 000 points

5. 5

   Virement dispatché de manière asynchrone via Stripe

6. 6

   Virement de 200€ effectué sur compte Paul

7. 7

   Notification : "Votre virement de 200€ a été effectué"

6.1 Arrondi des Points

6.2 Annulation de Transaction

• Si un achat est annulé/remboursé par le commerçant
• Les points crédités sont automatiquement débités
• Si le solde est insuffisant, le compte passe en négatif temporairement
• L'utilisateur doit régulariser avant toute nouvelle utilisation

6.3 Suspension de Compte

• En cas de suspicion de fraude, le compte est gelé
• Aucune utilisation de points possible pendant la suspension
• Les points continuent d'expirer normalement
• Levée de suspension après vérification admin

6.4 Suppression de Compte

• L'utilisateur peut demander la suppression de son compte (RGPD)
• Les demandes de virement en cours sont annulées
• Délai de rétractation : 30 jours