Poste de travail technique pour préparer un catalogue

Données et intégrations · Fiche de contrôle

Tester les notifications d’une réservation

Une notification signale un événement ; elle ne remplace pas toujours la lecture de l’état actuel du dossier. Testez les répétitions et les interruptions avant de vous appuyer sur elle.

Publié le . Mise à jour éditoriale le . Méthode éditoriale à adapter à votre produit et à votre organisation. Source de référence : Stripe : webhooks et traitement des événements, consultée le .

Définir ce que la fiche doit permettre de vérifier

Listez les événements attendus et les effets qu’ils peuvent déclencher. La réception, l’acceptation technique et l’application métier sont des étapes distinctes. Un accusé de réception rapide peut précéder un traitement en arrière-plan, à condition qu’une reprise soit organisée. Les journaux doivent permettre le rapprochement sans conserver des payloads complets contenant des informations personnelles par défaut.

Stripe documente la vérification de signature, les répétitions et l’absence de garantie d’ordre de livraison de ses événements. Ces propriétés concernent ce service ; les autres fournisseurs doivent être examinés à partir de leur propre documentation. Utilisez des événements de test autorisés et laissez la gestion des secrets au processus prévu, hors de cette fiche.

Mise en pratique · situation fictive

Quel résultat cette fiche doit-elle permettre de vérifier ?

Les données et conditions de cet exercice sont inventées. Rejouez le cas dans un environnement autorisé en utilisant les huit contrôles de la fiche, puis comparez votre lecture au résultat proposé.

Situation de départ

Le contrat technique fictif de l’exercice fournit une version croissante par réservation. Pour R42, l’événement E2 porte « confirmée », version 2 ; E3 porte « annulée », version 3. Les notifications arrivent dans l’ordre E3, E2, puis E3 une seconde fois. Leur authenticité est considérée comme vérifiée pour ce test. Observez l’état conservé dans le dossier et le nombre de traitements métier ; un accusé de réception technique seul ne suffit pas à conclure.

Comparer avec le résultat attendu

Reconnaître la seconde réception de E3 et éviter de répéter son effet. La version 2 reçue après la version 3 ne doit pas rétablir une confirmation périmée dans les règles de cet exercice ; retrouver l’état de référence si un doute subsiste. Conserver réception, identifiant d’événement, version et résultat du traitement séparément. Deux événements distincts et une livraison répétée ne représentent pas trois changements indépendants. Ne généraliser cette comparaison de versions qu’aux fournisseurs qui documentent effectivement cette garantie.

Huit champs à rapprocher de leurs preuves

Gardez la source et la date de vérification à côté des informations collectées. Sur téléphone, les contrôles se lisent en cartes.

Tester les notifications d’une réservation : données et contrôles
ChampÀ collecterTest ou rapprochement
ÉvénementTypes utiles, objet concerné et version du schéma.Relier chaque événement à une décision métier ; ne pas traiter indistinctement tous les messages reçus.
AuthenticitéMéthode documentée et résultat de sa vérification.Tester un message altéré dans l’environnement autorisé ; ne jamais copier une clé dans le compte rendu.
DéduplicationIdentifiant de livraison ou d’événement et règle d’unicité.Recevoir deux fois le même événement sans créer une seconde réservation ou opération financière.
OrdreDates, version de l’objet et lecture de l’état actuel.Recevoir une mise à jour ancienne après une récente sans faire régresser le dossier.
RéceptionRéponse attendue et frontière avec le traitement métier.Vérifier qu’un accusé positif n’entraîne pas la perte silencieuse d’un travail non enregistré.
RepriseÉchecs, relances et file des opérations à revoir.Interrompre le traitement puis reprendre sans effet métier supplémentaire.
RapprochementRéférence de réservation et canal de lecture de référence.Retrouver une opération dont la notification manque ou ne suffit pas à établir l’état final.
SurveillanceDélais observés, exceptions et responsable d’escalade.Détecter une accumulation de messages ou un dossier bloqué avec une preuve exploitable.

Trois erreurs qui fragilisent le dossier

  • Appliquer chaque message comme une nouvelle opération. Une répétition de livraison doit rester distincte d’une nouvelle demande métier.
  • Utiliser l’ordre d’arrivée comme vérité chronologique. Un événement retardé peut décrire un état déjà dépassé.
  • Accepter tous les événements puis perdre le traitement après une panne. La frontière entre réception et travail durable doit être testée.

Transmettre un résultat exploitable

Préparez une matrice événement, objet, action attendue, règle de répétition et procédure de reprise. Joignez les références de test, les états observés et les preuves masquées. Définissez qui surveille les exceptions et qui peut déclencher une reprise. Le service client a besoin du résultat sur le dossier, pas de l’intégralité des messages techniques. La recette doit laisser visibles les situations non couvertes plutôt que supposer que toutes les notifications se comportent comme celles de la source citée.

Choisir un registre de contenus, médias ou recette · Préciser les responsabilités du parcours

Questions fréquentes

Le premier événement reçu est-il le plus ancien ?

Pas nécessairement. Vérifiez les garanties du service et rapprochez les mises à jour de l’état actuel de l’objet.

Peut-on rejouer un événement en production pour tester ?

Utilisez un environnement et une procédure autorisés. Une reprise réelle peut avoir des effets ; la recette doit maîtriser ces effets et leurs références.

Faut-il conserver tous les payloads ?

Définissez les preuves nécessaires et une conservation adaptée. Des références et états ciblés peuvent éviter de dupliquer des données personnelles.

Documentation et application

Les précisions utiles des sources

Duffel : identifier et vérifier les notifications aériennes

Le guide distingue configuration, contrôle cryptographique et unicité du traitement. Ces trois points ne se remplacent pas mutuellement.

Duffel : identifier et vérifier les notifications aériennes
Point documentéCe que la source préciseConséquence pour votre contrôle
Changement compagnieorder.airline_initiated_change_detected signale un changement initié par la compagnie.Relire la commande et qualifier les conséquences pour les voyageurs ; la notification ne vaut pas accord du client.
SignatureLe contrôle emploie X-Duffel-Signature et un secret ; ce secret n’est montré qu’à la création du webhook.Prévoir stockage protégé et rotation sans écrire le secret dans les journaux.
DoublonsDuffel indique d’utiliser idempotency_key pour l’unicité des événements rejoués.Ne pas inventer une clé de dédoublonnage à partir de la date de réception.
EnvironnementsWebhooks test et production sont séparés ; live_mode permet de les distinguer.Ne pas compter un ping de connectivité comme une réservation réelle traitée.

Comportement décrit par Duffel, à ne pas généraliser aux webhooks de tous les fournisseurs.

Duffel — Receiving webhooks · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Postmark : un code d’erreur peut arrêter les notifications

La réponse du point de réception détermine si Postmark retentera de transmettre un événement sortant.

Postmark : un code d’erreur peut arrêter les notifications
Point documentéCe que la source préciseConséquence pour votre contrôle
Nouvelle tentativeLes erreurs 5xx, 408, 429 et les échecs réseau donnent lieu à des reprises.Conserver l’événement et surveiller la récupération du service.
Arrêt de l’événementLes autres erreurs 4xx, dont 401, 403, 404 et 422, ne sont pas retentées.Ne pas compter sur une nouvelle tentative automatique après une erreur d’authentification ou une URL incorrecte.
Accusé de réceptionPostmark demande une réponse 200 après traitement ou remise à une file durable.Distinguer réception technique, sauvegarde durable et traitement métier.
VérificationUne défaillance persistante peut suspendre un type d’événement jusqu’à correction et nouvelle vérification.Contrôler les statuts Delivery et Bounce séparément ; une catégorie qui fonctionne ne prouve pas que l’autre fonctionne.
AuthentificationPostmark ne fournit pas de signature HMAC ; sa documentation recommande HTTP Basic Authentication en HTTPS et un filtrage des adresses IP.Contrôler le mécanisme du fournisseur, puis la structure du message, au lieu d’attendre un en-tête de signature inexistant.

Comportement des webhooks sortants Postmark ; les messages entrants utilisent une infrastructure distincte.

Postmark — Webhooks overview, retry attempts · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Approfondir ce contrôle

Toutes les fiches de contrôle · Méthode des sources

Approfondir la méthode

Modèles et champs associés

Ces modèles sont reliés à cette fiche ou à ses guides. Choisissez le périmètre qui correspond à votre contrôle. Consultez les informations à rapprocher et les contrôles proposés.

Passer à la vérification

Des fiches de contrôle pour ce sujet

Champs à collecter, tests, erreurs fréquentes et consignes de transmission pour travailler sur un dossier concret.

Vignettes illustratives générées par IA.

Toutes les fiches de contrôle →