L’en-tête svix-id
Chaque requête webhook inclut un en-têtesvix-id. Cet ID est :
- Unique par message - Chaque événement distinct reçoit un ID unique
- Cohérent lors des nouvelles tentatives - Le même ID est utilisé lorsqu’on retente une livraison échouée
Implémenter la déduplication
Pour vous assurer de ne traiter chaque événement qu’une seule fois, stockez lesvix-id et vérifiez-le avant traitement :
Quand utiliser la déduplication
La déduplication est particulièrement importante pour :- Le traitement des paiements - Éviter de facturer les clients deux fois
- La création de commandes - Empêcher les commandes en doublon
- Les mises à jour d’inventaire - Garantir des niveaux de stock précis
- L’envoi de notifications - Ne pas spammer les utilisateurs avec des messages en doublon
Options de stockage
Vous pouvez stocker les IDs de webhooks traités dans :Même sans déduplication, concevoir vos gestionnaires de webhooks pour qu’ils soient idempotents (produisant le même résultat lorsqu’ils sont appelés plusieurs fois) est une bonne pratique.