Dokumentation für Wohltätigkeitsorganisationen

Erfahren Sie, wie Sie mit klaren Schritt-für-Schritt-Anleitungen das Beste aus Charitable herausholen.

Einrichtung von Square Webhooks

Möchten Sie, dass Charitable Echtzeit-Updates erhält, wenn eine Zahlung über Square abgeschlossen oder zurückerstattet wird? Mit aktivierten Square-Webhooks können Ihre Formulare mit Square synchronisiert bleiben, sodass die Zahlungsstatus immer aktuell sind.

Diese Anleitung zeigt Ihnen, wie Sie Square-Webhooks einfach mit Charitable verbinden, um sicherzustellen, dass Ihre Website mit Ihren Square-Aktivitäten synchron bleibt.

Stellen Sie vor Beginn sicher, dass Sie Charitable installieren auf Ihrer WordPress-Seite. Danach verbinden Sie Ihre Seite mit Ihrem Square-Konto.

Webhooks verstehen

Webhooks sind eine Möglichkeit für Square, Charitable zu benachrichtigen, wenn ein Ereignis in Ihrem Konto auftritt, z. B. wenn eine Zahlung aktualisiert oder zurückerstattet wird. Sobald Charitable aktiviert ist, lauscht es auf diese Ereignisse, damit Ihre Website Zahlungsstatusänderungen automatisch widerspiegeln kann.

Mit eingerichteten Square-Webhooks müssen Sie Ihre Formulareinträge nach der Verarbeitung einer Transaktion nicht manuell überprüfen oder aktualisieren. Ob eine Zahlung durchgeht, zurückerstattet oder teilweise zurückgegeben wird, Ihr Charitable-Dashboard bleibt auf dem neuesten Stand der Informationen von Square.

Webhooks in Charitable aktivieren

Hier sind die Schritte, die wir in dieser Anleitung befolgen werden:

Schritt 1: Square-Zahlungen aktivieren

Um zu beginnen, öffnen Sie Ihren WordPress-Adminbereich und gehen Sie zum Tab  Charitable » Einstellungen » Zahlungs-Gateways .

Hier sehen Sie eine Liste verfügbarer Zahlungs-Gateways, die Sie mit einem Klick aktivieren/deaktivieren können. Falls Square-Zahlungen noch nicht aktiviert wurden, klicken Sie hier auf die Schaltfläche „Gateway aktivieren“.

Screenshot der Charitable-Einstellungen: Zahlungs-Gateways mit Stripe-, PayPal-, Square- und Offline-Optionen; jede hat Gateway-Einstellungen und Gateway deaktivieren-Schaltflächen; Testmodus aktivieren-Umschalter und Änderungen speichern am unteren Rand.

Sobald aktiviert, erscheint eine grüne Schaltfläche „Gateway-Einstellungen“. Klicken Sie darauf, um zum nächsten Schritt zu gelangen.

Schritt 2: Verbindung mit Square herstellen

Auf der Seite „Square Gateway-Einstellungen“ sehen Sie einen Abschnitt „Verbindungsstatus“ mit einer Schaltfläche „Mit Square-Konto verbinden“. Wählen Sie diese aus, und die Square-Anmeldeseite wird geöffnet.

Square-Gateway-Einstellungen mit einer Schaltfläche „Mit Square-Konto verbinden“ (Symbol angezeigt), Statuszeile und einer grünen Schaltfläche „Änderungen speichern“.

Geben Sie Ihre Anmeldedaten ein und melden Sie sich bei Ihrem Square-Konto an. Sie sehen eine Seite, auf der Sie Charitable die Berechtigung erteilen müssen.

Wählen Sie „Erlauben“ und Charitable wird mit Square synchronisiert.

Sandbox-App fordert Zugriff auf Ihr Square-Konto an; fragt nach Berechtigungen wie Profil anzeigen, Zahlungshistorie, Zahlungen tätigen, Bestellungen erstellen/aktualisieren, Kundendaten anzeigen, Rechnungen; Ablehnen und Zulassen-Optionen unten.

Nach der Verbindung werden Sie zur Seite Square Gateway-Einstellungen in Charitable zurückgeleitet.

Charitable ruft automatisch Ihre Geschäftsstandorte ab, und Sie können diese aus einem Dropdown-Menü auswählen. Dies gibt Ihnen die Möglichkeit, Standorte nach Bedarf zu wechseln.

Abschnittsüberschrift „Geschäftsstandorte“ mit einem dunklen Tooltip, der „Healthy Fit“ und „Healthy Fit Alt Location“ auflistet

Schritt 3: Webhooks in Square aktivieren

Wir haben die Aktivierung von Webhooks mit Square so einfach wie möglich gemacht. Es ist nur ein Kopieren und Einfügen. Befolgen Sie einfach die nachstehenden Schritte.

Zuerst sehen Sie auf derselben Seite Square Gateway-Einstellungen einen Abschnitt Webhooks aktivieren.

Hier ist eine Webhook-URL verfügbar. Sie müssen diese in Ihrer Square Developer Console (developer.squareup.com) hinzufügen. Klicken Sie auf das Clip-Symbol, um sie schnell zu kopieren.

Screenshot der Einrichtung „Webhooks aktivieren“ mit einem URL-Feld und einer hervorgehobenen Kopierschaltfläche zum Kopieren der Webhook-URL; zeigt darunter die Liste der erforderlichen Abonnements

Gehen Sie zu Ihrer Square Developer Console unter developer.squareup.com (dies ist die Entwicklerseite, nicht Ihr reguläres Square-Konto-Dashboard) und melden Sie sich mit demselben Square-Konto an, das Sie oben verbunden haben. Öffnen Sie die Anwendung, die Sie mit Charitable verwenden, oder erstellen Sie eine, indem Sie auf der Anwendungsseite auf das „+“ klicken und ihr einen Namen wie „charitable-listener“ geben. Jede Anwendung kann im Sandbox- oder Produktionsmodus ausgeführt werden: Wenn der Testmodus von Charitable aktiviert ist, verwenden Sie Sandbox; wenn der Testmodus deaktiviert ist, verwenden Sie Produktion. Wählen Sie den richtigen Modus aus und öffnen Sie den Tab Webhooks » Abonnements.

Modal-Dialog mit dem Titel „Benennen Sie Ihre Anwendung“ mit einem Texteingabefeld mit der Bezeichnung „Anwendungsname“ und einer schwachen Schaltfläche „Weiter“; Schließen (X) oben links.

Hier sehen Sie alle von Ihnen eingerichteten Webhooks.

Webhook-Abonnements in Square

Wählen Sie die Schaltfläche „Abonnement hinzufügen“, um einen neuen Webhook zu erstellen.

Abonnement hinzufügen

Jetzt können Sie Ihrem Webhook einen Namen geben, damit Sie ihn in Zukunft leicht erkennen können.

Fügen Sie darunter die kopierte URL ein.

Formular mit dem Titel „Webhook-Abonnement hinzufügen“ mit Feldern für Abonnementname, Benachrichtigungs-URL und API-Version sowie einem Abschnitt „Ereignisse“ mit Kontrollkästchen und einer Suche nach „payment.created“ in der Nähe einer Schaltfläche „Speichern“.

Jetzt gibt es hier noch einen Schritt. Darunter sehen Sie eine Liste von Ereignissen.

Sie müssen hier 5 bestimmte Ereignisse auswählen:

  • Rechnung.Zahlung_erfolgt
  • oauth.autorisierung.widerrufen
  • zahlung.erstellt
  • zahlung.aktualisiert
  • Rückerstattung.aktualisiert
Checkliste der Ereignisstatus mit Kontrollkästchen; ausgewählt: payment.created, payment.updated, refund.updated; andere nicht ausgewählt.

Wenn Sie wiederkehrende Spenden verwenden, wählen Sie auch subscription.created und subscription.updated aus. Die vollständige Liste der erforderlichen Ereignisse finden Sie in Ihrem Charitable-Dashboard. Unter der kopierten Webhook-URL sehen Sie die Liste der erforderlichen Webhook-Abonnements.

Nachdem Sie diese Ereignisse in Ihrer Square Developer Console ausgewählt haben, klicken Sie oben auf die Schaltfläche „Speichern“, um Ihren neuen Webhook zu speichern.

Speichern-Schaltfläche in Square-Webhooks

Das war's! Sie haben Ihr Charitable-Konto mit Square-Webhooks verbunden.

Jetzt können Sie zum Tab Webhooks » Abonnements gehen, und Sie sehen den Webhook, den Sie gerade eingerichtet haben.

Webhook erscheint im Dashboard

Kopieren Sie nach dem Speichern des Abonnements seinen Signaturschlüssel aus der Square Developer Console und fügen Sie ihn in das Feld Signaturschlüssel im Abschnitt Webhooks aktivieren in Charitable ein. Charitable verwendet diesen Schlüssel, um zu überprüfen, ob eingehende Webhooks tatsächlich von Square stammen. Stellen Sie dann sicher, dass Sie auch die Änderungen auf der Seite Square Gateway-Einstellungen in Ihrem WordPress-Admin-Panel speichern.

Wir empfehlen, ein oder zwei Testspenden zu tätigen, um sicherzustellen, dass Ihre Verbindung ordnungsgemäß funktioniert.

Wenn ein Spender nun einen Beitrag mit Square-Zahlungen leistet, wird er in der Spendenquittung wie folgt angezeigt:

Square-Spenden in Charitable anzeigen

Wenn eine Spende getätigt wird, werden die Transaktionsdetails von Charitable aufgezeichnet.

Sie können darauf unter Charitable » Spenden zugreifen.

Hier sehen Sie alle Spenden, die über alle von Ihnen auf Ihrer Website aktivierten Zahlungsgateways getätigt wurden.

Charitable zeigt die Spenden details wie Name, E-Mail-Adresse, gespendeten Betrag, Zahlungsgateway, Kampagne und Status an.

Dies gibt Ihnen einen Gesamtüberblick über alle erhaltenen Spenden.

Square-Spendenbeleg

Alle Transaktionen, die über das Square-Zahlungsgateway getätigt wurden, werden auch in Ihrem Square-Dashboard unter dem Tab Zahlungen & Rechnungen » Transaktionen angezeigt, wie hier:

Square-Transaktion abgeschlossen

Als Nächstes zeigen wir Ihnen, wie Sie Square-Rückerstattungen ausstellen.

Spenden mit Square zurückerstatten

Charitable erleichtert Ihnen die Ausstellung von Rückerstattungen für jede über Square getätigte Spende. Gehen Sie zu Charitable » Spenden und bearbeiten Sie den Spenden datensatz, den Sie zurückerstatten müssen.

Wählen Sie in der rechten Taskleiste im Abschnitt Spendenaktionen den Status „Erstattet“ aus dem Dropdown-Menü.

Spendenaufzeichnung

Sie sehen ein Kontrollkästchen „Automatisch in Square erstatten“. Aktivieren Sie dieses Kontrollkästchen und klicken Sie auf die Schaltfläche „Status aktualisieren“ .

Square-Transaktion erstatten

Das war's. Sie sehen die Rückerstattungsaktivität im Aktivitätsprotokoll auf derselben Seite.

Square-Spendendatensätze

Die Rückerstattung wird von Square bearbeitet. Sie können Ihr Square-Dashboard besuchen und sehen, dass die Rückerstattung vorgenommen wurde.

Rückerstattung in Square

Jetzt wissen Sie, wie Sie Square-Webhooks mit Charitable einrichten.

Häufig gestellte Fragen

Dies sind Antworten auf einige der häufigsten Fragen, die wir zum Einrichten von Square-Webhooks in Charitable erhalten.

Wie aktiviere ich Square-Zahlungen in Charitable?

Gehen Sie in Ihrem Charitable-Dashboard zu Einstellungen » Zahlungs-Gateways und aktivieren Sie das Square-Zahlungs-Gateway. Befolgen Sie dann unsere Square-Einrichtungsanleitung, um die Verbindung herzustellen.

Muss ich Webhooks sowohl für den Testmodus als auch für den Live-Modus einrichten?

Ja, Square stellt separate Anmeldeinformationen für die Sandbox- (Test-) und Produktions- (Live-) Umgebungen bereit. Stellen Sie sicher, dass Sie den richtigen Zugriffstoken verwenden, je nachdem, ob der Testmodus in Ihren Charitable-Einstellungen aktiviert ist.

Kann ich neben Square auch mehrere Zahlungs-Gateways aktivieren?

Ja, Charitable ermöglicht die Aktivierung mehrerer Zahlungs-Gateways. Sie können auch bestimmte Gateways für verschiedene Kampagnen aktivieren.

Möchten Sie als Nächstes mehr über die Erstellung von Kampagnen in Charitable erfahren? Sehen Sie sich unser Tutorial zur Erstellung Ihrer ersten Kampagne mit Charitable an.

Haben Sie noch Fragen? Wir helfen Ihnen gerne weiter!

Zuletzt geändert:

Was ist neu bei Charitable

Die neuesten Updates anzeigen
🔔 Abonnieren Sie, um unsere neuesten Updates zu erhalten
📧 E-Mails abonnieren

E-Mail-Abonnement

Abonnieren Sie unseren Newsletter

Wir werden Sie nicht spammen. Wir senden nur eine E-Mail, wenn wir glauben, dass sie Ihnen wirklich hilft. Abmeldung jederzeit möglich!

Botschafter Neu

🔑 Passworterose Spendenaktionen vorstellen: Melden Sie sich nur mit einer E-Mail-Adresse an!

Unterstützer kommen, um zu helfen, und dann bittet das Formular sie, ein Passwort für eine Website zu erfinden, die sie vielleicht nur zweimal besuchen. Viele von ihnen hören genau dort auf. Passworterose Spendenaktionskonten, neu in Charitable Ambassadors 3.5.0, ermöglichen es einem Unterstützer, eine Peer-to-Peer-Spendenaktion mit nichts weiter als einer E-Mail-Adresse zu starten. Warum das wichtig ist:

  • 🔑 Keine Passwortabfrage, die sie verliert: Schalten Sie es in Charitable » Ambassadors » Templates » Submit Form ein, und das Formular zum Erstellen von Spendenaktionen fragt nur nach einem Namen, einer E-Mail-Adresse und einem Seitentitel.
  • 👤 Immer noch ein echtes WordPress-Konto: Ein Klick in einer E-Mail bestätigt die Adresse, meldet sie an und erstellt das Konto, sodass sie später zurückkehren können, um ihre Geschichte zu bearbeiten, ihr Foto zu ändern und zu sehen, wer gespendet hat.
  • 🎚️ Ihre Entscheidung für jede Kampagne: Jede Peer-to-Peer-Kampagne kann die Standardeinstellung der Website übernehmen oder sie überschreiben, was wichtig ist, wenn eine Kampagne Spendenaktionen über Stripe Connect bezahlt und diese Personen ein Passwort benötigen.
  • 📋 Sehen Sie, wer noch nicht geklickt hat: Die Registerkarte Charitable » Ambassadors » Directory » Awaiting Sign-In listet alle auf, die noch warten, mit der Kampagne, der sie beigetreten sind, und einer Schaltfläche zum erneuten Senden, sodass Sie einen Tippfehler oder einen Spam-Ordner erkennen und beheben können.
  • 🛡️ Links, die ein Scanner nicht aufbrauchen kann: Das Öffnen des Links zeigt nur eine Seite an, und Ihr Spendenaktionsteilnehmer wird angemeldet, wenn er auf die Schaltfläche darauf klickt. Daher verbrennen E-Mail-Scanner von Unternehmen den Link nie. Jeder funktioniert einmal, läuft von selbst ab und wird nur als Hash gespeichert.

Lesen Sie hier unsere Ankündigung.

Botschafter Neu

🏃 Aktivität vorstellen: Fortschritt bei mehr als nur Geld anzeigen!

Bei den meisten Peer-to-Peer-Spendenaktionen geht es um mehr als nur Geld. Bei einem Lese-Marathon geht es um gelesene Minuten, bei einem Spendenlauf um gegangene Meilen und bei einer Lebensmittelspendenaktion um verpackte Mahlzeiten. Mit der Aktivität für Charitable Ambassadors können Ihre Spendenwerber diese Anstrengung direkt neben den gesammelten Dollar anzeigen. Warum das wichtig ist:

  • 🎯 Fortschritt bei dem, was Sie tatsächlich zählen: Ein Fortschrittsbalken zeigt jede Sache, die Sie zählen, gegen ihr eigenes Ziel an, direkt neben dem gesammelten Geld.
  • 🏅 Meilensteine für Ja-oder-Nein-Dinge: Eine Meilenstein-Plakette kennzeichnet Bemühungen, die einfach erledigt oder nicht erledigt sind, ohne eine Zahl, die es zu erreichen gilt.
  • ✍️ Spendenwerber protokollieren ihre eigenen Zahlen: Ihre Unterstützer geben ihre Summen von ihren eigenen Seiten ein, sodass die Anstrengung aufhört, in einer Tabelle, einem Kommentar oder gar nirgends zu leben.
  • 🤖 Einige Zahlen zählen sich selbst: Ein AUTOMATISCHES Tag erscheint überall dort, wo die Website die Zahl aus abgeschlossenen Spenden ermittelt hat, sodass Sie auf einen Blick sehen können, was niemand eingetippt hat.
  • 🧩 Einmal einrichten, überall verwenden: Sie entscheiden, was einmal gezählt wird, und wählen dann aus, welche Kampagnen es zählen. Jetzt verfügbar in Charitable Ambassadors 3.4.7, ohne neues Plugin und ohne Entwickler.

Lesen Sie hier unsere Ankündigung.

Botschafter Neu

🖨️ Wir stellen vor: Flyer und Poster: Sammeln Sie Geld abseits des Bildschirms!

Viele Spendenaktionen von Person zu Person finden abseits eines Bildschirms statt: an der Ziellinie eines 5-km-Laufs, an einer Schultafel, in einer Büchereiküche. Charitable Ambassadors 3.4.7 fügt 2 druckbare Elemente hinzu: einen Spenden-Flyer mit der eigenen Geschichte und dem QR-Code jedes Spendenwerbers und ein Rekrutierungsplakat, das neue Spendenwerber anmeldet. Beide lassen sich wie eine normale Webseite öffnen und direkt aus dem Browser ausdrucken. Warum das wichtig ist:

  • 🏁 Ein Flyer für jeden Spendenwerber: Jeder Flyer enthält das eigene Foto, die eigene Geschichte und das eigene Ziel des Spendenwerbers, mit einem QR-Code, der dessen Seite öffnet und nicht Ihre Hauptkampagne.
  • 📌 Ein Plakat, das rekrutiert: Es zeigt „Jetzt rekrutieren“ über Ihrem Kampagnennamen mit einem großen QR-Code, der Ihr Anmeldeformular öffnet, sodass jemand mit dem Spenden sammeln beginnen kann, ohne auf einen Link von Ihnen zu warten.
  • 🪄 Kein Design-Tool erforderlich: Beide Druckvorlagen werden als normale Webseite gerendert und aus dem Browser gedruckt, ohne PDF-Plugin und ohne Designer.
  • 📄 2 Flyer-Layouts: „Hand out“ enthält die vollständige Geschichte für Spenden an Freunde und Familie, und „Post up“ enthält einen kurzen Aufhänger mit 5 abnehmbaren Reitkarten für eine Pinnwand.
  • 🛡️ Ausgeschaltet, bis Sie es einschalten: Flyer bleiben nach dem Update deaktiviert, bis Sie sie unter Charitable » Ambassadors » Other » Fliers aktivieren, und nur der Eigentümer oder ein Administrator kann einen öffnen.

Lesen Sie hier unsere Ankündigung.

Verbesserung Zahlungen

💸 Einführung von gestaffelten Sätzen für Gebührenerleichterungen: Passen Sie die Anfrage an die Spende an!

Gebührenerleichterungen stellt Ihren Spendern beim Bezahlvorgang eine kurze Frage: Möchten Sie die Bearbeitungsgebühr für diese Spende übernehmen? Bisher wurde für jede Spende über ein Gateway ein einziger Satz verwendet, sodass für eine Spende von 10 $ und eine Spende von 500 $ derselbe Prozentsatz berechnet wurde. Gebührenerleichterungen 1.3.0 ermöglicht es Ihnen, beliebig viele Spendenbänder festzulegen, die jeweils ihren eigenen Satz haben. Warum das wichtig ist:

  • 🪙 Schonender bei kleinen Spenden: Eine feste Transaktionsgebühr macht einen weitaus größeren Anteil einer 10 $-Spende aus als einer 500 $-Spende. Bänder ermöglichen es Ihnen daher, am unteren Ende weniger zu verlangen.
  • 🎚️ So viele Bänder wie nötig: Jedes Band hat seinen eigenen Prozentsatz und seinen eigenen festen Betrag, und das oberste Band läuft ohne Obergrenze weiter.
  • 🛑 Eine optionale Obergrenze: Ein Feld für die maximale Gebühr verhindert, dass von einem Spender mehr als ein von Ihnen gewählter Betrag verlangt wird, egal wie hoch die Spende ist.
  • 🔌 Pro Zahlungs-Gateway einstellbar: Stripe kann mit vier Bändern laufen, während Windcave und Payfast mit einem einzigen Satz arbeiten, da Bänder zu einem Gateway und nicht zu Ihrer gesamten Website gehören.
  • 🛡️ Nichts ändert sich, bis Sie es sagen: Ihre aktuellen Sätze bleiben genau so, wie sie sind, bis Sie unter Charitable » Einstellungen » Erweitert » Gebührenerleichterungen die Option „Gestaffelte Sätze verwenden“ aktivieren.

Lesen Sie hier unsere Ankündigung.

Spenden Verbesserung

📊 Ihr Pro Dashboard kann jetzt vergleichen, exportieren und bewerten!

Die meisten Fundraising-Dashboards zeigen Ihnen nur, wie viel Sie eingenommen haben. Charitable Pro 1.8.19 baut das Dashboard und die Berichtsübersicht um die schwierigeren Fragen herum neu auf: ob etwas kaputt ist, ob diese Periode die letzte geschlagen hat und welche einzelne Änderung heute den größten Unterschied machen würde. Warum das wichtig ist:

  • 📈 Jede Zahl hat einen Trend: Wählen Sie eine Periode aus und die Kacheln und das Diagramm bewegen sich zusammen, wobei jede Summe im Vergleich zur Vorperiode angezeigt wird.
  • 🗓️ Lesbare Diagramme: Kurze Zeiträume gruppieren Spenden tageweise, während längere Zeiträume nach Woche oder Monat gruppieren, sodass ein volles Jahr als Kurve und nicht als flache Linie gelesen wird.
  • 🔀 Vergleichen Sie beliebige 2 Perioden: Nicht nur aufeinanderfolgende, sodass Sie fragen können, wie dieser Dezember im Vergleich zum letzten Dezember abgeschnitten hat. Das ist wichtig, da Fundraising saisonabhängig ist.
  • 📤 Fassen Sie die gesamte Zusammenfassung zusammen: Senden Sie die vollständige Übersicht als CSV oder PDF, bereit für ein Board-Paket oder einen Spenderbericht.
  • 🎯 Bewerten Sie Ihr Setup kostenlos: Lassen Sie Ihr Fundraising-Setup bewerten, damit die eine Änderung, die sich als Nächstes lohnt, diejenige ist, die Sie sehen können.

Lesen Sie hier unsere Ankündigung.