Installer un module PrestaShop
Cette partie décrit l'installation d'un module PrestaShop. Pour comprendre ce qu'est un module et comment décider entre marketplace et dev custom, voir Modules : l'ADN de PrestaShop.
Objectif : installer et configurer un module PrestaShop de A à Z, en prenant Stripe comme fil rouge — l'un des modules de paiement les plus utilisés sur PrestaShop.
➡ Documentation officielle PrestaShop : https://devdocs.prestashop-project.org/9/modules/ ➡ Module Stripe officiel : https://addons.prestashop.com/fr/paiement-carte-wallet/24048-stripe-official.html
Avant d'installer n'importe quel module, vérifie toujours :
- 🔢 Compatibilité avec ta version de PrestaShop
- 📅 Date de dernière mise à jour (< 12 mois = bon signe)
- 🧪 Environnement de staging — jamais directement en production !
🗡️ Les 3 voies pour installer un module
Il existe trois façons d'armer ton royaume avec un nouveau module. Choisis ton chemin :
| ⚔️ Méthode | 📋 Description | ✅ Quand l'utiliser |
|---|---|---|
| Via le back-office (upload zip) | Tu télécharges le .zip du module et tu l'uploades depuis l'interface | Module acheté sur Addons ou fourni par un partenaire |
| Via le back-office (marketplace) | Tu cherches directement dans le catalogue Addons depuis ton back-office | Module gratuit ou déjà acheté sur ton compte Addons |
| Via FTP / Docker | Tu déposes le dossier du module directement dans /modules/ | Module développé en interne ou déployé via CI/CD |
📦 Étape 1 — Obtenir le module Stripe
Rends-toi sur la marketplace officielle PrestaShop Addons et télécharge le module Stripe.
Le module officiel Stripe pour PrestaShop est gratuit — c'est Stripe qui se rémunère sur les commissions de transaction (1,4% + 0,25€ pour les cartes européennes). Pas de mauvaise surprise côté module.
Tu obtiens un fichier .zip du type :
stripe_official-x.x.x.zip
Garde-le à portée — tu en as besoin dans l'étape suivante.
🏗️ Étape 2 — Installer le module dans PrestaShop
- 🖥️ Via le back-office (recommandé)
- 📁 Via FTP / Docker
Connecte-toi à ton back-office PrestaShop (/admin ou ton URL custom).
1. Navigue vers Modules > Gestionnaire de modules
2. Clique sur le bouton "Installer un module" en haut à droite
| 🖱️ Action | 📋 Détail |
|---|---|
| Cliquer sur "Sélectionner un fichier" | Sélectionne ton stripe_official-x.x.x.zip |
| Cliquer sur "Installer ce module" | PrestaShop dézippe et installe automatiquement |
| Patienter quelques secondes ⏳ | Le module s'installe dans /modules/stripe_official/ |
3. Une confirmation apparaît — le module est installé. Clique sur "Configurer" pour passer à l'étape suivante.
Si tu travailles avec Docker (comme décrit dans ce cookbook), tu peux déposer le module directement dans le volume :
1. Dézipe le module sur ta machine :
unzip stripe_official-x.x.x.zip -d ./modules/
2. Vérifie que le dossier est bien en place :
ls modules/stripe_official/
# → stripe_official.php config.xml views/ ...
3. Rends-toi dans Modules > Gestionnaire de modules dans le back-office, recherche "Stripe" et clique sur "Installer".
Assure-toi que les fichiers du module appartiennent au bon utilisateur (celui du serveur web) :
chown -R www-data:www-data modules/stripe_official/
⚙️ Étape 3 — Configurer le module Stripe
Une fois le module installé, clique sur "Configurer" (ou retrouve-le via Modules > Gestionnaire de modules > Stripe > Configurer).
🔑 Récupérer tes clés API Stripe
Avant tout, tu as besoin de tes clés API Stripe. Connecte-toi sur dashboard.stripe.com :
| 🗝️ Clé | 📋 Où la trouver | ⚠️ À savoir |
|---|---|---|
Clé publique (pk_test_...) | Dashboard Stripe > Développeurs > Clés API | Visible côté client — pas de secret |
Clé secrète (sk_test_...) | Dashboard Stripe > Développeurs > Clés API | Ne jamais la committer dans le code 🔐 |
Clé webhook (whsec_...) | Dashboard Stripe > Développeurs > Webhooks | Nécessaire pour les notifications de paiement |
Stripe fournit deux jeux de clés : pk_test_ / sk_test_ pour le développement, et pk_live_ / sk_live_ pour la production. Commence toujours en mode test — tu peux simuler des paiements sans débiter personne.
Cartes de test Stripe :
- ✅ Paiement réussi :
4242 4242 4242 4242 - ❌ Paiement refusé :
4000 0000 0000 0002 - 🔐 Authentification 3DS :
4000 0025 0000 3155
📝 Remplir la configuration
Dans l'interface de configuration du module Stripe, renseigne les champs suivants :
| 🏷️ Champ | 📝 Valeur à renseigner |
|---|---|
| Mode | Test pendant le développement, Live en production |
| Clé publique | Colle ta clé pk_test_... (ou pk_live_...) |
| Clé secrète | Colle ta clé sk_test_... (ou sk_live_...) |
| Clé webhook | Colle ta clé whsec_... |
| Méthodes de paiement | Carte bancaire, Apple Pay, Google Pay — coche selon ton besoin |
| Capture automatique | Oui dans la majorité des cas (débit immédiat à la commande) |
🔔 Configurer le Webhook
Le webhook permet à Stripe de notifier PrestaShop en temps réel de l'état du paiement (succès, échec, remboursement…). Sans lui, ta boutique ne sait pas si le paiement a abouti.
1. Dans le dashboard Stripe > Développeurs > Webhooks > Ajouter un endpoint
2. Renseigne l'URL fournie par le module (visible dans la config) :
https://ta-boutique.com/module/stripe_official/webhook
3. Sélectionne les événements à écouter — le module Stripe t'indique lesquels activer. A minima :
payment_intent.succeeded
payment_intent.payment_failed
charge.refunded
4. Copie la clé de signature générée et colle-la dans le champ "Clé webhook" de la configuration du module.
✅ Étape 4 — Tester l'installation
Avant de crier victoire, passe ton module à l'épreuve du feu 🔥 :
| 🧪 Test | ✅ Résultat attendu |
|---|---|
| Stripe apparaît au checkout | Le bloc paiement Stripe s'affiche bien sur la page de paiement |
Paiement avec 4242 4242 4242 4242 | Commande créée avec statut "Paiement accepté" |
Paiement avec 4000 0000 0000 0002 | Commande en statut "Paiement refusé", client informé |
| Remboursement depuis le back-office PS | Remboursement bien déclenché côté Stripe |
| Webhook reçu | Dans le dashboard Stripe > Webhooks, les events apparaissent en vert |
En ces temps de vérification sacrée, chaque pièce d'or simulée trace son chemin depuis les serveurs de Stripe jusqu'aux coffres de ta boutique. Vérifie bien chaque statut de commande et chaque event webhook — car un paiement accepté en silence est aussi dangereux qu'un dragon endormi dans tes réserves. 🐉
🚀 Passer en production
Quand tous les tests sont au vert, il est temps de basculer en mode réel :
Checklist avant le passage en live :
- Remplace les clés
pk_test_/sk_test_par les cléspk_live_/sk_live_ - Mets à jour l'URL du webhook avec les clés live
- Passe le mode du module sur "Live"
- Effectue une vraie commande test (quelques centimes) pour valider de bout en bout
- Vérifie que le paiement apparaît bien dans ton dashboard Stripe live
- Rembourse immédiatement la commande test 😄
Tes caisses sont désormais reliées aux circuits bancaires du royaume digital. Chaque pièce d'or versée par tes clients traversera les murailles de Stripe pour atterrir sagement dans tes coffres.
Que les conversions soient nombreuses et les taux d'abandon de panier aussi bas que l'horizon ! 🎺👑