Documentation Charitable

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

Getting Started: How to Use PayPal Commerce in Charitable

Are you ready to offer your donors the trusted convenience of PayPal for their donations? Enabling PayPal in Charitable allows you to easily accept contributions using one of the most recognized and reliable payment methods in the world.

With just a few clicks, you can enhance your fundraising efforts and provide a seamless donation experience.

In this guide, we’ll walk you through setting up PayPal as a payment gateway in Charitable, customizing its settings, and ensuring everything is running smoothly, so you can start accepting donations with confidence.

Enable PayPal Payment Gateway

First, to enable PayPal, head to your WordPress admin. Go to Charitable » Settings » Payment Gateways tab. Here, you’ll see the PayPal option along with a button to “Enable Gateway”.

Paypal gateway settings page

When you enable the gateway, a new green “Gateway Settings” button will appear.

At this point, we recommend first turning on Test Mode. This will allow you to set up the gateway safely without any transactions accidentally coming through when you’re not ready. When test mode is active, you should see an alert at the top.

Alerte : mode test caritatif activé

Connect to Your PayPal Account

Now click on the Gateway Settings to go to the PayPal settings page.

Bouton de configuration de la passerelle PayPal

On this page, you can now connect to PayPal with a few clicks. There’s absolutely no coding needed.

Start by hitting the green “Connect with PayPal” button.

Connect with PayPal button

This will open up a new page to log in to your PayPal account. Enter your email and follow the onscreen instructions from PayPal.

PayPal login screen

Once you’ve logged in, you’ll see a success message like this. This lets you know that you’re ready to get paid with PayPal on your eCommerce store.

Ready to get paid with paypal

Back in your WordPress site, you’ll see that PayPal Commerce is successfully connected. Charitable also gives you a list of capabilities available to you. These include:

  • Payments Receivable
  • Email Confirmed
  • Advanced Card Processing
  • Apple Pay
  • Google Pay
  • Payment Method Vaulting
  • Fastlane
PayPal connected successfully

Below this, you’ll see more settings and configurations to fine-tune your PayPal Commerce Gateway. We’ll go through the options available here.

Customizing PayPal Commerce Settings

Webhooks

These are the webhooks available for developers to use:

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

Button Customization

You can change the button color and shape here to match your donation form better. Use the drop down menus to see the options available here.

PayPal payment options button

Enable More Payment Methods

Below the button customization options, you’ll see options to enable Venmo and Pay Later.

  • Venmo is a highly popular mobile payment service owned by PayPal, primarily available only in the United States. It is designed to make it easy to send and receive money directly from your smartphone.
  • “Pay Later” (often referred to broadly as Buy Now, Pay Later, or BNPL) is a type of short-term financing that allows consumers to make purchases and pay for them at a future date, often interest-free.

You can enable these options using the toggle button here.

Enable Venmo and Pay Later in paypal

Next, there are more advanced payment methods. These include:

  • Card Fields (ACDC) – This shows credit and debit card fields directly on your site. It requires Advanced Card Processing approval
  • Apple Pay – This requires Apple Pay approval from PayPal. It will appear to users on the Safari browser on Apple devices.
  • Google Pay – Appears to donors using Chrome or Edge browsers with Google Pay enabled. This requires Google Pay approval from PayPal.
  • Fastlane – Gives you an accelerated checkout for guest users.
Advanced payment methods in paypal settings

All of these options can be enabled/disabled using the toggle button.

Payment Method Vaulting

Payment Method Vaulting (often referred to simply as the PayPal Vault) is a feature used by merchants and businesses to securely save a customer’s payment information for future use.

Instead of a business storing your sensitive credit card or bank account details on their own servers – which is a massive security risk – they use PayPal’s Vault to handle it.

You can enable it using the toggle next to “Enable Payment Method Vaulting”.

When enabled, you can customize the settings thatt include:

  • Vaulting Option Display: This decides how the option to save payment methods appears to users during checkout
  • Auto-vault for Recurring Donations: When enabled, this automatically saves payment methods for recurring donations.
  • Recurring Processing Mode: You can choose Vault+Cron (merchant-managed) or PayPal Subscriptions API (PayPal-managed)
  • Vaulted Method Expiry (in Days): Number of days before stored methods go unused before they expire. You can leave it empty if you don’t want this data to expire.
PayPal payment method vaulting

Once you’re done making changes, make sure you save changes before exiting this page.

Testing Your Donation Form with PayPal Commerce

We recommend running test transactions to ensure your transactions go through. Open any Charitable campaign, select an amount you want to donate. Scroll to the payment section and you should see PayPal appear like so:

Choose your preferred payment method and complete your donation.

PayPal Commerce donation form

Once your donation is successful, your receipt will appear.

Here’s a sample:

Charitable PayPal receipt

Check Donation Records

Head over to Charitable » Donations. You can view the donation record list here. Choose the one you just made.

On the next page, you’ll see the Donation Details. This will show you the Payment method and the log which bears all the details of the Prder ID, PayPal capture ID, and gateway transaction ID.

Donation record with PayPal details

On the right panel of this screen, you’ll see Donation Actions.

Using the drop-down menu, you can choose to refund the donation

Check the box that reads “Refund in PayPal Commerce automatically.”

Then “Update Status” here.

This will ensure that the donation is refunded directly through PayPal.

Refund in paypal

When you’re done testing PayPal with Charitable, make sure you turn off Test Mode. Now live donations can come through to your non-profit.

Disconnecting PayPal Commerce

To disconnect PayPal, return to Charitable » Payment Gateways, click on the “Gateway Settings” next to PayPal.

On this page, find the “Disconnect Account” button under Connection Status.

Disconnect PayPal

Disabling the PayPal Gateway

To disable the PayPal gateway, go to Charitable » Payment Gateways. Next to PayPal, you can click on the “Disable Gateway” button.

Disable PayPal gateway

That’s it. You’ve learned how to set up and manage PayPal as a payment gateway in Charitable. Next, you may also want to learn about payment gateways:

You may also want to read our guide on Understanding Nonprofit Platform and Processing Fees (And How to Minimize Them) »

Need support? Have a question? If you are a lite/free user of Charitable, you can reach out to our team on the WordPress.org support forums. If you have an active license, feel to reach out us directly for priority support.

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 →

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 !

GiveWP Migrations Nouveau

Service de migration "White Glove" pour GiveWP

Vous envisagez de passer de GiveWP à Charitable pour votre plateforme de collecte de fonds, mais vous ne voulez pas risquer de perdre vos données ni gérer vous-même une configuration technique complexe ? Le service de migration "White Glove" de Charitable comprend :

👥 Cartographie parfaite des donateurs : transférez en toute sécurité toute votre base de données de supporters sans aucune perte de données.

📊 Historique financier complet : préservez méticuleusement chaque transaction historique pour des rapports continus et précis.

🔄 Dons récurrents transparents : transférez en toute sécurité les abonnements récurrents actifs sans perturber vos revenus entrants ni obliger vos donateurs à mettre à jour leurs informations.

💳 Aucune interruption de passerelle : continuez à utiliser Stripe, PayPal ou tout autre processeur compatible avec GiveWP que vous utilisez déjà.

🚀 Configuration technique experte : détendez-vous pendant que notre équipe s'occupe du travail le plus difficile pour installer et configurer vos formulaires — de plus, les utilisateurs éligibles reçoivent une année complète de Charitable Pro gratuitement.

Visitez cette page pour en savoir plus.

automatisation Amélioration

📢 Alerte nouvelle fonctionnalité : Automation Connect 2.0 est là ! 🚀

Vous envisagez de connecter vos données de collecte de fonds à des outils comme Mailchimp, Slack ou Google Sheets, mais vous ne voulez pas engager un développeur ou écrire du code personnalisé ? Le nouvel add-on d'automatisation de Charitable propose :

⚡ 17 déclencheurs d'événements : déclenchez instantanément des webhooks pour le premier don d'un donateur, les paiements de renouvellement ou les étapes importantes de la campagne atteintes.

🎯 Logique conditionnelle intelligente : utilisez une logique ET/OU puissante sur 11 champs pour n'envoyer des données que lorsqu'elles répondent à vos critères exacts, comme les inscriptions à la newsletter.

📊 Contrôle personnalisé de la charge utile : choisissez parmi plus de 80 champs de données propres sur les métadonnées du donateur, du don et de la campagne afin que vos applications obtiennent exactement ce dont elles ont besoin.

🚀 Modèles de plateforme pré-intégrés : évitez la configuration à partir de zéro avec des modèles prêts à l'emploi pour Zapier, Make.com, n8n, HubSpot et Slack.

🛡️ Outils de développement fiables : alimentez vos flux de travail avec des charges utiles signées HMAC-SHA256, des filtres WordPress complets et des journaux de nouvelles tentatives automatiques.

automatisation Amélioration

🔌 Charitable rencontre Zapier : Connectez-vous à plus de 7 000 applications et automatisez votre collecte de fonds

Fatigué de copier manuellement les données de dons dans des feuilles comptables ou de rechercher les nouvelles inscriptions de donateurs ? Mettez vos tâches administratives en pilote automatique. Charitable est maintenant officiellement sur Zapier, vous offrant un moyen puissant et sans code de connecter directement votre collecte de fonds au reste de vos outils préférés.

Chaque don, inscription de donateur et jalon de campagne peut désormais déclencher un flux de travail automatisé en toute transparence.

Quoi de neuf :

♾️ Connectez-vous à plus de 7 000 applications : Reliez vos campagnes Charitable à des logiciels quotidiens comme Google Sheets, QuickBooks, Slack, Mailchimp, HubSpot, Notion, Airtable, et des milliers d'autres.

⚡ 12 déclencheurs puissants : Créez des flux de travail approfondis à l'aide de déclencheurs d'automatisation intelligents couvrant l'ensemble du cycle de vie des dons, y compris Nouveau don, Nouveau donateur, Abonnement annulé et Objectif de campagne atteint.

📋 Modèles d'actions pré-intégrés : Commencez en trois minutes ou moins avec nos combinaisons de modèles prédéfinis, comme l'enregistrement automatique des nouveaux dons directement dans une feuille Google ou l'envoi d'e-mails de bienvenue personnalisés aux donateurs via Gmail.

🚫 Zéro code requis : Pas de webhooks complexes ni de scripts PHP personnalisés nécessaires. Choisissez simplement votre déclencheur, sélectionnez votre application, mappez vos champs, et laissez Zapier s'occuper du travail acharné.

Prêt à économiser des heures d'administration ? Obtenez Charitable Pro avec le module complémentaire Automation Connect dès aujourd'hui et lancez votre premier Zap !

Amélioration Paiements

🚀 Présentation de PayPal Commerce : Une connexion, six façons de faire un don

Les donateurs s'attendent à des options de paiement modernes et flexibles lorsqu'ils soutiennent une cause. S'ils ne voient pas leur méthode préférée sur votre formulaire de don, ils disparaissent souvent sans un mot. Avec PayPal Commerce, nous apportons une expérience de paiement entièrement modernisée directement à vos campagnes.

Profitez d'une seule intégration qui améliore vos formulaires, rend le don transparent et vous aide à capturer chaque don.

Quoi de neuf :

🔌 Connexion en un clic : Oubliez les clés API compliquées et la documentation pour développeurs. Cliquez simplement sur « Se connecter avec PayPal », connectez-vous à votre compte professionnel, et votre formulaire moderne sera en ligne en moins de cinq minutes.

💳 Six façons de donner : Offrez à vos supporters un accès instantané à leur solde PayPal, Venmo (US), le financement « Pay Later », les principales cartes de crédit/débit, Apple Pay (Safari) et Google Pay (Chrome), le tout à partir du même formulaire.

🔄 Dons récurrents flexibles : Prend entièrement en charge les dons mensuels. Choisissez entre l'API PayPal Subscriptions (gérée automatiquement par PayPal) ou Vault + Cron (gérée en toute sécurité sur votre site).

💬 Récupération d'erreurs conviviale : Fini les alertes navigateur confuses. Si un paiement est refusé, les donateurs voient des messages clairs et intégrés qui les guident sur la façon de résoudre le problème et de finaliser leur don.

Prêt pour PayPal, modernisé ? Mettez à jour vers Charitable Pro 1.8.15+ (ou Charitable Lite 1.8.11+) et connectez votre compte dès aujourd'hui !

Campagnes Nouveau

⏳ Compte à rebours de campagne : Créez de l'urgence et augmentez les dons

L'urgence est l'un des outils les plus puissants en collecte de fonds ! Découvrez le compte à rebours de campagne, un minuteur en direct et en temps réel conçu pour transformer la procrastination en générosité immédiate.

animation_compte_a_rebours_campagne

Quoi de neuf :

⏱️ Urgence en temps réel : Suivez magnifiquement les jours, heures, minutes et secondes jusqu'à la date limite de votre campagne avec des comptes à rebours visuels mis à jour en direct.

🎨 Adapté à votre style : Choisissez entre des tuiles bordées "Boxed" ou un affichage épuré "Inline" sur une seule ligne. Adaptez instantanément votre thème avec des contrôles de police et de couleur profonde.

🛠️ Placez-le n'importe où : Insérez le compte à rebours où vous le souhaitez en utilisant le champ "Campaign Builder", un bloc Gutenberg dédié, ou un simple shortcode.

🚨 Actions intelligentes à l'expiration : Contrôle total de l'état final : choisissez de remplacer automatiquement le minuteur par un message personnalisé, de le figer à zéro, et plus encore.