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 saisir un nom d’utilisateur et un mot de passe. Assurez-vous de 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 mode de paiement n’est affiché au moment du paiement

Plusieurs raisons peuvent expliquer que le mode de paiement ne s’affiche 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 mode 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 ne s’affiche toujours pas, procédez comme suit :

• Assurez-vous d’activer Apple Pay et Google Pay dans vos paramètres des modes 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 bureau ou mobile Chrome avec un compte Google connecté.
• Vérifiez que vous avez au moins une carte dans votre portefeuille numérique.
  • Dans iOS, vous pouvez ajouter une carte dans Paramètres > Portefeuille numérique > Apple Pay.
  • Dans Chrome, vous pouvez ajouter une carte dans Paramètres > Remplissage automatique > Modes de paiement > Ajouter une carte de carte de crédit.
• 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 le 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 numérique dans la section de configuration du module.
• Vérifiez que vous avez configuré un pays par défaut (Magasins > Configuration > Général > Options du pays > Pays par défaut).
• Assurez-vous de ne pas utiliser une ancienne clé API Stripe. Apple Pay exige une clé API moderne, qui commence par pk_live_ ou pk_test_. Vous pouvez échanger 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 de 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 l’institution financière du client est toujours en cours. Pour tous les modes de paiement exigeant une redirection, Stripe informe votre site Web à l’aide de liens de rappel HTTP. Si vos commandes ne passent pas de Pending Payment à Processing, il est possible qu’il manque des liens de rappel HTTP ou que ces derniers soient incorrects.

Accédez aux paramètres de liens de rappel HTTP pour vérifier si un point de terminaison de lien de rappel HTTP contenant l’URL de votre magasin 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 le point de terminaison de lien de rappel HTTP existe, vérifiez le Taux d’erreur pour identifier les liens de rappel HTTP qui échouent. Vous pouvez cliquer sur le point de terminaison de lien de rappel HTTP pour afficher les messages d’erreur. Pour obtenir de l’aide concernant des problèmes de lien de rappel HTTP 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 lien de rappel HTTP 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 à l’aide de 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 consulter le journal des erreurs :

tail -f var/log/*

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