Documentation Charitable

Apprenez à tirer le meilleur parti de Charitable grâce à des instructions claires, étape par étape.

PayPal Commerce

PayPal Commerce est une intégration PayPal unique et moderne qui permet à vos donateurs de payer avec PayPal, Venmo, Pay Later, cartes de crédit et de débit, Apple Pay et Google Pay via une seule connexion. Le bouton « Se connecter avec PayPal » en un clic gère la configuration, et les dons et les remboursements transitent par l'administration standard des dons de Charitable sans avoir besoin de se connecter à PayPal.

Disponible dans Charitable Pro 1.8.15+ et Charitable 1.8.11 (qui ne prend actuellement pas en charge les dons récurrents / la mise en coffre).  Il a été testé de bout en bout dans des environnements sandbox et réels, et nous continuerons à affiner l'expérience en fonction des commentaires des clients.

Fonctionnalités clés

  • Acceptez les dons via PayPal, Venmo, Pay Later, les cartes de crédit et de débit, Apple Pay et Google Pay grâce à une seule intégration.
  • Connectez votre compte professionnel PayPal en un clic. Aucun développeur nécessaire.
  • Proposez des dons ponctuels et récurrents à partir du même formulaire.
  • Choisissez entre deux modes récurrents : abonnements gérés par PayPal, ou renouvellements gérés par Charitable utilisant les méthodes de paiement enregistrées.
  • Laissez les donateurs récurrents enregistrer leur compte PayPal ou leur carte et la réutiliser pour les dons futurs.
  • Remboursez et annulez les dons directement depuis l'administration WordPress.
  • Visualisez le statut en temps réel des capacités de PayPal (Paiements Recevables, Email Confirmé, Traitement des Cartes, Apple Pay, Google Pay, Mise en coffre des méthodes de paiement, Fastlane) dans le panneau de connexion.
  • Les donateurs qui rencontrent une erreur côté PayPal voient des messages clairs et conviviaux avec une suggestion de récupération au lieu d'une alerte générique du navigateur.

Pourquoi utiliser PayPal Commerce ?

PayPal Commerce offre à vos donateurs le maximum de moyens de paiement sans que votre équipe ait à gérer plusieurs passerelles. Une seule connexion débloque PayPal, Venmo, le financement Pay Later, le traitement complet des cartes de crédit et de débit via les champs de carte conformes PCI de PayPal, et les portefeuilles modernes (Apple Pay, Google Pay) que tous les donateurs attendent sur un formulaire de don de l'ère 2026. Comparé à l'ancienne intégration PayPal Legacy, vous bénéficiez d'options de paiement plus riches, d'un paiement plus rapide et d'outils d'administration pour les remboursements et la gestion des récurrents sans jamais quitter WordPress.

Voyez-le en action

Exigences

  • Charitable Lite 1.8.11 ou Charitable Pro 1.8.15 ou plus récent
  • Un compte professionnel PayPal (vous pouvez en créer un pendant le flux de connexion)
  • WordPress 6.0+ et PHP 7.4+
  • L'extension PHP gd ou imagick si vous prévoyez d'utiliser la génération de PDF de reçus (déjà requis par le cœur de Charitable)

Démarrage

Activation

  1. Dans votre administration WordPress, allez à Charitable → Paramètres → Passerelles de paiement.
  2. Trouvez PayPal Commerce dans la liste des passerelles et cliquez sur Activer.
  3. Cliquez sur Paramètres à côté de PayPal Commerce, puis cliquez sur le bouton Se connecter avec PayPal.
  4. PayPal s'ouvre dans une nouvelle fenêtre. Connectez-vous à votre compte professionnel PayPal (ou créez-en un) et approuvez la connexion.
  5. PayPal vous redirige vers WordPress. Le panneau de connexion affichera votre identifiant marchand et une liste de contrôle des capacités accordées.

C'est tout. Vous pouvez commencer à accepter les dons via PayPal Commerce immédiatement.

Mode Test vs Mode Réel

PayPal Commerce respecte le paramètre Mode test standard de Charitable. Lorsque le mode test est activé, les dons transitent par l'environnement sandbox de PayPal afin que vous puissiez valider l'intégralité du parcours du donateur sans utiliser d'argent réel. Désactivez le mode test lorsque vous êtes prêt à accepter des dons réels.

Les méthodes de paiement enregistrées sont limitées par commerçant : une carte que vous avez enregistrée en mode sandbox n'apparaîtra pas en mode réel, et vice versa.

Options de configuration

Après la connexion, la page Paramètres PayPal Commerce expose ces options. La plupart des paramètres par défaut sont judicieux pour une nouvelle installation, vous pouvez donc généralement les laisser tels quels.

Modes de paiement

ParamètreTypeDéfautDescription
Activer VenmoActiver/DésactiverDésactivéAffichez le bouton Donner avec Venmo à côté de PayPal. Venmo est réservé aux États-Unis et nécessite la capacité de paiement différé sur votre compte PayPal.
Activer le paiement différéActiver/DésactiverDésactivéAffichez le bouton de paiement différé de PayPal (Payez en 4 fois, Crédit PayPal). L'éligibilité est déterminée par PayPal au moment du paiement en fonction de la région du donateur et du montant du don.
Activer les champs de carte (ACDC)Activer/DésactiverActivéAffichez les champs de carte de crédit et de débit conformes PCI de PayPal directement sur votre formulaire de don. Rebascule vers un bouton autonome « Carte de débit ou de crédit » si PayPal n'a pas encore activé les champs de carte sur votre compte.
Activer Apple PayActiver/DésactiverActivéAffichez le bouton Apple Pay sur Safari. Nécessite la capacité Apple Pay sur votre compte PayPal.
Activer Google PayActiver/DésactiverActivéAffichez le bouton Google Pay sur Chrome. Nécessite la capacité Google Pay sur votre compte PayPal.
Activer FastlaneActiver/DésactiverActivéPermettez aux donateurs récurrents de finaliser leur achat avec Fastlane (l'option de paiement enregistré de PayPal pour les invités).
Comportement de FastlaneSélectionnerInvités uniquementChoisissez quand Fastlane est proposé : invités uniquement, tous les donateurs, ou jamais.

Méthodes de paiement enregistrées (coffre-fort)

ParamètreTypeDéfautDescription
Activer le coffre-fort de méthodes de paiementActiver/DésactiverActivéPermettez aux donateurs d'enregistrer des comptes PayPal et des cartes sur le formulaire de don pour une utilisation lors de futurs dons.
Affichage de l'option de coffre-fortSélectionnerOpt-inChoisissez comment l'option « Enregistrer ma méthode de paiement » apparaît au moment du paiement : opt-in (non cochée par défaut), opt-out (cochée par défaut), ou enregistrer toujours.
Expiration de la méthode enregistrée (jours)Nombre(vide)Nombre de jours avant que les dons récurrents enregistrés non utilisés n'expirent automatiquement. Laissez vide pour aucune expiration.

Dons récurrents

ParamètreTypeDéfautDescription
Coffre-fort automatique pour les dons récurrentsActiver/DésactiverActivéEnregistrez automatiquement le moyen de paiement du donateur lorsqu'il choisit un don récurrent. Requis pour que le cron de renouvellement puisse débiter les cycles ultérieurs.
Mode de traitement des dons récurrentsRadioAPI d'abonnements PayPalChoisissez comment les dons récurrents sont traités. Coffre-fort + Cron : votre site enregistre le jeton de paiement et déclenche chaque renouvellement. API d'abonnements PayPal : PayPal gère automatiquement le cycle de renouvellement (nécessite une licence Pro ; les sites Lite reviennent automatiquement à Coffre-fort + Cron avec des frais de plateforme minimes sur chaque renouvellement).

Plongée en profondeur dans le mode récurrent

PayPal Commerce prend en charge deux manières distinctes de gérer les dons récurrents. Les deux fonctionnent avec la même expérience donateur, mais le flux en coulisses diffère.

Coffre-fort + Cron (géré par le marchand)

Lorsqu'un donateur choisit un don récurrent, votre site enregistre son compte PayPal ou sa carte sous forme de jeton sécurisé. À chaque cycle, le cron de Charitable déclenche un nouveau débit sur ce jeton via l'API Orders de PayPal. Vous conservez le contrôle total sur le comportement de relance, le recouvrement et les annulations via l'administration des dons récurrents de Charitable.

Fonctionne sur Lite et Pro. Les sites Lite paient des frais de plateforme minimes (3 %) sur chaque capture de renouvellement ; les sites Pro ne paient aucuns frais de plateforme.

API d'abonnements PayPal (gérée par PayPal)

Lorsqu'un donateur choisit un don récurrent, votre site crée un plan de facturation et un abonnement PayPal. PayPal gère automatiquement le cycle de renouvellement et informe votre site lorsque chaque cycle est facturé. Les donateurs peuvent également voir et gérer l'abonnement dans leur propre compte PayPal.

Disponible sur Pro uniquement. Les sites Lite qui sélectionnent ce mode reviennent automatiquement à Coffre-fort + Cron, de sorte que les donateurs ne voient jamais d'erreur.

Activation Pro sur les dons récurrents existants

Si vous activez Pro sur un site qui a déjà des dons récurrents Lite en cours, les frais de plateforme sont automatiquement supprimés lors du prochain renouvellement. Vous n'avez pas besoin de migrer l'abonnement, de demander au donateur de réapprouver, ou de prendre toute autre mesure. Le seuil de frais est vérifié à chaque renouvellement en fonction de votre état de licence actuel.

Remboursements et annulations

Les remboursements et les annulations sont émis depuis l'administration standard des dons Charitable. Vous n'avez pas besoin de vous connecter à PayPal.

Rembourser un don

  1. Ouvrez le don dans Charitable → Dons.
  2. Dans Actions sur le don, choisissez Remboursé et cochez « Rembourser automatiquement dans PayPal Commerce. ».
  3. Cliquez sur Mettre à jour le statut.

Si le remboursement réussit, le statut du don passe à Remboursé et l'ID du remboursement est enregistré dans le journal des dons. Si le remboursement échoue (par exemple, PayPal renvoie « solde insuffisant »), le statut du don est rétabli à Payé afin que vos enregistrements et PayPal restent synchronisés.

Annuler un don récurrent

  1. Ouvrez le don récurrent dans Charitable → Dons récurrents.
  2. Dans Actions sur le don, choisissez Annuler dans la passerelle.
  3. Cliquez sur Annuler le don récurrent.

L'annulation est envoyée à PayPal afin que le donateur ne soit plus facturé, et le message de don récurrent est défini sur Annulé dans WordPress.

Erreurs côté donateur

Lorsque PayPal ne parvient pas à traiter un don (le compte marchand est restreint, la carte est refusée, le pays n’est pas pris en charge, etc.), les donateurs voient un message clair et concis sur le formulaire de don avec une suggestion de résolution. Ils ne voient jamais de boîte de dialogue d’alerte générique du navigateur.

Exemples :

  • « Les dons en ligne via PayPal sont temporairement indisponibles. Veuillez essayer une autre méthode de paiement ou nous contacter pour finaliser votre don. »
  • « Votre méthode de paiement a été refusée. Veuillez essayer une autre carte ou utiliser votre solde PayPal. »
  • « Les dons via PayPal ne sont pas pris en charge depuis votre pays. Veuillez essayer une autre méthode de paiement. »

Si le visiteur actuel est connecté en tant qu’administrateur (capacité manage_charitable_settings ou manage_options), le message intégré affiche en plus le texte d’erreur PayPal sous-jacent et l’ID de débogage PayPal afin que vous puissiez trier sans consulter les journaux.

Journaux

Chaque erreur de l’API PayPal est enregistrée dans Charitable → Outils → Journaux sous la source paypal_commerce. Chaque entrée comprend :

  • Le message convivial affiché au donateur
  • Le texte d’erreur brut de PayPal
  • Le code d’erreur PayPal (par exemple, PAYEE_ACCOUNT_RESTRICTED)
  • L’ID de débogage PayPal (pour les tickets de support avec PayPal)
  • Contexte du don : montant, campagne, méthode de paiement

C’est le moyen le plus rapide de diagnostiquer le rapport d’un client indiquant « PayPal ne fonctionne pas ».

Dépannage

Les donateurs voient « Les dons en ligne via PayPal sont temporairement indisponibles. »

Ce message indique que PayPal a restreint votre compte marchand. Connectez-vous sur paypal.com avec votre compte professionnel, résolvez les éventuels problèmes de vérification ou de conformité en attente, puis revenez à Charitable → Paramètres → Passerelles de paiement → PayPal Commerce et cliquez sur Actualiser le statut pour confirmer que la restriction est levée.

L’onglet « Payer par carte » ne s’affiche pas ; seul un bouton « Carte de débit ou de crédit » apparaît.

PayPal n’a pas encore activé la capacité de traitement avancé des cartes (ACDC) sur votre compte. Le bouton Carte autonome accepte toujours les dons via une fenêtre contextuelle PayPal hébergée. Pour activer les champs de carte intégrés, connectez-vous à votre compte professionnel PayPal, terminez les étapes de vérification en attente, puis revenez au panneau de connexion et cliquez sur Actualiser le statut.

Après avoir déconnecté et reconnecté, la connexion affiche toujours l’ancien marchand.

Videz le cache d’objets de votre WordPress (ou redémarrez votre service PHP-FPM si un cache au niveau de l’hôte est impliqué). Le bouton Actualiser le statut force une nouvelle vérification des capacités auprès de PayPal.

Les dons récurrents ne sont jamais renouvelés.

Vérifiez que Mémoriser automatiquement pour les dons récurrents est activé et que le cron de WordPress s’exécute sur votre serveur. Pour le mode Mémoriser + Cron, le cron de renouvellement s’exécute quotidiennement et débite chaque don récurrent dû. Consultez Charitable → Outils → Journaux pour les entrées de paypal_commerce afin de voir si des tentatives de renouvellement ont été effectuées ou ont échoué.

Le bouton Rembourser affiche « Aucune ID de capture trouvée » sur un don par abonnement.

Cela peut se produire si vous tentez un remboursement dans les secondes qui suivent l'approbation de l'abonnement par le donateur, avant que PayPal n'ait enregistré la première transaction. Attendez quelques minutes et réessayez. Le plugin récupérera l'ID de capture de l'historique des transactions de PayPal au moment du remboursement.

Ressources pour les développeurs

Hooks et filtres

  • charitable_paypal_log_platform_fee_on_donation (filtre, par défaut false). Retourne true pour ajouter une ligne « Frais de plateforme » au journal des dons à chaque capture. Utile pour les sites qui souhaitent une visibilité complète sur les frais de renouvellement de niveau Lite.
  • charitable_paypal_platform_fee_percentage (filtre, par défaut 3). Ajustez le pourcentage des frais de plateforme appliqués aux dons de niveau Lite.
  • charitable_donation_cancellation_page (filtre). Personnalisez la page sur laquelle les donateurs arrivent après avoir annulé l'approbation d'un abonnement PayPal.
  • charitable_donation_cancellation_args (filtre). Personnalisez les arguments de requête ajoutés à l'URL d'annulation du don.

WP-CLI

Le plugin est livré avec une commande WP-CLI spécifique à PayPal :

wp charitable paypal force-commerce-tier

Utilisez ceci si Charitable a détecté votre site comme un site Legacy PayPal (par exemple, s'il a importé des dons à partir d'un export hérité, ou d'un test de passerelle hérité abandonné) et que vous souhaitez opter pour PayPal Commerce à la place. Comprend un aperçu --dry-run et une confirmation requise --confirm-recurring-impact lorsque des dons récurrents hérités actifs sont présents.

Webhooks

Une fois connecté, le panneau de connexion affiche l'URL de webhook de votre site. Abonnez-vous à ces événements dans votre tableau de bord développeur PayPal :

  • CHECKOUT.ORDER.APPROVED
  • PAYMENT.CAPTURE.COMPLETED
  • PAYMENT.CAPTURE.DENIED
  • PAYMENT.CAPTURE.PENDING
  • PAYMENT.CAPTURE.REFUNDED
  • MERCHANT.ONBOARDING.COMPLETED
  • MERCHANT.PARTNER-CONSENT.REVOKED

Pour les comptes sandbox, vous pouvez également cliquer sur Créer automatiquement le webhook pour les enregistrer automatiquement.

Ressources supplémentaires

Vous avez encore des questions ? Nous sommes là pour vous aider !

Dernière modification :

Quoi de neuf dans Charitable

Voir les dernières mises à jour
🔔 Abonnez-vous pour recevoir nos dernières mises à jour
📧 Abonnez-vous aux e-mails

Abonnement par e-mail

Rejoignez notre newsletter

Nous ne vous enverrons pas de spam. Nous envoyons un e-mail uniquement lorsque nous pensons qu'il vous sera réellement utile. Désabonnez-vous à tout moment !

ambassadeurs Nouveau

🖨️ Présentation des prospectus et affiches : collectez des fonds loin de l'écran !

Une grande partie de la collecte de fonds de pair à pair se fait loin d'un écran : à la ligne d'arrivée d'un 5 km, sur un panneau d'affichage d'école, dans une cuisine de bureau. Charitable Ambassadors 3.4.7 ajoute 2 imprimables, un prospectus de collecte de fonds portant la propre histoire et le code QR de chaque collecteur de fonds, et une affiche de recrutement qui inscrit de nouveaux collecteurs de fonds. Les deux s'ouvrent comme une page Web normale et s'impriment directement depuis le navigateur. Pourquoi c'est important :

  • 🏁 Un prospectus pour chaque collecteur de fonds : Chacun porte la propre photo, histoire et objectif de ce collecteur de fonds, avec un code QR qui ouvre sa page plutôt que votre campagne principale.
  • 📌 Une affiche qui recrute : Elle affiche « Recrutement en cours » au-dessus du nom de votre campagne avec un grand code QR qui ouvre votre formulaire d'inscription, afin que quelqu'un puisse commencer à collecter des fonds sans attendre un lien de votre part.
  • 🪄 Aucun outil de conception nécessaire : Les deux imprimables s'affichent comme une page Web normale et s'impriment depuis le navigateur, sans plugin PDF et sans designer.
  • 📄 2 mises en page de prospectus : « À distribuer » contient l'histoire complète pour donner à vos amis et à votre famille, et « À afficher » contient un court message accrocheur avec 5 languettes détachables pour un panneau d'affichage.
  • 🛡️ Désactivé jusqu'à ce que vous l'activiez : Les prospectus restent désactivés après la mise à jour jusqu'à ce que vous les activiez sous Charitable » Ambassadeurs » Autre » Prospectus, et seul le propriétaire ou un administrateur peut en ouvrir un.

Consultez notre annonce ici.

Amélioration Paiements

💸 Introduction des tarifs échelonnés pour l'allègement des frais : Adaptez la demande au don !

L'allègement des frais pose une courte question à vos donateurs lors du paiement : souhaitez-vous couvrir les frais de traitement de ce don ? Jusqu'à présent, cette question utilisait un taux unique pour chaque don sur une passerelle, de sorte qu'un don de 10 $ et un don de 500 $ se voyaient demander le même pourcentage. L'allègement des frais 1.3.0 vous permet de définir autant de tranches de dons que vous le souhaitez, chacune portant son propre taux. Pourquoi c'est important :

  • 🪙 Plus doux pour les petits dons : Un coût de transaction fixe représente une part beaucoup plus importante d'un don de 10 $ que d'un don de 500 $, les tranches vous permettent donc de demander moins en bas.
  • 🎚️ Autant de tranches que nécessaire : Chaque tranche porte son propre pourcentage et son propre montant fixe, et la tranche supérieure s'exécute sans limite supérieure.
  • 🛑 Un plafond facultatif : Un champ de frais maximum empêche qu'un donateur ne se voie demander plus qu'un nombre que vous choisissez, quel que soit le montant du don.
  • 🔌 Défini par passerelle de paiement : Stripe peut fonctionner avec quatre tranches tandis que Windcave et Payfast restent sur un taux unique, car les tranches appartiennent à une passerelle et non à l'ensemble de votre site.
  • 🛡️ Rien ne change tant que vous ne le décidez pas : Vos taux actuels restent exactement les mêmes jusqu'à ce que vous activiez « Utiliser les tarifs échelonnés » sous Charitable » Paramètres » Avancé » Allègement des frais.

Consultez notre annonce ici.

Dons Amélioration

📊 Votre tableau de bord Pro peut désormais comparer, exporter et évaluer !

La plupart des tableaux de bord de collecte de fonds vous indiquent seulement combien vous avez collecté. Charitable Pro 1.8.19 reconstruit le tableau de bord et la Vue d'ensemble des rapports autour des questions les plus difficiles : si quelque chose ne fonctionne pas, si cette période a été meilleure que la précédente, et quel changement unique ferait la plus grande différence aujourd'hui. Pourquoi c'est important :

  • 📈 Chaque chiffre a une tendance : Choisissez une période et les vignettes ainsi que le graphique bougent ensemble, chaque total étant affiché par rapport à la période précédente.
  • 🗓️ Des graphiques lisibles : Les courtes périodes regroupent les dons jour par jour, tandis que les longues périodes regroupent par semaine ou par mois, de sorte qu'une année complète se lit comme une courbe au lieu d'une ligne plate.
  • 🔀 Comparez n'importe quelles 2 périodes : Pas seulement consécutives, vous pouvez donc demander comment ce mois de décembre s'est comparé au mois de décembre dernier. C'est important car la collecte de fonds est saisonnière.
  • 📤 Exportez le résumé complet : Envoyez la vue d'ensemble complète en CSV ou PDF, prête pour un dossier de conseil d'administration ou un rapport de bailleur de fonds.
  • 🎯 Évaluez votre configuration gratuitement : Faites évaluer votre configuration de collecte de fonds, de sorte que le seul changement à faire ensuite soit celui que vous pouvez voir.

Consultez notre annonce ici.

Fonctionnalité Nouveau

🎟️ Présentation des Événements Caritatifs : Vendez des Billets dans Vos Campagnes !

La plupart des organisations à but non lucratif vendent des billets d'événement dans un outil et collectent des dons dans un autre, ce qui laisse deux ensembles de rapports et une correspondance manuelle à la fin de l'année. Événements Caritatifs réunit les deux, en vendant des billets via les mêmes formulaires de don et passerelles de paiement que vous utilisez déjà dans Charitable. Pourquoi c'est important :

  • 🎟️ Chaque billet est un don : Les ventes de billets passent par la passerelle que vous utilisez déjà et comptent pour l'objectif de la campagne, le tout géré sous Charitable » Événements.
  • 📱 Enregistrement par QR code depuis n'importe quel téléphone : Chaque participant reçoit son propre code QR sur le reçu, et les bénévoles scannent à l'entrée via un lien d'enregistrement qui ne nécessite aucun compte WordPress.
  • 🧾 Reçus prêts pour la déclaration de revenus : Attribuez à chaque type de billet une juste valeur marchande, et Charitable indiquera le montant déductible d'impôt correct sur chaque reçu de donateur.
  • 📋 Détails des participants au moment du paiement : Demandez à chaque invité son choix de repas, sa taille de chemise ou ses besoins d'accès, avec un enregistrement distinct du participant créé pour chaque billet.
  • 🗓️ Blocs et calendriers inclus : Trois blocs d'éditeur ainsi que la prise en charge de Sugar Calendar et The Events Calendar placent vos événements là où les supporters les recherchent déjà.

Consultez notre annonce ici.

ia Nouveau

🚀 Libérez la puissance de l'IA dans Charitable !

Votre assistant IA peut désormais créer, modifier et gérer vos campagnes de collecte de fonds Charitable directement — il suffit de demander. Avec Charitable Pro ajoutant la prise en charge de l'écriture pour l'API WordPress Abilities, des outils comme ChatGPT, Claude et Cursor peuvent gérer des actions administratives complètes en toute sécurité via MCP. Pourquoi c'est important :

  • 🤖 Création de campagnes en langage clair : Demandez à votre assistant un objectif comme « Mettre en place une collecte de fonds pour le refuge avec un objectif de 5 000 $ », et il crée une ébauche de campagne complète avec des paliers de dons suggérés.
  • 🎨 Modifications instantanées du formulaire de don : Ajoutez des champs personnalisés, changez les couleurs des boutons ou réorganisez les éléments sans avoir à modifier les paramètres du formulaire.
  • 📝 Enregistrement des dons hors ligne : Informez votre assistant des dons en espèces ou par chèque, et il associera les e-mails des donateurs et enregistrera les transactions dans votre historique.
  • 🛡️ Sécurité et contrôle par défaut : L'accès en écriture reste désactivé jusqu'à ce qu'il soit activé dans Charitable » Outils » AI MCP, maintenant la sécurité des rapports en lecture seule par défaut.
  • 📜 Journalisation complète des audits : Chaque modification apportée par un assistant IA est suivie dans Charitable » Outils » Journaux, vous savez donc toujours qui (ou quoi) a mis à jour votre site.

Consultez notre annonce ici.