
Comparatif documenté · 4 périmètres
Autorisation, capture, annulation et remboursement : distinguer les opérations
Le mot paiement recouvre plusieurs étapes. Cette lecture de la documentation Stripe aide à choisir un état juste dans le suivi, sans l’étendre à tous les prestataires.
Contenu éditorial mis à jour le . Chaque référence indique sa propre date de consultation. Les faits sont attribués aux sources ; les scénarios et conseils sont éditoriaux. Le périmètre commercial, les prix et les droits de votre compte restent à confirmer.
Références documentaires et points à vérifier
Les lignes comparent des rôles et des conditions d’accès. Un point non documenté reste une question à poser, sans lui attribuer une note négative. Sur téléphone, chaque périmètre se lit dans une carte.
| Périmètre et rôle | Documenté | Limite | À demander |
|---|---|---|---|
Autorisation Préparer une capture différée lorsque le moyen le permet | Stripe décrit la séparation autorisation et capture pour des moyens éligibles, avec une période de validité à surveiller. Stripe : autorisation et capture séparées ↗Consulté le | Les possibilités et délais varient selon le moyen et le contexte. Une autorisation n’est pas une capture. | Quel état et quelle expiration sont retournés pour cette opération ? |
Capture Exécuter l’opération autorisée selon le modèle utilisé | La documentation explique comment capturer une autorisation et vérifier la limite temporelle de cette capture. Stripe : suivi de la capture ↗Consulté le | La réussite financière ne confirme pas automatiquement une prestation chez le fournisseur voyage. | Comment rapprocher la capture du dossier fournisseur et gérer une confirmation échouée ? |
Annulation du PaymentIntent Clôturer une opération dans un état qui l’autorise | L’API prévoit une annulation pour certains états du PaymentIntent et refuse des états incompatibles. Stripe API : annuler un PaymentIntent ↗Consulté le | Cette annulation technique ne remplace pas l’annulation de la prestation réservée. | L’état actuel permet-il cette action et quel résultat clôt le suivi ? |
Remboursement Suivre une restitution financière complète ou partielle | Stripe distingue annulation d’un paiement non finalisé et remboursement après succès. Plusieurs remboursements partiels sont possibles sans dépasser le paiement initial. Un solde disponible insuffisant peut laisser un remboursement par carte en attente ou faire échouer celui d’un autre moyen de paiement ; la demande n’établit donc pas le crédit du client. Stripe : remboursements ↗Consulté le | La documentation financière ne détermine pas le montant dû au titre du contrat de voyage. | Quel montant a été décidé, demandé puis effectivement traité ? |
Dessiner deux chronologies
Conservez une chronologie financière et une chronologie de prestation, reliées par des références. Le client peut avoir un paiement accepté tandis que la réservation attend encore une réponse. Le support doit pouvoir expliquer ce décalage sans inventer un état final.
Définissez les messages associés à chaque étape. Une demande envoyée, une opération acceptée et un résultat terminé doivent garder des noms distincts dans l’interface et les exports.
Rapprocher les montants et les références
Une commande peut produire plusieurs opérations. Le montant seul ne permet pas de les identifier. Gardez la référence du paiement, celle des captures ou remboursements utiles et le dossier commercial auquel elles appartiennent.
Pour les opérations partielles, suivez le cumul et le solde selon le modèle réellement utilisé. Le calcul commercial et l’exécution financière doivent pouvoir être contrôlés séparément.
Préparer les états incertains
Une interruption de réponse demande un rapprochement avant relance. Vérifiez si l’opération existe déjà et qui peut décider de la suite. Les répétitions de notifications ne doivent pas créer des actions supplémentaires.
Cette comparaison sert à nommer les étapes, pas à choisir un prestataire ni à garantir des délais. Faites confirmer les moyens, droits et procédures adaptés au produit avant la recette.
Fermer un pilote sans perdre les opérations différées
Scénario de préparation : les ventes nouvelles quittent le prestataire alors que des autorisations, captures ou remboursements restent en cours. Listez ces objets par état et date attendue. Le retrait d’une intégration ne permet pas de conclure que les fonds sont réglés.
Faites confirmer accès de suivi, pièces de rapprochement et traitement des échecs tardifs. Gardez un responsable pour chaque opération jusqu’à sa preuve de fin ; évitez une relance chez le nouveau prestataire sur la seule base d’un état local incomplet.
Choisir selon le besoin
Trois situations pour cadrer le bon périmètre
Le circuit de paiement doit suivre la confirmation de la prestation. Une autorisation peut sécuriser un montant pendant une étape, tandis qu’une capture crée un mouvement différent. Définissez ce que le client voit et ce que l’équipe peut déclencher pour chaque état.
Les situations ci-dessous sont fictives. Elles servent à comparer un périmètre de travail et les preuves nécessaires ; elles ne décrivent pas les conditions d’une offre fournisseur.
Prestation encore en confirmation
Cas fictif : le dossier indique une autorisation de 300 €, mais aucune capture n’est constatée et le fournisseur n’a pas encore confirmé l’activité. Le parcours financier reste à décider selon les moyens du prestataire.
Avant de retenir ce périmètre : Retrouver séparément les deux états et les actions permises. Ne pas comptabiliser 300 € encaissés ni promettre un remboursement d’une capture qui n’apparaît pas dans les données.
Prix modifié avant capture
Cas fictif : l’offre acceptée à 300 € est remplacée par une proposition à 340 € avant la capture. L’accord client sur le supplément et les opérations autorisées pour l’autorisation initiale restent à obtenir.
Avant de retenir ce périmètre : Conserver l’écart de 40 €, la nouvelle version et la réponse du prestataire sur la suite financière. Ne pas déduire d’une ancienne autorisation le droit d’encaisser automatiquement le nouveau montant.
Remboursement après encaissement
Cas fictif : 280 € ont été capturés ; une restitution de 60 € est demandée mais reste en attente. Aucun crédit final n’est encore documenté.
Avant de retenir ce périmètre : Présenter 280 € capturés et 60 € demandés, dans deux états distincts. Le net de 220 € ne devient le résultat après remboursement que lorsque l’opération réussie est établie ; la visibilité du crédit demande son propre suivi.
Arbitrer les contraintes et le coût de fonctionnement
L’automatisation réduit certaines tâches mais demande des règles de validation et des contrôles de doublons. Un circuit simple avec des exceptions attribuées peut être préférable à une suite d’actions automatiques dont personne ne sait expliquer les états. Le rapprochement doit rester possible pour chaque opération et chaque devise. Un jeu de test fictif peut retenir 300 € autorisés, 240 € capturés puis 60 € remboursés. Le montant capturé net du remboursement est alors de 180 €, sous réserve du résultat final de ces opérations ; ce calcul ne décrit ni les frais ni le règlement bancaire. Les 60 € non capturés de l’autorisation suivent un autre état. Faites expliquer ces deux montants de 60 € sans les confondre dans le dossier transmis au service client.
Points à clarifier avant la décision
- Les montants autorisés, capturés et demandés en remboursement sont additionnés comme s’ils représentaient le même état.
- Une réponse perdue déclenche une nouvelle opération sans recherche du résultat ni procédure de reprise autorisée.
Quatre cas pour rendre la comparaison vérifiable
Les nombres et situations ci-dessous sont fictifs, à adapter au périmètre proposé. Utilisez un environnement et des données de test autorisés. Conservez les réponses, les opérations manuelles et les points qui restent inconnus.
| Situation | Contrôle | Preuve utile |
|---|---|---|
| Autoriser puis capturer partiellement | Cas fictif : autorisation 600 €, capture 450 €. Vérifier la gestion du reliquat dans le parcours et le contrat proposés. | 450 € capturés, sort des 150 € restants explicite ; autorisation séparée de l’encaissement. |
| Paiement réussi, prestation échouée | Créer un suivi d’exception qui rapproche les deux chronologies. | États financiers et fournisseur, responsable et prochaine action. |
| Deux remboursements successifs | Sur les 450 € capturés, demander 100 €, puis 50 €. Simuler une attente sur le second. | 300 € de solde net seulement après succès des deux remboursements ; demande, attente et crédit final distingués. |
| Réponse interrompue | Rechercher l’opération existante avant relance. | État de référence et résultat d’une reprise autorisée. |
Consulter le registre de comparaison et préparer le contrôle d’accès API.
Questions fréquentes
Une autorisation est-elle un paiement capturé ?
Non. Vérifiez l’état de l’opération et la séparation des étapes dans le modèle utilisé.
Annuler le paiement annule-t-il le voyage ?
Non. Le dossier de prestation suit son propre processus et doit être rapproché de l’opération financière.
Ces étapes sont-elles identiques chez tous les prestataires ?
La comparaison est fondée sur Stripe. D’autres services doivent être vérifiés dans leurs propres documents et contrats.
Quelle étape faut-il tester en plus du paiement réussi ?
Ajoutez un refus de prestation, une réponse financière manquante et une restitution encore ouverte. Ces situations vérifient si l’équipe retrouve le résultat avant de répéter une action et distingue les mouvements constatés des demandes. Les opérations possibles sur autorisation, capture ou remboursement dépendent du contrat et du prestataire réellement utilisés.
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.
Stripe : même devise, règles différentes entre paiement et versement
La devise du paiement, celle du moyen de paiement et celle du règlement bancaire peuvent différer. Il faut aussi identifier l’opération avant d’interpréter les décimales.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| ISK | Les paiements sont exprimés avec deux décimales techniques dont la partie décimale doit rester 00 ; les fractions d’ISK ne sont pas acceptées. | Ne pas confondre facteur d’encodage 100 et possibilité de facturer une fraction de couronne. |
| HUF et TWD | Les paiements peuvent avoir deux décimales ; les versements manuels exigent un amount divisible par 100. | Relire séparément le paiement voyageur et le versement du solde. |
| Devises distinctes | Presentment désigne la devise du paiement ; settlement désigne celle du règlement au compte destinataire. | Comparer montants et frais sur le même mouvement, sans supposer que le montant débité équivaut au montant versé. |
Ces règles sont celles de Stripe. La disponibilité dépend notamment du pays et de la configuration du compte ; aucune opération réelle n’est exécutée par les exemples du site.
Stripe — Supported currencies, special cases · 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 : une capture partielle libère normalement le solde
La somme autorisée ne reste pas automatiquement disponible après une première capture partielle.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| État préalable | Après autorisation, le PaymentIntent passe à requires_capture ; la capture prend par défaut tout le montant autorisé. | Vérifier l’état et le montant demandé avant l’action. |
| Capture partielle | amount_to_capture permet une capture inférieure ; le reste est automatiquement libéré dans le parcours standard. | Ne pas planifier une seconde capture sur ce reste sans vérifier la capacité réellement disponible. |
| Exception | La plupart des paiements n’acceptent qu’une capture ; certains paiements par carte sont éligibles à multicapture. | Traiter la capture multiple comme une capacité à vérifier pour le paiement concerné. |
Documentation de capture différée Stripe. L’éligibilité multicapture et les règles propres au moyen de paiement doivent être vérifiées séparément.
Stripe — Place a hold on a payment method · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Stripe : suivre le remboursement jusqu’à son résultat
Un remboursement créé possède encore son propre circuit de traitement et de suivi.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Destination | Un remboursement retourne au moyen de paiement d’origine, pas à une autre carte ou à un autre compte choisi dans la demande. | Identifier le paiement initial avant de promettre une autre destination. |
| Plusieurs remboursements | Plusieurs remboursements peuvent concerner une même charge, sans dépasser son montant initial au total. | Rapprocher les montants déjà remboursés et ceux encore disponibles, paiement par paiement. |
| Solde insuffisant | Stripe met un remboursement par carte en attente si le solde disponible est insuffisant ; pour les autres types de moyens, le remboursement échoue. | Ne pas étendre le comportement « en attente » à tous les moyens de paiement. |
| Événements | refund.created décrit la création ; refund.failed signale un échec. | Ne pas clôturer le dossier à la seule réception de l’événement de création. |
Règles Stripe ; les montages Connect et les délais du moyen de paiement demandent une lecture propre à leur périmètre.
Stripe — Refund and cancel payments · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Adyen : success se lit avec le type d’événement de remboursement
Une valeur success vraie ne signifie pas toujours que le voyageur a reçu son argent. Identifiez l’événement, la demande de remboursement et le paiement d’origine avant de clôturer le suivi.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| REFUND avec success true | Les validations ont réussi et la demande a été transmise au réseau de cartes ; un échec ou une inversion reste possible. | N’en déduisez pas une réception bancaire déjà constatée. |
| REFUND avec success false | Les validations du remboursement ont échoué ; reason décrit le problème. | Relisez le motif avant d’envisager une correction ou une nouvelle demande. |
| REFUND_FAILED ultérieur | Un remboursement peut échouer après un premier REFUND positif, parfois plusieurs jours après la demande. | Gardez le traitement des événements ultérieurs et le rapprochement du dossier. |
| REFUNDED_REVERSED | Cet événement peut porter success true tout en indiquant le retour des fonds chez Adyen. | Le booléen ne remplace pas eventCode ; vérifiez le motif et le suivi client avant toute nouvelle action. |
Deux notifications positives à lire différemment
Fragments fictifs simplifiés ; aucune notification réelle n’est traitée.
Un échec arrive après un REFUND positif
Le dossier fictif a été clos après le premier événement, puis une notification complémentaire arrive.
Premier événement : REFUND, success true
Événement ultérieur : REFUND_FAILED
Rapprochement client : à reprendreLecture du cas. Réexaminez le suivi avec la demande et le paiement concernés. Le premier événement ne permet pas d’ignorer l’échec ultérieur ni d’affirmer que le voyageur a été crédité.
success true accompagne une inversion du remboursement
Un tableau fictif ne conserve que le booléen et masque le nom de l’événement.
eventCode : REFUNDED_REVERSED
success : true
État affiché automatiquement : client rembourséLecture du cas. Cet affichage perd le sens de l’événement. Les fonds sont revenus dans le circuit Adyen ; conservez eventCode et reprenez le rapprochement avant de définir la suite avec le client.
Documentation Adyen consultée le 23 octobre 2026. Les opérations et les délais dépendent du moyen de paiement. Ces exemples décrivent la lecture d’événements, sans attester un crédit bancaire ni déclencher de remboursement.
Adyen Docs — Refund, webhooks for refunds · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Stripe : distinguer cadence, concurrence et verrouillage
Deux réponses HTTP 429 peuvent demander des corrections différentes. Le motif compte autant que le statut.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Cadence | Stripe-Rate-Limited-Reason distingue notamment global-rate et endpoint-rate. | Réduire le rythme au niveau concerné, sans saturer à nouveau l’ensemble du compte. |
| Concurrence | global-concurrency et endpoint-concurrency concernent les requêtes simultanément en cours. | Limiter le nombre d’appels actifs ; espacer seulement leur départ peut ne pas suffire si les traitements restent longs. |
| Absence du motif | Un 429 sans cet en-tête n’est pas produit par le limiteur de cadence ; la documentation cite notamment les lock timeouts. | Examiner le code d’erreur et sérialiser les mises à jour concurrentes d’une même ressource lorsque le verrouillage l’exige. |
Périmètre Stripe. La documentation recommande un recul exponentiel avec dispersion aléatoire pour les reprises de limitation. L’état du paiement doit rester rapproché de celui de la réservation.
Stripe — Rate limits · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.