MODULE 58 / 72
💳
Scénario : paiement en ligne (Stripe & co)
La règle absolue : votre serveur ne touche JAMAIS aux numéros de carte. Jamais. Ni en BDD, ni en logs, ni en mémoire. C'est une obligation PCI-DSS, et une erreur peut coûter des millions en amendes + procès.
Flux Stripe actuel : (1) le backend crée un PaymentIntent ou une Checkout Session et renvoie le `client_secret` ; (2) le front affiche le Payment Element / redirige vers Checkout et appelle `confirmPayment` (3DS géré par Stripe) ; (3) redirection `return_url` = UX seulement ; (4) le webhook `payment_intent.succeeded` confirme le paiement côté serveur. Option no-code : Payment Links + webhook vers Xano / n8n / Edge Function.
Idempotence — LE concept critique : l'utilisateur clique "Payer", la requête part, mais il perd internet 2 secondes. Il reclique. Sans protection, il paie deux fois. Solution : le frontend génère un `idempotency_key` unique (UUID). Stripe garantit qu'avec la même clé, la même requête ne sera exécutée qu'une seule fois — même si vous l'envoyez 10 fois.
Votre backend n'attend pas la redirection : il fait foi du webhook. Ne marquez jamais une commande payée sur la seule base du `success_url`.
Sécuriser les webhooks : un attaquant peut envoyer une fausse requête à `/webhooks/stripe` en prétendant "paiement réussi". Défense : Stripe signe chaque webhook avec un HMAC. Votre backend vérifie la signature avec votre secret. Sans ça, vous livrez gratuitement.
États d'une commande : `created` → `pending_payment` → `processing` → `paid` ou `failed`. Machine à états stricte : une commande `paid` ne peut pas revenir à `pending`. Traçabilité complète de chaque transition en BDD (audit log).
Réconciliation : tous les soirs, un job compare vos commandes BDD avec les paiements Stripe. Détection des décalages (commande marquée payée sans paiement réel, ou inverse). Indispensable pour la compta.
⚡ ANALOGIE — LE PAIEMENT PAR CHÈQUE VIA INTERMÉDIAIRE
Le client signe un chèque devant un notaire (Stripe), qui vous remet un reçu signé (token). Vous n'avez jamais touché le chèque — si votre coffre est volé, rien de sensible ne fuite. Idempotency key = numéro unique sur le reçu, pour qu'on ne le présente pas deux fois. Webhook = le notaire qui vous rappelle 10 minutes après pour confirmer que le chèque a bien été encaissé. Vérification de signature = vous reconnaissez l'écriture et le tampon du notaire pour vous assurer que l'appel est authentique.
📐 SCHÉMA
Frontend
Stripe.js (iframe)
Carte jamais exposée
Frontend
POST /orders {token, idempotency_key}
Token, pas de carte
Backend
Crée order (status: pending)
BDD + log
Backend
Stripe.paymentIntents.create(...)
Avec idempotency_key
Stripe
Traitement (3DS, banque)
Async, 2-20s
Stripe
Webhook → /webhooks/stripe
Signé HMAC
Backend
Vérifie signature + update order
status: paid
💬 QUESTION INTERACTIVE
1/5
"Votre client voit 'Paiement échoué' et reclique 3 fois frénétiquement. Il se retrouve avec 3 débits. Où était l'erreur architecturale ?"
🎯 PIÈGE / QUESTION D'ENTRETIEN
Pourquoi utilise-t-on des webhooks pour les paiements plutôt qu'attendre la réponse synchrone de Stripe ?