Ihre Tools mit Webhooks verbinden

Bereiten Sie die Empfangsadresse vor

Das ist die https-Adresse Ihres Servers, Ihres CRM oder eines Make- oder Zapier-Szenarios. Um es ohne Installation auszuprobieren, öffnen Sie webhook.site: Dort erscheint eine kostenlose Adresse, die Sie kopieren.

Öffnen Sie die Einstellungen

Klicken Sie im Dashboard unten links auf den Namen Ihrer Organisation, dann auf Einstellungen und den Tab Webhooks.

Fügen Sie die Adresse hinzu

Klicken Sie auf Adresse hinzufügen, fügen Sie die Adresse ein und geben Sie ihr eine aussagekräftige Beschreibung, zum Beispiel „Conversions Google Ads“.

Wählen Sie die Ereignisse aus

Die Ereignisse sind nach Bereichen geordnet: Zahlungen, monatliche Spenden, Bestellungen, Mitglieder und Tickets, Spendenbescheinigungen, Auszahlungen … Lassen Sie im Zweifel alles angehakt und klicken Sie dann auf Hinzufügen.

Kopieren Sie das Secret

Ein Fenster zeigt das Signatur-Secret an (es beginnt mit whsec_). Klicken Sie auf Kopieren und geben Sie es an Ihr technisches Team weiter: Damit lässt sich prüfen, dass die Nachrichten wirklich von Donoor stammen. Sie können es jederzeit erneut anzeigen.

Senden Sie eine Testnachricht

Klicken Sie auf der Karte Ihrer Adresse auf Test senden. Sofort geht eine Testnachricht hinaus, genauso signiert wie die echten.

Simulieren Sie ein echtes Ereignis

Schaltfläche Ereignis simulieren: Wählen Sie zum Beispiel „Zahlung bestätigt“ oder „Eintritt gescannt“. Eine Vorschau zeigt die Nachricht, dann sendet Donoor sie mit fiktiven Daten (livemode false), ganz ohne echte Zahlung. Für Ihren Entwicklungsserver fügen Sie eine Adresse hinzu und aktivieren Testadresse: Sie empfängt nur diese Simulationen.

Sehen Sie sich das Protokoll an

Weiter unten listet das Zustellprotokoll jede Nachricht der letzten 30 Tage mit ihrem Status auf: erfolgreich, fehlgeschlagen oder ausstehend. Filtern Sie mit den Schaltflächen über der Liste.

Öffnen Sie eine Zustellung

Klicken Sie auf eine Zeile: Sie sehen die Antwort Ihres Servers (Code 200, wenn alles in Ordnung ist), jeden Versuch mit Uhrzeit und die genaue gesendete Nachricht, die Sie bei Bedarf kopieren können.

Prüfen Sie auf dem Server

In Ihrem Tool (oder auf webhook.site) ist die Nachricht mit dem Header Donoor-Signature angekommen: Genau diesen prüft Ihr technisches Team.

Fügen Sie Ihre Tracking-Parameter hinzu

Ergänzen Sie in Ihren Anzeigen Ihren Donoor-Link um die üblichen Parameter: utm_source, utm_campaign … Google Ads fügt den gclid selbst hinzu, wenn die automatische Tag-Kennzeichnung aktiviert ist. Die Parameter bleiben bis zur Zahlung erhalten, auch wenn die spendende Person den Tab wechselt.

Die Person spendet

Für sie ändert sich nichts: Die Spendenseite bleibt dieselbe. Das funktioniert auch mit dem auf Ihrer Website eingebundenen Widget.

Die Nachricht kommt an

Weniger als zwei Minuten nach der Zahlung erhält Ihr Tool payment.succeeded: Betrag, spendende Person, Conversion-ID und unter attribution die Parameter der ursprünglichen Anzeige.

Übermitteln Sie die Conversion

Ihr Server oder ein Make- oder Zapier-Szenario sendet die Conversion mit Betrag und Conversion-ID an Google Ads, GA4 oder Meta. Ihre Kampagnen werden Spende für Spende gemessen, selbst wenn der Browser Cookies blockiert.

Ändern Sie eine Adresse

Der Stift öffnet das Fenster der Adresse: Ändern Sie ihre Beschreibung oder ihre Ereignisse. Die Schaltflächen Alle auswählen und Alle abwählen wirken jeweils auf einen Bereich.

Pausieren Sie die Adresse

Pausieren stoppt die Zustellungen an diese Adresse, zum Beispiel während einer Wartung. Wieder aktivieren nimmt sie wieder auf.

Ändern Sie bei Bedarf das Secret

Schaltfläche Secret, dann Secret ändern. Das alte bleibt 24 Stunden gültig, damit Ihr Team Zeit hat, das neue einzurichten.

Wenn Ihr Server nicht antwortet

Donoor versucht es automatisch 8-mal über etwa 28 Stunden erneut; das Protokoll zeigt die Uhrzeit des nächsten Versuchs an. Nach dem letzten werden Sie per E-Mail benachrichtigt. Eine Adresse, bei der die Zustellung 3 Tage lang fehlschlägt, wird automatisch pausiert.

Senden Sie eine Nachricht erneut

Sobald Ihr Server repariert ist, öffnen Sie die Zustellung im Protokoll und klicken Sie auf Erneut senden: Dieselbe Nachricht geht sofort wieder hinaus.

Geben Sie die Dokumentation weiter

Senden Sie Ihrem technischen Team den Link zur Technischen Dokumentation der Webhooks: Sie beschreibt jedes Ereignis und jedes Feld.

Prüfen Sie jede Nachricht

Der Server prüft den Header Donoor-Signature mit dem Secret und antwortet dann innerhalb von 10 Sekunden mit dem Code 200. Ein durchgerechnetes Beispiel hilft beim Testen des Codes.

Testen Sie ohne Risiko

Erstellen Sie auf sandbox.donoor.org, einer getrennten Testumgebung, die von Suchmaschinen nicht indexiert wird, eine Organisation und verbinden Sie Stripe im Testmodus (fiktive Angaben genügen). Ihre Test-Zahlungsseite ist sofort online: Spenden Sie dort fiktiv mit der Karte 4242 4242 4242 4242 und erhalten Sie echte Nachrichten mit livemode false.