> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tester les webhooks

> Testez votre intégration webhook avant la mise en production. Envoyez des événements d'exemple depuis le tableau de bord, rejouez les livraisons et développez en local à l'aide de ngrok ou de tunnels similaires.

Tester votre intégration webhook avant la mise en production est essentiel pour une intégration réussie.

## Utilisation du tableau de bord

### Envoyer des événements de test

1. Accédez à votre endpoint webhook dans le tableau de bord
2. Cliquez sur **Send Test Event**
3. Sélectionnez le type d'événement à tester
4. Vérifiez le payload de test et envoyez-le

### Consulter les logs de webhook

Le tableau de bord affiche un journal complet de toutes les livraisons de webhook :

* **Statut** : succès ou échec
* **Temps de réponse** : combien de temps votre endpoint a mis à répondre
* **Code de réponse** : le code de statut HTTP renvoyé
* **Payload** : les données exactes envoyées

## Développement local

Pendant le développement, votre localhost n'est pas accessible depuis Internet. Voici quelques solutions :

### Utiliser ngrok

[ngrok](https://ngrok.com) crée une URL publique qui se connecte via tunnel à votre serveur local :

```bash theme={null}
# Start your local server on port 3000
npm run dev

# In another terminal, start ngrok
ngrok http 3000
```

Utilisez l'URL ngrok (par ex. `https://abc123.ngrok.io/webhooks`) comme endpoint webhook.

### Utiliser webhook.site

[webhook.site](https://webhook.site) fournit une URL gratuite qui capture toutes les requêtes entrantes :

1. Rendez-vous sur webhook.site
2. Copiez votre URL unique
3. Ajoutez-la comme endpoint webhook dans storekit
4. Déclenchez des événements et inspectez les payloads

## Checklist de test

Avant la mise en production, vérifiez :

<Checklist>
  * [ ] L'endpoint renvoie un statut 2xx dans les 15 secondes
  * [ ] La vérification des signatures est implémentée
  * [ ] La validation de l'horodatage rejette les anciens webhooks
  * [ ] Le gestionnaire est idempotent (gère les doublons)
  * [ ] Les erreurs sont loguées pour le débogage
  * [ ] La protection CSRF est désactivée pour l'endpoint
</Checklist>

## Mode test vs mode production

Testez les webhooks dans votre environnement de développement avant de les activer en production :

1. Créez un endpoint séparé pour les tests
2. Utilisez des identifiants de test / sandbox
3. Vérifiez que tout fonctionne
4. Basculez sur l'endpoint de production


## Related topics

- [Configurer les webhooks](/docs/fr/developers/webhooks/setting-up-webhooks.md)
- [Transformations](/docs/fr/developers/webhooks/transformations.md)
- [Aperçu des webhooks](/docs/fr/developers/webhooks/overview.md)
- [7. Tester et mettre en ligne](/docs/fr/getting-started/launch/test-and-go-live.md)
- [Événements webhook](/docs/fr/developers/webhooks/webhook-events.md)