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 :
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.
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.
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 :
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.
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).
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 :
- Accédez à Charitable > Paramètres > Passerelles de paiement et cliquez sur Paramètres de la passerelle à côté de Square.
- Désactivez le Mode test et cliquez sur Enregistrer les modifications.
- 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 :
- Abonnez-vous à notre newsletter – Recevez des conseils réguliers et des guides exclusifs dans votre boîte de réception
- Abonnez-vous à notre chaîne YouTube – Regardez des tutoriels étape par étape et des histoires de réussite
- Suivez-nous sur LinkedIn – Connectez-vous avec notre communauté et obtenez des informations quotidiennes sur les organisations à but non lucratif
- Suivez-nous sur TikTok – Des vidéos perspicaces et amusantes pour vous aider à développer votre cause
Besoin d'aide avec d'autres fonctionnalités de Charitable ? Consultez nos autres guides de documentation ou contactez le support.
