Un webhook annonce un événement externe ; sa réception ne garantit pas que le traitement métier a réussi. Concevez explicitement la validation, la déduplication et la reprise.
Séparer réception et traitement
Pour un service fictif d’abonnement, une notification de paiement peut arriver plusieurs fois ou dans un ordre inattendu. Vérifiez la signature selon le fournisseur, enregistrez durablement l’événement puis organisez son traitement. Ne marquez pas une opération terminée avant que son effet métier soit confirmé.
| Situation | Comportement attendu |
|---|---|
| Même événement reçu deux fois | Un seul effet métier |
| Traitement interrompu | Reprise identifiable |
| Événement ancien | Pas de retour incohérent à un état dépassé |
| Signature invalide | Refus et trace adaptée |
Préparer un outil de réconciliation
Conservez l’identifiant externe, le type d’événement et l’état du traitement, sans copier inutilement des données sensibles dans les journaux. Prévoyez une comparaison avec l’état de référence du fournisseur lorsque l’historique local est incomplet. Les modalités exactes de livraison et de nouvelle tentative dépendent du service utilisé.
Peut-on simplement répondre succès ?
Seulement si la réception est réellement acceptée selon votre contrat de traitement. Un succès HTTP envoyé avant tout enregistrement durable peut perdre un événement lors d’une panne. À l’inverse, un traitement long dans la requête peut provoquer des délais et des répétitions. Testez un doublon, un arrêt entre deux étapes et une reprise manuelle sur un environnement de test.
Sources et lectures utiles
Du guide à votre projet
Développement ↗
Un SaaS est un système : données, utilisateurs, droits, facturation et opérations. L’architecture doit soutenir votre modèle économique.
Parlez-nous de votre idéeLes exemples sont pédagogiques et ne décrivent pas des résultats clients. Contenu préparé avec assistance IA ; voir notre politique éditoriale. Notre méthode ↗