Aller au contenu principal

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 CotisationReadService et CotisationWriteService ;
  • tables assosuite_cotisation_plans et assosuite_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_rate depuis 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.