# Utiliser l’application Stripe pour Adobe Commerce (Magento 2) Découvrez comment installer, mettre à jour et désinstaller l’application Stripe pour Adobe Commerce (Magento 2). > Nous vous recommandons de tester le module avant de l’installer dans votre environnement de production. Si vous rencontrez un problème d’installation, consultez la documentation consacrée à la [résolution des problèmes](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/troubleshooting.md). ## Installer le module #### À partir de la place de marché (recommandé) 1. Passez une commande pour le module via la [place de marché Adobe](https://marketplace.magento.com/stripe-stripe-payments.html). 1. Ouvrez un terminal et exécutez la commande suivante dans votre répertoire Adobe Commerce : ```bash composer require stripe/stripe-payments ``` À cette étape, vous devrez peut-être saisir votre identifiant et votre mot de passe. Fournissez vos [clés d’authentification Adobe Commerce](https://devdocs.magento.com/guides/v2.3/install-gde/prereq/connect-auth.html). Lorsque vous y êtes invité(e) par Composer, vous pouvez accepter d’enregistrer vos informations de connexion. Si vous obtenez l’erreur `Invalid Credentials` alors que vous avez enregistré vos clés, mettez-les à jour dans `~/.composer/auth.json` ou supprimez ce fichier et exécutez à nouveau la commande. 1. Configurez le module en exécutant les commandes suivantes : ```bash php bin/magento setup:upgrade php bin/magento cache:flush php bin/magento cache:clean ``` 1. Si vous exécutez Adobe Commerce en mode production, vous devez également compiler et déployer les fichiers statiques du module. ```bash php bin/magento setup:di:compile php bin/magento setup:static-content:deploy ``` #### À partir du paquet brut 1. Téléchargez la [dernière version](https://github.com/stripe/stripe-magento2-releases/raw/master/stripe-magento2-latest.tgz) du module sur Stripe. 1. Extrayez le module dans votre répertoire Adobe Commerce. ```bash tar -xvf stripe-magento2-latest.tgz ``` 1. Installez la bibliothèque PHP Stripe. ```bash composer require stripe/stripe-php:~17.6 ``` 1. Configurez le module. ```bash php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento cache:flush ``` 1. Si vous exécutez Adobe Commerce en mode production, vous devez également compiler et déployer les fichiers statiques du module. ```bash php bin/magento setup:di:compile php bin/magento setup:static-content:deploy ``` ## Mettre le module à niveau Avant de procéder à la mise à niveau : - Sauvegardez vos fichiers et votre base de données. - Commencez par votre environnement de test. - Gardez une copie de toutes les personnalisations que vous avez apportées au code d’origine du module. - Consultez le [CHANGELOG](https://github.com/stripe/stripe-magento2-releases/blob/master/CHANGELOG.md). Les versions de correctifs (x.x.Y) sont rétrocompatibles et ne nécessitent aucun développement supplémentaire de votre part après la mise à niveau. Les versions mineures et majeures peuvent ajouter de nouvelles fonctionnalités ou modifier le code d’une manière incompatible avec les versions précédentes. Si vous avez personnalisé le code du module, vous devrez migrer vos personnalisations après la mise à niveau et résoudre les éventuels conflits. #### À partir de la place de marché Exécutez les commandes suivantes : ```bash composer remove stripe/stripe-payments composer require stripe/stripe-payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:clean ``` #### À partir du paquet brut Exécutez les commandes suivantes : ```bash php bin/magento module:disable --clear-static-content StripeIntegration_Payments rm -rf app/code/StripeIntegration/Payments tar -xvf stripe-magento2-latest.tgz php bin/magento module:enable StripeIntegration_Payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:flush php bin/magento cache:cleanStripeIntegration_Payments ``` ## Désinstaller le module Avant de le désinstaller : - Sauvegardez vos fichiers et votre base de données. - Conservez une copie de toutes les personnalisations que vous avez apportées au code d’origine du module au cas où vous auriez besoin de le réinstaller ultérieurement. #### À partir de la place de marché Exécutez les commandes suivantes : ```bash composer remove stripe/stripe-payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:clean ``` #### À partir du paquet brut Exécutez les commandes suivantes : ```bash php bin/magento module:disable --clear-static-content StripeIntegration_Payments composer remove stripe/stripe-php rm -rf app/code/StripeIntegration/Payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:flush php bin/magento cache:clean ``` ## Politique en matière de cycle de vie La dernière version du module prend en charge les versions suivantes d’Adobe Commerce : | Publication | Prise en charge | | ---------------------------- | ------------------------------------------------------------------------------------------------------ | | Adobe Commerce 2.0 à 2.3.6 | Cette version ayant été abandonnée, la dernière version compatible est `stripe/stripe-payments:2.9.5`. | | Adobe Commerce 2.3.7 à 2.4.x | Actuellement pris en charge. Consultez notre politique en matière de cycle de vie ci-dessous. | Pour `stripe/stripe-payments:4.5.x` et versions ultérieures, nous fournissons des correctifs et des mises à jour de sécurité. Stripe recommande de mettre à niveau vers la dernière version du module publiée. Toutes les versions sont disponibles sur Adobe Marketplace et dans le dépôt GitHub [stripe-magento2-releases](https://github.com/stripe/stripe-magento2-releases). ## Historique des versions Découvrez les modifications apportées à la rétrocompatibilité des versions de l’application Adobe Commerce (Magento 2). ### Version 4.1 La version 4.1.0 apporte des modifications visant à gérer les cas où des commandes sont passées et facturées sans que le paiement soit encaissé. En voici quelques exemples : - Achats d’abonnements d’essai. - Subscriptions avec dates de début futures. - Passages d’abonnements existants à des offres supérieures ou inférieures. Auparavant, le module remboursait et clôturait automatiquement ces commandes avec un avoir hors ligne. Désormais, pour améliorer le processus de déclaration fiscale : - Les remboursements automatiques sont obsolètes. - Dans ces cas, les articles de la commande ont un tarif personnalisé de 0. - Ces articles sont exclus du calcul des frais de port. Il en résulte des commandes dont les montants du sous-total, des frais de port et des taxes sont nuls. Lorsque des produits ordinaires sont achetés avec des abonnements, les montants du sous-total, des frais de port et des taxes ne reflètent que les postes de commande ordinaires. Ces modifications garantissent que le total général de la commande correspond au montant du paiement encaissé à la date de la commande. En outre, la version 4.1 modifie la manière dont les captures partielles et les remboursements sont traités : - Auparavant, les captures partielles ou les remboursements depuis le Dashboard Stripe créaient automatiquement des factures ou des avoirs dans Magento. - Ces documents n’incluaient pas les postes de commande, utilisant à la place des totaux manuels, des frais de réajustement ou des remboursements. - Cette approche posait des problèmes en matière de déclaration fiscale. Dans la version 4.1 : - Seuls les captures et les remboursements complets donnent lieu à des factures ou à des avoirs automatiques. - Pour les captures partielles ou les remboursements, les marchands doivent utiliser le panneau administrateur Magento. - Cela permet de garantir une ventilation correcte des taxes sur les documents et un reporting précis à l’API Stripe. ## See also - [Configurer l’application Stripe pour Adobe Commerce](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/configuration.md) - [Utiliser le panneau d’administration Adobe Commerce](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/admin.md) - [Résolution des problèmes](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/troubleshooting.md)