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.
Documents consultés le . Les faits ci-dessous sont attribués à leurs 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 ↗ | 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 ↗ | 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 ↗ | 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 décrit des remboursements complets ou partiels avec un suivi de leur état, y compris des situations en attente ou en échec. Stripe : remboursements ↗ | 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.
Quatre cas pour rendre la comparaison vérifiable
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 |
|---|---|---|
| Autorisation proche de sa limite | Vérifier l’état et la fenêtre réellement retournés. | Référence de test, expiration et décision de capture. |
| 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 partiels | Rapprocher chaque opération et le cumul. | Références, montants, devises et solde du dossier. |
| Réponse interrompue | Rechercher l’opération existante avant relance. | État de référence et résultat d’une reprise autorisée. |
Télécharger 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.