
Paiement · Fiche de contrôle
Rapprocher le paiement et la réservation de voyage
Un paiement accepté, une prestation confirmée et un remboursement exécuté sont trois faits distincts. Cette fiche aide les équipes produit, finance et service client à garder leurs références et leurs états cohérents.
Publié le . Mise à jour éditoriale le . Méthode éditoriale à adapter à votre produit et à votre organisation. Source de référence : Stripe : réception et traitement des événements, consultée le .
Définir ce que la fiche doit permettre de vérifier
Commencez par dessiner les objets suivis : commande commerciale, réservation fournisseur, opération de paiement et opération de remboursement. Ils peuvent évoluer à des moments différents. Une page de retour du navigateur ne suffit pas à établir tous leurs états. Le dossier doit permettre de retrouver ce qui a été demandé, accepté ou rejeté sans assimiler un écran client à une preuve financière.
La documentation Stripe explique que les notifications peuvent arriver de manière asynchrone, être répétées et ne pas suivre l’ordre attendu. Pour une intégration qui utilise ces événements, contrôlez la déduplication et la lecture de l’état de référence. Les scénarios ci-dessous sont une méthode éditoriale ; adaptez-les aux événements et aux responsabilités réellement décrits par votre prestataire.
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 dossier fictif porte une prestation à 500 €. Le prestataire de paiement indique une autorisation de 600 €, dont 450 € ont été capturés ; le scénario ne prévoit aucun autre encaissement. La réponse à la demande de réservation s’est perdue. Un écran propose de recommencer la création et le paiement. Préparez le rapprochement qui évite de confondre somme autorisée, somme capturée et réservation confirmée.
Comparer avec le résultat attendu
Retrouver les références du paiement et de la demande fournisseur avant toute nouvelle opération. Les 450 € capturés ne prouvent pas la confirmation de la prestation. Les 150 € non capturés de l’autorisation ne sont pas un second encaissement ni une somme à rembourser comme telle. Si le prix de 500 € est maintenu et que les 450 € sont bien affectés à ce dossier, l’écart commercial à rapprocher est de 50 €. La décision de poursuivre, capturer davantage ou rembourser dépend ensuite des états et procédures effectivement confirmés.
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.
Aucun contrôle marqué comme examiné.
Marquez seulement les points dont vous avez examiné la preuve. Ce repère de lecture reste dans cet onglet ; il ne certifie pas le dossier et disparaît au rechargement.
| Champ | À collecter | Test ou rapprochement |
|---|---|---|
| Commande | Référence interne et total présenté au client. | Retrouver la même référence dans la réservation et dans le suivi financier. |
| Paiement | Référence du prestataire, montant, devise et état. | Distinguer demande, autorisation, capture, échec et annulation selon le modèle utilisé. |
| Prestation | Identifiant fournisseur et statut de confirmation. | Vérifier le traitement d’un paiement réussi lorsque la réservation échoue. |
| Événement | Identifiant, type, objet concerné et date de réception. | Rejouer un événement déjà reçu et vérifier qu’aucune action financière n’est doublée. |
| Chronologie | Heures des opérations et état de référence. | Recevoir une notification ancienne après une notification récente sans faire régresser le dossier. |
| Remboursement | Référence, montant demandé et résultat. | Rapprocher un remboursement partiel du solde ; conserver un statut en attente tant que nécessaire. |
| Frais | Commission, frais de traitement et règles applicables. | Ne pas confondre montant remboursé au client et frais restitués au marchand. |
| Exception | Responsable, motif et prochaine action. | Retrouver les dossiers bloqués sans explorer manuellement tous les événements. |
Trois erreurs qui fragilisent le dossier
- Confirmer la prestation à partir du seul retour du navigateur. Une interruption réseau peut produire une vue incomplète du paiement ou de la réservation.
- Marquer un remboursement comme terminé au moment de sa demande. Le résultat et ses éventuelles étapes intermédiaires doivent rester distincts.
- Utiliser le montant comme identifiant de rapprochement. Deux commandes différentes peuvent avoir exactement le même total.
Transmettre un résultat exploitable
Préparez un tableau d’exceptions avec référence de commande, référence fournisseur, référence financière, dernier état confirmé, responsable et date de prochaine action. Les preuves doivent provenir d’un environnement de test autorisé et masquer les informations personnelles. Définissez qui peut relancer une opération et quelle vérification précède cette relance. Le service client a besoin d’une explication de l’état du dossier ; la finance a besoin d’une piste de rapprochement. Une procédure commune doit relier les deux sans demander de partager des secrets dans le registre.
Choisir un registre de contenus, médias ou recette · Préciser les responsabilités du parcours
Questions fréquentes
Un événement reçu deux fois signifie-t-il deux paiements ?
Pas nécessairement. Distinguez l’identifiant de notification de l’opération financière. Le traitement doit retrouver l’objet concerné et éviter une seconde exécution de la même action.
Comment tester un paiement sans réserver réellement ?
Utilisez les environnements et moyens de test prévus par les prestataires. Vérifiez séparément le périmètre du paiement et celui du fournisseur de voyage avant de lancer le scénario.
Que doit voir le service client ?
Un état compréhensible, les références utiles, le dernier contrôle et la prochaine action. Les journaux techniques complets et les informations confidentielles ne sont pas nécessaires à chaque échange.
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.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| API v1 | Une 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 v1 | Une 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ètres | Stripe 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 v2 | La 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 /v2 | Mê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.
Booking.com Demand : carte exigée et paiement à l’hôtel
Le moment du paiement, le moyen demandé à la réservation et les cartes acceptées sur place répondent à des questions différentes.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Créer la réservation | Dans le preview d’hébergement, method_required indique si un moyen de paiement doit être fourni pour l’option choisie. | false ne signifie pas qu’aucune somme ne sera due plus tard. |
| Payer en ligne | Les cartes disponibles figurent dans general_policies.payment.<timing>.methods.cards du preview. | Lisez les méthodes de l’option sélectionnée, pas une liste générale de logos. |
| Payer sur place | Avec l’extra payment, /accommodations/details expose payment.methods.cards, virtual_cards et éventuellement cash. | Vérifiez séparément les moyens acceptés par l’établissement. /common/payments/cards permet de traduire les identifiants. |
| Transmission des cartes | Dans le modèle de paiement sur place géré par Booking.com, l’établissement ne reçoit pas la carte du voyageur via Demand. | Ne promettez pas sa transmission à l’hôtel ; le circuit corporate avec votre VCC est distinct. |
Périmètre hébergement Demand 3.2 et 3.3, consulté le 22 octobre 2026. method_required n’est pas renvoyé dans les previews de location de voiture.
Booking.com Demand — FAQ paiements, versions 3.2 et 3.3 · 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.
Stripe Connect : dossier transmis, paiement et versement restent distincts
Sur une plateforme touristique utilisant Connect, l’envoi des informations d’un prestataire ne suffit pas à le déclarer prêt à encaisser et à recevoir ses fonds.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Deux capacités | charges_enabled et payouts_enabled indiquent séparément la possibilité de créer des paiements et de recevoir des versements. | Conservez deux états lisibles dans le suivi du prestataire. |
| Demandes à traiter | currently_due rassemble les exigences à résoudre avant current_deadline. eventually_due contient celles qui peuvent devenir nécessaires selon les seuils atteints. | Affectez un responsable et une échéance aux demandes courantes. |
| Retard de vérification | past_due contient les exigences dont le dépassement d’échéance a désactivé des capacités ; pending_verification signale une vérification en cours. | Ne traitez pas une pièce en examen comme une pièce absente. |
| Suivi dans le temps | Stripe demande de surveiller account.updated ; disabled_reason et errors aident à comprendre le blocage. | La fin du premier parcours d’inscription n’arrête pas le suivi. |
Référence technique Connect consultée le 22 octobre 2026. Les exigences dépendent notamment du pays, du type d’entreprise et des capacités demandées. Cette vérification financière ne valide ni le contrat touristique ni la qualité des offres.
Stripe Connect — suivre la vérification des comptes par API · 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.
Stripe Connect : relire le résultat de l’inscription après le retour du prestataire
Pour inscrire un prestataire dans un parcours Stripe Connect, distinguez le lien d’accès, le retour dans votre application et l’état du compte. Le suivi doit permettre de reprendre une inscription incomplète.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Lien temporaire | Chaque Account Link est temporaire et utilisable une seule fois ; Stripe demande d’authentifier le titulaire avant la redirection. | Faites démarrer la reprise depuis le parcours authentifié du prestataire. |
| Lien expiré ou déjà ouvert | La refresh_url doit faire créer un nouvel Account Link avec les mêmes paramètres, puis rediriger vers ce nouveau lien. | Rejouez l’expiration et le retour arrière dans l’environnement de test. |
| Retour dans l’application | Le retour à return_url peut suivre la fin du parcours ou Save for later ; il ne prouve pas que toutes les informations ont été collectées. | Relisez les exigences restantes du compte via l’API Accounts ou l’événement account.updated. |
| Adresses de retour | Le mode réel accepte uniquement des adresses HTTPS pour refresh_url et return_url ; HTTP reste possible en test. | Vérifiez les adresses de l’environnement réellement utilisé avant la mise en service. |
Reprendre une inscription de prestataire sans perdre son état
Quatre contrôles proposés pour la recette d’un parcours d’inscription.
- Retrouver le compte
Relier le prestataire authentifié au compte Connect concerné.
- Préparer le lien
Vérifier le traitement d’un lien nouveau, expiré ou déjà utilisé.
- Observer le retour
Retrouver le passage dans le parcours sans en déduire son achèvement.
- Relire le résultat
Vérifier les informations encore demandées et la prochaine action.
Deux retours à qualifier dans le suivi
Comptes et parcours fictifs.
Save for later est compté comme une activation terminée
Un prestataire fictif quitte le formulaire avec Save for later. L’application affiche aussitôt « inscription terminée » sans relire le compte.
Action : Save for later
Retour à l’application : effectué
Exigences restantes : non reluesLecture du cas. Faites reprendre l’état du compte avant d’afficher le résultat. Le suivi doit distinguer le retour observé des informations encore à fournir.
Un lien déjà utilisé est réemployé pour reprendre l’inscription
Une recette fictive conserve le même Account Link après un premier passage, puis tente de l’ouvrir de nouveau.
Account Link : déjà ouvert
Nouvelle tentative : même lien
Parcours de reprise : à vérifierLecture du cas. Contrôlez le passage par refresh_url et la création d’un nouveau lien dans le parcours authentifié. Conservez le résultat de la reprise avec la référence du compte fictif.
Documentation Stripe Connect consultée le 23 octobre 2026. Cette référence décrit le parcours d’inscription hébergé et ses liens ; le statut des fonctions nécessaires à votre activité reste à contrôler sur le compte concerné.
Stripe — Stripe-hosted onboarding · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Approfondir ce contrôle
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.
- Registre : Annulation partielle d’un dossier voyage
Exemple fictif expliqué : Une activité retirée et un paiement encore à rapprocher.
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.

Paiement
Suivre une annulation jusqu’au résultat du remboursement
Annuler une prestation, calculer ce qui est dû et rembourser un paiement sont des opérations distinctes. Le suivi doit rendre visibles les étapes qui restent en attente.
8 contrôles, un cas pratique et 3 questions fréquentes : Suivre une annulation jusqu’au résultat du remboursement →
Standards et continuité
Contrôler un montant entre offre et API de paiement
Le même montant traverse plusieurs systèmes. Chaque passage doit conserver sa devise et sa convention pour que la finance puisse expliquer les écarts.
8 contrôles, un cas pratique et 3 questions fréquentes : Contrôler un montant entre offre et API de paiement →
Paiements
Contrôler une préautorisation et son règlement final
La garantie financière doit rester distincte du prix du séjour, du règlement final et de la réservation. Vérifiez les preuves avant une capture ou une nouvelle tentative.
8 contrôles, un cas pratique et 3 questions fréquentes : Contrôler une préautorisation et son règlement final →Vignettes illustratives générées par IA.