Documentation Charitable

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

Comment utiliser les paiements locaux Braintree

Vous souhaitez accepter des dons de vos sympathisants en utilisant leurs méthodes de paiement locales préférées ? Le module complémentaire Braintree de Charitable Pro (version 1.3.0 et ultérieures) ajoute la prise en charge de six méthodes de paiement européennes et polonaises, notamment iDEAL, Bancontact, EPS, BLIK, Przelewy24 et MyBank. Ces méthodes apparaissent automatiquement sur votre formulaire de don lorsque la devise de votre site correspond aux devises prises en charge par la méthode.

Ce guide vous expliquera comment activer et configurer les méthodes de paiement locales dans le module complémentaire Braintree.

Prérequis : Les méthodes de paiement locales nécessitent Charitable Pro avec le module complémentaire Braintree version 1.3.0 ou ultérieure.

Lire l'annonce complète de la fonctionnalité »

Avant de commencer, assurez-vous que Charitable Pro et le module complémentaire Braintree sont installés et activés sur votre site, avec vos identifiants API Braintree déjà configurés.

Table des matières

Méthodes de paiement locales disponibles

Le module complémentaire Braintree prend en charge six méthodes de paiement locales. Chaque méthode est liée à des devises et des pays spécifiques :

  • iDEAL – EUR uniquement. Utilisé aux Pays-Bas.
  • Bancontact – EUR uniquement. Utilisé en Belgique.
  • EPS – EUR uniquement. Utilisé en Autriche.
  • BLIK – PLN uniquement. Utilisé en Pologne.
  • Przelewy24 – PLN ou EUR. Utilisé en Pologne.
  • MyBank – EUR uniquement. Utilisé en Italie et au Portugal.

Vos donateurs ne verront que les méthodes qui correspondent à la devise de votre site. Par exemple, un site configuré en EUR affichera iDEAL, Bancontact, EPS, Przelewy24 et MyBank, mais pas BLIK (qui nécessite le PLN).

Activation des méthodes de paiement locales

Pour configurer les méthodes de paiement locales, allez dans Charitable » Paramètres » Passerelles de paiement »Þ Braintree dans votre administration WordPress. Faites défiler jusqu'à la section Méthodes de paiement locales.

Chaque méthode a son propre interrupteur. Le texte d'aide sous chaque interrupteur indique les devises et les pays pris en charge par la méthode. Activez les méthodes que vous souhaitez proposer à vos donateurs.

Lorsque vous avez terminé d'activer vos méthodes préférées, faites défiler jusqu'en bas de la page et cliquez sur Enregistrer les modifications.

Remarque : Vous devez également activer les méthodes de paiement locales au niveau du compte dans votre tableau de bord Braintree. Si vos donateurs rencontrent des erreurs lors de l'utilisation d'une méthode de paiement locale, contactez le support Braintree et demandez-leur d'activer les paiements locaux sur votre compte marchand.

Comment fonctionne le filtrage des devises ?

Les méthodes de paiement locales n'apparaissent sur votre formulaire de don que lorsque la devise de votre site correspond aux devises prises en charge par la méthode. Ce filtrage se fait automatiquement. Vous n'avez rien à configurer au-delà de l'activation des méthodes souhaitées.

Si la devise de votre site est définie sur USD, aucun bouton de paiement local n'apparaîtra sur le formulaire de don, même si vous avez activé les six méthodes dans les paramètres. Seules les devises EUR et PLN activent les boutons de paiement locaux.

Pour vérifier ou modifier la devise de votre site, accédez à Charitable > Paramètres > Général et recherchez le paramètre Devise.

L'expérience du donateur

Lorsqu'un donateur visite une page de campagne, il verra d'abord le formulaire de paiement par carte Braintree standard. Sous le formulaire de carte, un séparateur « ou payez avec » apparaît, suivi des boutons pour chaque méthode de paiement locale active.

Bouton local du formulaire de don

Lorsqu'un donateur clique sur un bouton de paiement local, une fenêtre contextuelle s'ouvre où il effectue le paiement via sa banque ou son fournisseur de paiement. Après autorisation, la fenêtre contextuelle se ferme et le formulaire de don est soumis automatiquement.

Si le navigateur du donateur bloque la fenêtre contextuelle, Braintree redirige le donateur vers le fournisseur de paiement dans la même fenêtre. Après avoir effectué le paiement, il est redirigé vers le formulaire de don où la soumission s'achève automatiquement.

Configuration des webhooks

Les méthodes de paiement locales traitent les dons de manière asynchrone. Le paiement du donateur n'est pas confirmé instantanément. Au lieu de cela, Braintree envoie des notifications webhook à votre site lorsque le statut du paiement change. Sans webhooks, les statuts des dons ne seront pas mis à jour après la soumission initiale.

Faites défiler vers le bas jusqu'à la section Configuration des webhooks sur la page des paramètres Braintree.

Si vous avez déjà configuré des webhooks pour les dons récurrents, vous devez ajouter les quatre événements de paiement locaux à votre abonnement webhook existant dans le tableau de bord Braintree :

  • Paiement local effectué – se déclenche lorsque la banque du donateur confirme le paiement. Met à jour le statut du don à Payé.
  • Paiement local annulé – se déclenche lorsqu'un paiement est annulé ou remboursé par la banque.
  • Paiement local expiré – se déclenche lorsqu'une autorisation de paiement expire avant que le donateur ne la complète.
  • Paiement local crédité – se déclenche lorsque les fonds sont réglés sur votre compte marchand.

Pour ajouter ces événements, cliquez sur le lien Ouvrir les paramètres des webhooks Braintree, trouvez votre abonnement webhook existant et ajoutez les quatre types d'événements de paiement locaux. Si vous n'avez pas encore de webhook configuré, copiez l'URL du point de terminaison affichée dans les paramètres et créez un nouveau webhook dans votre tableau de bord Braintree avec tous les événements listés.

Remarque : Sans le webhook Paiement local effectué, les dons effectués via les méthodes de paiement locales resteront en statut En attente et ne seront jamais mis à jour à Payé.

Limitations des dons récurrents

Les méthodes de paiement locales ne prennent pas en charge les dons récurrents. Il s'agit d'une limitation du traitement des paiements locaux de Braintree, et non du plugin Charitable.

Lorsqu'un donateur sélectionne une période de don récurrent (telle que Mensuelle ou Annuelle) sur un formulaire de campagne, tous les boutons de paiement locaux sont automatiquement masqués. Ils réapparaissent lorsque le donateur revient à un don unique.

Si vos campagnes reposent fortement sur les dons récurrents, vos donateurs devront toujours utiliser les paiements par carte, PayPal ou une autre méthode prise en charge pour ces dons.

Test de votre configuration

Après avoir activé vos méthodes de paiement locales et configuré les webhooks, visitez l'une de vos pages de campagne pour confirmer que les boutons s'affichent correctement. Assurez-vous que la devise de votre site est définie sur EUR ou PLN pour que les boutons soient visibles.

Essayez de cliquer sur un bouton de paiement local pour vérifier que la fenêtre contextuelle s'ouvre. Dans l'environnement de test (sandbox) de Braintree, vous pouvez effectuer un don de test en sélectionnant une banque de test dans la liste. Après le don de test, consultez Charitable » Donations pour confirmer que le don a été enregistré et que le statut est mis à jour à Payé après le déclenchement du webhook.

C'est tout ! Vos donateurs peuvent désormais utiliser leurs méthodes de paiement locales préférées pour contribuer à vos campagnes. Pour en savoir plus sur les autres fonctionnalités du module complémentaire Braintree, consultez la documentation du module complémentaire Braintree.

FAQ

Que faire si les boutons de paiement locaux n'apparaissent pas sur mon formulaire de don ?

Il y a trois raisons courantes. Premièrement, vérifiez que la devise de votre site est définie sur EUR ou PLN dans Charitable » Settings » General. Les méthodes de paiement locales n'apparaissent pas pour les USD ou d'autres devises non prises en charge. Deuxièmement, confirmez qu'au moins une méthode est activée dans les paramètres de la passerelle Braintree. Troisièmement, vérifiez que Braintree a activé les paiements locaux au niveau du compte sur votre compte marchand.

Les dons sont bloqués en statut En attente. Comment puis-je résoudre ce problème ?

Cela signifie généralement que vos webhooks Braintree ne sont pas correctement configurés. Les dons par paiement local commencent en statut En attente et ne sont mis à jour à Payé que lorsque le webhook Local Payment Completed se déclenche. Accédez à la section Configuration des Webhooks et vérifiez que les quatre événements de paiement local sont inclus dans votre abonnement webhook.

Puis-je utiliser les méthodes de paiement locales avec une devise USD ?

Non. Les six méthodes de paiement locales nécessitent soit EUR, soit PLN comme devise du site. Si votre site est configuré en USD, les boutons n'apparaîtront pas sur les formulaires de don.

Les méthodes de paiement locales fonctionnent-elles avec les formulaires Campaign Builder ?

Oui. Les boutons de paiement locaux apparaissent sur les formulaires de don hérités et sur ceux de Campaign Builder, tant que la passerelle Braintree est active et que la devise du site correspond.

Les donateurs peuvent-ils enregistrer une méthode de paiement locale pour de futurs dons ?

Non. Les méthodes de paiement locales ne peuvent pas être stockées (enregistrées) dans Braintree. Les donateurs devront effectuer l'autorisation bancaire chaque fois qu'ils feront un don en utilisant une méthode de paiement locale.

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 !

Nouveau modèles

🤩 Nouveaux modèles de campagne Beacon avec bloc « Héros » !

Avec les nouveaux modèles de campagne Beacon pour Charitable Pro, vous pouvez lancer une page de collecte de fonds époustouflante sur toute la largeur qui capte instantanément l’attention des visiteurs au-dessus de la ligne de flottaison.

En-tête de la page de collecte de fonds pour Sauver le parc Maple Grove avec un widget de don et une petite photo carrée d'une miniature d'arbre ensoleillé à gauche.

🔦 Impact au-dessus de la ligne de flottaison : commencez avec une image principale sur toute la largeur, votre logo et votre objectif avec un widget de don directement sur la bannière afin que votre demande et votre élan soient enregistrés instantanément sans faire défiler.

📐 Deux mises en page flexibles : choisissez entre une mise en page structurée à deux colonnes pour le récit côte à côte et les détails de support, ou une vue épurée à une colonne conçue pour des récits longs et ininterrompus.

⚡ Champ Héros tout-en-un : alimenté par le nouveau champ Héros de campagne, réunissant les médias d’arrière-plan, les barres de progression en direct, les montants de don personnalisés et les onglets de dons récurrents dans un seul bloc cohérent qui peut être intégré dans n’importe quelle mise en page.

🎨 Correspondance automatique des thèmes : la bannière principale et le widget de don héritent automatiquement des couleurs de bouton et d’accent de votre thème de campagne, garantissant que l’ensemble de votre présentation reste magnifiquement fidèle à la marque sans toucher une ligne de CSS.

En savoir plus ici.

formulaire de don Fonctionnalité Nouveau

📝 Bloc de formulaire de don : Intégrez un formulaire de don fonctionnel n'importe où

Avec le nouveau bloc de formulaire de don pour Charitable Pro, vous pouvez placer un formulaire de don entièrement fonctionnel directement sur n'importe quelle page ou publication dans l'éditeur de blocs WordPress. Pas de redirections, pas de rechargements de page, et zéro friction entre la lecture de votre histoire et la contribution.

📝 Placez des formulaires n'importe où : Placez un formulaire fonctionnel directement sur votre page d'accueil, à l'intérieur d'une publication de blog axée sur l'histoire, sur une page de destination dédiée, ou dans une annonce de campagne.

🎯 Liaison dynamique de campagne : Choisissez facilement une campagne spécifique dans la barre latérale du bloc ou définissez-la pour qu'elle se lie automatiquement à la campagne en cours de visualisation.

📐 Vues de formulaire complètes vs minimales : Basculez entre une mise en page complète ou une vue minimale compacte pour s'adapter parfaitement aux barres latérales, aux colonnes étroites ou aux larges pages de destination.

🎨 Styles sans code ciblés : Personnalisez la typographie, l'espacement des conteneurs, le rayon des bordures, les boutons de montant et les couleurs d'accent indépendamment pour chaque instance de formulaire sans toucher une ligne de CSS.

En savoir plus ici.

ambassadeurs Nouveau

👤 Profils des créateurs : Mettez un visage derrière chaque campagne pair-à-pair

Ambassadors 3.3.0 propose désormais des profils de créateurs, offrant à vos supporters un espace public permanent et partageable qui transforme les collecteurs de fonds ponctuels en relations durables.

👤 Pages publiques des créateurs : Donnez à chaque collecteur de fonds une page de destination instantanée et soignée sur /creator/leur-nom/ pour présenter leur avatar personnalisé, leur biographie et une grille consultable de leurs campagnes.

📊 Preuve d'impact : Renforcez la confiance des donateurs en affichant les jalons de l'ensemble du site sur le profil, tels que le montant total collecté et le nombre total de donateurs.

💳 Cartes interactives au survol : Lorsque les donateurs survolent le nom d'un créateur sur une page de campagne, une carte compacte s'affiche avec sa biographie et ses identifiants sociaux au moment de la décision.

📍 Partage responsable de la localisation : Permettez aux créateurs d'indiquer en toute sécurité où se trouvent leurs supporters locaux en utilisant uniquement les détails de la ville, de l'État et du pays.

🛠️ Personnalisation en libre-service : Les collecteurs de fonds peuvent mettre à jour leurs propres profils et lier jusqu'à six réseaux sociaux directement depuis le hub Mes campagnes, ce qui vous fait gagner du temps d'administration.

Prêt à responsabiliser vos défenseurs ? Mettez à jour vers Ambassadors 3.3.0 et activez "Activer la page publique du créateur" dès aujourd'hui !

Amélioration Paiements

📱 Transformez les utilisateurs mobiles en donateurs : Découvrez la mise à niveau Mollie de Charitable

Vous perdez des supporters mobiles parce qu'ils détestent taper de longs numéros de carte sur leur téléphone ? L'intégration Mollie mise à jour de Charitable propose :

⚡ Paiement instantané via portefeuille : Permettez aux donateurs d'effectuer leurs dons instantanément en utilisant Apple Pay ou Google Pay avec une simple analyse faciale, une empreinte digitale ou un toucher.

💰 Pas de charge PCI supplémentaire : Évitez la vérification complexe du domaine et la conformité de sécurité, car toutes les transactions de portefeuille s'effectuent en toute sécurité via le paiement hébergé de Mollie.

🛠️ Routage personnalisé de l'annulation : Gardez l'expérience prévisible en renvoyant automatiquement les donateurs qui se retirent vers votre page d'annulation, ou utilisez des filtres de développeur pour les rediriger vers une page personnalisée.

Visitez cette page pour en savoir plus.

ambassadeurs amélioré Nouveau

Écrans de modération et d'annuaire dans Ambassadors 3.0

Ambassadors 3.0 propose de nouvelles fonctionnalités : écrans de modération et d'annuaire... voyez facilement ceux qui gagnent des dons sur votre réseau pair-à-pair, y compris les créateurs de campagnes qui pourraient avoir besoin d'être vérifiés, le tout en un seul endroit. Générez des rapports, envoyez des e-mails directement aux ambassadeurs et aux créateurs de campagnes, et plus encore.

🚀 Voyez quand les créateurs de campagnes et les ambassadeurs ont mis à jour leurs campagnes, ce que les donateurs/dons qu'ils ont apportés et plus encore.

🎉 Ajoutez manuellement des ambassadeurs et des créateurs de campagnes, et approuvez-les en un clic !

Visitez cette page pour en savoir plus.