Initial commit

docs/adr/009-solution-paiement.md

@@ -0,0 +1,61 @@
+# ADR-009 : Solution de Paiement et Gestion des Abonnements
+
+**Statut** : Accepté
+**Date** : 2025-01-19
+
+## Contexte
+
+RoadWave nécessite une solution de paiement pour gérer les abonnements Premium (4.99€/mois) et reverser 70% des revenus aux créateurs de contenu. Besoin de marketplace natif (split payments), KYC automatique, conformité RGPD, et coûts maîtrisés.
+
+## Décision
+
+**Mangopay** (France/Luxembourg) comme solution unique pour paiements, marketplace et abonnements.
+
+## Alternatives considérées
+
+| Solution | Coût transaction | Marketplace | KYC | Souveraineté |
+|----------|-----------------|-------------|-----|--------------|
+| **Mangopay** | 1.8% + 0.18€ | ✅ Natif | ✅ Gratuit | 🇪🇺 France/LU |
+| Stripe Connect | 2.9% + 0.30€ | ✅ Natif | ❌ 1.20€ | 🇺🇸 USA |
+| Mollie | 2.9% + 0.29€ | ❌ Non | ❌ Non | 🇪🇺 Pays-Bas |
+| Paddle | 5% + 0.50€ | ✅ Natif | ✅ Inclus | 🇬🇧 UK |
+
+## Justification
+
+- **38% moins cher** que Stripe (1.8% vs 2.9%)
+- **Marketplace natif** : E-wallets automatiques, split payments 70/30, payouts SEPA gratuits
+- **KYC gratuit** : vérification d'identité incluse (vs 1.20€/créateur chez Stripe)
+- **Souveraineté EU** : France/Luxembourg, régulé ACPR, RGPD natif
+- **Conformité DAC7** : reporting fiscal automatique
+- **Spécialisé marketplace** : utilisé par Vinted, Ulule, ManoMano
+
+## Architecture
+
+```
+┌────────────────────────┐
+│   Utilisateurs Premium │  4.99€/mois
+└───────────┬────────────┘
+            │
+    ┌───────▼───────┐
+    │   Mangopay    │  - Abonnements récurrents
+    │               │  - KYC créateurs (gratuit)
+    │               │  - E-wallets automatiques
+    └───────┬───────┘  - Payouts SEPA (gratuits)
+            │
+  ┌─────────┼─────────┐
+  │         │         │
+┌─▼───┐  ┌─▼───┐  ┌─▼────┐
+│Créa │  │Créa │  │Plate-│
+│teur │  │teur │  │forme │
+│  A  │  │  B  │  │(30%) │
+│(70%)│  │(70%)│  │      │
+└─────┘  └─────┘  └──────┘
+```
+
+## Conséquences
+
+- Solution tout-en-un : 1 seul prestataire vs 2-3
+- Économie de 2160€/an sur 1000 abonnés (vs Stripe)
+- Délai activation compte : 2-5 jours
+- Intégration Go via REST API (pas de SDK Go officiel)
+- Apple/Google IAP gérés séparément (comme toute solution de paiement)