Dons récurrents

Un don récurrent est une instruction enregistrée pour prélever la carte d'un donateur selon un échéancier — typiquement hebdomadaire, bimensuel ou mensuel. La carte est tokenisée par notre passerelle, vous ne manipulez donc jamais un vrai PAN. Une fois configurés, les prélèvements se font automatiquement par une tâche cron quotidienne.

Deux voies pour la mise en place

Voie	Qui la déclenche	Quand l'utiliser
Initiée par admin	Un membre du personnel, en utilisant les détails de carte du donateur	Le donateur vous a dit en personne et vous saisissez en son nom
Initiée par le visiteur	Le donateur, sur le formulaire public de don	Le donateur veut s'inscrire en libre-service depuis chez lui

Les deux voies produisent la même ligne en base dans recurring_donations et sont traitées par la même tâche nocturne.

Configuration initiée par admin

1. Ouvrez le profil de membre du donateur → onglet Dons.
2. Cliquez sur l'action de création de récurrent.
3. Remplissez :
   • Fonds — à quelle catégorie va chaque prélèvement.
   • Montant — montant par prélèvement.
   • Fréquence — hebdomadaire, bimensuelle, mensuelle.
   • Date de début — quand le premier prélèvement s'exécute.
   • Date de fin (optionnel) — laissez vide pour indéfini.
   • Détails de carte — numéro, expiration, CVV. Ils passent par notre passerelle et reviennent sous forme de token.
4. Enregistrez.

Le premier prélèvement s'exécute habituellement immédiatement (ou à la date de début si elle est dans le futur). Les prélèvements suivants s'exécutent la nuit jusqu'à ce que l'échéancier dise qu'ils ne doivent plus s'exécuter.

La fonction edge qui alimente cela est create-recurring-donation-gc — elle tokenise la carte via PowerTranz, ne stocke que le token + les quatre derniers chiffres + l'expiration dans la base de données, et ne touche jamais au PAN complet au-delà de la soumission initiale.

Configuration initiée par le visiteur

Quand un donateur visite votre formulaire de don public et sélectionne Faire de ceci un don récurrent, le formulaire bascule en mode récurrent :

1. Le donateur choisit la fréquence, le montant, le fonds, la date de début.
2. Les détails de carte du donateur passent par un flux de paiement hébergé (Genius Checkout) — il saisit la carte sur une page hébergée par la passerelle, pas par GCM.
3. La passerelle renvoie un token.
4. La fonction edge start-public-recurring-donation-gc enregistre la ligne de don récurrent en utilisant ce token.

Le donateur reçoit un e-mail de confirmation et peut gérer (annuler, changer le montant) le don récurrent en se connectant à son compte de membre ou en cliquant sur un lien magique dans l'e-mail de confirmation.

Exigence de carte enregistrée

Pour prélever ultérieurement sans le donateur présent, la carte doit être tokenisée à la configuration. Certains modes de paiement ne peuvent pas être tokenisés — par exemple, certaines cartes de débit dans certaines régions. Le flux de configuration fait apparaître une erreur "cette carte ne peut pas être utilisée pour les récurrents" dans ce cas ; le donateur doit changer de carte.

Tâche nocturne de prélèvement

La fonction edge charge-recurring-donations s'exécute une fois par jour. Pour chaque don récurrent dont la next_charge_date est arrivée :

1. Elle appelle la passerelle avec le token enregistré et le montant.
2. Si le prélèvement réussit — elle écrit une ligne de don, avance next_charge_date à la prochaine date programmée.
3. Si le prélèvement échoue — elle enregistre l'échec, envoie au donateur un e-mail lui demandant de mettre à jour sa carte, et réessaie à la prochaine exécution nocturne pendant jusqu'à 5 jours. Après 5 échecs, le don récurrent est mis en pause.

INFO

Nous réessayons délibérément plutôt que de mettre en pause immédiatement — les refus bancaires sont souvent transitoires (fonds insuffisants momentanément) et se résolvent d'eux-mêmes en une journée.

Vue du donateur

Les donateurs peuvent :

• Voir leurs dons récurrents actifs sur le profil de membre (s'ils sont connectés).
• Les voir dans le lien Gérer vos dons de l'e-mail de confirmation.
• Annuler depuis l'un ou l'autre endroit — l'annulation est immédiate.
• Changer le montant ou la fréquence — cela produit une nouvelle ligne récurrente et met fin à l'ancienne.

Vue admin

La page Dons → Récurrents liste chaque don récurrent dans l'espace de travail. Vous pouvez :

• Filtrer par donateur, fonds, statut.
• Voir la dernière date de prélèvement et la prochaine date de prélèvement de chaque récurrent.
• Mettre en pause / reprendre des échéanciers individuels.
• Annuler au nom du donateur.

Annulation

Un don récurrent peut être annulé par :

• Le donateur (depuis le lien de gestion).
• Un administrateur (depuis la page des dons récurrents).
• Le système, après 5 prélèvements échoués consécutifs.

L'annulation ne rembourse pas les prélèvements antérieurs. Les dons passés restent sur le profil du donateur et sur les relevés de fin d'année.

Permissions

Action	Admin	Trésorier	Donateur (soi)
Créer un récurrent	oui	oui	oui
Voir la liste des récurrents	oui	oui	uniquement les siens
Modifier le montant / la fréquence	oui	oui	uniquement les siens
Annuler	oui	oui	uniquement les siens

Questions fréquentes

Que se passe-t-il si la carte expire ? Le donateur reçoit un e-mail une semaine avant l'expiration lui demandant de mettre à jour. S'il ne le fait pas, le prochain prélèvement échoue et nous lançons le cycle de nouvelle tentative.

Puis-je rembourser un prélèvement récurrent ? Oui — ouvrez la ligne de don et cliquez sur rembourser. Nous appelons process-refund contre la passerelle. Les remboursements apparaissent comme un don négatif sur les relevés de fin d'année.

Les échéanciers récurrents tiennent-ils compte du fuseau horaire ? Oui. Nous prélevons selon le fuseau horaire de votre église (défini dans Paramètres → Organisation), pas en UTC.

Prochaines étapes

• Formulaire de don en ligne — où les visiteurs s'inscrivent en libre-service.
• Relevés et reçus — vue de fin d'année des dons récurrents.
• Lancer une campagne de dons — recette utilisant les dons récurrents.