Uw tools koppelen met webhooks

Bereid het ontvangstadres voor

Dit is het https-adres van uw server, uw CRM of een Make- of Zapier-scenario. Om het uit te proberen zonder iets te installeren, opent u webhook.site: er verschijnt een gratis adres, kopieer het.

Open de instellingen

Klik in het dashboard linksonder op de naam van uw organisatie en daarna op Instellingen en het tabblad Webhooks.

Voeg het adres toe

Klik op Adres toevoegen, plak het adres en geef het een herkenbare beschrijving, bijvoorbeeld ‘Conversies Google Ads’.

Kies de gebeurtenissen

De gebeurtenissen zijn per categorie gerangschikt: betalingen, maandelijkse donaties, bestellingen, leden en tickets, donatiebewijzen, uitbetalingen… Laat bij twijfel alles aangevinkt en klik daarna op Toevoegen.

Kopieer het geheim

Een venster toont het ondertekeningsgeheim (het begint met whsec_). Klik op Kopiëren en geef het door aan uw technische team: het bewijst dat de berichten echt van Donoor komen. U kunt het op elk moment opnieuw weergeven.

Verstuur een testbericht

Klik op de kaart van uw adres op Test versturen. Er vertrekt meteen een testbericht, ondertekend net als de echte.

Simuleer een echte gebeurtenis

Knop Gebeurtenis simuleren: kies bijvoorbeeld ‘Betaling bevestigd’ of ‘Toegang gescand’. Een voorbeeld toont het bericht, daarna verstuurt Donoor het met fictieve gegevens (livemode false), zonder echte betaling. Voeg voor uw ontwikkelserver een adres toe en vink Testadres aan: het ontvangt alleen deze simulaties.

Bekijk het logboek

Verderop toont het Verzendlogboek elk bericht van de afgelopen 30 dagen met zijn status: geslaagd, mislukt of in behandeling. Filter met de knoppen boven de lijst.

Open een verzending

Klik op een regel: u ziet het antwoord van uw server (code 200 als alles goed gaat), elke poging met het tijdstip en het exacte verzonden bericht, dat u indien nodig kunt kopiëren.

Controleer op de server

In uw tool (of op webhook.site) is het bericht aangekomen met de header Donoor-Signature: die controleert uw technische team.

Voeg uw trackingparameters toe

Voeg in uw advertenties de gebruikelijke parameters toe aan uw Donoor-link: utm_source, utm_campaign… Google Ads voegt de gclid zelf toe als automatische tagging is ingeschakeld. De parameters blijven bewaard tot de betaling, ook als de donateur van tabblad wisselt.

De donateur doneert

Voor de donateur verandert er niets: de donatiepagina is dezelfde. Het werkt ook met de widget die in uw website is ingesloten.

Het bericht komt binnen

Minder dan twee minuten na de betaling ontvangt uw tool payment.succeeded: bedrag, donateur, conversie-ID en, in attribution, de parameters van de oorspronkelijke advertentie.

Geef de conversie door

Uw server, of een Make- of Zapier-scenario, stuurt de conversie naar Google Ads, GA4 of Meta met het bedrag en de conversie-ID. Uw campagnes worden donatie per donatie gemeten, ook als de browser cookies blokkeert.

Wijzig een adres

Het potlood opent het venster van het adres: wijzig de beschrijving of de gebeurtenissen. De knoppen Alles selecteren en Alles deselecteren werken per categorie.

Pauzeer het adres

Pauzeren stopt de verzendingen naar dit adres, bijvoorbeeld tijdens onderhoud. Weer inschakelen hervat ze.

Wijzig zo nodig het geheim

Knop Geheim, daarna Geheim wijzigen. Het oude blijft 24 uur geldig, zodat uw team de tijd heeft om het nieuwe te installeren.

Als uw server niet antwoordt

Donoor probeert het automatisch 8 keer opnieuw, verspreid over ongeveer 28 uur; het logboek toont het tijdstip van de volgende poging. Na de laatste krijgt u een e-mail. Een adres dat 3 dagen lang faalt, wordt automatisch gepauzeerd.

Verstuur een bericht opnieuw

Zodra uw server hersteld is, opent u de verzending in het logboek en klikt u op Opnieuw versturen: hetzelfde bericht vertrekt meteen opnieuw.

Geef de documentatie door

Stuur uw technische team de link naar de Technische documentatie van de webhooks: die beschrijft elke gebeurtenis en elk veld.

Controleer elk bericht

De server controleert de header Donoor-Signature met het geheim en antwoordt daarna binnen 10 seconden met code 200. Met een uitgewerkt voorbeeld kunt u de code testen.

Test zonder risico

Maak op sandbox.donoor.org, een afzonderlijke testomgeving die niet door zoekmachines wordt geïndexeerd, een organisatie aan en koppel Stripe in testmodus (fictieve gegevens volstaan). Uw testbetaalpagina staat meteen online: doe er fictieve donaties met de kaart 4242 4242 4242 4242 en ontvang echte berichten, gemarkeerd met livemode false.