Aller au contenu
Meubles Morinière

Le produitSite public15 min de lecture

Panier et paiement

Le client paie ce qu’il a vu. Le panier n’a pas de table, le volet donne le total pour son code postal et le formulaire ne fait rien retaper. On suit aussi une commande jusqu’à Stripe, y compris quand ça ne se passe pas comme prévu.

Le panier et le paiement suivent une seule règle : le client paie ce qu’il a vu. Ce que la page lui montrait déjà, on ne le lui refuse pas une seconde fois. Si quelque chose a changé sans qu’il le voie, on le lui dit. Ensuite le panier se met à jour, et il peut vérifier avant de relancer.

Les chemins sans préfixe partent de apps/site/. Les calculs (prix, remises, TVA, port, totaux) viennent de packages/domain, que l’ERP appelle aussi (Prix, remises, TVA et port).

Un panier sans table

Le panier d’un visiteur est dans un cookie httpOnly, scellé par le site (modules/cart/services/cart-cookie.service.ts). Pour chaque ligne, il contient la déclinaison, la quantité et le prix vu à l’ajout. Il contient aussi la commande en attente que ce panier a lancée, s’il en a lancé une. Le sceau est un HMAC propre à chaque usage (SealPurpose : panier, favoris, code promo, shared/server/cookie-seal.ts), et une clé précédente reste acceptée le temps d’une rotation (SITE_COOKIE_SECRET_PREVIOUS). Le cookie dure un mois (CART_EXPIRATION_DAYS). Le nombre de lignes et la quantité par ligne sont plafonnés (MAX_CART_ITEMS, MAX_QUANTITY_PER_ORDER).

Pourquoi pas une table ? Avec un panier en base, il faudrait écrire dans la base de l’ERP pour chaque visiteur anonyme, puis nettoyer les paniers abandonnés. Il faudrait aussi donner au rôle du site plus de droits en écriture. Le cookie ne coûte rien au serveur et n’ouvre aucun droit, puisque le rôle du site n’écrit pas de panier (Données).

Le cookie ne porte que des identifiants et un prix vu, et on ne lui fait confiance pour rien. À chaque lecture, on relit le prix, le stock et l’état de chaque déclinaison. Le prix vu à l’ajout sert seulement à dire « le prix a baissé » ou « a augmenté ». La commande en attente est scellée avec le panier. Du coup, personne ne peut y glisser la commande d’un autre pour libérer ses pièces.

La barre du site compte le panier deux fois (téléphone et bureau), le volet l’affiche et la commande le relit. Donc getCart ne lit et ne vérifie le cookie qu’une fois par rendu (cache() de React, modules/cart/data/get-cart.ts). Le cookie se lit hors cache. Ensuite les déclinaisons, qui sont communes à tout le monde, passent par une lecture en cache, avec leurs identifiants en argument. Le stock, lui, c’est le stock libre, lu à l’heure de la requête : le solde moins ce que d’autres paiements en cours retiennent (withFreeStock).

En contrepartie, le panier ne suit pas le client d’un appareil à l’autre, même s’il est connecté à son compte. Et un cookie scellé doit rester sous les 4 Ko d’un navigateur. C’est pour ça que les lignes sont plafonnées.

Le volet du panier

Les frais inattendus, c’est la première cause d’abandon d’un panier. Donc le volet doit donner le total dès qu’il le peut.

Le volet ne pèse rien dans le JavaScript de chaque page. Il se charge au survol du bouton du panier, dès que le navigateur a un moment de libre sur une fiche, ou à l’ouverture (cart-sheet-slot.tsx). Une fois chargé, il reste monté, parce qu’il garde l’état optimiste et l’annulation d’un retrait. Si le fichier n’arrive pas (hors ligne, déploiement passé), l’ouverture est annulée et le volet le dit. Le geste suivant redemande le fichier. Sur téléphone, il monte du bas et se referme d’un glissé. Sur ordinateur, il sort du bord droit.

Les gestes sont optimistes. Quand on retire une ligne, ou qu’on change sa quantité ou sa déclinaison, le résultat s’affiche avant la réponse (cartReducer). Un refus s’affiche sous la ligne, et le panier est relu pour montrer le stock. Une ligne retirée se rattrape pendant quelques secondes (« Annuler »). Ce délai se met en pause tant que le bouton a le focus ou le pointeur. Comme ça, un lecteur d’écran a le temps de lire la ligne (WCAG 2.2.1).

Sans code postal, la livraison est une fourchette pour toute la France. Une fois le code donné (sur une fiche ou dans le volet, CartShippingDestination), le volet chiffre la livraison du panier entier pour sa zone, toutes les pièces en un seul envoi, comme la caisse la calculera (visitorCartShippingOf, modules/cart/lib/visitor-cart-shipping.ts). Le total est présenté comme exact quand un seul montant est possible, comme estimé quand il dépend du mode, et en attente quand les frais ne se chiffrent pas encore (cartTotalEstimate). Si l’adresse n’est pas livrée, le volet le dit avant la caisse.

Quand le prix d’une ligne a bougé, elle le dit (« il était de X »). C’est à l’encre pour une hausse et en sourdine pour une baisse, parce que le rouge est réservé à ce qui bloque. Une pièce partie, retirée ou en quantité insuffisante est marquée et sort du total. Une pièce supprimée du catalogue depuis l’ajout est annoncée une fois, puis oubliée (forgetMissingCartPieces).

Pour rassurer, il y a des phrases sous « Passer commande » et à côté du formulaire. Elles se suffisent à elles-mêmes, il n’y a pas de pictogramme de cadenas. La dernière dit qu’une personne du magasin répond, avant l’achat aussi (CartTrustNotes).

Les codes promo

Un code se tape dans le volet ou à la caisse. Il peut aussi arriver par un lien (?promo=, PROMOTION_LINK_PARAM). Le code retenu est gardé dans un cookie scellé, à part du panier. Un code refusé pour de bon (échu, épuisé) le dit et n’est pas gardé. Si le panier est encore vide, la page dit que le code s’appliquera au premier meuble ajouté (promotionLinkOutcome).

Le refus est précis. Un code échu donne sa date de fin, et un code sous le minimum dit ce qui manque (promotionRefusalMessage). La remise se calcule et se répartit entre les lignes avec les mêmes règles que dans l’ERP.

Le plafond d’usages d’un code se vérifie au paiement, paiements en cours compris, sous un verrou que le site et l’ERP partagent (promotion-lock.ts). Si un code est épuisé par des paiements en cours, il quitte le panier, et la page relue donne le total sans remise. Sinon on buterait sur le même refus à chaque envoi.

Les essais de code sont plafonnés par connexion (SITE_RATE_LIMITS.promotionCode). On ne peut donc pas deviner un code en enchaînant les essais.

Le formulaire de commande

Sur un téléphone, chaque champ à retaper fait perdre une commande. Donc le formulaire est court, on peut le reprendre après un détour, et il signale tous les oublis d’un coup.

La saisie est gardée pour l’onglet (sessionStorage, modules/checkout/lib/checkout-draft.ts). On la retrouve après un retour au panier, une fiche ouverte, un onglet rechargé ou une page de paiement abandonnée. Elle se périme au bout de douze heures. Elle s’efface quand la commande est confirmée, ou avec « Tout effacer ». Et elle ne survit pas à la fermeture de l’onglet, parce qu’un ordinateur peut être partagé. L’acceptation des CGV n’est jamais reprise, on la donne à chaque commande. Le brouillon ne garde que ce que le client a changé. Du coup, un compte ouvert ensuite garde son préremplissage, et un champ vidé exprès reste vide.

La société et le complément d’adresse sont repliés derrière un lien, qui s’ouvre tout seul si le champ a déjà une valeur (OptionalFieldReveal). Le code postal propose les communes qu’il couvre, d’après la Base Adresse Nationale (postal-code-cities.ts), et l’adresse se complète avec le service public de l’IGN. Les deux aident mais ne bloquent jamais : s’ils ne répondent pas, on tape la ville et l’adresse à la main. Quand le domaine d’une adresse e-mail ressemble beaucoup à une messagerie courante (« gmial.com »), le formulaire propose la correction (suggestEmailFix), parce que la confirmation, la facture et le suivi d’une commande sans compte n’arrivent que par cette adresse. Au pouce, Entrée passe au champ suivant et n’envoie pas la commande (advanceOnEnter).

La vérification tourne dans le navigateur avec la même règle que le schéma du serveur, sans embarquer zod côté client (checkoutFieldErrors). Du coup, le client voit tous ses oublis, champ par champ, avant le moindre aller-retour. Le serveur revérifie, et c’est lui seul qui décide. Un formulaire vierge n’est pas en faute, et le récapitulatif ne passe au rouge qu’après une tentative.

Avant de payer, le récapitulatif reprend les pièces, l’adresse et le mode choisi. Chaque bloc a son « Modifier », qui mène au premier champ vide du bloc et y pose le curseur (CheckoutReview). Le nom du bouton commence par le mot affiché, pour qu’une commande vocale le trouve (WCAG 2.5.3). Seul le récapitulatif suit chaque frappe. Le reste du formulaire ne se redessine pas.

Dès que le code postal est tapé, la caisse donne la livraison de sa zone, comme le volet pour le même code. Elle ne revient pas à la fourchette nationale un pas plus loin. Le mode coché fixe le prix et la date. La pièce la plus encombrante dit le passage ou le véhicule à prévoir.

La connexion à Stripe s’ouvre pendant la saisie, avant le clic. L’envoi se verrouille pendant la vérification, pour qu’un double clic n’envoie pas deux commandes. Si la redirection n’aboutit pas (Échap, une extension qui l’annule), le bouton reprend son état au bout de quelques secondes. Il ne reste pas bloqué sur « Redirection vers le paiement… » (useLeavingPage).

Quand ça ne se passe pas comme prévu

ScénarioPanier (volet)Page de commandeAu paiement (serveur)
Prix revu depuis l’ajout (dont fin d’une remise)Note sur la ligne : « Le prix a augmenté/baissé… il était de X »Même note, sélection ouverte d’office. Les montants sont les nouveauxLignes affichées = lignes présentes → la commande part au nouveau prix. Sinon refus PRICE_CHANGED, panier actualisé
Pièce partie (stock à 0) ou retirée de la venteLigne marquée « partie » / « plus proposée », exclue du total« N pièces ne sont plus disponibles : elles ne font pas partie de cette commande »Lignes affichées = lignes présentes → la pièce sort du panier, le reste se commande. Sinon un seul refus les nomme toutes. Panier vidé → /commande?retrait= dit lesquelles
Stock insuffisant pour la quantité« Il n’en reste pas assez (N disponibles) : ajustez-la »Le navigateur bloque l’envoi et mène au panierRefus INSUFFICIENT_STOCK : la quantité reste au client, jamais corrigée en silence
Pièce supprimée du catalogue (panier ancien)Avis : « Une pièce n’est plus au catalogue… rien ne vous sera demandé »Même avis. Panier vide → l’avis au-dessus de « Votre panier est vide »Ne bloque pas : elle n’était ni affichée ni comptée. L’avis se dit une fois, puis le cookie l’oublie (forgetMissingCartPieces)
Code promo échu, épuisé, sous le minimumMessage de refus précis (date de fin, montant manquant)Idem, sélection ouverteRemise affichée ≠ remise présente → refus PROMOTION_CHANGED. Code refusé → son motif
Paiement interrompu (retour de Stripe)Panier intact?paiement=interrompu : « Aucun paiement n’a été enregistré… votre sélection est conservée », saisie repriseLa commande en attente de ce navigateur ne bloque ni ses pièces ni le plafond par IP, et sa session se ferme à la tentative suivante
Paiement échoué ou abandonné, lien de confirmationPanier non vidé—Confirmation : « Paiement non abouti », sans « Merci » ni e-mail promis, bouton « Reprendre ma commande »
Paiement en cours (webhook en retard)——Confirmation relue d’elle-même. Passé 30 s : « ne payez pas une seconde fois », numéro à citer
Double clic / deux onglets—Envoi verrouillé pendant la vérificationCommande jumelle reprise (resume) ou refus ALREADY_STARTED / ALREADY_PAID
Panier illisible (base indisponible)« Votre sélection n’a pas pu être chargée. Elle est conservée »Idem, bouton « Réessayer »—

Le serveur compare les lignes une par une (déclinaison, quantité, prix annoncé). Il ne compare pas leur somme. Du coup, si deux changements de sens contraire et de même valeur arrivent entre l’affichage et l’envoi, ils sont refusés aussi. Un refus métier vient souvent d’une page périmée. Dans ce cas, la page se relit avec la réponse, le formulaire garde sa saisie et le récapitulatif montre l’état présent. Sinon chaque nouvel envoi buterait sur le même refus.

Où c’est dans le code

  • Le rapprochement au paiement : modules/checkout/services/checkout.service.ts (reconcileCartWithCatalogue, lignes attendues expectedLines posées par checkout-form.tsx, format dans modules/checkout/lib/checkout-shown-lines.ts). Une page qui a montré un autre panier (autre onglet) reçoit CART_CHANGED.
  • La lecture du panier et les pièces disparues : modules/cart/data/get-cart.ts (missingCount), modules/cart/components/missing-cart-pieces-notice.tsx.
  • Les notes de ligne : modules/cart/constants/cart-copy.ts, app/(site)/commande/_lib/checkout-lines.ts.
  • La confirmation : app/(site)/commande/confirmation/page.tsx, modules/orders/lib/payment-not-completed.ts.

Du panier au paiement

  1. La page de commande envoie les lignes qu’elle a montrées. Le serveur les rapproche du catalogue une par une, sans cache (read-*, reconcileCartWithCatalogue).
  2. Le site crée la commande, en attente de paiement. C’est la seule commande qu’il peut créer, et un trigger de la base refuse toute autre forme (Données). Ses lignes recopient le nom, la référence et le prix. Comme ça, une retouche du catalogue ne change pas ce qui a été vendu.
  3. Tant que la session de paiement est ouverte, la commande retient ses pièces suivies. Une pièce réservée n’est libre ni pour un autre panier, ni pour un geste de l’ERP qui sert du stock (reserveTrackedStock, modules/checkout/services/stock-reservation.service.ts, sur la règle commune de packages/domain/src/stock-reservation.ts). La commande en attente de ce navigateur ne bloque pas celle qui la remplace. Donc un client qui revient de Stripe pour corriger son e-mail ne bute pas sur sa propre réservation.
  4. Le site ouvre la session Stripe avec sa clé restreinte (modules/checkout/services/checkout-session.service.ts). Son échéance suit la réservation : elle est courte dès que la commande retient une pièce suivie, et plus longue quand tout se fabrique à la commande (checkoutSessionTtlSeconds). Stripe refuse une échéance à moins de trente minutes de son horloge. Quand il refuse seulement à cause de l’heure, la session se recrée une fois, avec une échéance recalculée et une autre clé d’idempotence (createCheckoutSessionWithFreshExpiry). Les sessions plus anciennes du même client sur les mêmes pièces ou le même code se ferment (supersedeEarlierSessions).
  5. Le client paie, et c’est l’ERP qui marque la commande payée, quand il reçoit le webhook (Stripe). Si la base flanche juste après la création de la session, le client paie quand même. Au premier webhook, l’ERP rattache la session à sa commande grâce à ses métadonnées (adoptOrphanSession).

Si la même commande (mêmes coordonnées, mêmes lignes, même montant) a été ouverte peu avant, on la reprend et on n’en crée pas une seconde (findCheckoutTwin). Il y a aussi le cas d’un panier dont la commande a déjà été payée, mais que la page de confirmation n’a pas vidé (onglet fermé, retour de l’application bancaire, réseau coupé). On le reconnaît, et il ne se paie pas une seconde fois (findOwnPaidOrder). Passé la fenêtre où la confirmation l’aurait vidé, le même panier redevient un nouvel achat.

Le client revient souvent de Stripe avant le webhook. Dans ce cas, la page de confirmation relit la commande quelques fois, à intervalles de plus en plus longs. Elle ne reste pas sur « en cours de confirmation » (RefreshWhilePending). Passé une trentaine de secondes, elle dit quoi faire, et surtout de ne pas payer une seconde fois. Après un paiement échoué ou abandonné, la page ne dit pas « Merci » et ne promet pas d’e-mail. Le panier et le brouillon restent, et la commande se reprend telle quelle.

Le lien de confirmation se rouvre pendant sept jours (ORDER_CONFIRMATION_LOOKUP_MAX_AGE_MS). La page montre le meuble payé et donne la même phase que le suivi (customerOrderPhase). Elle n’annonce la date promise que tant que la commande est à l’atelier. Pour une commande partie, annulée ou remboursée, elle renvoie au suivi.

Payer un devis

Un devis s’ouvre sur le site avec son jeton (/devis/[token]) et se paie en ligne, sans compte. La page n’est pas indexée et ne transmet pas son adresse aux autres sites (referrer limité à la même origine), parce que le jeton, c’est le secret du lien. Un verrou Postgres sépare ce paiement de l’accord au magasin et de l’annulation. Sa clé est écrite une seule fois pour les deux applications (packages/contracts/src/quote-payment-lock.ts). Du coup, un devis ne peut pas être payé en ligne pendant que l’atelier l’annule. Le PDF du devis, le site le demande à l’ERP, avec un plafond par visiteur (public-quote-pdf.service.ts). L’ouverture du devis est notée pour l’équipe, au plus une fois par période (QUOTE_VIEW_REFRESH_MS).

Sur cette page