Aller au contenu principal
Technique

Erreur de validation du panier ou du checkout Shopify qui ne s'affiche pas ? 9 causes et solutions

Jahangir Alam21 novembre 2026Faits vérifiés le 21 novembre 202610 min read

Quand une règle de validation Shopify n'affiche aucun message, c'est en général l'une de ces quatre situations : la validation est désactivée, la Function a échoué et le checkout a continué sans elle, la règle ne s'exécute qu'au checkout, ou le thème a reçu l'erreur sans l'afficher. Testez la page produit, le panier et le checkout l'un après l'autre pour trouver laquelle.

Ce guide traite de la validation du checkout construite avec les Shopify Functions, la méthode qu'utilisent les applications de limites de commande, de minimum de commande et d'horaires de boutique (dont OrderRules) pour bloquer des commandes. Si vous débutez, commencez par comment fonctionne la validation du checkout Shopify.

Où Shopify affiche les erreurs de validation

L'endroit où le message apparaît dépend de l'endroit où se trouve le client.

Où se trouve le clientCe qui se passeQui affiche le message
CheckoutL'erreur bloque l'étape. Une erreur sur tout le panier s'affiche sur la page de checkout en cours ; une erreur sur un champ s'affiche à côté de ce champ.Shopify
Page produit ou panier (ajout ou modification d'articles)La requête de panier échoue et renvoie l'erreur.Votre thème, s'il lit l'erreur
Boutique headlessLes erreurs apparaissent dans le panier de la Storefront API.Votre front-end
Paiement express (Shop Pay, Apple Pay, Google Pay, PayPal, Buy it now)La validation s'exécute comme au checkout.Shopify

C'est dans la ligne du milieu que les messages disparaissent. Shopify renvoie l'erreur ; que l'acheteur la voie dépend du JavaScript du thème.

Les 9 causes, par symptôme

SymptômeCause probableSolution
Aucune règle ne se déclenche, nulle part1. Validation non activeL'activer dans Règles de paiement
Fonctionne sur les petits paniers, pas sur les gros2. La Function a planté ou manqué d'instructionsLe signaler au développeur de l'application avec l'heure et la taille du panier
Rien sur la page panier, blocage au checkout3. La règle ne s'exécute qu'au checkoutNormal ; prévenir les clients en amont
« Sold out » ou une erreur générique à la place de votre message4. Le thème masque ou remplace l'erreur du panierTester dans Dawn ; corriger la gestion d'erreur du thème
Fonctionne depuis le panier, pas depuis Buy it now5. Le paiement express a ignoré les attributs du panierStocker le choix par ligne d'article, ou l'exiger au checkout
La première commande après la limite est passée6. Les compteurs n'étaient pas encore à jourPrévoir une marge ; les compteurs se mettent à jour après chaque commande
Un autre message s'affiche7. Une autre règle ou application a échoué en premierVérifier l'ordre de contrôle des règles
Le message affiche ' ou un autre code8. Message échappé deux foisLe signaler au développeur de l'application
Commande arrivée sans aucun contrôle9. Commande issue d'un canal qui ignore la validationPOS, renouvellements, modifications et commandes API ne sont pas validés

1. La validation n'est pas active

Installer une application avec une Function de validation ne l'active pas toujours. Allez dans Paramètres → Paiement → Règles de paiement et vérifiez que la règle de l'application figure dans la liste et qu'elle est activée. Si elle est désactivée, aucune règle de cette application ne s'exécute, sur aucune surface. Dans OrderRules, la liste de contrôle « règles non appliquées » commence par ce point.

2. La Function a planté, dépassé le délai ou manqué d'instructions

Une erreur de validation bloque toujours le checkout. Une exécution échouée, non. Si la Function lève une erreur ou dépasse les limites de Shopify, le checkout continue par défaut sans cette validation, et le client ne voit rien. L'application peut changer ce comportement avec un paramètre blockOnFailure à la création de la validation.

La limite qui pose problème en pratique est de 11 millions d'instructions par exécution pour les paniers jusqu'à 200 lignes. Le coût augmente avec chaque ligne du panier : une règle qui fonctionne sur un panier de 3 articles peut échouer sur un panier de 40. Si votre limite tient sur les petits paniers et échoue sur les gros, c'est la cause probable. Les marchands ne peuvent pas voir les journaux d'exécution des Functions ; le développeur de l'application, lui, le peut dans son Partner Dashboard. Envoyez-lui l'heure de la commande et le nombre de lignes du panier. La liste complète des limites se trouve dans les limites de ressources des Functions.

3. La règle ne s'exécute qu'au checkout

Shopify indique à la Function où se trouve l'acheteur : en train de modifier le panier, ou au checkout. Beaucoup d'applications ne vérifient certaines règles qu'au checkout, pour que l'ajout au panier n'échoue jamais sur, par exemple, une date de livraison que le client n'a pas encore choisie. Ces règles n'affichent rien sur la page panier et bloquent au checkout.

Dans OrderRules, la boutique fermée, les plafonds de commande, les plafonds par produit et par variante, les quantités minimales et par pas, et les limites par tag et par collection sont vérifiés à l'ajout des articles. Les limites par client et les contrôles de livraison et de retrait ne s'exécutent qu'au checkout, car le client n'est peut-être pas encore connecté ou n'a pas encore choisi de date. Si vous voulez que les clients le sachent avant le checkout, affichez la règle sur la page avec un message sur la boutique.

4. Le thème masque ou remplace l'erreur

Quand une règle rejette un ajout au panier ou un changement de quantité, le thème reçoit une requête échouée contenant le message. La suite dépend du code du thème :

  • Dawn (16.x) affiche le message sous le bouton d'ajout au panier. Il peut aussi passer le bouton sur « Sold out », si bien que le produit semble indisponible alors qu'il ne l'est pas.
  • Les boutons d'ajout rapide sur les pages de collection n'affichent souvent que « Sold out » ou une courte erreur générique.
  • Les tiroirs de panier personnalisés peuvent ignorer totalement l'erreur et simplement ne pas ajouter l'article.

Pour confirmer que c'est le thème : ouvrez les outils de développement du navigateur, allez dans l'onglet Network et ajoutez de nouveau le produit. Une requête /cart/add.js ou /cart/change.js échouée dont la réponse contient votre message prouve que la règle a fonctionné et que le thème ne l'a pas affiché. Essayez la même action dans un aperçu de Dawn non modifié. Si Dawn affiche le message, demandez à votre développeur de thème d'afficher l'erreur de la requête de panier échouée.

5. Le paiement express a ignoré un attribut de panier

La référence de validation de Shopify précise que le paiement accéléré depuis une page produit ignore les attributs du panier. Si une règle dépend d'un choix fait par le client sur la page panier et enregistré comme attribut de panier, comme une date de livraison ou un mot cadeau, un bouton Buy it now ou Shop Pay sur la page produit ne l'envoie jamais. Selon la conception de l'application, la règle ne voit pas le choix ou bloque la commande avec un message « choisissez une date ».

La solution se trouve dans l'application : enregistrer le choix sur chaque ligne d'article, que les boutons de la page produit transmettent, ou exiger le choix au checkout. OrderRules enregistre sur la ligne d'article la date de livraison choisie sur la page produit, donc les commandes Buy it now la conservent. Testez ce bouton sur votre boutique avant une période chargée.

6. Les compteurs n'étaient pas à jour

Une Function ne peut pas appeler le serveur de l'application pendant le checkout. Elle lit des compteurs que l'application a enregistrés plus tôt, et l'application les met à jour après chaque commande. Le premier checkout après l'atteinte d'une limite peut donc passer, et deux checkouts simultanés pour la dernière unité peuvent passer tous les deux. Il ne manque aucun message ici : la règle a vu l'ancien compteur. Prévoyez une petite marge sur un plafond que vous ne pouvez pas dépasser, et voyez limites par checkout vs par client pour savoir comment les limites par client sont comptées.

7. Une autre règle ou application a répondu en premier

Shopify exécute chaque Function de validation active, jusqu'à 25 par boutique, et il suffit qu'une seule renvoie une erreur pour bloquer le checkout. Au sein d'une même application, les règles sont souvent vérifiées dans un ordre fixe. Dans OrderRules, une boutique fermée n'affiche que le message de fermeture, même si le panier est aussi sous le minimum. Le client corrige un point, puis voit le suivant. Voir quel message le client voit pour l'ordre complet.

Si le message ne vient pas du tout de votre application, c'est la validation d'une autre application qui bloque. Consultez la liste sous Paramètres → Paiement → Règles de paiement.

8. Le message affiche du code

Une apostrophe qui s'affiche ', ou une esperluette &, signifie que le message a été échappé en HTML deux fois entre l'application et la page. C'est un bug d'affichage de l'application ou du thème, pas de vos réglages. Signalez au développeur de l'application la page et le message exacts.

9. La commande n'est jamais passée par la validation du checkout

Certaines commandes n'exécutent pas du tout la validation du panier et du checkout, donc il n'y a aucun message à afficher :

  • Les ventes Shopify POS
  • Les commandes de renouvellement d'abonnement (le premier checkout d'abonnement, lui, est validé)
  • Les modifications de commande après l'achat
  • Les commandes créées par d'autres applications ou intégrations via la Create Order API
  • Les achats en précommande et « essayer avant d'acheter »

Les brouillons de commande payés via le checkout de la facture sont validés. Dans OrderRules, les commandes issues des canaux ci-dessus ne sont pas bloquées, mais elles comptent quand même dans vos limites. Le tableau complet se trouve sur compatibilité et limitations.

Testez chaque surface en 10 minutes

Utilisez une boutique de développement ou un produit de test, et définissez une règle que vous pouvez enfreindre exprès, comme un maximum de 2.

  1. Page produit : ajoutez 3. Notez ce que font le bouton et le message.
  2. Ajout rapide en collection : ajoutez le produit depuis une page de collection.
  3. Page panier et tiroir : passez la quantité à 3.
  4. Checkout : passez au checkout avec 3 dans le panier. Vous devez voir le message et ne pas pouvoir payer.
  5. Buy it now et Shop Pay : achetez 3 depuis la page produit avec chaque bouton.
  6. Connecté et déconnecté : répétez le checkout dans les deux cas si vous utilisez des limites par client.
  7. Un gros panier : ajoutez 40 lignes ou plus si votre boutique vend beaucoup de petits articles.

Gardez l'onglet Network ouvert pendant vos tests. Toute étape qui bloque sans message à l'écran est un problème de thème (cause 4). Toute étape qui passe alors qu'elle ne devrait pas relève des causes 1, 2, 5 ou 9.

Pour aller plus loin

Sources

Questions fréquentes

Les causes les plus courantes : la validation n'est pas activée dans Paramètres → Paiement → Règles de paiement ; la Function a planté ou dépassé son budget d'instructions, donc le checkout a continué sans elle ; la règle ne s'exécute qu'au checkout, donc rien ne s'affiche sur la page panier ; ou le thème intercepte l'erreur du panier et affiche un message générique ou « Sold out ». Testez séparément la page produit, le panier et le checkout pour savoir lequel est en cause.

Au checkout, une erreur visant tout le panier s'affiche sur l'étape en cours, et une erreur visant un champ s'affiche à côté de ce champ. Sur la boutique en ligne, une erreur renvoyée lors de l'ajout ou de la modification d'articles revient au thème sous forme de requête de panier échouée. C'est le thème qui décide s'il l'affiche et où. Les boutiques headless lisent les erreurs dans le panier de la Storefront API.

Si une règle de validation rejette une demande d'ajout au panier, certains thèmes traitent tout ajout échoué comme une rupture de stock. Dawn, par exemple, affiche le message sous le bouton et peut aussi passer le bouton sur « Sold out ». Le produit n'est pas en rupture : la règle a bloqué cette quantité ou ce panier. Vérifiez quelle règle s'applique au produit.

Pas par défaut. Si l'exécution d'une Function échoue, par exemple par délai dépassé ou manque d'instructions sur un gros panier, Shopify laisse le checkout continuer sans cette validation, sauf si l'application l'a créée avec blockOnFailure activé. Le client ne voit aucun message et la commande passe.

La validation s'exécute sur Shop Pay, Apple Pay, Google Pay, PayPal express et Buy it now. Une réserve : le paiement express depuis une page produit ignore les attributs du panier. Une règle qui dépend d'un choix fait par le client sur la page panier, comme une date de livraison stockée en attribut de panier, ne peut donc pas le voir là.

Les ventes POS, les renouvellements d'abonnement, les modifications de commande, les commandes créées via l'API et les achats en précommande ou « essayer avant d'acheter » n'exécutent pas la validation du panier et du checkout, donc ne peuvent pas afficher son message. Les brouillons de commande payés via le checkout de la facture l'exécutent.

Vous comparez des applications ?

Découvrez comment OrderRules se compare à toutes les autres applications Shopify de cette catégorie.

Prêt à reprendre le contrôle de vos commandes ?

Essayer OrderRules gratuitement