Wenn Sie Ihr Square-Zahlungsgateway testen, bevor Sie live gehen, stellen Sie sicher, dass Spenden reibungslos funktionieren, wenn Sie starten. Diese Anleitung führt Sie durch die Verbindung Ihres Square-Sandbox-Kontos (Testkonto) mit Charitable.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:
- Ein Square-Konto
- Das Charitable-Plugin ist installiert und aktiviert
- Zugriff auf den WordPress-Admin
In dieser Anleitung
Schnelle Antworten
Ich habe auf „Mit Square (Sandbox) verbinden“ geklickt und ein leerer weißer Bildschirm wurde angezeigt. Was ist passiert?
Dies ist eine Anforderung von Square, kein Fehler in Charitable. Bevor Sie auf Verbinden klicken, öffnen Sie Ihr Square Sandbox Dashboard in einem anderen Tab desselben Browsers und lassen Sie es geöffnet. Kehren Sie dann zu Charitable zurück und klicken Sie erneut auf Verbinden. Die vollständigen Schritte finden Sie unten in Schritt 1.
Müssen meine WordPress-E-Mail und meine Square-E-Mail übereinstimmen?
Nein. Ihre WordPress-Admin-E-Mail, Ihre Live-Square-Konto-E-Mail und Ihre Square-Sandbox-Testkonto-E-Mail können alle unterschiedlich sein. Das ist normal und wird erwartet. Charitable verbindet sich über einen sicheren Autorisierungsfluss (OAuth) mit Square, nicht durch Abgleich von E-Mail-Adressen.
Was ist die Square-Sandbox?
Die Square-Sandbox ist eine Testumgebung, die das Live-Square-System widerspiegelt, ohne echtes Geld zu verarbeiten. Sie können den vollständigen Spendenfluss, die Fehlerbehandlung und Bestätigungs-E-Mails mit den Testkartennummern von Square testen. Sandbox-Transaktionen landen niemals auf einem echten Bankkonto.
Schritt 1: Erstellen Sie Ihr Square-Sandbox-Konto
Melden Sie sich bei Square an, falls Sie dies noch nicht getan haben, und melden Sie sich dann in Ihrer Square Developer Console an.
Hinweis: Die Developer Console dient zur Verwaltung von Anwendungen und API-Zugriffen. Das Square Dashboard dient allgemeinen Geschäftsoperationen. Es sind zwei verschiedene Orte.
Sie sollten eine Seite wie diese sehen:
Öffnen Sie im linken Navigationsmenü die Seite Sandbox-Testkonten. Sie sehen ein Standard-Testkonto zusammen mit einem Link zum Square Dashboard.
Klicken Sie auf den Link Square Dashboard. Ein neuer Tab öffnet sich mit Ihrem Sandbox-Square-Dashboard. Oben sehen Sie eine Sandbox-Anzeige, die bestätigt, dass dies nicht Ihr Live-Dashboard ist.
Wichtig: Lassen Sie diesen Sandbox-Dashboard-Tab während des gesamten Verbindungsvorgangs geöffnet und aktiv. Dies ist eine Anforderung von Square (nicht von Charitable) und notwendig, damit die Verbindung ordnungsgemäß funktioniert. Wenn Sie den Tab schließen, sehen Sie beim Versuch, eine Verbindung herzustellen, einen leeren weißen Bildschirm.
Schritt 2: Verbinden Sie Charitable mit Square
Wechseln Sie bei noch geöffnetem Sandbox-Dashboard-Tab zu Ihrem WordPress-Admin. Gehen Sie im Menü auf der linken Seite zu Charitable > Einstellungen > Zahlungsgateways.
Klicken Sie auf Gateway aktivieren neben Square, falls Sie dies noch nicht getan haben:
Aktivieren Sie auf derselben Seite den Testmodus – dies weist Charitable an, sich mit der Sandbox anstelle des Live-Squares zu verbinden. Klicken Sie auf Änderungen speichern.
Klicken Sie nun auf Gateway-Einstellungen, um die Square-Konfiguration zu öffnen. Suchen Sie den Abschnitt Verbindungsstatus und klicken Sie auf Mit Square-Konto verbinden (Sandbox).
Square wird Sie auffordern, die Verbindung zu autorisieren. Klicken Sie auf Zulassen und kehren Sie dann zu Charitable zurück und klicken Sie auf Änderungen speichern, um den Vorgang abzuschließen.
Erinnerung: Der Tab mit dem Square-Sandbox-Dashboard muss in einem anderen Browser-Tab geöffnet bleiben, während Sie die Verbindung herstellen. Halten Sie ihn auch für zukünftige Square-Tests geöffnet – nicht nur für die erstmalige Einrichtung.
Schritt 3: Testen Sie Ihre Verbindung
Machen Sie eine Testspende für eine Ihrer Kampagnen mit einer der Testkartennummern von Square (z. B. 4111 1111 1111 1111 für eine erfolgreiche Visa-Zahlung). Überprüfen Sie dann:
- Die Spende erscheint unter Charitable > Spenden
- Die Transaktion wird in Ihrem Square Sandbox Dashboard unter Transaktionen angezeigt
- Die Spender-E-Mail wird gesendet und sieht korrekt aus
Wenn alle drei übereinstimmen, funktioniert Ihre Verbindung.
Schritt 4: Wechseln Sie zu Live-Zahlungen
Sobald Sie sicher sind, dass die Sandbox-Verbindung funktioniert, schalten Sie Charitable in den Live-Modus:
- Gehen Sie zu Charitable > Einstellungen > Zahlungs-Gateways und klicken Sie auf Gateway-Einstellungen neben Square.
- Schalten Sie den Testmodus aus und klicken Sie auf Änderungen speichern.
- Klicken Sie im Abschnitt Verbindungsstatus auf Mit Square-Konto verbinden (diesmal ohne den Zusatz „Sandbox“) und autorisieren Sie Ihr Live-Square-Konto.
Ihre Live-Spenden werden nun von Ihrem echten Square-Konto verarbeitet.
Weitere Fragen
Wie schalte ich den Testmodus in Charitable aus?
Gehen Sie zu Charitable > Einstellungen > Zahlungs-Gateways, klicken Sie auf Gateway-Einstellungen neben Square, schalten Sie den Testmodus aus und klicken Sie auf Änderungen speichern.
Ich möchte mit der Währung eines anderen Landes testen. Wie?
Gehen Sie im Square Developer Dashboard zu Sandbox-Testkonten und klicken Sie auf Neues Sandbox-Testkonto. Wählen Sie das Land aus, dessen Währung Sie testen möchten, und verbinden Sie dann Charitable mit diesem Konto, indem Sie die oben genannten Schritte ausführen.
Wo finde ich weitere Tipps und Ratschläge für gemeinnützige Organisationen von Charitable?
Wir teilen regelmäßig praktische Anleitungen, bewährte Strategien und Insider-Tipps, um Ihnen zu helfen, mehr Spenden zu sammeln und stärkere Spenderbeziehungen aufzubauen:
- Abonnieren Sie unseren Newsletter – Erhalten Sie regelmäßig Tipps und exklusive Anleitungen in Ihrem Posteingang
- Abonnieren Sie unseren YouTube-Kanal – Sehen Sie sich Schritt-für-Schritt-Tutorials und Erfolgsgeschichten an
- Folgen Sie uns auf LinkedIn – Vernetzen Sie sich mit unserer Community und erhalten Sie tägliche Einblicke in Non-Profit-Organisationen
- Folgen Sie uns auf TikTok – Aufschlussreiche und unterhaltsame Videos, die Ihnen helfen, Ihre Anliegen voranzubringen
Benötigen Sie Hilfe bei anderen Funktionen von Charitable? Sehen Sie sich unsere anderen Dokumentationsleitfäden an oder kontaktieren Sie den Support.
