Réponse en moins d’1 h, 8 h-22 h, 7j/7

Réponse en moins d’1 h, 8 h-22 h, 7j/7

PrestaShop Checkout : les erreurs fréquentes et comment les réparer

Sommaire

Vous ouvrez la configuration de PrestaShop Checkout et vous lisez : « Error retrieving context, please try to reset or reinstall the module ». Ailleurs, le module refuse des cartes, ou le paiement tombe en erreur 500 au lendemain d’une mise à jour. Pendant ce temps, PayPal et la carte bancaire manquent peut-être à vos clients.

Chaque message a son endroit et ses causes connues. Retrouvez le vôtre en deux minutes, puis voyez ce que vous pouvez vérifier seul, et où vous arrêter.

En bref

Retrouvez votre message dans le tableau de tri : configuration de PrestaShop Checkout, compte PrestaShop Accounts, paiement du client ou mise à jour récente.

Réinstaller ne suffit pas dans les cas rapportés de « Error retrieving context » : le blocage se trouvait côté serveur ou en base.

Un test sur ordinateur (F12, onglet Réseau) dit de quel côté chercher.

Le paiement ne passe plus : décrivez la panne ou appelez le 09 72 03 59 17, réponse en moins d’une heure, 7j/7, de 8 h à 22 h.

Quelle erreur de PrestaShop Checkout, à quel endroit

Cherchez le texte exact, à l’écran ou dans les journaux ; la dernière colonne mène à la bonne section.

MessageOù, et cause probableSection
« Error retrieving context, please try to reset or reinstall the module »Configuration ; l’appel à PrestaShop Accounts échoueError retrieving context
« Unable to retrieve data… unexpected response »Première configuration ; contrôleur jamais enregistréConfiguration
« The configuration is not set »Fin de la configuration ; compte ou réglages incompletsConfiguration
« accounts-api/connect-error », « Store cannot be requested », erreur 504Accounts ; réseau, IP bloquée, URL changéeVérification
Webhooks en 400 ou 500, « Undefined array key Shop-Id »Après passage en 8.5.0.3 ou 8.5.0.4Mise à jour
Erreur 500 au paiement, « Class GuzzleHttp\Client not found »Après passage en 8.5.3.0 ou en 5.5.1Mise à jour
Carte refusée, erreur 500, « domain binding files »Tunnel ; 3D Secure, jeton PayPal, Apple PayPaiement
Payé sans commande, aucun moyen de paiementTunnel ; notification, compte non reliéPaiement

Rien ne correspond ? Notez le message mot pour mot, avec les versions du module et de PrestaShop.

« Error retrieving context, please try to reset or reinstall the module »

Rapporté sur le GitHub de l’éditeur (discussion #1395) depuis le 17/10/2025, de PrestaShop 8.2.0 à 9.2.0.

Ce que le module essaie de faire

Le texte du message ne figure ni dans le code de PrestaShop Checkout ni dans celui de PrestaShop Accounts (ps_accounts), le module qui relie la boutique à votre compte PrestaShop. Il vient de l’interface de configuration, chargée depuis assets.prestashop3.com, qui demande d’abord son « contexte » à votre boutique par cet appel à ps_accounts :

index.php?controller=AdminAjaxV2PsAccounts&ajax=1&action=getContext&source=ps_accounts&refresh=true

Dans les cas rapportés, le message apparaît quand cet appel ne reçoit pas la réponse attendue.

Les trois causes rapportées

Aucune ne se trouve dans les fichiers du module.

  • Un pare-feu répond à la place de la boutique. Un marchand recevait la page HTML du pare-feu de son hébergeur au lieu des données, et a fait autoriser ces appels (18/01/2026). Un mainteneur cite aussi un cas avec Cloudflare.
  • Le navigateur bloque l’appel. L’interface vient d’un autre domaine, donc le navigateur envoie d’abord une requête de contrôle (OPTIONS), à laquelle ps_accounts répond avec des en-têtes d’autorisation. Qu’un proxy ou une redirection les retire, et le navigateur refuse la suite (erreur CORS).
  • Un contrôleur manque en base après une mise à jour ratée. Sur PrestaShop 9, un utilisateur a trouvé la ligne AdminAjaxV2PsAccounts absente de la table des onglets (tab), sans rien dans les journaux PHP (06/10/2026). Un mainteneur évoquait déjà un contrôleur mal installé, probablement par une mise à jour ratée (17/11/2025).

Pourquoi réinitialiser ne suffit pas

Réinstaller remplace les fichiers du module ; le pare-feu et le navigateur ne bougent pas. Dans le fil, des réinstallations répétées sont restées sans effet. Celui qui a trouvé le contrôleur manquant évite même de réinitialiser PrestaShop Accounts : selon lui, une réinitialisation délie la boutique du compte PrestaShop. Témoignage unique, non confirmé par l’éditeur ; sauvegardez quand même et vérifiez l’accès à votre compte avant toute réinitialisation.

Le support de l’éditeur corrige des défauts (webhooks en 5.0.6, Guzzle en 5.5.2). Pour ce message, la discussion a été fermée pour inactivité le 01/04/2026, alors que le problème persistait selon le rapporteur.

Le test à faire dans votre navigateur

Sur ordinateur, dans Chrome ou Firefox :

  1. Ouvrez la configuration du module PrestaShop Checkout.
  2. Appuyez sur F12, onglet Réseau (Network).
  3. Rechargez, puis filtrez sur getContext.
  4. Ouvrez la ligne, onglet Réponse (Response).
  • Du JSON (texte entre accolades) : la boutique répond ; voyez la configuration, la vérification du compte ou une mise à jour récente.
  • Une page HTML : quelque chose répond à la place de la boutique. Les cas rapportés désignent :
    • un pare-feu applicatif, sur le serveur ;
    • le filtrage de l’hébergeur ;
    • Cloudflare, s’il protège votre domaine.
  • Une requête OPTIONS en échec (ERR_INVALID_REDIRECT, puis erreur CORS) : dans un cas rapporté, le contrôleur manquait après une montée du cœur de 9.0.2 à 9.2.0. La réparation touche la base.

N’ajoutez pas vous-même d’en-têtes CORS. Le rapporteur initial l’a fait dans son .htaccess, et « The configuration is not set » a suivi.

Arbre de décision du test getContext de PrestaShop Checkout : réponse JSON, page HTML ou redirection CORS, et où chercher dans chaque cas
Lire la réponse de getContext avant de réinitialiser ou réinstaller PrestaShop Checkout.

Partager cette infographie : copiez le code ci-dessous pour l’afficher sur votre site.

<a href="https://cyberial.fr/prestashop-checkout-erreurs/"><img src="https://cyberial.fr/wp-content/uploads/checkout-getcontext-arbre-decision.png.webp" alt="Arbre de décision du test getContext de PrestaShop Checkout : réponse JSON, page HTML ou redirection CORS, et où chercher dans chaque cas" /></a><p>Infographic by <a href="https://cyberial.fr">cyberial.fr</a></p>
Du HTML ou une redirection ?

Le blocage est côté serveur ou en base ; réinstaller PrestaShop Checkout ne l’a pas réglé dans les cas rapportés. Nous cherchons la cause et réparons, dès 150 € HT, prix fixe validé avant toute intervention.

Décrire la panne

« Unable to retrieve data » et « The configuration is not set »

Deux autres messages s’affichent pendant la configuration du module PrestaShop Checkout.

  • « An error occurred, unable to retrieve data from PrestaShop Checkout module due to an unexpected response » : rapporté à la première configuration (module 8.5.0.3, PrestaShop 8.2.2, #1385, 29/09/2025). Le mainteneur soupçonnait un contrôleur absent de la base. L’utilisateur a trouvé la cause : une installation interrompue par des doublons dans les tables des pays, qui n’avait jamais enregistré le contrôleur (04/10/2025).
  • « The configuration is not set. You have an issue with your configuration, try onboarding again or contact our support » : l’éditeur soupçonnait le compte PayPal. Le marchand encaissait pourtant sans souci avec le module PayPal officiel. Il a fini par écrire cinq réglages à la main dans la table ps_configuration (10/12/2025), un geste à ne pas reproduire sans sauvegarde.

Premiers gestes : refaire la connexion du compte (onboarding), puis passer par le support. Le module s’installe mais ne s’affiche pas au paiement ? Sans compte PayPal relié et prêt, ni compte PrestaShop associé, il ne propose rien. Voyez notre article quand aucun moyen de paiement ne s’affiche.

La boutique ne se vérifie pas dans PrestaShop Accounts

PrestaShop Checkout passe par PrestaShop Accounts, et la boutique doit y être vérifiée : les serveurs de PrestaShop l’appellent en retour pour s’assurer qu’elle existe. Quand ce contrôle échoue, ps_accounts affiche « accounts-api/connect-error », « Store cannot be requested » ou une erreur 504. Trois situations reviennent :

  • Changement d’URL : la boutique et le compte PrestaShop peuvent se retrouver dans un état incohérent (ps_accounts #568, 26/09/2025).
  • Copie de boutique : fichiers et base copiés pour une préproduction ou un déménagement. Le support demande alors le Request ID relevé dans les journaux var/logs/ps-accounts.
  • IP bloquée : la connexion vers PrestaShop était coupée net depuis l’IP d’un hébergeur. Selon un mainteneur, un blocage de réputation chez Cloudflare, côté PrestaShop ; le support a fourni des IP à autoriser (#647, 04/07/2026).

Un cas reste ouvert : sur un hébergement LiteSpeed sans Cloudflare, connexions sortantes correctes, la vérification échoue toujours (#661, ouverte au 09/11/2026). Les journaux de ps_accounts restent alors la seule piste.

Après une mise à jour du module PrestaShop Checkout

Le module porte deux numéros. La version publiée (5.5.6, par exemple), et celle qu’affiche votre back-office, qui commence par 7, 8 ou 9 selon votre PrestaShop : 9.5.5.6 sur PrestaShop 9.

VersionSymptômeCe qui est connu
8.5.0.3 et 8.5.0.4Webhooks rejetés en 400 ou 500, « Undefined array key Shop-Id »Corrigé dans la 5.0.6 du 03/12/2025, selon le mainteneur (#1383)
8.5.3.0Erreur 500 au paiementRetour à 8.5.2.0 pour un marchand ; le jour même (15/04/2026), l’éditeur confirme une cause dans les traductions et retire temporairement la version de la Marketplace (#1515)
5.5.1« Class GuzzleHttp\Client not found »Défaut reconnu, corrigé en 5.5.2 le jour même, 26/06/2026 (#1556)
PHP 7.1Module non installableJugé trop lourd (22/09/2025), puis la v5 « semble bien fonctionner » (18/11/2025). Au 09/11/2026 : 7.1 accepté pour 1.7, 7.2.5 minimum pour PrestaShop 8

PHP 7.1 ne reçoit plus de correctifs de sécurité : faites-le monter de toute façon. Après une montée du cœur, vérifiez aussi que le module est toujours actif. L’Update Assistant désactive sans prévenir un module dont la migration échoue.

Notre journal des mises à jour de modules que nous avons posées (production et préproduction, du 07/09 au 02/10/2026) le montre aussi. 39 % des mises à jour de modules étaient à moitié faites : le fichier du module était neuf, mais ses migrations n’avaient jamais été jouées en base, et il a fallu les terminer. PrestaShop Checkout faisait partie des modules concernés. Parmi les 3 modules qu’il a fallu remettre à la version précédente figurent ps_accounts et ps_checkout.

Pour ne plus poser ces mises à jour vous-même : maintenance PrestaShop à 69 € HT/mois, sans engagement, mises à jour des modules incluses.

Erreurs au paiement : 3D Secure, jeton PayPal, Apple Pay

Ici, le client voit l’erreur avant vous. Ce que disent les discussions GitHub au 09/11/2026 :

  • Cartes refusées en 3D Secure : le résultat de l’authentification n’est jamais lu, selon l’analyse des rapporteurs. Cas en 9.5.5.4 sur PrestaShop 9.1.5 avec le réglage SCA_ALWAYS (#1579, 05/10/2026), puis de 7.5.5.4 à 7.5.5.6 sur PrestaShop 1.7 (#1592, 27/10/2026, encore présent en 7.5.5.6 le 03/11). Aucune réponse de l’éditeur ; discussions ouvertes.
  • Jeton PayPal expiré : le premier paiement qui suit tombe en erreur 500 (9.5.5.3, #1572, ouverte et sans réponse).
  • Apple Pay, « We couldn’t find your domain binding files » : selon l’éditeur, le fichier /.well-known/apple-developer-merchantid-domain-association doit rester accessible, sans blocage par le serveur, un proxy ou le CDN (#1557).
  • Client débité sans commande, ou commande en double : voyez que faire quand le paiement arrive sans commande.
  • Plus aucun moyen proposé au tunnel : vérifiez le compte relié au module.

PrestaShop Payments, annoncé pour début 2027

Au PS Summit de Lyon, PrestaShop a dévoilé PrestaShop Payments, « une solution de paiement intégrée à la boutique et à son back-office, attendue début 2027 » (mind Fintech, 05/11/2026). Au 09/11/2026, rien n’a été annoncé sur le sort de PrestaShop Checkout. D’ici là :

  • réparez Checkout maintenant : les ventes qui passent par lui en dépendent, Black Friday (27/11/2026) et Noël compris ;
  • ne le désinstallez pas par anticipation ;
  • gardez l’accès au compte PrestaShop et au compte PayPal relié, avec une sauvegarde avant toute mise à jour de Checkout ou d’Accounts ;
  • revoyez la question à l’annonce officielle.

Le reste de ce que le PS Summit a montré : préparer PrestaShop 10.

Où vous arrêter seul

Le test du navigateur et la lecture des journaux ne risquent rien. Le reste touche la base ou la liaison des comptes. À ne pas faire seul :

  • réinitialiser ou réinstaller PrestaShop Accounts sans sauvegarde ni accès vérifié à votre compte PrestaShop ;
  • écrire dans ps_configuration ou ajouter des en-têtes dans le fichier .htaccess, comme l’a fait un utilisateur sur GitHub ;
  • recréer à la main un contrôleur dans la table des onglets ;
  • couper Cloudflare ou le pare-feu en entier « pour voir » ;
  • mettre à jour Checkout ou Accounts la veille d’un pic de ventes, sans sauvegarde.
Le paiement doit repartir

PrestaShop Checkout bloque toujours ? Dépannage dès 150 € HT, prix fixe validé avant toute intervention, recherche de la cause comprise. Ces 150 € sont déduits si vous passez ensuite à la maintenance. Réponse en moins d’une heure, 7j/7, de 8 h à 22 h.

Décrire la panne ou 09 72 03 59 17

Questions fréquentes

Faut-il réinstaller PrestaShop Checkout quand il affiche « Error retrieving context » ?

Dans les cas rapportés, la réinstallation n’a rien changé : la cause se trouvait côté serveur, dans le navigateur ou en base. Faites d’abord le test de l’onglet Réseau (F12).

PrestaShop Checkout a-t-il besoin de PrestaShop Accounts ?

Oui. Le module ps_accounts relie la boutique à votre compte PrestaShop, et l’interface de configuration de Checkout l’interroge avant de s’afficher. Sans compte PrestaShop associé, Checkout ne propose aucun moyen de paiement.

Cloudflare peut-il bloquer PrestaShop Checkout ?

Des cas rapportés l’impliquent, comme le pare-feu d’un hébergeur ou une IP bloquée. Le signe : l’appel getContext reçoit une page HTML au lieu de données. Faites autoriser ces appels plutôt que de couper la protection.

Pourquoi PrestaShop Checkout refuse-t-il des cartes en 3D Secure ?

Selon des marchands qui ont analysé le code, le résultat de l’authentification n’est pas lu (9.5.5.4 avec SCA_ALWAYS, 7.5.5.4 à 7.5.5.6 sur PrestaShop 1.7). Au 09/11/2026, les discussions restent ouvertes, sans réponse de l’éditeur.

Combien coûte la réparation de PrestaShop Checkout ?

Chez CYBERIAL, dès 150 € HT, prix fixe validé avant toute intervention, recherche de la cause comprise. Réponse en moins d’une heure, 7j/7, de 8 h à 22 h.

PrestaShop Payments remplace-t-il PrestaShop Checkout ?

Rien n’a été annoncé à ce sujet au 09/11/2026. La solution est « attendue début 2027 » (mind Fintech, 05/11/2026). D’ici là, gardez Checkout en état de marche.

Votre module PrestaShop Checkout bloque ?

Collez le message de PrestaShop Checkout et sa version. Dès 150 € HT, prix fixe validé avant toute intervention. Réponse en moins d’une heure, 7j/7, de 8 h à 22 h, ou appelez le 09 72 03 59 17.

Un technicien PrestaShop vous rappelle sous 1 h, 7j/7, de 8 h à 22 h.

Vos réponses sont enregistrées au fur et à mesure pour pouvoir vous rappeler, même si vous n’allez pas au bout. Politique de confidentialité.

Image de Sébastien
Sébastien
Co-fondateur de l'agence PrestaShop CYBERIAL. J'évolue depuis 15 ans dans le monde des sites internet et boutique en ligne open source.