Documentation Charitable

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

Comment connecter votre compte de test Square dans Charitable

Tester votre passerelle de paiement Square avant la mise en ligne garantit que les dons fonctionneront sans problème lors de votre lancement. Ce guide vous accompagne dans la connexion de votre compte sandbox (test) Square à Charitable.

Prérequis

Avant de commencer, assurez-vous d'avoir :

  • Un compte Square
  • Plugin Charitable installé et activé
  • Un accès administrateur WordPress

Dans ce guide

Réponses rapides

J'ai cliqué sur « Connecter à Square (Sandbox) » et j'ai obtenu un écran blanc vierge. Que s'est-il passé ?

C'est une exigence de Square, pas un bug de Charitable. Avant de cliquer sur Connecter, ouvrez votre Tableau de bord Sandbox Square dans un autre onglet du même navigateur et laissez-le ouvert. Revenez ensuite à Charitable et cliquez à nouveau sur Connecter. Les étapes complètes se trouvent dans l'Étape 1 ci-dessous.

Mon e-mail WordPress et mon e-mail Square doivent-ils correspondre ?

Non. Votre e-mail d'administrateur WordPress, votre e-mail de compte Square en direct et votre e-mail de compte de test Square Sandbox peuvent tous être différents. C'est normal et attendu. Charitable se connecte à Square via un flux d'autorisation sécurisé (OAuth), et non en faisant correspondre les adresses e-mail.

Qu'est-ce que le sandbox Square ?

Le sandbox Square est un environnement de test qui reflète Square en direct sans traiter d'argent réel. Vous pouvez tester le flux de dons complet, la gestion des erreurs et les e-mails de confirmation en utilisant les numéros de carte de test de Square. Les transactions Sandbox n'atteignent jamais un vrai compte bancaire.

Étape 1 : Créez votre compte sandbox Square

Inscrivez-vous à Square si ce n'est pas déjà fait, puis connectez-vous à votre Console Développeur Square.

Remarque : La Console Développeur sert à gérer les applications et l'accès aux API. Le Tableau de bord Square sert aux opérations commerciales générales. Ce sont deux endroits différents.

Vous devriez voir une page comme celle-ci :

Onglet de l'application Square

Dans la navigation de gauche, ouvrez la page Comptes de test Sandbox. Vous verrez un compte de test par défaut ainsi qu'un lien vers le Tableau de bord Square.

Onglet de test sandbox avec lien vers le tableau de bord Square

Cliquez sur le lien Tableau de bord Square. Un nouvel onglet s'ouvre avec votre tableau de bord Sandbox Square. Vous verrez un indicateur Sandbox en haut, confirmant qu'il ne s'agit pas de votre tableau de bord en direct.

Tableau de bord sandbox Square

Important : Gardez cet onglet de tableau de bord Sandbox ouvert et actif pendant tout le processus de connexion. C'est une exigence de Square (pas de Charitable) et c'est nécessaire pour que la connexion fonctionne correctement. Si vous fermez l'onglet, vous verrez un écran blanc vierge lorsque vous tenterez de vous connecter.

Étape 2 : Connectez Charitable à Square

L'onglet du tableau de bord Sandbox toujours ouvert, basculez vers votre administration WordPress. Dans le menu de gauche, allez dans Charitable > Paramètres > Passerelles de paiement.

Cliquez sur Activer la passerelle à côté de Square si vous ne l'avez pas déjà fait :

Passerelle d'activation Square de Charitable

Sur la même page, activez le Mode Test – c'est ce qui indique à Charitable de se connecter au sandbox au lieu de Square en direct. Cliquez sur Enregistrer les modifications.

Activer le mode test

Cliquez maintenant sur Paramètres de la passerelle pour ouvrir la configuration de Square. Trouvez la section État de la connexion et cliquez sur Se connecter au compte Square (Sandbox).

État de la connexion Square sandbox

Square vous demandera d'autoriser la connexion. Cliquez sur Autoriser, puis revenez à Charitable et cliquez sur Enregistrer les modifications pour finaliser.

Rappel : L'onglet du tableau de bord sandbox de Square doit rester ouvert dans un autre onglet de navigateur pendant que vous vous connectez. Gardez-le ouvert pour tout test futur de Square également – pas seulement pour la configuration initiale.

Étape 3 : Testez votre connexion

Effectuez un don de test sur l'une de vos campagnes en utilisant l'un des numéros de carte de test de Square (par exemple, 4111 1111 1111 1111 pour un paiement Visa réussi). Vérifiez ensuite :

  • Le don apparaît dans Charitable > Dons
  • La transaction apparaît dans votre tableau de bord sandbox Square sous Transactions
  • L'e-mail de reçu du donateur est envoyé et semble correct

Si les trois correspondent, votre connexion fonctionne.

Étape 4 : Passez aux paiements en direct

Une fois que vous êtes sûr que la connexion sandbox fonctionne, passez Charitable en mode réel :

  1. Accédez à Charitable > Paramètres > Passerelles de paiement et cliquez sur Paramètres de la passerelle à côté de Square.
  2. Désactivez le Mode test et cliquez sur Enregistrer les modifications.
  3. Dans la section État de la connexion, cliquez sur Se connecter au compte Square (pas d'étiquette sandbox cette fois) et autorisez votre compte Square réel.

Vos dons réels seront désormais traités par votre véritable compte Square.


Plus de questions

Comment désactiver le mode test dans Charitable ?

Accédez à Charitable > Paramètres > Passerelles de paiement, cliquez sur Paramètres de la passerelle à côté de Square, désactivez le Mode test et cliquez sur Enregistrer les modifications.

Je veux tester avec la devise d'un autre pays. Comment ?

Dans le tableau de bord développeur Square, accédez à Comptes de test sandbox et cliquez sur Nouveau compte de test sandbox. Choisissez le pays dont vous souhaitez tester la devise, puis connectez Charitable à ce compte en suivant les mêmes étapes que ci-dessus.

Où puis-je trouver plus de conseils et d'aide pour les organisations à but non lucratif de la part de Charitable ?

Nous partageons régulièrement des guides pratiques, des stratégies éprouvées et des conseils d'initiés pour vous aider à collecter plus de fonds et à établir des relations plus solides avec les donateurs :

Besoin d'aide avec d'autres fonctionnalités de Charitable ? Consultez nos autres guides de documentation ou contactez le support.

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 !

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.

Amélioration Paiements

💰 Acceptez les dons récurrents avec Windcave et Charitable

Un donateur configure son don une seule fois sur la page de paiement sécurisée de Windcave, et Charitable facture chaque renouvellement par la suite selon le calendrier établi. Pourquoi c'est important :

🏦 Organisations basées en Nouvelle-Zélande ou en Australie : dons mensuels sur la passerelle avec laquelle votre banque vous a déjà configuré, sans second processeur à intégrer.
⛪ Églises acceptant les dîmes et offrandes régulières : les membres de la congrégation définissent leur propre calendrier une fois, ce qui est le moyen le plus simple de lancer des dons d'église récurrents sans plateforme distincte.
🌏 Groupes avec des donateurs dans plusieurs devises : Windcave en gère plus de 20, ainsi un sympathisant peut donner dans la devise qu'il détient réellement.
📅 Fonds de fonctionnement plutôt que des campagnes ponctuelles : activez le mode « Récurrent uniquement » et l'option ponctuelle disparaît, de sorte que chaque don à cette campagne est un abonnement.
🧾 Équipes sans développeur attitré : 3 jeux d'identifiants collés sur une page de paramètres, et aucun code nulle part.

Consultez notre annonce ici.