> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Comment configurer les Webhooks

# 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](https://docs.zrupay.com/) 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](https://academy.zrupay.com/fr/article/cle-publique-et-cle-secrete-kacngf/).