Responsable paiements voyage

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.

• 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.

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 27/10/2026. 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.

Adyen : les décimales de l’API peuvent différer de la devise ISO

Adyen demande généralement un montant entier en unités mineures. Sa documentation exclut explicitement Terminal API de cette règle générale.

• Exceptions : CLP, CVE, IDR et ISK ont un nombre de décimales Adyen différent de la référence ISO 4217. Appliquer la table de l’API et conserver aussi le code monétaire.
• ISK : Pour l’ISK, la référence ISO indique zéro décimale, tandis qu’Adyen en demande deux pour le montant transmis. Un montant de 10 ISK s’écrit 1000 selon cette convention Adyen ; ce calcul n’est pas un taux de change.

La table technique ne confirme ni l’activation d’une devise sur le compte ni les conditions de règlement, les frais ou un taux de change.

Adyen — Currency codes and minor units · consultée le 31/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

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.

• 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.

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 22/10/2026. 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.

• É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.

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 22/10/2026. 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.

• 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.

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 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Booking.com Demand : un frais exclu du prix affiché peut rester à payer

Pour expliquer un prix d’hôtel, séparez le total du séjour, les frais encore indéterminés et ce qui sera encaissé en ligne. Un seul indicateur « inclus » ne décrit pas ces trois informations.

• Prix affiché : included et excluded décrivent la position des frais par rapport au prix book ; ils ne désignent pas directement le bénéficiaire du paiement. Ne traduisez pas excluded par « facultatif » ou « non dû ».
• Avant confirmation : Dans /orders/preview et /orders/create, les frais obligatoires calculables sont regroupés dans non_conditional et inclus dans total. Ne rajoutez pas ces lignes une seconde fois au total de réservation.

Modèle Demand API consulté le 22 octobre 2026. Les montants et conditions restent ceux du produit réservé ; cette lecture ne fixe aucun barème fiscal local.

Booking.com Demand — calcul et conditions des frais supplémentaires · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

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.

• 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.

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 22/10/2026. 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.

• 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.

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 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Stripe : distinguer enquête préalable et réponse définitive à une contestation

Le dossier de paiement doit conserver l’étape de procédure, le motif et la version des pièces effectivement transmises. La réponse à une simple demande d’information ne clôt pas toutes les étapes possibles.

• Enquête avant contestation : Stripe présente les inquiries comme une phase préalable ; si elle devient un chargeback, une nouvelle réponse est nécessaire. Rattachez la première réponse et l’escalade au même dossier, avec deux états distincts.
• Envoi des pièces : Le Dashboard ne permet qu’une soumission de la réponse ; après envoi, elle ne peut plus être modifiée ni complétée par d’autres fichiers. Faites relire les pièces assemblées avant la soumission autorisée.

Parcours Dashboard Stripe consulté le 22 octobre 2026. Les échéances et frais doivent être lus dans le dossier et les conditions applicables ; aucun délai de réponse universel n’est calculé ici. Ces repères ne déclenchent aucun envoi de preuves ni mouvement de paiement.

Stripe — répondre aux contestations dans le Dashboard · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Acomptes Stripe : paiement rattaché, page hébergée et trop-perçu

Pour rapprocher un acompte, retrouvez la facture et le paiement qui lui est rattaché. Une capacité disponible dans un parcours Stripe peut demander une configuration différente dans un autre.

• Paiement partiel par API : Stripe demande un PaymentIntent de même devise et de même client que la facture, pour un montant au plus égal au restant dû. Contrôlez ces trois correspondances avant de rapprocher l’acompte du dossier voyage.
• Paiement créé à la finalisation : Le PaymentIntent par défaut de la facture n’est pas directement modifiable ; le parcours partiel crée et rattache un PaymentIntent distinct. Gardez la référence du paiement rattaché, sans traiter chaque tentative comme une nouvelle facture.

Périmètre Stripe Invoicing, consulté le 22 octobre 2026. Le fonctionnement des paiements partiels ne fixe pas les dates d’acompte du contrat de voyage ni les échéances des fournisseurs.

Stripe Invoicing — Accept partial payments for invoices · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Stripe Billing : lire le signe du crédit et retrouver son application

Le solde de crédit de facturation est un journal d’ajustements lié aux factures d’un client. Son signe, son utilisation et sa correction doivent rester distincts d’un remboursement bancaire.

• Application aux factures : Le crédit s’applique automatiquement à la prochaine facture finalisée du client ; on ne peut pas choisir une facture précise pour son application. Retrouvez la facture effectivement finalisée avant de promettre l’utilisation sur une autre réservation.
• Convention de signe : Dans ce solde Stripe, un crédit est négatif et réduit ce que le client doit ; un débit est positif et l’augmente. Conservez la convention de cet objet dans le rapprochement, sans l’appliquer à tous les écrans ou soldes bancaires.

Périmètre : customer credit balance de Stripe Billing, distinct du cash balance et d’un remboursement de paiement. Les exemples ne valident aucun traitement fiscal ni aucune conversion de devise. Aucune écriture n’est créée depuis cette page.

Stripe — Customer credit balance · consultée le 23/10/2026. 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.

• 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.

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 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

WeTravel : un reçu téléchargé décrit l’état actuel de la réservation

Le reçu acheteur rassemble la réservation et ses transactions. Sa lecture doit garder la date de récupération, la devise et le statut des mouvements.

• Version courante : Le PDF est régénéré à partir de l’état actuel ; WeTravel ne conserve ni anciennes versions du reçu ni historique de téléchargement. Conservez la version nécessaire à votre suivi avec sa date, dans les accès et durées adaptés au dossier.
• Transactions distinctes : Le résumé mentionne notamment les paiements en attente, remboursements et contestations. Remboursements et contestations y apparaissent en négatif. Lisez le type et le statut du mouvement avant de parler de somme effectivement rendue au client.

Aide WeTravel consultée le 23 octobre 2026. Ce reçu de réservation ne démontre pas à lui seul la conformité d’une facture fiscale, la réception des fonds par une banque ou l’acceptation du document par un assureur.

WeTravel — How to download a buyer receipt? · consultée le 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Booqable : calculer le dépôt sur la bonne base et distinguer sa retenue

Le dépôt de garantie dépend de la méthode choisie. Son montant ne se déduit pas toujours du total affiché sur la commande.

• Pourcentage de commande : Avec cette méthode, seuls les articles loués entrent dans la base ; services, ventes et lignes personnalisées en sont exclus. Séparez la location des autres lignes avant de vérifier le calcul.
• Valeur de dépôt du produit : La valeur définie pour le produit est soumise au pourcentage choisi dans les réglages ; 100 % utilise la valeur entière. Contrôlez à la fois la valeur du produit et le taux global appliqué.

Aide Booqable datée du 19 août 2026, consultée le 23 octobre 2026. Ces règles décrivent le logiciel ; elles ne déterminent pas la justification contractuelle d’une retenue. Un dépôt encaissé et une autorisation bancaire suivent des traitements distincts.

Booqable — How to set up refundable security deposits · mise à jour par la source le 19/08/2026 · consultée le 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

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.

• 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.

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 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Stripe : distinguer cadence, concurrence et verrouillage

Deux réponses HTTP 429 peuvent demander des corrections différentes. Le motif compte autant que le statut.

• 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.

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 27/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.