---
title: "Erreur de validation du panier ou du checkout Shopify qui ne s'affiche pas ? 9 causes et solutions"
description: "Votre limite de commande ou règle de checkout est définie, mais le client ne voit jamais le message, ou voit « Sold out » à la place. Voici où Shopify affiche les erreurs de validation, les neuf causes les plus fréquentes et comment tester chaque surface."
contentType: "blog"
locale: "fr"
localized: true
source: "https://orderrules.com/fr/blog/shopify-checkout-validation-error-not-showing"
slug: "shopify-checkout-validation-error-not-showing"
date: "2026-11-21"
tags:
  - "shopify"
  - "checkout validation"
  - "shopify functions"
  - "troubleshooting"
  - "order limits"
  - "cart"
---
**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](/blog/shopify-checkout-validation-functions-block-orders).

## 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 client | Ce qui se passe | Qui affiche le message |
|---|---|---|
| **Checkout** | L'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 headless** | Les 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ôme | Cause probable | Solution |
|---|---|---|
| Aucune règle ne se déclenche, nulle part | 1. Validation non active | L'activer dans Règles de paiement |
| Fonctionne sur les petits paniers, pas sur les gros | 2. La Function a planté ou manqué d'instructions | Le signaler au développeur de l'application avec l'heure et la taille du panier |
| Rien sur la page panier, blocage au checkout | 3. La règle ne s'exécute qu'au checkout | Normal ; prévenir les clients en amont |
| « Sold out » ou une erreur générique à la place de votre message | 4. Le thème masque ou remplace l'erreur du panier | Tester dans Dawn ; corriger la gestion d'erreur du thème |
| Fonctionne depuis le panier, pas depuis Buy it now | 5. Le paiement express a ignoré les attributs du panier | Stocker le choix par ligne d'article, ou l'exiger au checkout |
| La première commande après la limite est passée | 6. Les compteurs n'étaient pas encore à jour | Prévoir une marge ; les compteurs se mettent à jour après chaque commande |
| Un autre message s'affiche | 7. Une autre règle ou application a échoué en premier | Vérifier l'ordre de contrôle des règles |
| Le message affiche `&#39;` ou un autre code | 8. Message échappé deux fois | Le signaler au développeur de l'application |
| Commande arrivée sans aucun contrôle | 9. Commande issue d'un canal qui ignore la validation | POS, 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 »](/docs/troubleshooting/rules-not-applying) 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](/blog/shopify-checkout-validation-functions-block-orders).

### 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](/docs/guides/storefront-messaging).

### 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](/blog/per-checkout-vs-per-customer-limits-shopify) 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](/blog/shopify-order-rules-recipes) 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 `&#39;`, ou une esperluette `&amp;`, 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](/docs/guides/compatibility-and-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

- [Comment fonctionne la validation du checkout Shopify](/blog/shopify-checkout-validation-functions-block-orders)
- [Règles non appliquées : la liste de contrôle OrderRules](/docs/troubleshooting/rules-not-applying)
- [Où les règles d'OrderRules sont vérifiées : compatibilité et limitations](/docs/guides/compatibility-and-limitations)
- [Messages dynamiques sur la boutique](/docs/guides/storefront-messaging)

## Sources

- Shopify.dev : [Cart and Checkout Validation Function API](https://shopify.dev/docs/api/functions/latest/cart-and-checkout-validation) (cibles, étapes du parcours acheteur, exécutions échouées et `blockOnFailure`, surfaces prises en charge, paiement accéléré et attributs du panier)
- Shopify.dev : [Function APIs: resource limits](https://shopify.dev/docs/api/functions)
- Shopify Dawn sur GitHub : [`assets/product-form.js`](https://github.com/Shopify/dawn/blob/main/assets/product-form.js) (gestion des erreurs d'ajout au panier, version 16.2.0)
