Connecter vos outils avec les webhooks

Préparez l'adresse de réception

C'est l'adresse https de votre serveur, de votre CRM ou d'un scénario Make ou Zapier. Pour essayer sans rien installer, ouvrez webhook.site : une adresse gratuite s'affiche, copiez-la.

Ouvrez les réglages

Dans le tableau de bord, cliquez sur le nom de votre association en bas à gauche, puis sur Paramètres et l'onglet Webhooks.

Ajoutez l'adresse

Cliquez sur Ajouter une adresse, collez l'adresse et donnez-lui une description qui vous parle, par exemple « Conversions Google Ads ».

Choisissez les événements

Les événements sont rangés par famille : paiements, dons mensuels, commandes, adhérents et billets, reçus fiscaux, versements… Dans le doute, gardez tout coché, puis cliquez sur Ajouter.

Copiez le secret

Une fenêtre affiche le secret de signature (il commence par whsec_). Cliquez sur Copier et transmettez-le à votre équipe technique : il prouve que les messages viennent bien de Donoor. Vous pourrez le réafficher à tout moment.

Envoyez un message d'essai

Sur la carte de votre adresse, cliquez sur Envoyer un test. Un message d'essai part aussitôt, signé comme les vrais.

Simulez un vrai événement

Bouton Simuler un événement : choisissez par exemple « Paiement confirmé » ou « Entrée scannée ». Un aperçu montre le message, puis Donoor l'envoie avec des données fictives (livemode false), sans aucun vrai paiement. Pour votre serveur de développement, ajoutez une adresse en cochant Adresse de test : elle ne reçoit que ces simulations.

Regardez le journal

Plus bas, le Journal des envois liste chaque message des 30 derniers jours, avec son statut : réussi, en échec ou en attente. Filtrez avec les boutons au-dessus de la liste.

Ouvrez un envoi

Cliquez sur une ligne : vous voyez la réponse de votre serveur (code 200 si tout va bien), chaque tentative avec son heure, et le message exact envoyé, à copier si besoin.

Vérifiez côté serveur

Dans votre outil (ou sur webhook.site), le message est arrivé avec l'en-tête Donoor-Signature : c'est lui que votre équipe technique vérifie.

Ajoutez vos paramètres de suivi

Dans vos annonces, ajoutez à votre lien Donoor les paramètres habituels : utm_source, utm_campaign… Google Ads ajoute lui-même le gclid si le marquage automatique est activé. Les paramètres sont gardés jusqu'au paiement, même si le donateur change d'onglet.

Le donateur fait son don

Rien ne change pour lui : la page de don est la même. Cela fonctionne aussi avec le widget intégré à votre site.

Le message arrive

Moins de deux minutes après le paiement, votre outil reçoit payment.succeeded : montant, donateur, identifiant de conversion et, dans attribution, les paramètres de l'annonce d'origine.

Transmettez la conversion

Votre serveur, ou un scénario Make ou Zapier, envoie la conversion à Google Ads, GA4 ou Meta avec le montant et l'identifiant de conversion. Vos campagnes sont mesurées don par don, même quand le navigateur bloque les cookies.

Modifiez une adresse

Le crayon ouvre la fenêtre de l'adresse : changez sa description ou ses événements. Les boutons Tout cocher et Tout décocher agissent famille par famille.

Mettez en pause

Mettre en pause arrête les envois vers cette adresse, par exemple pendant une maintenance. Réactiver les relance.

Changez le secret si besoin

Bouton Secret, puis Changer le secret. L'ancien reste valable 24 heures, le temps que votre équipe installe le nouveau.

Si votre serveur ne répond pas

Donoor réessaie automatiquement 8 fois sur environ 28 heures ; le journal affiche l'heure de la prochaine tentative. Après la dernière, vous êtes prévenu par e-mail. Une adresse en échec pendant 3 jours est mise en pause automatiquement.

Renvoyez un message

Une fois votre serveur réparé, ouvrez l'envoi dans le journal et cliquez sur Renvoyer : le même message repart aussitôt.

Transmettez la documentation

Envoyez à votre équipe technique le lien de la documentation technique des webhooks : elle décrit chaque événement et chaque champ.

Vérifiez chaque message

Le serveur vérifie l'en-tête Donoor-Signature avec le secret, puis répond par un code 200 en moins de 10 secondes. Un exemple chiffré permet de tester le code.

Testez sans risque

Sur sandbox.donoor.org, environnement de test séparé et non référencé par les moteurs de recherche, créez une association et connectez Stripe en mode test (des informations fictives suffisent). Votre page de paiement de test est aussitôt en ligne : faites-y des dons fictifs avec la carte 4242 4242 4242 4242 et recevez de vrais messages, marqués livemode false.