LeçonsComment accepter un paiement sur votre site

Mini-leçon 26 sur 30 · Exploiter et entretenir votre site

Choisissez un objectif de paiement en bac à sable

À qui s’adresse cette leçon ?

Pour les personnes souhaitant un bouton de paiement. Le parcours de base utilise une page hébergée et un assistant pour le lien ; code serveur, base et webhooks sont des prolongements avancés facultatifs.

Commencez par un paiement hébergé plutôt que de recueillir vous-même les données de carte.

Objectif de cette leçon

  • Créez un lien de paiement clairement identifié comme bac à sable.
  • Connectez et testez le bouton de paiement du site.
  • Vérifiez les états payé/annulé réels chez le fournisseur plutôt que de faire confiance à la page de retour.
Explications, exemple détaillé et exercices

Avant de commencer

Votre compte Stripe admissible avec environnement bac à sable/test et la page fournie. L’assistant peut configurer le lien de test public. Le parcours de base n’exige ni Supabase, ni clé secrète dans le navigateur, ni serveur personnalisé.

Vérifiez vos acquis de départ

Ce sont des compétences utiles, pas des cours obligatoires bloquants. Si vous les maîtrisez, commencez ici ; sinon, ouvrez la préparation. Les fichiers fournis remplacent un site personnel préalable.

  1. Comment publier votre site depuis GitHub

    Connectez un dépôt d’exercice à l’hébergement.

Durée estimée: 35–53 min

Estimations avec les fichiers fournis et les comptes et outils requis déjà prêts. La configuration, les files de déploiement et les délais de messagerie ou de DNS demandent du temps supplémentaire. Admissibilité du compte, activation et lancement commercial réel sont hors de cet atelier. Aucun vrai fonds ni renseignement de carte réel n’est utilisé.

Comprendre le principe

Utilisez votre environnement Stripe de test et un produit/prix fictif. Ouvrez la page avec l’assistant et décidez ce que décrira le bouton.

Gardez cet exercice en mode test. Ouvrir une adresse de réussite ne prouve pas un paiement.

Un exemple concret

Le produit pourrait être « Sample digital workshop », au prix de test unique de USD 5. Le bouton doit annoncer un paiement de test ; ni la page ni la leçon ne promettent une livraison automatique du produit.

Utilise la page publique pour un exercice de base de Payment Link hébergé. Aide à créer un produit/prix de test dans mon bac à sable Stripe et place seulement son URL publique de paiement de test dans la configuration. N’installe pas l’extension base/webhook et n’utilise pas d’identifiants réels. Aide à publier uniquement la page d’exercice voulue et à vérifier le paiement de test dans le Dashboard. La page de retour ne prouve pas le paiement.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

Examiner les fichiers séparément (facultatif)

À vous de jouer

Quel article et prix de test le bouton décrira-t-il et où vérifierez-vous le paiement ?

Afficher une solution détaillée

Mon produit illustratif est « Sample digital workshop » à USD 5 dans l’environnement de test Stripe. Le bouton ouvre son paiement hébergé. Je vérifierais statut paid, montant et devise dans mon compte Stripe ; visiter success.html ne démontrerait aucun paiement.

Éléments d’une réponse solide

  • Nomme un produit fictif de test, son montant et sa devise.
  • Identifie le relevé du paiement chez le fournisseur comme endroit de vérification.
Comment ça marche (facultatif)

Acceptez un paiement de test hébergé

Commencez par une page de test du fournisseur et une frontière de réussite précise.

Un Payment Link hébergé laisse le fournisseur recueillir les renseignements de paiement sans champs de carte sur votre page. Cette pratique utilise seulement l’environnement et les cartes de test Stripe.

Le site ouvre le paiement, le serveur reçoit les événements signés et enregistre un reçu. La page de retour n’est que de la navigation : tout le monde peut ouvrir une URL ; sa présence ne prouve pas le paiement.

Exemple détaillé

Ouvrir directement success.html ne doit créer aucun reçu. Une session payée vérifiée du Payment Link configuré peut en créer un même si le client ne revient jamais sur votre site.

Stripe : après un paiement Payment Link · Stripe : tests

Exercice technique complémentaire

Un utilisateur visite /success.html?paid=true. Faut-il lui accorder un produit payé ?

Afficher une solution détaillée

Non. Le visiteur contrôle le paramètre. Utilisez un événement vérifié ou une vérification fournisseur côté serveur liée à la transaction voulue.

  • Refuse les URL contrôlées par l’appelant comme preuve de paiement.
  • Exige un état de paiement vérifié du fournisseur.

Étape 1 · Comment accepter un paiement sur votre site

Créez et connectez le lien de test

Utilisez le tableau de bord et laissez l’assistant modifier la page.

Explications, exemple détaillé et exercices

Comprendre le principe

Créez le produit/prix de test à paiement unique et le Payment Link dans votre compte. Ouvrez le paiement public déconnecté, puis donnez cette URL de test à l’assistant pour la page publique fournie.

Vérifiez article, montant, devise et environnement de test avant de continuer. Seule l’URL publique de test appartient à cette page ; le lien de base n’exige aucune clé privée d’API ou de signature.

Un exemple concret

Une bonne configuration ouvre le paiement public de test sans connexion. Une page de réglages Stripe ou la valeur test_REPLACE inchangée n’est pas un lien utilisable.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

Examiner les fichiers séparément (facultatif)

À vous de jouer

Le bouton ouvre-t-il le paiement de bac à sable voulu avec le bon article/prix ?

Afficher une solution détaillée

Exemple de vérification : Le lien ouvre le paiement public de test « Sample digital workshop », USD 5, sans connexion à mon compte Stripe. Seul ce lien est configuré ; aucune clé API ni aucun secret webhook n’est nécessaire pour ce parcours de base.

Éléments d’une réponse solide

  • Vérifie produit, montant, devise et mode de test dans le paiement hébergé sans connexion.
  • Utilise uniquement le Payment Link public de test dans la configuration de la page fournie.
Comment ça marche (facultatif)

Configurez le paiement de test séparé

Distinguez URL publiques, identifiants serveur et secrets webhook.

Suivez START-HERE.txt pour créer un Payment Link de test à paiement unique, une table et une destination webhook. Installez la dépendance Stripe épinglée et conservez le verrouillage généré.

Placez seulement l’URL publique de test dans config.js. Les variables serveur comprennent la clé secrète de test, le secret de signature du point d’accès, l’ID Payment Link attendu et la clé privée de base. Le code rejette volontairement les identifiants de production.

Pour la séquence locale complète, ouvrez run-locally.txt : préparez l’environnement privé de la racine, liez uniquement le projet d’entraînement et démarrez le proxy de fonctions Netlify. server-env.example.txt liste les noms des variables sans vrais secrets. Ouvrir seulement le HTML ne lance pas le serveur.

Exemple détaillé

Le secret de signature prouve de quel point d’accès vous acceptez les événements. Ce n’est ni le Payment Link ni la clé API ; copier le mauvais secret fait échouer la signature.

Node.js : état de prise en charge des versions

Exercice technique complémentaire

Que placer dans public/config.js : l’URL de test ou le secret de signature whsec ?

Afficher une solution détaillée

Seulement l’URL publique. Gardez secret webhook et clés secrètes fournisseur et base dans les variables serveur.

  • Garde les secrets de signature et d’API au serveur.
  • Utilise seulement la destination publique de paiement côté navigateur.

Étape 2 · Comment accepter un paiement sur votre site

Terminez un paiement de test fournisseur

Suivez les instructions officielles de test et examinez le résultat du compte.

Explications, exemple détaillé et exercices

Comprendre le principe

Suivez le guide Stripe lié uniquement dans le bac à sable. Terminez un paiement jetable, puis retrouvez le paiement/la session réels dans votre compte.

Vérifiez montant, devise et statut payé attendus à cet endroit. Un parcours de page terminé peut différer de l’état final du paiement, surtout pour les moyens réglés plus tard.

Un exemple concret

« Parcours de paiement terminé » et « paiement confirmé payé » ne sont pas toujours la même observation.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

    Examiner les fichiers séparément (facultatif)

    À vous de jouer

    Qu’a réellement rapporté l’enregistrement fournisseur pour votre paiement de test ?

    Afficher une solution détaillée

    Exemple fournisseur : Le paiement correspondant est marqué paid pour USD 5, conformément au prix choisi. Si le statut est processing ou unpaid, je noterais cet état au lieu d’annoncer payé parce que la page de paiement s’est terminée.

    Éléments d’une réponse solide

    • Retrouve le paiement de test correspondant et son véritable statut paid dans le compte fournisseur.
    • Compare montant et devise enregistrés au prix de test choisi.
    Comment ça marche (facultatif)

    Vérifiez l’événement et enregistrez le paiement une seule fois

    Authentifiez le contenu brut avant d’interpréter son JSON.

    Le gestionnaire passe les octets bruts inchangés et Stripe-Signature au SDK officiel. Analyser ou reformater le JSON avant peut modifier les octets et casser la vérification.

    Il accepte seulement les types prévus, le mode test, le payment_link correspondant et payment_status=paid. Des méthodes différées peuvent terminer le parcours avant la réussite du paiement ; la fin de checkout ne suffit donc pas. Un session_id unique rend les insertions répétées sans effet supplémentaire.

    Deux ID d’événements peuvent décrire la même session : fin du parcours puis réussite asynchrone. La clé primaire session_id avec on_conflict=session_id et resolution=ignore-duplicates rend l’insertion durable répétable. Un échec de base n’est pas caché : il renvoie 503 pour permettre une nouvelle livraison.

    Exemple détaillé

    La même session livrée deux fois possède toujours une seule valeur de clé primaire. Un échec de base renvoie 503 pour réessayer au lieu de confirmer un événement dont le résultat est perdu.

    Stripe : vérification des signatures webhook et nouvelles tentatives

    Exercice technique complémentaire

    Pourquoi checkout.session.completed avec payment_status=unpaid n’est-il pas encore une commande payée ?

    Afficher une solution détaillée

    Certaines méthodes confirment plus tard. Attendez un état payé vérifié, notamment l’événement asynchrone si nécessaire, avant d’enregistrer un reçu payé.

    • Distingue fin du parcours et état de paiement confirmé.
    • Attend la confirmation de paiement adaptée.

    Étape 3 · Comment accepter un paiement sur votre site

    Essayez annulation et retour direct

    Vérifiez qu’un visiteur ne peut pas fabriquer un résultat payé par navigation.

    Explications, exemple détaillé et exercices

    Comprendre le principe

    Démarrez un autre paiement de test et quittez-le sans payer, ou utilisez un parcours d’annulation réellement proposé. Ouvrez séparément success.html directement. Comparez les deux aux paiements de test du fournisseur.

    Un paiement abandonné peut rester incomplet ou ouvert plutôt qu’afficher littéralement « canceled ». Aucun des deux gestes ne doit devenir un nouvel achat payé dans votre relevé. La page de base ne livre pas automatiquement le produit.

    Un exemple concret

    Ouvrir success.html ou ajouter paid=true à son URL ne crée pas de paiement paid correspondant dans Stripe. Revenir sur le site et démontrer le paiement sont deux opérations distinctes.

    Fichiers de cette étape

    Commencer iciFichiers de l’atelier

    Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

      Examiner les fichiers séparément (facultatif)

      À vous de jouer

      Qu’ont prouvé annulation et visite directe de la page de retour, et que n’ont-elles pas prouvé ?

      Afficher une solution détaillée

      Dans ce contrôle illustratif, le second paiement a été abandonné sans nouveau paiement paid. Ouvrir success.html directement n’a affiché que le message de retour. Aucun geste ne prouve un achat et la page n’accorde aucun accès automatique au produit.

      Éléments d’une réponse solide

      • Distingue un paiement annulé ou incomplet d’un paiement correspondant réellement paid.
      • Reconnaît qu’un accès direct à la page de retour ne prouve pas un paiement ni n’accorde une livraison.
      Comment ça marche (facultatif)

      Suivez un paiement de test de bout en bout

      Reliez session, événement signé et reçu stocké.

      Utilisez seulement les cartes officielles de test dans l’environnement de test. Retrouvez la session et sa livraison webhook dans votre compte, puis la table privée payment_receipts du projet.

      Comparez montant et devise à cette session. Renvoyez le même événement légitime et confirmez une seule ligne. Essayez une requête non signée et une visite directe de réussite ; aucune ne doit créer de paiement.

      Exemple détaillé

      Une réponse webhook 200 prouve que le gestionnaire a accusé réception de quelque chose. Vérifiez reçu et session au lieu de supposer que tous les événements visent le bon produit.

      Exercice technique complémentaire

      Le webhook renvoie 200 pour un événement sans rapport. Un reçu doit-il exister ?

      Afficher une solution détaillée

      Non. Le gestionnaire accuse réception des événements ignorés sans reçu. Seule une session payée de test correspondante doit créer l’enregistrement voulu.

      • Comprend les événements volontairement ignorés.
      • Relie l’état stocké à la session payée précise.

      Étape 4 · Comment accepter un paiement sur votre site

      Livrez le parcours de paiement de base

      Terminez un lien utile sans prétendre disposer d’un système commercial complet.

      Explications, exemple détaillé et exercices

      Comprendre le principe

      Répétez les contrôles du bouton et du paiement de bac à sable après correction. Gardez page/lien et un relevé expurgé des tentatives réussies et annulées ou non terminées.

      Avant de vraies ventes, confirmez l’admissibilité entreprise/compte, prix/devise, conditions et processus opérationnel. Accès automatique, événements signés et récupération de base relèvent du contenu avancé facultatif ci-dessous.

      Un exemple concret

      Un bouton de paiement hébergé fonctionnel est un petit résultat valable ; il ne prouve pas l’existence d’un serveur de livraison non construit.

      Fichiers de cette étape

      Commencer iciFichiers de l’atelier

      Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

      Examiner les fichiers séparément (facultatif)

      À vous de jouer

      Fournissez le parcours de test et les vrais résultats de bac à sable, ainsi que les besoins avant lancement réel.

      Travail à rendre: Votre lien/page de paiement de test et les observations réelles paiement/annulation en bac à sable ; aucun débit réel.

      Afficher une solution détaillée

      Exemple de transmission : La page ouvre le test d’atelier à USD 5 ; un paiement correspondant est paid pour USD 5 ; la tentative abandonnée ne l’est pas ; ouvrir directement le retour ne change aucun relevé. Aucun prélèvement réel ni livraison automatique n’a été testé. Il reste avant lancement un compte éligible, de vraies conditions et une livraison vérifiée.

      Éléments d’une réponse solide

      • Fournit le parcours public de test configuré avec ses résultats payé et incomplet/annulé.
      • Précise que prélèvement réel et livraison automatique sortent du test de base effectué.
      Comment ça marche (facultatif)

      Votre devoir : répéter une récupération sans vrai débit

      Un parcours de paiement doit récupérer une écriture de base manquée.

      Dans le projet jetable, utilisez temporairement un réglage de base invalide et renvoyez l’événement payé légitime. Observez une réponse d’échec et aucun nouveau reçu. Restaurez, renvoyez et vérifiez exactement une ligne correspondante.

      Expliquez le travail avant de vendre réellement : compte et activité pris en charge, prix, devise et conditions exacts, livraison durable du produit, rapprochement, remboursements et surveillance. Cet atelier ne stocke que des reçus de test.

      Exemple détaillé

      Si le stockage échoue mais que le point d’accès renvoie une réponse de réussite, les nouvelles tentatives automatiques peuvent s’arrêter avant que votre enregistrement existe. Signaler honnêtement l’échec fait partie d’un traitement fiable des paiements.

      Le parcours de référence complet est disponible dans reference/assignment-walkthrough.txt. Comparez ses étapes avec votre résultat ; remplissez le relevé de test à partir de vos propres observations sur votre projet.

      Exercice technique complémentaire

      Démontrez un échec de stockage et une récupération réussie sans doublons.

      Afficher une solution détaillée

      Installez avec npm install dans le projet séparé ; cela génère package-lock.json à conserver. Utilisez seulement Payment Link de test et identifiants sk_test_. Le lien public n’est pas le secret webhook.

      Retrouvez la session payée de test, sa livraison signée et le reçu privé avec mêmes session_id, montant et devise. Renvoyez : clé primaire et ignore-duplicates doivent laisser un reçu. Une requête non signée ou une visite directe de réussite n’en crée aucun.

      Pour l’essai d’échec, changez temporairement SUPABASE_URL uniquement dans l’environnement local ou serveur jetable vers une cible de test invalide. Renvoyez le même événement légitime et constatez l’échec réessayable. Restaurez, renvoyez et vérifiez un reçu durable. Ne modifiez jamais la production et n’utilisez pas de vraie carte.

      • L’échec de persistance ne confirme pas un traitement réussi.
      • La récupération crée un reçu ; aucune vraie donnée de paiement ni somme réelle n’est utilisée.

      Cette leçon vous a-t-elle été utile ?

      Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.