Résolution des problèmes liés à Adobe Commerce

Utilisez ce guide pour résoudre les problèmes liés à Stripe Connector for Adobe Commerce.

Problèmes d’installation

Voici l’erreur que vous êtes le plus susceptible de rencontrer lorsque vous installez le module à l’aide de Composer :

Composer package not found: Could not find a matching version of package stripe/stripe-payments

Si vous rencontrez ce problème, suivez les étapes suivantes :

1. Commandez le module depuis la place de marché Adobe.
2. Supprimez les fichiers sous ~/.composer/auth.json, dans le cas où vous auriez saisi les mauvaises clés API Adobe Commerce.
3. Exécutez à nouveau la commande Composer. Vous devrez peut-être entrer un nom d’utilisateur et un mot de passe. Veillez à saisir les clés API Adobe Commerce du compte que vous avez utilisé pour passer la commande. Vous pouvez obtenir vos clés d’authentification auprès d’Adobe Commerce.

Problèmes de mises à niveau et de cache

Si vous mettez à niveau le module mais que, pour une raison quelconque, vous ne voyez pas les nouveaux changements, vous pouvez vider le cache d’Adobe Commerce manuellement en supprimant plusieurs répertoires. Vous trouverez dans la documentation officielle Adobe Commerce la description des répertoires à supprimer pour Adobe Commerce 2.3 et Adobe Commerce 2.4.

Après avoir supprimé ces répertoires, exécutez les commandes suivantes :

php bin/magento setup:upgrade
php bin/magento cache:flush

Si vous êtes en mode production, vous devez compiler et déployer vos ressources statiques :

php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Si vous exécutez Varnish, vous devez également redémarrer Varnish après la suppression des fichiers var/cache/*. Certains navigateurs mettent également en cache les requêtes Adobe Commerce ; si vous rencontrez toujours des problèmes de mise en cache, essayez un autre navigateur.

Aucun moyen de paiement n’est affiché au moment du paiement

Plusieurs raisons peuvent expliquer que le moyen de paiement n’apparaisse pas au moment du paiement :

• Vous n’avez pas installé la bibliothèque PHP de Stripe ou vous utilisez une ancienne version. Vous pouvez installer cette dépendance en suivant l’étape 3 des instructions d’installation
• Vous avez installé un autre module Stripe qui utilise une ancienne version de la bibliothèque PHP de Stripe. Désactivez ou désinstallez tout autre module Stripe actif.
• Vous n’avez pas correctement configuré les clés API Stripe.
• Vous avez restreint la disponibilité du moyen de paiement à des pays ou des devises spécifiques.

Apple Pay ou Google Pay ne s’affiche pas

Si vous avez configuré le bouton de demande de paiement et qu’il n’apparaît toujours pas, procédez comme suit :

• Assurez-vous d’activer Apple Pay et Google Pay dans vos paramètres des moyens de paiement.
• Pour Apple Pay, utilisez Safari sur les iPhone exécutant iOS 10 ou une version ultérieure.
• Pour Google Pay, utilisez la version PC ou mobile Chrome avec un compte Google connecté.
• Assurez-vous d’avoir au moins une carte bancaire dans votre portefeuille.
  • Dans iOS, vous pouvez ajouter une carte bancaire en vous rendant dans Réglages > Portefeuille > Apple Pay.
  • Dans Chrome, vous pouvez ajouter une carte en vous rendant dans Paramètres > Saisie automatique > Moyens de paiement > Ajouter une carte.
• Confirmez que votre appareil iOS prend en charge Apple Pay.
• Confirmez que votre appareil Android prend en charge Google Pay.
• Confirmez que votre domaine est enregistré et vérifié.
• Si le nom du domaine de votre site Web commence par www, vérifiez que la syntaxe du domaine est www.example.com et pas example.com.
• Vous devez servir votre site Web via HTTP en utilisant un certificat TLS 1.2 valide. Vous pouvez vérifier si tel est bien le cas à partir de votre navigateur ou de SSL Labs.
• Assurez-vous que votre page HTTPS ne charge pas d’images, de contenu CSS ou JavaScript de manière non sécurisée. Pour ce faire, cliquez sur le cadenas dans la barre d’adresse de votre navigateur.
• Assurez-vous d’avoir activé le bouton Portefeuille dans la section de configuration du module.
• Vérifiez que vous avez configuré un pays par défaut (Boutiques > Configuration > Général > Options du pays > Pays par défaut).
• Assurez-vous de ne pas utiliser une ancienne clé API Stripe. Apple Pay requiert une clé API moderne, qui commence par pk_live_ ou pk_test_. Vous pouvez révoquer votre clé publique dans la section Développeurs du Dashboard.
• Si vous utilisez un module OneStepCheckout, vous devrez peut-être le configurer de façon à ce qu’il rafraîchisse le formulaire de paiement lorsque les clients non connectés indiquent leur adresse de facturation. Dans la plupart des cas, cela n’est pas nécessaire.

Si Apple Pay apparaît au moment du paiement, mais pas sur les pages produit, cela peut être dû à d’autres raisons :

• Vous avez désactivé les paiements des clients non connectés depuis le panneau d’administration Adobe Commerce.
• Votre site Web affiche vos pages produits sans certificat TLS 1.2 valide.
• Vous avez écrasé le modèle de bouton Ajouter au panier dans votre thème. Essayez d’ajouter du texte à app/code/StripeIntegration/Payments/view/frontend/templates/express/product_button.phtml. Si vos pages de produits restent inchangées, personnalisez votre thème et intégrez les deux modèles ensemble.
• Les erreurs JavaScript se produisent lorsque Stripe.js est en cours d’initialisation. Vérifiez la présence de toute erreur JavaScript associée à Stripe.js dans la console de votre navigateur.

Commande en attente bloquée

Lorsque vous créez une commande, l’état initial est Pending Payment, ce qui signifie que l’autorisation du paiement par la banque du client est toujours en cours. Pour tous les moyens de paiement exigeant une redirection, Stripe informe votre site Web à l’aide de webhooks. Si vos commandes ne passent pas de Pending Payment à Processing, il est possible qu’il manque des webhooks ou que ces derniers soient incorrects.

Accédez aux paramètres de webhooks pour vérifier si un endpoint de webhook contenant l’URL de votre boutique existe. Si ce n’est pas le cas, vous pouvez essayer de le créer manuellement en exécutant la commande suivante depuis votre répertoire racine Magento :

bin/magento stripe:webhooks:configure

Si l’endpoint de webhook existe, vérifiez le Taux d’erreur pour identifier les webhooks qui échouent. Vous pouvez cliquer sur l’endpoint de webhook pour afficher les messages d’erreur. Pour obtenir de l’aide concernant des problèmes de webhook qui ne proviennent pas d’une configuration incorrecte du serveur, contactez le service d’assistance Stripe afin de nous faire part des erreurs survenues.

Une fois le problème de webhook résolu, vous devez renvoyer les événements charge.succeeded qui n’ont pas été envoyés correctement à votre site Web. Le module propose trois commandes pour renvoyer un seul événement, une série d’événements ou les événements d’une période donnée :

bin/magento stripe:webhooks:process-event [-f|--force] <event_id>
bin/magento stripe:webhooks:process-events-range <from_event_id> <to_event_id>
bin/magento stripe:webhooks:process-events-date-range <from_date> [<to_date>]

Vous pouvez obtenir une liste de tous les événements charge.succeeded qui ont échoué dans la section Développeurs de votre Dashboard Stripe et décider lesquels sont à renvoyer grâce à l’une des commandes ci-dessus.

Enregistrement des erreurs et erreurs côté serveur (HTTP 500)

Adobe Commerce enregistre toutes les erreurs et exceptions rencontrées lors de l’exécution de l’application dans le répertoire var/log. Vous pouvez trouver ces erreurs dans les deux fichiers suivants :

var/log/system.log
var/log/exception.log

Si vous disposez d’un accès SSH, vous pouvez filtrer les messages d’erreur à l’aide de la commande suivante :

grep -i Stripe var/log/system.log

Vous pouvez afficher les erreurs en direct dans la console au moment où elles se produisent (ou lorsque vous rafraîchissez une page donnée). Pour surveiller les erreurs, exécutez la commande suivante pour observer le log des erreurs :

tail -f var/log/*

Si vous n’avez pas accès au shell, vous pouvez télécharger ce fichier et rechercher les erreurs Stripe avec un éditeur de texte.