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).
Mise en garde
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.
Installer le module
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.
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.
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.
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. . |
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.
et les versions ultérieures, nous fournissons de nouvelles fonctionnalités, des corrections de bugs et des correctifs de sécurité. Les anciennes versions sont obsolètes. Stripe vous recommande de procéder à la mise à niveau dès que possible. Toutes les versions sont disponibles sur Adobe Marketplace et dans le référentiel GitHub 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.