Revue d’habilitations dans une équipe touristique fictive

Intégration et fiabilité · Fiche de contrôle

Contrôler les reprises sans doublon

À utiliser pour une recette de double clic, délai dépassé ou réponse perdue. Vérifier les effets dans chaque système et le mécanisme de reprise autorisé.

Publié le . Mise à jour éditoriale le . Méthode éditoriale à adapter à votre produit et à votre organisation. Source de référence : Stripe : requêtes idempotentes, consultée le .

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

Préparer des données de test et interrompre le retour de l’opération dans l’environnement autorisé. Retrouver l’intention, ses paramètres et son résultat sans créer automatiquement une nouvelle commande.

Utiliser des références et documents autorisés, avec les droits adaptés. Conserver les éléments nécessaires au contrôle et retirer les données personnelles ou de compte inutiles.

Pour Stripe, conservez explicitement le chemin /v1 ou /v2. Le guide sur l’idempotence détaille leurs différences et propose un exercice de lecture. Cette distinction concerne la reprise technique ; elle ne confirme pas la prestation de voyage.

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

Une intention fictive V8 prévoit une réservation de 240 € et le paiement P8. La création de P8 part avec la clé K8, puis la réponse est perdue. Entre-temps, le voyageur choisit une option à 260 €. Un collègue propose de reprendre K8 en modifiant simplement le montant.

Comparer avec le résultat attendu

Rechercher d’abord le résultat de l’intention à 240 €, côté paiement et réservation. La demande à 260 € doit suivre un traitement explicitement prévu ; elle n’est pas une répétition identique. Relier les deux versions et faire valider le devenir de la première avant tout nouvel engagement. Aucune valeur secrète n’est nécessaire dans le registre.

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.

Contrôler les reprises sans doublon : données et contrôles
ChampÀ collecterTest ou rapprochement
IntentionV8 à 240 €, puis choix modifié à 260 €.Distinguer reprise de V8 et changement de commande avant de choisir le mécanisme.
PérimètreChemin /v1 ou /v2, API, compte ou sandbox et version utilisée.Identifier le périmètre exact avant d’appliquer une règle de reprise ; le namespace et la version ne sont pas interchangeables.
ConservationDate de première utilisation de la clé et règle documentée.Dans Stripe /v1, une clé peut être supprimée après au moins 24 heures. Retrouver le résultat avant de rejouer une ancienne intention.
ParamètresPremière tentative K8 : 240 € ; reprise proposée : 260 €.Comparer les paramètres et les règles du service ; ne pas masquer le changement derrière la même clé.
TentativesMoments et résultats reçus.Conserver délai dépassé comme état inconnu tant qu’il ne l’est pas.
Résultat conservéCode HTTP, réponse enregistrée et état de l’objet.Dans Stripe /v1, un 500 peut être conservé puis rejoué. Il ne justifie pas à lui seul une nouvelle clé.
RapprochementRéponse de P8 perdue ; réservation et paiement à retrouver.Rapprocher les références des deux systèmes avant une nouvelle création.
EffetsDossiers, transactions et notifications.Compter les conséquences finales, pas seulement les écrans.

Trois erreurs qui fragilisent le dossier

  • Créer une référence différente à chaque double clic.
  • Supposer qu’un paiement protégé empêche un second dossier fournisseur.
  • Réessayer toute erreur sans vérifier sa nature.

Transmettre un résultat exploitable

Transmettre le cas, les références, la version des règles et le résultat constaté. Identifier la différence non résolue et la personne chargée de confirmer la prochaine action.

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

Questions fréquentes

Que montrer lors d’un délai dépassé ?

Un état de suivi fidèle à la preuve disponible, avec recherche de résultat ou traitement par un responsable, au lieu d’affirmer un refus non établi.

Quel test révèle une protection partielle ?

Une reprise qui produit un seul paiement mais plusieurs réservations, ou l’inverse ; inspecter les deux systèmes.

Comment vérifier la clôture ?

Rapprocher les références et le nombre d’effets attendus, avec l’état final des tentatives et les événements reçus.

Documentation et application

Les précisions utiles des sources

Stripe : distinguer les règles d’idempotence v1 et v2

La documentation distingue les générations d’API. La même expression « requête idempotente » ne suffit pas à décrire les conditions d’une reprise.

Stripe : distinguer les règles d’idempotence v1 et v2
Point documentéCe que la source préciseConséquence pour votre contrôle
API v1Une fois l’exécution commencée, le premier statut et le corps sont conservés pour la clé, y compris une réponse 500.Relire l’objet et l’état de l’opération avant de changer de clé après une erreur.
Durée de conservation v1Une clé peut être supprimée après au moins 24 heures ; sa réutilisation après suppression peut démarrer une nouvelle requête.Conserver aussi un identifiant métier durable ; la clé HTTP n’est pas une protection permanente.
ParamètresStripe compare les paramètres d’une reprise avec ceux de la première requête.Ne pas réutiliser une clé pour un montant ou un bénéficiaire différent.
API v2La documentation décrit une reprise des requêtes incomplètes ou échouées lorsque c’est possible, avec une réponse pouvant être actualisée.Lire la règle de la version appelée au lieu de transposer automatiquement celle de v1.
Périmètre de reprise /v2Même clé pour la même API, dans le même compte ou sandbox et dans un délai de 30 jours.Noter le namespace, le compte et la date initiale ; une version Stripe ne remplace pas ces informations.

Ces règles concernent Stripe ; elles ne confirment ni la prestation touristique ni le traitement idempotent d’un second système.

Stripe — Idempotent requests · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.

Stripe — périmètre et reprise dans /v2 · consultée le 27/10/2026

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.

GetYourGuide Supplier : une modification peut conserver la référence GYG

Une demande de changement d’effectif ou d’horaire crée un nouveau cycle de réservation dans le parcours documenté.

GetYourGuide Supplier : une modification peut conserver la référence GYG
Point documentéCe que la source préciseConséquence pour votre contrôle
Même référence GYGGetYourGuide crée une nouvelle réserve puis une réservation avec la même référence GYG, mais des données modifiées.Ne pas ignorer la demande comme un doublon uniquement parce que la référence GYG est déjà connue.
Nouveau résultatL’intégrateur doit détecter les données modifiées et retourner une nouvelle réservation.Conserver la référence fournisseur et les détails de chaque version.
Ancienne réservationAprès réussite de la nouvelle réservation, GetYourGuide demande l’annulation avec l’ancienne référence de réservation fournisseur.Appliquer l’annulation à la bonne version.

Parcours Supplier API lorsque le client demande une modification à GetYourGuide ; distinct des droits de l’API partenaire de distribution.

GetYourGuide Integrator Portal — Booking Change · 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.

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.

Toutes les fiches de contrôle →