Aller au contenu principal
Technique

Comment fonctionne la validation du checkout Shopify (et comment les applications l'utilisent pour bloquer des commandes)

Jahangir Alam3 mai 2026Mis à jour le 8 octobre 2026Faits vérifiés le 8 octobre 202611 min read
CheckoutShop PayApple PayBuy it nowone checkserver-side

La validation du checkout Shopify est une Shopify Function, issue de la Cart and Checkout Validation API, qu'une application installe sur votre boutique. Shopify l'exécute sur ses propres serveurs chaque fois qu'un panier ou un checkout change. Si la Function renvoie une erreur, le checkout affiche le message et l'acheteur ne peut pas finaliser la commande tant qu'il n'a pas corrigé le problème. Elle s'exécute sur le checkout classique, les boutons express comme Shop Pay et Apple Pay, les checkouts headless et les commandes provisoires, sur tous les forfaits Shopify lorsqu'elle provient d'une application publique. Elle ne s'exécute pas sur POS, les renouvellements d'abonnement, les modifications de commande ni les commandes créées via l'API. Elle peut bloquer une commande, mais elle ne peut pas modifier le panier ni réserver du stock.

Dernière vérification : 8 octobre 2026, à partir de la documentation développeur et du centre d'aide de Shopify. Les sources sont à la fin.

Transparence : OrderRules est une application de validation du checkout. Ce guide explique d'abord la plateforme Shopify, puis la façon dont nous l'utilisons.

La validation du checkout comparée aux applications de script de panier sur le checkout standard, Shop Pay, Apple Pay, Google Pay, les liens de checkout directs et les vitrines headless

Qu'est-ce qu'une Function de validation

Les Shopify Functions permettent aux applications d'ajouter leur propre logique au backend de Shopify. Chaque API de Function couvre une tâche : réductions, options de livraison, moyens de paiement, etc. La validation est celle qui décide si un panier peut passer au checkout.

Voici comment cela fonctionne :

  1. Une application fournit la Function. Elle est compilée en WebAssembly et déployée avec l'application. Vous installez l'application ; vous ne touchez pas au code.
  2. C'est Shopify qui l'exécute, pas votre thème. La Function s'exécute dans l'infrastructure de Shopify, pas dans le navigateur de l'acheteur. Désactiver JavaScript ou modifier la page ne permet pas de la contourner.
  3. Elle lit une entrée et renvoie des erreurs. Shopify lui transmet le panier et les données associées. La Function renvoie une liste d'erreurs, chacune avec un message et une cible (le panier entier, ou un champ précis).
  4. Le checkout affiche le message. Liste vide : le checkout continue. Des erreurs : Shopify affiche les messages et bloque la finalisation jusqu'à ce que l'acheteur modifie quelque chose.

Shopify exécute la Function à plusieurs moments du parcours d'achat : interactions avec le panier, interactions avec le checkout et finalisation du checkout. Une Function peut vérifier à quelle étape elle se trouve et ne bloquer qu'au checkout, pour que l'ajout au panier n'échoue jamais.

Shopify impose des Functions petites et rapides. Chaque exécution a des limites strictes en nombre d'instructions et en taille d'entrée : la logique doit donc rester simple et les données compactes.

Voici un exemple simplifié en JavaScript de la cible actuelle, cart.validations.generate.run. Il est illustratif, ce n'est pas le code d'OrderRules :

// Exemple simplifié, pas du code de production.
// L'entrée vient d'une requête d'entrée GraphQL (lignes du panier, identité de l'acheteur, métachamps).
export function cartValidationsGenerateRun(input) {
  const limits = input.shop.limits?.jsonValue ?? {}; // écrit à l'avance par l'application
  const errors = [];

  for (const line of input.cart.lines) {
    const productId = line.merchandise.product?.id;
    const remaining = limits[productId];
    if (remaining !== undefined && line.quantity > remaining) {
      errors.push({
        message: `Only ${remaining} left for today. Lower the quantity to continue.`,
        target: "$.cart",
      });
    }
  }

  return { operations: [{ validationAdd: { errors } }] };
}

Remarquez ce qui manque : aucune requête de base de données, aucun appel d'API, aucun « compter les commandes du jour ». La Function ne voit que ce qui se trouve dans son entrée. Tout ce qui suit en découle.

Où elle s'exécute, et où elle ne s'exécute pas

Shopify documente les surfaces sur lesquelles les Functions de validation s'exécutent. Le tableau suit la référence de la Cart and Checkout Validation API.

SurfaceValidation exécutée ?Remarques
Panier et checkout de la boutique en ligneOuiLe panier et le checkout sont listés séparément ; les deux sont pris en charge
Shop Pay, Apple Pay, Google Pay, PayPal express, Acheter maintenantOuiListés comme Storefront Accelerated Checkout
Vitrines headless (Storefront API)OuiHydrogen et front-ends personnalisés inclus
Checkout B2BOuiLes acheteurs entreprises sont soumis à la même validation
Commandes provisoires (admin et checkout de facture)OuiListées comme Draft Order (Admin and Checkout) et Shopify Admin
Shopify POSNonLes ventes en magasin ne sont pas validées
Commandes de renouvellement d'abonnementNonSeul le premier checkout de l'abonnement est validé
Modifications de commandeNonModifier une commande après l'achat contourne la validation
Create Order APINonCommandes créées par d'autres applications ou intégrations
Précommande et essai avant achatNonLes options d'achat différé ne sont pas prises en charge

Dire qu'elle « ne peut pas être contournée » n'est donc pas exact. Un acheteur ne peut pas échapper à la validation depuis la boutique en ligne ou un bouton express. Mais une commande issue de POS, d'un renouvellement, d'une modification ou de l'API n'y passe jamais. Si vous comptez sur une limite, vérifiez lesquels de ces canaux votre boutique utilise.

Ce qu'une Function peut voir

Une Function déclare une requête d'entrée, écrite en GraphQL, que Shopify remplit à chaque exécution. Champs utiles :

  • Lignes du panier : quantité, variante, produit, poids, attributs de ligne.
  • Identité de l'acheteur : s'il est connecté et, pour les clients, des champs comme le nombre de commandes et le montant dépensé.
  • Métachamps : sur la boutique, les produits, les variantes et les clients.
  • Attributs du panier : par exemple une date de livraison choisie sur la page panier.
  • L'étape du parcours d'achat : interaction avec le panier, interaction avec le checkout ou finalisation du checkout.

Ce qu'elle ne peut pas faire dans une application publique : accéder au réseau. Elle ne peut pas demander au serveur de l'application « combien de commandes aujourd'hui ? » pendant le checkout. C'est l'application qui compte ailleurs. Elle écoute les notifications de commande de Shopify, met à jour ses totaux et les écrit dans des métachamps. La Function lit ces métachamps à l'exécution suivante.

C'est pourquoi les compteurs d'une Function sont des instantanés. Ils sont aussi frais que la dernière écriture de métachamp, pas en temps réel.

Ce qu'elle peut faire, et ce qu'elle ne peut pas faire

Elle peut bloquer avec un message. C'est tout ce qu'elle renvoie. Les messages peuvent cibler le panier entier ou un champ précis du checkout, et une application peut vous laisser rédiger votre propre texte.

Elle ne peut pas modifier les quantités. Une Function de validation ne peut pas réduire une quantité, retirer une ligne ni changer un prix. Les anciens Shopify Scripts pouvaient modifier le panier discrètement ; la validation ne le peut pas. L'acheteur lit le message et corrige son panier. D'autres API de Functions, comme Cart Transform ou les réductions, gèrent les modifications du panier, et elles ne bloquent pas le checkout.

Elle ne peut pas réserver de stock ni de créneaux. La Function lit un instantané et répond oui ou non. Elle ne retient rien. Si deux acheteurs passent au checkout pour la dernière unité, ou la dernière place d'un créneau de livraison, presque au même moment, tous deux peuvent lire « 1 restant » et passer tous les deux. La validation rend les limites fiables avec un trafic normal. Elle ne garantit pas que vous ne les dépasserez jamais.

Jusqu'à 25 Functions de validation par boutique. Shopify plafonne le nombre de Functions de validation actives en même temps. Plusieurs applications peuvent chacune en ajouter une, et elles s'exécutent toutes ; il suffit que l'une d'elles renvoie une erreur pour bloquer le checkout.

Forfaits

  • Les applications publiques de l'App Store avec Functions fonctionnent sur tous les forfaits Shopify. Vous n'avez pas besoin de Plus pour installer une application de validation.
  • Les applications personnalisées avec Functions nécessitent Shopify Plus. C'est le cas des boutiques qui développent leur propre Function privée.
  • Les Shopify Scripts ont disparu. Les Scripts ont cessé de s'exécuter le 30 juin 2026. Beaucoup de limites de quantité vivaient dans des scripts d'articles. Si c'était votre cas, voir remplacer les Shopify Scripts par des Functions pour les règles de quantité et de checkout.

JavaScript du thème vs validation

Beaucoup d'outils de limites s'exécutent dans le thème : ils masquent un bouton, plafonnent un champ de quantité ou affichent un avertissement sur la page panier. C'est utile pour montrer les limites tôt. Ce n'est pas une application des règles.

JavaScript du thème ou de la page panierFunction de validation
Checkout classique de la boutique en ligneSeulement si l'acheteur passe par la page panier avec JavaScript activéOui
Boutons Shop Pay, Apple Pay, Google Pay sur les pages produitNon, ils contournent la page panierOui
Liens de checkout directsNonOui
Vitrines headlessNon, il n'y a pas de thèmeOui
Commandes provisoiresNonOui
POSNonNon
Renouvellements d'abonnement, modifications de commande, commandes via APINonNon
Peut afficher les limites avant le checkoutOuiNon, seulement des messages quand le panier est vérifié
Contournable en désactivant JavaScriptOuiNon

Aucun des deux ne couvre POS ni les renouvellements. La meilleure configuration combine les deux : des messages sur la boutique pour que les acheteurs voient les limites tôt, et une Function de validation comme barrière ferme au checkout.

C'est la même chose pour les dates de livraison. Un sélecteur de date grise les jours complets ou fermés dans le navigateur, mais les boutons express et les liens de checkout directs contournent la page où se trouve le calendrier. Seule une Function de validation revérifie la date choisie au checkout. Voir comment les applications de sélection de date de livraison Shopify se comparent sur la validation du checkout.

Comment OrderRules l'utilise

OrderRules installe une seule Function de validation. Vous définissez les règles dans l'application ; l'application tient les compteurs et les écrit dans des métachamps ; la Function les lit au checkout et bloque les commandes qui enfreignent une règle. Elle vérifie :

  • Horaires d'ouverture et jours fériés : ferme le checkout en dehors de vos horaires.
  • Plafonds de commandes : plafonds quotidiens pour toute la boutique, plus des plafonds hebdomadaires et mensuels sur les forfaits payants.
  • Plafonds par produit, variante et collection : des totaux partagés entre tous les acheteurs.
  • Quantité minimum de commande et quantité par incrément : par produit ou variante, par commande.
  • Limites par client : commandes, unités, dépense ou poids par période, pour les clients connectés.
  • Dates de livraison et créneaux de retrait sur le forfait Advanced : heures limites, dates bloquées et plafonds par créneau.

Le message de chaque type de règle se modifie dans Paramètres. Les règles sont vérifiées sur chaque surface du tableau ci-dessus où la validation s'exécute. Les commandes POS et les renouvellements ne sont pas bloqués, mais ils comptent quand même dans vos limites. Les compteurs sont des instantanés : deux checkouts quasi simultanés pour la dernière place peuvent donc passer tous les deux.

L'application des règles au checkout est incluse dans tous les forfaits, y compris le forfait gratuit Starter. Tous les détails : où les règles d'OrderRules sont vérifiées : compatibilité et limitations.

À lire aussi

Sources

Essayez-le sur votre boutique

Installez OrderRules depuis le Shopify App Store. La validation du checkout est incluse dans tous les forfaits, et les forfaits payants bénéficient d'un essai gratuit de 14 jours.

Questions fréquentes

C'est une API de Shopify Functions, la Cart and Checkout Validation API. Une application installe une petite Function que Shopify exécute sur ses propres serveurs quand un panier ou un checkout change. La Function renvoie une liste d'erreurs. Si la liste n'est pas vide, Shopify affiche les messages et l'acheteur ne peut pas finaliser le checkout tant que le problème n'est pas corrigé.

Non. Les boutiques de tous les forfaits peuvent utiliser les applications publiques de l'App Store qui contiennent des Functions de validation. Seules les applications personnalisées avec des Functions nécessitent Shopify Plus.

Oui. Shopify indique que les checkouts accélérés sont pris en charge : la même Function s'exécute donc pour les boutons express Shop Pay, Apple Pay, Google Pay et PayPal. Elle s'exécute aussi sur les checkouts headless (Storefront API), les checkouts B2B et les commandes provisoires.

Shopify indique comme non pris en charge POS, les commandes de renouvellement d'abonnement, les modifications de commande, les commandes créées avec la Create Order API, et les options d'achat de précommande ou d'essai avant achat. Les commandes issues de ces sources ne sont pas bloquées par une Function de validation.

Non. Une Function de validation ne peut que renvoyer des erreurs. Elle ne peut pas modifier les quantités, retirer des articles ni changer les prix. L'acheteur voit le message et modifie lui-même son panier.

Pas à elle seule. Une Function ne peut pas faire d'appels réseau dans les applications publiques : l'application lui transmet donc les compteurs via des métachamps, et la Function lit un instantané. Elle ne peut pas réserver de stock ni de créneaux : deux checkouts qui se terminent presque au même moment pour la dernière place peuvent donc passer tous les deux.

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

Essayer OrderRules gratuitement