Paiements et cotisations
Statut
Document de cadrage AssoSuite — version initiale.
Rôle
Les cotisations sont un besoin central pour de nombreuses associations.
AssoSuite doit permettre de proposer des plans de cotisation simples, de suivre les paiements et de limiter les manipulations administratives.
État actuel visible
Le backend contient :
- modèle
AssoCotisationPlan; - modèle
AssoCotisation; - contrôleur
CotisationController; - services
CotisationReadServiceetCotisationWriteService; - tables
assosuite_cotisation_plansetassosuite_cotisations; - intégration Stripe via PaymentIntent et Subscription ;
- traitement de webhooks Stripe dans le module de monétisation ;
- lecture d'un taux de commission
assosuite.commission_ratedepuis les settings.
Plans de cotisation visibles
Les plans contiennent :
- association via
acteur_id; - nom ;
- description ;
- montant en centimes ;
- périodicité ;
- statut actif ;
- identifiant Stripe Price pour les plans récurrents.
Les périodicités visibles sont :
unique;mensuelle;trimestrielle;annuelle.
Cotisations visibles
Les cotisations contiennent :
- association ;
- membre ;
- plan ;
- montant ;
- statut ;
- identifiants Stripe masqués dans les modèles ;
- période ;
- date de paiement.
Les statuts documentés dans la migration sont :
pending;paid;failed;refunded.
Principes de paiement
- Stripe gère les données bancaires sensibles.
- L'application ne doit pas stocker localement les données de carte.
- Les associations doivent comprendre les frais et commissions.
- Le paiement doit rester optionnel si l'association n'en a pas besoin.
- Le parcours doit rester compatible avec des budgets associatifs limités.
Vision cible
La cible est un module cotisation :
- simple à configurer ;
- compréhensible par un trésorier bénévole ;
- compatible paiement unique et récurrent ;
- relié aux statuts membres ;
- capable de produire un suivi clair ;
- exportable si nécessaire ;
- intégré au modèle économique sans bloquer l'usage gratuit essentiel.
Points à clarifier
- Parcours Stripe Connect côté association.
- Gestion des remboursements côté interface.
- Reçus, justificatifs ou exports comptables.
- Règles de commission finales.
- Gestion des paiements hors ligne.