Mini-leçon · Français

Comment accepter un paiement sur votre site

Créez un Payment Link de test, connectez-le à la page et vérifiez le paiement dans votre compte fournisseur sans développer de serveur de paiement.

Commencer le cours interactifLire les notes du cours

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

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

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

Ce que vous apprendrez

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

Fichiers de l’atelier

Étape 1

Choisissez un objectif de paiement en bac à sable

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

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.

Stripe : créer un Payment Link · Stripe : tests

Fichiers de cette étape

Start hereFichiers de l’atelier

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

Inspect individual files (optional)
How it works (optional)

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

Extra implementation exercise

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 2

Créez et connectez le lien de test

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

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.

Stripe : créer un Payment Link

Fichiers de cette étape

Start hereFichiers de l’atelier

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

Inspect individual files (optional)
How it works (optional)

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

Extra implementation exercise

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 3

Terminez un paiement de test fournisseur

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

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.

Stripe : tests

Fichiers de cette étape

Start hereFichiers de l’atelier

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

    Inspect individual files (optional)
    How it works (optional)

    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

    Extra implementation exercise

    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 4

    Essayez annulation et retour direct

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

    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

    Start hereFichiers de l’atelier

    Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

      Inspect individual files (optional)
      How it works (optional)

      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.

      Extra implementation exercise

      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 5

      Livrez le parcours de paiement de base

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

      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

      Start hereFichiers de l’atelier

      Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

      Inspect individual files (optional)
      How it works (optional)

      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.

      Extra implementation exercise

      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.

      Poursuivre votre apprentissage

      Explorer les autres leçons