Stripe encaisse les paiements de la boutique et des abonnements. La mise en place se fait une seule fois, en six étapes, et se termine par un achat de test qui ne coûte rien. L’article Configurer Stripe décrit ce que contient chacun des champs ; celui-ci donne l’ordre des opérations.

1. Créer le compte Stripe

Ouvrez un compte au nom de votre entreprise sur https://dashboard.stripe.com (nouvelle fenêtre). Stripe demande ensuite vos informations légales et un compte bancaire pour verser l’argent encaissé. Tant que cette vérification n’est pas terminée, le mode réel reste bloqué, mais rien n’empêche de tout configurer et de tout tester pendant ce temps : commencez par les étapes suivantes dans un environnement de test.

2. Ouvrir un environnement de test

L’environnement de test est un compte parallèle dans lequel aucun argent ne circule. Cliquez sur le sélecteur de compte, en haut du tableau de bord Stripe, puis sur Basculer vers l’environnement de test. S’il n’en existe encore aucun, choisissez Créer un environnement de test, donnez-lui un nom qui indique son usage (par exemple Test), gardez l’option qui copie les paramètres de votre compte, et validez. Un compte Stripe peut contenir cinq environnements de test au maximum.

Pour y revenir plus tard, reprenez le même chemin et cliquez sur Ouvrir en face de l’environnement voulu, ou sur Gérer les environnements de test pour les voir tous. Une bannière en haut du tableau de bord rappelle en permanence que vous êtes dans un environnement de test : tant qu’elle est affichée, rien de ce que vous faites n’a d’effet réel. La procédure est décrite en détail par Stripe : https://docs.stripe.com/sandboxes/dashboard/manage (nouvelle fenêtre)

3. Copier les clés de test

Dans l’environnement de test, ouvrez la page Développeurs, puis Clés d’API. Sur un compte encore en mode test classique, l’adresse directe https://dashboard.stripe.com/test/apikeys (nouvelle fenêtre) mène au même endroit. Collez la clé publique (pk_test_…) et la clé secrète (sk_test_…) dans l’onglet Paiement des paramètres. Vérifiez au passage la devise : elle doit être celle de votre compte Stripe, sinon les paiements sont refusés.

4. Brancher le webhook

Le webhook est le canal par lequel Stripe prévient votre site qu’un paiement a abouti. Un achat ponctuel s’en remet : le navigateur confirme la commande, et un rattrapage repasse toutes les heures sur les paiements qu’aucune de ces voies n’a enregistrés. Un abonnement, non : c’est le webhook, et lui seul, qui le renouvelle et qui accorde ses crédits chaque mois. Ce n’est donc pas une étape facultative. Toujours dans l’environnement de test, ouvrez Développeurs, puis Webhooks (adresse directe en mode test classique : https://dashboard.stripe.com/test/webhooks (nouvelle fenêtre)). Ajoutez un endpoint et renseignez :

L’adresse à appeler : https://votre-domaine.fr/api/payments/stripe/webhooks, en remplaçant votre-domaine.fr par l’adresse publique de votre site, celle que voient vos clients.
Les événements à écouter : payment_intent.succeeded, payment_intent.canceled, invoice.payment_succeeded, invoice.payment_failed, customer.subscription.updated et customer.subscription.deleted. Les deux premiers couvrent les achats, les quatre suivants les abonnements. Grâce à payment_intent.succeeded, un achat payé est enregistré immédiatement, même si le client ferme la page avant la fin ; sans lui, il ne l’est qu’au contrôle horaire suivant.
La version de l’API : 2026-02-25.clover. Stripe propose par défaut la version la plus récente de votre compte ; choisissez explicitement celle-ci, car c’est le seul format que le site sait lire. Sous une autre version, les notifications arrivent bien, mais certains champs changent de place : le paiement est encaissé chez Stripe et, sur le site, la commande ou les crédits ne suivent pas.

Une fois l’endpoint créé, Stripe affiche un secret de signature (whsec_…) : copiez-le dans le champ Secret du webhook des paramètres. Ce secret appartient à cet endpoint et à ce mode : le webhook de test et le webhook réel en ont chacun un, et ils ne sont pas interchangeables.

5. Faire un achat de test

Publiez un produit, achetez-le depuis votre boutique avec le numéro de carte de test 4242 4242 4242 4242, une date d’expiration future et n’importe quel cryptogramme. Aucun argent ne circule. La commande doit passer à terminée en quelques secondes, et les crédits éventuels apparaître sur le compte du client. Si elle reste en attente, le webhook est en cause : la page de l’endpoint dans Stripe liste chaque tentative d’appel avec la réponse reçue.

6. Passer en mode réel

Quittez l’environnement de test : cliquez sur le sélecteur de compte, puis sur le nom de votre compte pour revenir en mode réel. Refaites ensuite les étapes 3 et 4 : de nouvelles clés (pk_live_… et sk_live_…) et un nouvel endpoint, avec la même adresse, les mêmes événements et la même version de l’API (2026-02-25.clover), dont il faut recopier le nouveau secret. Rien n’est repris automatiquement de l’environnement de test.

La clé secrète et les secrets de webhook sont chiffrés : une fois enregistrés, le champ affiche une valeur masquée et ne les remontre jamais en clair. Pour en changer, collez simplement la nouvelle valeur par-dessus.

Reverser à un coach (facultatif)

Stripe Connect permet d’envoyer le paiement d’un produit sur le compte Stripe du coach qui lui est associé plutôt que sur le vôtre. L’option est ouverte par la plateforme, sur demande. Elle demande un second endpoint, https://votre-domaine.fr/api/payments/stripe/webhooks-connect, configuré dans Stripe pour les événements des comptes connectés, dont le secret va dans le champ Secret du webhook Connect. L’identifiant Connect du coach se renseigne ensuite sur sa fiche. Un produit sans coach, ou un coach sans identifiant Connect, est encaissé normalement sur votre compte.

Ce qui bloque le plus souvent

Une commande payée reste en attente : le webhook manque, son adresse est erronée, ou son secret vient de l’autre mode.
Un paiement aboutit chez Stripe mais la commande, les crédits ou les dates de facturation d’un abonnement sont absents ou faux : l’endpoint est enregistré sous une version de l’API autre que 2026-02-25.clover. La version se change sur la page de l’endpoint, dans Stripe, sans avoir à le recréer.
Le formulaire de carte ne s’affiche pas : la clé publique est vide, ou elle appartient à un mode différent de celui de la clé secrète, voire à un autre environnement de test. Les deux clés vont toujours par paire, et proviennent toujours du même endroit.
La devise des paramètres ne correspond pas à celle du compte Stripe : le paiement est refusé par Stripe.
Le compte Stripe n’a pas fini d’être vérifié : les paiements réels sont refusés tant que Stripe n’a pas validé les informations légales et le compte bancaire.

Dans tous les cas, le tableau de bord Stripe reste la source de vérité : il montre chaque tentative de paiement, réussie ou non, avec le motif du refus, et chaque appel de webhook avec la réponse reçue.

Mettre en place Stripe, pas à pas