Gérer une organisation à but non lucratif signifie que chaque euro compte, y compris ceux qui disparaissent discrètement dans les frais de traitement des paiements. Lorsqu'un donateur donne 100 € via Stripe ou PayPal, la passerelle prend sa part avant que cet argent n'atteigne votre compte. Vous savez que cela se produit.

Mais jusqu'à ce que vous vous connectiez séparément à votre tableau de bord de passerelle, que vous extraiez un rapport de transactions et que vous rapprochiez chaque entrée de vos enregistrements de dons caritatifs, vous ne connaissez pas le nombre exact. Pas même de près.

Charitable vous affiche désormais les frais de traitement de la passerelle directement dans votre tableau de bord WordPress !

Chaque enregistrement de don individuel affiche les frais de traitement exacts facturés pour cette transaction – là où vous regardez déjà, sans étapes supplémentaires, sans rapprochement, sans calcul requis.

Vous ouvrez un don. Vous voyez ce qui est arrivé. Vous voyez ce que la passerelle a pris. Vous voyez ce que vous avez gardé.

Présentation du suivi des frais de traitement de la passerelle

Le suivi des frais de traitement de la passerelle, nouveau dans Charitable Pro, enregistre automatiquement les frais de traitement réels facturés pour chaque don au moment où le paiement est validé. Cela fonctionne pour les passerelles suivantes :

• PayPal
• Stripe

Aucune saisie manuelle, aucun appel d'API supplémentaire, aucune connexion à un tableau de bord séparé pour retrouver le chiffre.

Votre brut, vos frais et votre net : tout est dans WordPress où vous gérez déjà tout le reste.

Voici comment cela fonctionne en pratique.

Comment ça marche

Le suivi des frais est conçu pour être passif. Il lit les frais de traitement à partir des données que la passerelle envoie déjà lors de la confirmation d'un paiement, sans requêtes supplémentaires aux API de Stripe ou PayPal et sans configuration au-delà de l'activation de la fonctionnalité. Il n'y a pas de charge supplémentaire sur votre site et pas de nouveaux webhooks à configurer au-delà de ce que Charitable exige déjà.

🛠️ Les détails techniques : Pour Stripe, les frais sont lus à partir du champ balance_transaction.fee de l'objet de paiement lorsque le webhook de Charitable traite la confirmation du paiement. Le montant est converti de centimes en un chiffre décimal avant d'être stocké.

Pour PayPal, les frais arrivent dans la charge utile de notification IPN sous mc_fee, déjà formatés en décimal, et sont stockés tels quels.

Dans les deux cas, les frais sont enregistrés une fois et ne sont jamais écrasés. Si PayPal réessaie une notification IPN ou si Stripe déclenche un événement de webhook en double, la valeur d'origine est préservée. Vos enregistrements de dons restent précis, quoi qu'il arrive du côté de la passerelle après cette première confirmation.

Voici ce que cela signifie en pratique : une petite organisation d'éducation à but non lucratif traite environ 200 dons par mois, répartis entre Stripe et PayPal.

Avec le suivi des frais activé, les frais de traitement sont stockés sur chaque nouvel enregistrement de don dans WordPress et inclus en tant que colonne dédiée dans chaque exportation CSV.

La réconciliation qui prenait autrefois une bonne partie de la matinée prend maintenant environ 15 minutes.

Les données dont vous avez besoin sont déjà là, correctement formatées et prêtes à l'emploi.

Pour les organisations qui gèrent des opérations allégées, ce n'est pas une commodité mineure. C'est du temps administratif réel rendu à l'équipe.

Ce que le suivi des frais de passerelle peut faire

Voici un aperçu rapide de tout ce que cette fonctionnalité gère automatiquement :

• Capture les frais exacts par don : Les frais de traitement réels signalés par Stripe ou PayPal sont stockés dans l'enregistrement du don au moment de la confirmation du paiement. Pas d'arrondis, pas d'estimations, pas de moyennes basées sur des taux typiques.
• Affiche les frais sur la page d'administration des dons : Ouvrez n'importe quel don Stripe ou PayPal dans votre tableau de bord WordPress sous Dons et vous trouverez une ligne Frais de traitement de la passerelle dans la section des métadonnées du don, formatée dans la devise du don.
• Ajoute une colonne de frais dédiée aux exportations CSV : Lorsque le suivi est activé, chaque exportation de dons comprend une colonne Frais de traitement de la passerelle aux côtés de vos autres données de dons. Extrayez une exportation et le tableau complet est déjà là pour votre comptable, auditeur ou responsable de subvention — aucune étape supplémentaire.
• Calcule les montants nets par don : Une fonction d'aide intégrée calcule le montant net réel reçu par don, en tenant compte des frais de traitement de la passerelle et des frais de connexion Stripe le cas échéant. Les développeurs qui créent des rapports ou des intégrations personnalisés peuvent appeler charitable_gateway_fees_get_net_amount( $donation ) pour le récupérer sous forme de chaîne de devises formatée.
• Gère correctement Stripe Connect : Pour les comptes Stripe Connect, les frais de plateforme sont suivis séparément et pris en compte dans les calculs nets aux côtés des frais de traitement. Les deux montants sont stockés indépendamment pour des rapports précis et vérifiables.
• Protège contre les doublons de données : Une fois qu'un frais est enregistré sur un don, il n'est pas écrasé. Le stockage idempotent signifie que les webhooks et les notifications IPN répétés ne peuvent pas corrompre ou remplacer la valeur d'origine.

Premiers pas avec le suivi des frais

Le suivi des frais est désactivé par défaut. Voici tout ce qu'il faut pour l'activer :

1. Mettez à jour Charitable Pro vers la version 1.8.13 ou supérieure. Accédez à Plugins dans votre tableau de bord WordPress, vérifiez votre version de Charitable Pro et exécutez la mise à jour si nécessaire.
2. Ajoutez la ligne suivante au fichier functions.php de votre thème ou à un plugin spécifique au site :

add_filter( 'charitable_show_gateway_processing_fee', '__return_true' );

C'est la configuration complète. Enregistrez le fichier et Charitable commence à enregistrer automatiquement les frais de traitement sur tous les nouveaux dons Stripe et PayPal. Il n'y a rien d'autre à configurer dans l'administration WordPress.

Avant d'activer, confirmez deux prérequis :

• Utilisateurs Stripe : La capture des frais nécessite que le webhook Stripe soit actif et délivre les événements charge.succeeded ou payment_intent.succeeded avec la transaction de solde développée. Si vous avez configuré Stripe via le flux standard de Charitable, cela est déjà en place.
• Utilisateurs PayPal : La capture des frais dépend de la bonne livraison des notifications par PayPal IPN. Si vous n'êtes pas sûr que l'IPN soit actif, vérifiez les paramètres de votre compte PayPal ou consultez la documentation de configuration PayPal de Charitable.

Une note importante : les données sur les frais ne sont capturées qu'à partir de maintenant. Les dons traités avant l'ajout du filtre ne sont pas mis à jour rétroactivement, le champ des frais sera donc vide sur les anciens enregistrements.

Pour désactiver le suivi des frais, supprimez l'extrait ou remplacez-le par :

add_filter( 'charitable_show_gateway_processing_fee', '__return_false' );

La désactivation du suivi arrête l'enregistrement des nouveaux frais. Elle ne supprime pas les données de frais déjà stockées sur les dons existants.

Vous n'êtes pas à l'aise avec le code ? Vous craignez de casser votre site ? Besoin d'aide pour ajouter du code à votre site sans avoir à modifier manuellement des fichiers ?

Je vous recommande de consulter WPCode »

Il permet d'ajouter facilement et en toute sécurité des fonctionnalités personnalisées à WordPress via des extraits de code. Vous pouvez créer en toute sécurité des extraits de code personnalisés en remplissant simplement un formulaire, sans avoir à vous soucier du code.

Il est également doté d'une gestion des erreurs sécurisée. Cela vous aide à éviter les erreurs de code courantes lors de l'ajout d'extraits personnalisés, afin de ne jamais casser votre site.

Pourquoi vous allez adorer le suivi des frais de passerelle

La configuration est une seule ligne de code. Le résultat est chaque mois, pour toujours.

• 📊 Plus besoin de faire de recoupement avec le tableau de bord de votre passerelle ; les frais de traitement exacts sont stockés sur chaque enregistrement de don dans WordPress, juste là où vous faites tout le reste.
• 💸 Vrai montant net par don, calculé pour vous ; l'aide au montant net prend en compte les frais de passerelle et les frais d'application Stripe Connect, vous savez donc toujours ce que vous avez réellement reçu.
• 📁 Prêt à l'exportation pour la comptabilité et les rapports de subvention ; la colonne des frais est incluse automatiquement dans chaque exportation CSV, formatée et prête pour votre comptable ou auditeur sans aucune étape supplémentaire.
• 🔒 Conçu pour éviter les doublons ; le stockage idempotent garantit que les webhooks ou les notifications IPN répétés ne peuvent pas écraser les données de frais une fois qu'elles ont été enregistrées.
• ⚙️ Fonctionne avec votre configuration Stripe et PayPal existante ; pas de nouveaux webhooks, pas de modifications de votre configuration de passerelle, et pas de surcharge de performance sur votre site.

Obtenez le suivi des frais de passerelle avec Charitable Pro

Le suivi des frais de traitement de passerelle est disponible sur tous les plans Charitable Pro : Basic, Plus, Pro et Elite. Les plans commencent à 69 $/an, et chaque plan inclut une garantie de remboursement de 14 jours à 100 %. Aucun risque, aucune question posée.

Pas encore sur Charitable Pro ? Comparez tous les plans et tarifs pour trouver celui qui convient à votre organisation.

Prêt à l'activer ?

Connaître votre montant net exact par don est l'une de ces petites victoires opérationnelles qui améliorent discrètement tout : la planification budgétaire, les rapports de subvention et la réconciliation de fin de mois que votre équipe effectuait manuellement. Vous utilisez déjà Charitable Pro 1.8.13 ou une version supérieure ?

Rendez-vous sur la documentation du suivi des frais de traitement de passerelle pour obtenir l'extrait de configuration et la référence complète du développeur.

Des questions ? Notre équipe de support est là pour vous aider.

Restez connecté pour plus de ressources pour les organisations à but non lucratif

Pour plus de tutoriels et de vidéos adaptés aux organisations à but non lucratif, abonnez-vous à notre chaîne YouTube. Nous publions régulièrement des conseils d'experts, des guides étape par étape sur les dons en ligne, des stratégies de collecte de fonds et des ressources pratiques pour aider votre organisation à réussir.

🗞️ Recevez des conseils hebdomadaires et des guides exclusifs dans votre boîte de réception
Rejoignez notre newsletter →  

🎥 Regardez des tutoriels étape par étape et des histoires de réussite
Abonnez-vous à notre chaîne YouTube →  

👩🏽‍💻 Connectez-vous avec notre communauté et obtenez des informations quotidiennes sur les organisations à but non lucratif
Suivez-nous sur LinkedIn →

🥳 Reels amusants et informations sur les organisations à but non lucratif
Suivez-nous sur Instagram → 

👀 Vidéos perspicaces et amusantes pour vous aider à développer votre cause
Suivez-nous sur TikTok→  

🌎 Abonnez-vous et suivez pour des conseils généraux sur la collecte de fonds
Obtenez des conseils sur la collecte de fonds sur TikTok → 

Ressources puissantes pour la collecte de fonds

⬇️ Téléchargez des stratégies éprouvées, des idées de campagnes et des outils d'experts
Obtenez le kit de collecte de fonds →  

💸 Obtenez des ressources gratuites pour la collecte de fonds
Rendez-vous sur le Hub de collecte de fonds Charitable →

🤔 Des questions sur Charitable ?
FAQ Charitable →

🏎️ Essayez Charitable
Créez votre démo Charitable →

Comprendre les termes et le jargon des organisations à but non lucratif
Glossaire des organisations à but non lucratif→

% Vous recherchez des offres et des réductions pour les organisations à but non lucratif ?
Meilleures offres et réductions pour les organisations à but non lucratif →

David Bisset Chef de projet

David est le chef de projet de Charitable depuis 2022. David travaille avec plusieurs organisations à but non lucratif (dont une gérée par sa femme) tout en gérant et développant les fonctionnalités, le support et le marketing pour Charitable. Il travaille avec WordPress depuis 2006 et a été l'organisateur principal de plusieurs conférences, événements et rencontres.

Voir la biographie complète