---
title: "Comment fonctionne la validation du checkout Shopify (et comment les applications l'utilisent pour bloquer des commandes)"
description: "Comment fonctionnent les Functions de Cart and Checkout Validation de Shopify : où elles s'exécutent et où elles ne s'exécutent pas, quelles données une Function peut voir, ce qu'elle peut et ne peut pas faire, quels forfaits peuvent l'utiliser, et comment des applications comme OrderRules s'en servent pour bloquer des commandes."
contentType: "blog"
locale: "fr"
localized: true
source: "https://orderrules.com/fr/blog/shopify-checkout-validation-functions-block-orders"
slug: "shopify-checkout-validation-functions-block-orders"
date: "2026-05-03"
tags:
  - "shopify"
  - "checkout validation"
  - "shopify functions"
  - "server-side validation"
  - "block checkout outside business hours"
  - "order limits"
---
**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](/images/blog/shopify-checkout-validation-functions-block-orders.png)

## 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 :

```javascript
// 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.

| Surface | Validation exécutée ? | Remarques |
|---|---|---|
| Panier et checkout de la boutique en ligne | **Oui** | Le 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 maintenant | **Oui** | Listés comme Storefront Accelerated Checkout |
| Vitrines headless (Storefront API) | **Oui** | Hydrogen et front-ends personnalisés inclus |
| Checkout B2B | **Oui** | Les acheteurs entreprises sont soumis à la même validation |
| Commandes provisoires (admin et checkout de facture) | **Oui** | Listées comme Draft Order (Admin and Checkout) et Shopify Admin |
| Shopify POS | **Non** | Les ventes en magasin ne sont pas validées |
| Commandes de renouvellement d'abonnement | **Non** | Seul le premier checkout de l'abonnement est validé |
| Modifications de commande | **Non** | Modifier une commande après l'achat contourne la validation |
| Create Order API | **Non** | Commandes créées par d'autres applications ou intégrations |
| Précommande et essai avant achat | **Non** | Les 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](/blog/shopify-scripts-to-functions-order-limits).

## 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 panier | Function de validation |
|---|---|---|
| Checkout classique de la boutique en ligne | Seulement si l'acheteur passe par la page panier avec JavaScript activé | **Oui** |
| Boutons Shop Pay, Apple Pay, Google Pay sur les pages produit | Non, ils contournent la page panier | **Oui** |
| Liens de checkout directs | Non | **Oui** |
| Vitrines headless | Non, il n'y a pas de thème | **Oui** |
| Commandes provisoires | Non | **Oui** |
| POS | Non | Non |
| Renouvellements d'abonnement, modifications de commande, commandes via API | Non | Non |
| Peut afficher les limites avant le checkout | **Oui** | Non, seulement des messages quand le panier est vérifié |
| Contournable en désactivant JavaScript | Oui | Non |

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](/blog/best-shopify-delivery-date-picker-apps).

## 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](/docs/guides/compatibility-and-limitations).

## À lire aussi

- [Comment définir des limites de commande sur Shopify](/blog/how-to-set-order-limits-shopify)
- [Éviter la survente : stratégies pour les boutiques à capacité limitée](/blog/prevent-overselling-shopify)
- [Limites de commande par client : le guide](/blog/per-customer-order-limits-shopify-guide)
- [Messages dynamiques sur la boutique](/docs/guides/storefront-messaging)
- [Les meilleures applications de sélection de date de livraison Shopify, comparées sur la validation du checkout](/blog/best-shopify-delivery-date-picker-apps)
- [Validation de la date de livraison Shopify : les contrôles et les messages que voient les clients](/blog/shopify-delivery-date-validation)
- [Les limites de commande natives de Shopify vs les applications (2026)](/blog/shopify-native-order-limits-vs-orderrules)
- [Où les règles d'OrderRules sont vérifiées : compatibilité et limitations](/docs/guides/compatibility-and-limitations)
- [Remplacer les Shopify Scripts par des Functions pour les règles de quantité et de checkout](/blog/shopify-scripts-to-functions-order-limits)

## Sources

- Shopify.dev : [Cart and Checkout Validation Function API](https://shopify.dev/docs/api/functions/latest/cart-and-checkout-validation) (cibles, surfaces prises en charge et non prises en charge, limite par boutique)
- Shopify.dev : [Créer une Function de validation du panier et du checkout](https://shopify.dev/docs/apps/build/checkout/cart-checkout-validation)
- Shopify.dev : [Shopify Functions](https://shopify.dev/docs/apps/build/functions) (disponibilité par forfait pour les applications publiques et personnalisées)
- Changelog Shopify.dev : [Shopify Scripts will be deprecated on June 30, 2026](https://shopify.dev/changelog/shopify-scripts-will-be-deprecated-on-june-30-2026)
- Centre d'aide Shopify : [Passer des Scripts aux Functions](https://help.shopify.com/en/manual/checkout-settings/script-editor/transitioning-to-functions)

## Essayez-le sur votre boutique

Installez OrderRules depuis le [Shopify App Store](https://apps.shopify.com/orderrules-limit-sales?utm_source=blog&utm_medium=inline_cta&utm_campaign=shopify-checkout-validation-functions-block-orders). La validation du checkout est incluse dans tous les forfaits, et les forfaits payants bénéficient d'un essai gratuit de 14 jours.
