Guide du module Passerelle de paiement Stripe

15 min de lecture Mis à jour le oct. 22, 2026 377 vues

Installation

Étape 1 : Téléverser l'add-on

Allez dans Panneau d'administration → Extensions → Add-ons, cliquez sur Téléverser un add-on et déposez le fichier .zip de l'add-on dans la zone de téléversement (50 Mo maximum). L'archive est extraite dans extensions/addons/stripe/ et Stripe apparaît dans la liste, désactivé.

Impossible de téléverser depuis le navigateur ? Décompressez l'archive sur votre ordinateur et copiez le dossier de l'add-on dans extensions/addons/stripe/ par FTP ou SSH : son fichier addon.json doit se trouver directement dans ce dossier. Ouvrez ensuite Panneau d'administration → Extensions → Add-ons. La page analyse extensions/addons/ à chaque chargement : l'add-on est donc listé immédiatement (le bouton Synchroniser lance la même analyse à la demande).

Étape 2 : Activer l'add-on

Cliquez sur Activer sur la carte Stripe. C'est un add-on payant : une fenêtre demande son code d'achat, qui est vérifié avant toute autre opération. Un code invalide est refusé dans la fenêtre et rien n'est modifié.

Une fois le code accepté, l'activation se fait en une seule passe : elle crée les tables de base de données de l'add-on (ses migrations), enregistre ses permissions, exécute ses seeders et publie ses assets publics. Rechargez la page pour voir sa nouvelle entrée dans la section Add-ons de la barre latérale d'administration.

Étape 3 : Configurer

Ouvrez Panneau d'administration → Stripe depuis la section Add-ons de la barre latérale et configurez l'add-on : voir Configuration.

Code d'achat (clé de licence)

Stripe est vendu comme un produit séparé, il possède donc son propre code d'achat (clé de licence), distinct du code d'achat de l'application principale et de celui de chaque autre add-on. Il vous est demandé lorsque vous activez Stripe dans Panneau d'administration → Extensions → Add-ons.

Nos produits sont vendus sur trois plateformes. La façon dont vous recevez un code d'achat dépend de l'endroit où vous avez acheté le produit.

Plateforme / Marketplace	Comment obtenir le code d'achat	Où le retrouver
Boutique bedigit.com Achat sur le site (Shop)	Généré automatiquement lorsque la commande est payée, puis envoyé par e-mail, soit dans un e-mail de licence dédié, soit dans l'e-mail de confirmation de commande.	Mon compte → Mes licences sur bedigit.com
Gumroad	Créé dès que Gumroad nous notifie la vente, puis envoyé dans un e-mail séparé, en plus du reçu Gumroad.	L'e-mail de licence, votre Bibliothèque Gumroad et Mon compte → Mes licences sur bedigit.com
Envato Market CodeCanyon	Délivré par Envato, pas par nous, et jamais envoyé par e-mail : vous le téléchargez vous-même depuis votre compte Envato.	Compte Envato → Downloads → License certificate & purchase code

Vérifiez votre dossier de spam. Pour les achats effectués sur la Boutique bedigit.com et sur Gumroad, le code d'achat est envoyé par e-mail. Les e-mails de licence automatiques sont très souvent filtrés : si le message ne se trouve pas dans votre boîte de réception, regardez dans votre dossier spam / courrier indésirable avant de contacter le support, et ajoutez notre adresse d'expédition à vos contacts ou à votre liste d'autorisation.

1. Boutique bedigit.com (achat sur le site)

Dès que le statut de paiement de la commande devient Payée, une clé de licence est générée automatiquement pour chaque article sous licence de la commande (une clé par unité achetée : acheter 3 unités donne 3 clés distinctes).
Elle est envoyée par e-mail à l'adresse utilisée pour la commande, soit dans un e-mail de licence dédié, soit dans l'e-mail de confirmation de commande. Vérifiez votre boîte de réception et votre dossier spam / courrier indésirable.
La clé reste disponible dans votre compte sous Mon compte → Mes licences. Les clés sont masquées dans la liste ; ouvrez la page de détail de la licence pour afficher et copier la clé complète, voir les domaines sur lesquels elle est activée, et désactiver un domaine pour libérer un emplacement d'activation.
La facture correspondante se trouve sous Mon compte → Mes commandes.

2. Gumroad

Un achat sur Gumroad produit deux e-mails distincts : le reçu Gumroad (envoyé par Gumroad, donnant accès aux fichiers) et un e-mail de clé de licence (envoyé par bedigit.com) qui contient votre code d'achat.
L'e-mail de clé de licence est généré dès que Gumroad nous notifie la vente, il arrive donc normalement quelques secondes après le paiement. Ici aussi, vérifiez votre boîte de réception et votre dossier spam / courrier indésirable.
Lorsque le produit Gumroad utilise la fonctionnalité de clés de licence propre à Gumroad, la même clé apparaît aussi dans votre reçu Gumroad et sous Bibliothèque → votre achat sur gumroad.com.
Utilisez la même adresse e-mail sur bedigit.com que sur Gumroad : vos clés sont alors liées automatiquement à votre compte et listées sous Mon compte → Mes licences, même si vous vous inscrivez après l'achat. Vous pouvez aussi ajouter une clé Gumroad manuellement depuis Mon compte → Mes licences Gumroad.

3. Envato Market (CodeCanyon)

Les codes d'achat Envato sont délivrés et fournis par Envato Market, jamais envoyés par e-mail par nous, il n'y a donc rien à chercher dans votre dossier de spam : vous récupérez le code depuis votre compte Envato.
Connectez-vous à votre compte Envato / CodeCanyon, ouvrez la page Downloads, trouvez l'article et choisissez License certificate & purchase code dans le menu déroulant Download. Le code est inscrit dans ce certificat.
Un code d'achat Envato ressemble à 12345678-90ab-cdef-1234-567890abcdef (8-4-4-4-12 caractères). Il ne change jamais, et le renouvellement du support de l'article n'en délivre pas de nouveau.
Article officiel Envato : Where Is My Purchase Code?

Vous avez perdu votre code d'achat ? Recherchez dans votre messagerie (dossier de spam inclus) “licence” ou “code d'achat”, puis consultez Mon compte → Mes licences sur bedigit.com pour les achats Boutique et Gumroad, ou Downloads → License certificate sur Envato. S'il est toujours introuvable, ouvrez un ticket sur notre Centre d'aide avec votre numéro de commande (Boutique), l'ID de vente Gumroad ou l'e-mail de l'acheteur (Gumroad), ou votre nom d'utilisateur Envato et le nom de l'article (Envato).

Compatibilité

v4.0.2 => LaraClassifier v19.1.0+ et JobClass v19.1.0+
v4.0.1 => LaraClassifier v19.1.0+ et JobClass v19.1.0+
v4.0.0 => LaraClassifier (v19.0.0 à v19.0.1) et JobClass (v19.0.0 à v19.0.1)
v3.2.6 => LaraClassifier v18.3.0+ et JobClass v17.3.0+
v3.2.5 => LaraClassifier v18.2.0 et JobClass v17.2.0
v3.2.4 => LaraClassifier (v18.1.1 à v18.1.1) et JobClass (v17.1.1 à v17.1.1)
v3.2.3 => LaraClassifier (v18.0.0 à v18.1.0) et JobClass (v17.0.0 à v17.1.0)
v3.2.2 => LaraClassifier (v17.0.0 à v17.1.1) et JobClass (v16.0.0 à v16.1.1)
v3.2.1 => LaraClassifier (v16.0.0 à v16.0.2) et JobClass (v15.0.0 à v15.0.2)
v3.2.0 => LaraClassifier (v15.1.1 à v15.4.1) et JobClass (v14.1.1 à v14.4.1)
v3.1.4 => LaraClassifier (v15.1.1 à v15.1.6) et JobClass (v14.1.1 à v14.1.6)
v3.1.3 => LaraClassifier v15.1.1 et JobClass v14.1.1
v3.1.2 => LaraClassifier v15.1.1 et JobClass v14.1.1
v3.1.1 => LaraClassifier v15.1.0 et JobClass v14.1.0
v3.1.0 => LaraClassifier v15.0.0 et JobClass v14.0.0
v3.0.1 => LaraClassifier v14.2.0 et JobClass v13.2.0
v3.0.0 => LaraClassifier (v14.0.0 à v14.1.0) et JobClass (v13.0.0 à v13.1.0)
v2.7 => LaraClassifier (v11.0.0 à v13.0.0) et JobClass (v10.0.0 à v12.0.0)
v2.6 => LaraClassifier v10.2.0+ et JobClass v9.2.0+
v2.5 => LaraClassifier v10.2.0 et JobClass v9.2.0
v2.4 => LaraClassifier (v10.0.1 à v10.1.4) et JobClass (v9.0.1 à v9.1.5)
v2.3 => LaraClassifier v10.0.1 et JobClass v9.0.1
v2.2 => LaraClassifier v10.0.1 et JobClass v9.0.1
v2.1 => LaraClassifier v10.0.0 et JobClass v9.0.0
v2.0 => LaraClassifier (v9.0.0 à v9.0.1) et JobClass (v8.0.0 à v8.0.1)
v1.9 => LaraClassifier (v8.0.2 à v8.0.6) et JobClass (v7.0.2 à v7.0.6)
v1.8 => LaraClassifier (v7.1.0 à v8.0.1) et JobClass (v5.9.0 à v7.0.1)
v1.7 => LaraClassifier (v6.6 à v7.0.4) et JobClass (v5.4 à v5.8.4)
v1.6 => LaraClassifier (v5.7 à v6.5) et JobClass (v4.5 à v5.3)
v1.5 => LaraClassifier (v5.2 à v5.6) et JobClass (v4.0 à v4.4)
v1.4 => LaraClassifier v5.1 et JobClass v3.9
v1.3 => LaraClassifier (v4.9 à v5.0) et JobClass (v3.7 à v3.8)
v1.1 à v1.2 => LaraClassifier (v3.1 à v4.8) et JobClass (v2.0 à v3.6)
v1.0 => LaraClassifier v3.0 et JobClass v1.9

Mise à jour

Une mise à jour ne remplace que les fichiers de l'add-on. Ses tables et ses données, ses paramètres, son état d'activation et son code d'achat enregistré sont tous conservés : ne désactivez et ne supprimez pas l'add-on avant de le mettre à jour. Sauvegardez tout de même votre base de données au préalable.

Méthode 1 : Téléverser la nouvelle version (recommandé)

Téléchargez le dernier fichier .zip de l'add-on.
Allez dans Panneau d'administration → Extensions → Add-ons et cliquez sur Téléverser un add-on.
Déposez le fichier .zip dans la zone de téléversement.
Comme Stripe est déjà installé, une demande de confirmation affiche la version installée et la nouvelle. Cliquez sur Remplacer : le dossier extensions/addons/stripe/ est remplacé par les nouveaux fichiers. Annuler la demande abandonne le téléversement.

Méthode 2 : Remplacer les fichiers à la main

Par FTP ou SSH, supprimez le dossier extensions/addons/stripe/ et envoyez le nouveau à sa place. Remplacez le dossier entier plutôt que de copier par-dessus, afin que les fichiers retirés par la nouvelle version ne subsistent pas.
Ouvrez Panneau d'administration → Extensions → Add-ons : la page relit addon.json et la carte affiche le nouveau numéro de version.

Une fois les fichiers remplacés

Nouvelles tables ou colonnes. Lorsqu'une nouvelle version en ajoute, créez-les en exécutant php artisan migrate --force en SSH, ou sans SSH en cliquant sur Désactiver puis Activer sur la carte de l'add-on : l'activation exécute toutes les migrations en attente (et redemande le code d'achat). Vos données ne sont pas touchées dans les deux cas.

Assets publics. Les fichiers publics de l'add-on sont copiés dans public/vendor/stripe/ lors de son activation, et remplacer ses fichiers ne rafraîchit pas cette copie. Lorsqu'une mise à jour les modifie, republiez-les avec php artisan vendor:publish --tag=stripe-assets --force, ou cliquez sur Désactiver puis Activer sur sa carte.

Si votre installation met en cache sa configuration ou ses routes (php artisan config:cache, route:cache), exécutez php artisan optimize:clear après la mise à jour.

Configuration

Obtenir vos identifiants d'API

Récupérez votre clé publiable et votre clé secrète depuis la page des clés d'API de votre tableau de bord Stripe. Stripe délivre des paires de clés distinctes pour les tests et la production.

Les configurer depuis le panneau d'administration

L'add-on ajoute une entrée Stripe à la section Add-ons de la barre latérale d'administration. Ouvrez-la pour atteindre Panneau d'administration → Stripe, la méthode recommandée pour configurer la passerelle.

Champ	Rôle
Integration	Checkout redirige les acheteurs vers une page de paiement hébergée par Stripe ; Payment Intent recueille les données de carte dans un formulaire intégré à votre site. Obligatoire. Checkout exige qu'un nom de compte ou d'entreprise soit défini sur votre compte Stripe ; Payment Intent implique que vous respectiez les exigences PCI.
Key	Votre clé publiable Stripe.
Secret	Votre clé secrète Stripe.
CurlProxy	Un proxy HTTP sortant, si votre serveur en a besoin pour joindre Stripe. Facultatif.
CurlSslVersion	Fixe la version TLS utilisée pour appeler Stripe : `CURL_SSLVERSION_TLSv1` ou `CURL_SSLVERSION_TLSv1_2`. Laissez l'entrée vide pour laisser cURL choisir.
Actif	L'interrupteur de la passerelle. Lorsqu'il est désactivé, Stripe disparaît des moyens de paiement proposés à vos clients.

Cliquez sur Enregistrer et les réglages s'appliquent immédiatement : il n'y a rien d'autre à vider ni à recompiler.

Où sont stockés les identifiants. Tous les champs ci-dessus sauf Actif sont écrits dans votre fichier /.env, et non en base de données, ce qui leur permet de survivre à un vidage de cache et à un config:cache. Le formulaire est pré-rempli avec ce que contient actuellement /.env, vous voyez donc toujours la valeur réellement utilisée. Key et Secret sont masqués, avec un bouton d'affichage, et sont les seuls champs pour lesquels un vide signifie inchangé : enregistrer le formulaire sans eux conserve la valeur déjà enregistrée, si bien que réenregistrer pour basculer l'interrupteur Actif ne vous coûte jamais un secret. Vider n'importe quel autre champ retire sa clé de /.env, c'est ainsi que l'on supprime un réglage depuis le panneau d'administration. Actif est la seule valeur stockée en base de données, sur la ligne payment_methods de la passerelle.

L'utilisateur du serveur web doit pouvoir écrire dans /.env. L'enregistrement du formulaire modifie ce fichier sur place. Si votre hébergement rend /.env non inscriptible par PHP, les réglages ne peuvent pas être enregistrés depuis le panneau d'administration : définissez-les manuellement, comme décrit ci-dessous.

Les configurer manuellement

Vous pouvez aussi vous passer du formulaire et modifier directement le fichier /.env du script. Ce sont exactement les clés que le formulaire d'administration écrit :

STRIPE_INTEGRATION=
STRIPE_KEY=
STRIPE_SECRET=
STRIPE_CURL_PROXY=
STRIPE_CURL_SSLVERSION=

Exemple d'utilisation :

STRIPE_INTEGRATION=checkout
STRIPE_KEY=your-stripe-key
STRIPE_SECRET=your-stripe-secret

NOTE :

Modes d'intégration pris en charge : checkout et payment_intent.
Pour sélectionner un mode d'intégration, vous devez utiliser la variable STRIPE_INTEGRATION= dans le fichier /.env comme ceci : STRIPE_INTEGRATION=payment_intent.
Si la variable STRIPE_INTEGRATION= est absente ou vide, l'intégration par défaut est checkout.
STRIPE_CURL_PROXY= (ex. proxy.local:80) et STRIPE_CURL_SSLVERSION= (CURL_SSLVERSION_TLSv1 ou CURL_SSLVERSION_TLSv1_2) sont facultatives : ne les ajoutez que si votre serveur en a besoin.
Pour utiliser l'intégration checkout, vous devez définir un nom de compte ou d'entreprise sur https://dashboard.stripe.com/account.
Pour utiliser payment_intent, vous devez respecter les exigences PCI : https://stripe.com/docs/security#pci-dss-guidelines.

Exécutez php artisan config:clear après avoir modifié /.env à la main si votre installation met sa configuration en cache. Modifier /.env n'active pas la passerelle : utilisez l'interrupteur Actif sur Panneau d'administration → Stripe, ou activez Stripe sous Panneau d'administration → Moyens de paiement.

Traduction

Pour traduire cet add-on dans votre langue :

Allez dans le dossier des langues à /extensions/addons/stripe/resources/lang/
Dupliquez le dossier /extensions/addons/stripe/resources/lang/en/ vers /extensions/addons/stripe/resources/lang/<code>/
NOTE : N'oubliez pas de remplacer <code> par le code de votre langue (ex. "de" pour l'allemand).
Ouvrez le fichier /extensions/addons/stripe/resources/lang/<code>/messages.php et traduisez-le.
NOTE : Pour traduire le fichier, vous devez modifier les valeurs et non les clés du tableau PHP.

Désinstallation

Éteindre un add-on sans rien perdre, c'est le désactiver : allez dans Panneau d'administration → Extensions → Add-ons, cliquez sur Désactiver sur la carte Stripe et confirmez.

L'add-on n'est plus chargé : ses routes, ses vues, son entrée dans la barre latérale d'administration et ses pages publiques ne répondent plus.
Ses tables de base de données et toutes les données qu'elles contiennent sont conservées, et ses fichiers restent dans extensions/addons/stripe/. Rien n'est supprimé.
Ses permissions et son code d'achat enregistré restent en base de données. Seule la suppression les efface.
La désactivation est refusée tant qu'un autre add-on actif dépend de celui-ci : désactivez d'abord cet add-on.

Cliquez sur Activer sur la même carte pour le rallumer. Comme lors de la première activation, le code d'achat est redemandé et vérifié ; ensuite les migrations en attente sont exécutées, les assets republiés, et l'add-on reprend exactement là où il s'était arrêté.

Suppression

La suppression est définitive et détruit les données de l'add-on. Le bouton Supprimer n'apparaît que sur un add-on désactivé : la suppression se fait donc toujours en deux temps :

Désactivez Stripe (voir Désinstallation).
Cliquez sur Supprimer sur sa carte et confirmez la demande.

Le panneau d'administration, en une seule passe :

exécute le hook de désinstallation de l'add-on, s'il en fournit un, tant que son code est encore sur le disque ;
révoque les permissions déclarées dans son addon.json ;
annule ses migrations, ce qui supprime ses tables de base de données et toutes les lignes qu'elles contiennent, et purge ses entrées de la table migrations, afin qu'une réinstallation ultérieure reparte de zéro ;
supprime ses assets publiés : public/addons/stripe/, public/vendor/stripe/ et storage/app/public/addons/stripe/ ;
supprime le dossier de l'add-on extensions/addons/stripe/ ;
supprime sa ligne dans la table addons (le code d'achat enregistré disparaît avec elle) et vide le cache de l'application.

Cette action est irréversible. Sauvegardez votre base de données avant de supprimer un add-on dont les données peuvent encore vous servir : le réinstaller plus tard crée des tables vides, pas votre ancien contenu, et redemande le code d'achat.

La suppression est refusée, avec un message explicatif et avant toute destruction, lorsque l'add-on est encore actif, lorsqu'un autre add-on actif en dépend, ou lorsque l'utilisateur du serveur web (PHP) ne peut pas supprimer extensions/addons/stripe/. Dans ce dernier cas, donnez à cet utilisateur le droit d'écriture sur le dossier et sur son parent, puis réessayez.

Supprimer le dossier en FTP ou en SSH n'est pas équivalent : l'add-on est seulement éteint, et ses tables, ses entrées dans la table migrations et sa ligne addons restent en place. Utilisez plutôt Supprimer dans le panneau d'administration.

Guide du module Passerelle de paiement Stripe pour LaraClassifier & JobClass

Installation

Étape 1 : Téléverser l'add-on

Étape 2 : Activer l'add-on

Étape 3 : Configurer

Code d'achat (clé de licence)

1. Boutique bedigit.com (achat sur le site)

2. Gumroad

3. Envato Market (CodeCanyon)

Compatibilité

Mise à jour

Méthode 1 : Téléverser la nouvelle version (recommandé)

Méthode 2 : Remplacer les fichiers à la main

Une fois les fichiers remplacés

Configuration

Obtenir vos identifiants d'API

Les configurer depuis le panneau d'administration

Les configurer manuellement

Traduction

Désinstallation

Suppression

Ressources

Guides des add-ons

Guide du module Passerelle de paiement Stripe pour LaraClassifier & JobClass

Installation

Étape 1 : Téléverser l'add-on

Étape 2 : Activer l'add-on

Étape 3 : Configurer

Code d'achat (clé de licence)

1. Boutique bedigit.com (achat sur le site)

2. Gumroad

3. Envato Market (CodeCanyon)

Compatibilité

Mise à jour

Méthode 1 : Téléverser la nouvelle version (recommandé)

Méthode 2 : Remplacer les fichiers à la main

Une fois les fichiers remplacés

Configuration

Obtenir vos identifiants d'API

Les configurer depuis le panneau d'administration

Les configurer manuellement

Traduction

Désinstallation

Suppression

Ressources

Articles Liés

Guide du module Passerelle de paiement PayPal pour LaraClassifier & JobClass

Guide du module Passerelle de paiement 2Checkout pour LaraClassifier & JobClass

Guide du module Mappage de domaines (multisite) pour LaraClassifier & JobClass

Guides des add-ons