Qu'est-ce qu'un Webhook ?

Un webhook est une notification HTTP que Zru envoie à votre serveur chaque fois qu'un événement pertinent se produit dans votre environnement : un paiement est terminé, un abonnement est prélevé, une autorisation est créée, etc.

Comment configurer un Webhook

• Allez dans Développeurs dans le menu latéral gauche.
• Sélectionnez l'onglet « Webhooks ».
• Cliquez sur « Ajouter un webhook ».
• Saisissez un Nom pour identifier le webhook (par exemple : « Notifications vers le CRM »).
• Saisissez l'URL de votre endpoint.
• Dans Types de notification, choisissez les événements que vous souhaitez recevoir. Ils sont regroupés en neuf catégories que vous pouvez déplier : Transactions, Abonnements, Autorisations, Ventes, Transferts, Clients, Wallets, IBAN et Checkout.
• Utilisez le toggle Activé pour activer ou désactiver le webhook à la création.
• Cliquez sur « Créer ».

🧐 Chaque catégorie affiche un compteur avec les types sélectionnés sur le total, et propose un Tout sélectionner pour les cocher d'un coup.

🧐 À côté du nom de chaque événement, vous verrez son identifiant technique (par exemple transaction_confirmation_error). C'est la valeur que vous recevrez dans la notification, elle vous sert donc à développer votre intégration.

✋ Vous devez choisir au moins un type de notification pour pouvoir créer le webhook.

Actions disponibles sur les Webhooks

Une fois créé, le webhook apparaît dans la liste avec son Nom, son URL, le Type (les identifiants des événements auxquels il est abonné) et s'il est Activé. Depuis l'en-tête, vous pouvez filtrer par état et exporter la liste en CSV.

Vérification de la livraison

Depuis Développeurs ▶︎ Notifications vous pouvez voir toutes les notifications envoyées à votre endpoint et les réponses retournées.

Sécurité des webhooks

Chaque notification inclut un en-tête de signature que vous pouvez utiliser pour vérifier que la requête provient bien de Zru. Consultez notre documentation API pour plus de détails.

🧐 Les notifications sont toujours signées avec la Clé par défaut de l'environnement. Vous pouvez en savoir plus dans ce guide.

Mis à jour le : 11/08/2026