Saltar al contenido principal
Técnico

Cómo funciona la validación del checkout de Shopify (y cómo la usan las apps para bloquear pedidos)

Jahangir Alam3 de mayo de 2026Actualizado el 8 de octubre de 2026Datos verificados el 8 de octubre de 202611 min read
CheckoutShop PayApple PayBuy it nowone checkserver-side

La validación del checkout de Shopify es una Shopify Function, de la Cart and Checkout Validation API, que una app instala en tu tienda. Shopify la ejecuta en sus propios servidores cada vez que cambia un carrito o un checkout. Si la Function devuelve un error, el checkout muestra el mensaje y el comprador no puede completar el pedido hasta resolver el problema. Se ejecuta en el checkout normal, en botones exprés como Shop Pay y Apple Pay, en checkouts headless y en pedidos borrador, en cualquier plan de Shopify cuando proviene de una app pública. No se ejecuta en POS, renovaciones de suscripciones, ediciones de pedidos ni pedidos creados mediante la API. Puede bloquear un pedido, pero no puede cambiar el carrito ni reservar stock.

Última verificación: 8 de octubre de 2026, con la documentación para desarrolladores y el centro de ayuda de Shopify. Las fuentes están al final.

Aviso: OrderRules es una app de validación del checkout. Esta guía explica primero la plataforma Shopify y después cómo la usamos.

Validación del checkout comparada con apps de scripts en el carrito en el checkout estándar, Shop Pay, Apple Pay, Google Pay, enlaces directos al checkout y tiendas headless

Qué es una Function de validación

Shopify Functions permite a las apps añadir su propia lógica al backend de Shopify. Cada API de Functions cubre una tarea: descuentos, opciones de entrega, métodos de pago, etc. La validación es la que decide si un carrito puede pasar por el checkout.

Así funciona:

  1. Una app incluye la Function. Se compila a WebAssembly y se despliega con la app. Tú instalas la app; no tocas código.
  2. La ejecuta Shopify, no tu tema. La Function se ejecuta dentro de la infraestructura de Shopify, no en el navegador del comprador. Desactivar JavaScript o editar la página no la evita.
  3. Lee una entrada y devuelve errores. Shopify le pasa el carrito y datos relacionados. La Function devuelve una lista de errores, cada uno con un mensaje y un destino (todo el carrito o un campo concreto).
  4. El checkout muestra el mensaje. Lista vacía: el checkout continúa. Si hay errores: Shopify muestra los mensajes y bloquea la finalización hasta que el comprador cambie algo.

Shopify ejecuta la Function en varios puntos del recorrido del comprador: interacciones con el carrito, interacciones con el checkout y finalización del checkout. Una Function puede comprobar en qué paso está y decidir bloquear solo en el checkout, para que añadir al carrito nunca falle.

Shopify mantiene las Functions pequeñas y rápidas. Cada ejecución tiene límites estrictos de instrucciones y de tamaño de entrada, así que la lógica debe ser sencilla y los datos compactos.

Este es un ejemplo simplificado en JavaScript del target actual, cart.validations.generate.run. Es ilustrativo, no es el código de OrderRules:

// Ejemplo simplificado, no es código de producción.
// La entrada proviene de una consulta de entrada GraphQL (líneas del carrito, identidad del comprador, metacampos).
export function cartValidationsGenerateRun(input) {
  const limits = input.shop.limits?.jsonValue ?? {}; // escrito por la app de antemano
  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 } }] };
}

Fíjate en lo que falta: ninguna consulta a base de datos, ninguna llamada a API, ningún «contar los pedidos de hoy». La Function solo ve lo que hay en su entrada. Eso condiciona todo lo que sigue.

Dónde se ejecuta y dónde no

Shopify documenta qué superficies ejecutan Functions de validación. La tabla sigue la referencia de la Cart and Checkout Validation API.

Superficie¿Se ejecuta la validación?Notas
Carrito y checkout de la tienda onlineSíCarrito y checkout figuran por separado; ambos compatibles
Shop Pay, Apple Pay, Google Pay, PayPal exprés, Comprar ahoraSíFiguran como Storefront Accelerated Checkout
Tiendas headless (Storefront API)SíIncluye Hydrogen y frontends personalizados
Checkout B2BSíLos compradores de empresas reciben la misma validación
Pedidos borrador (admin y checkout de factura)SíFiguran como Draft Order (Admin and Checkout) y Shopify Admin
Shopify POSNoLas ventas en tienda física no se validan
Pedidos de renovación de suscripcionesNoSolo se valida el primer checkout de la suscripción
Ediciones de pedidosNoEditar un pedido después de la compra evita la validación
Create Order APINoPedidos creados por otras apps o integraciones
Preventa y probar antes de comprarNoLas opciones de compra diferida no son compatibles

Así que «no se puede eludir» no es exacto. Un comprador no puede saltarse la validación desde la tienda online ni con un botón exprés. Pero un pedido de POS, una renovación, una edición o la API nunca pasa por ella. Si dependes de un límite, comprueba cuáles de esos canales usa tu tienda.

Qué puede ver una Function

Una Function declara una consulta de entrada, escrita en GraphQL, y Shopify la rellena en cada ejecución. Entre los campos útiles están:

  • Líneas del carrito: cantidad, variante, producto, peso, atributos de línea.
  • Identidad del comprador: si ha iniciado sesión y, para clientes, campos como el número de pedidos y el importe gastado.
  • Metacampos: de la tienda, productos, variantes y clientes.
  • Atributos del carrito: por ejemplo, una fecha de entrega elegida en la página del carrito.
  • El paso del recorrido del comprador: interacción con el carrito, interacción con el checkout o finalización del checkout.

Lo que no puede hacer en una app pública: acceder a la red. No puede preguntar al servidor de la app «¿cuántos pedidos hoy?» durante el checkout. En su lugar, la app cuenta en otro sitio. Escucha las notificaciones de pedidos de Shopify, actualiza sus totales y los escribe en metacampos. La Function lee esos metacampos en la siguiente ejecución.

Por eso los recuentos en una Function son instantáneas. Están tan actualizados como la última escritura en los metacampos, no en tiempo real.

Qué puede y qué no puede hacer

Puede bloquear con un mensaje. Esa es toda su salida. Los mensajes pueden dirigirse a todo el carrito o a un campo concreto del checkout, y una app puede dejarte escribir tu propio texto.

No puede cambiar cantidades. Una Function de validación no puede reducir una cantidad, quitar una línea ni cambiar un precio. Los antiguos Shopify Scripts podían editar el carrito sin avisar; la validación no. El comprador lee el mensaje y corrige el carrito. Otras APIs de Functions, como Cart Transform o los descuentos, se encargan de modificar el carrito, y no bloquean el checkout.

No puede reservar stock ni franjas. La Function lee una instantánea y dice sí o no. No retiene nada. Si dos compradores pasan por el checkout por la última unidad, o la última plaza de una franja de entrega, casi en el mismo momento, ambos pueden leer «queda 1» y ambos pueden pasar. La validación hace fiables los límites con tráfico normal. No garantiza que nunca te pases.

Hasta 25 Functions de validación por tienda. Shopify limita cuántas Functions de validación pueden estar activas a la vez. Varias apps pueden añadir una cada una, y se ejecutan todas; basta con que una devuelva un error para bloquear el checkout.

Planes

  • Las apps públicas de la App Store con Functions funcionan en todos los planes de Shopify. No necesitas Plus para instalar una app de validación.
  • Las apps personalizadas con Functions requieren Shopify Plus. Es para tiendas que crean su propia Function privada.
  • Shopify Scripts ya no existen. Los Scripts dejaron de ejecutarse el 30 de junio de 2026. Muchos límites de cantidad vivían en scripts de artículos de línea. Si era tu caso, consulta cómo sustituir Shopify Scripts por Functions para reglas de cantidad y de checkout.

JavaScript del tema vs validación

Muchas herramientas de límites se ejecutan en el tema: ocultan un botón, limitan un campo de cantidad o muestran un aviso en la página del carrito. Es útil para mostrar los límites pronto. No es aplicarlos.

JavaScript del tema o de la página del carritoFunction de validación
Checkout normal de la tienda onlineSolo si el comprador pasa por la página del carrito con JavaScript activadoSí
Botones de Shop Pay, Apple Pay, Google Pay en páginas de productoNo, se saltan la página del carritoSí
Enlaces directos al checkoutNoSí
Tiendas headlessNo, no hay temaSí
Pedidos borradorNoSí
POSNoNo
Renovaciones de suscripciones, ediciones de pedidos, pedidos por APINoNo
Puede mostrar los límites antes del checkoutSíNo, solo mensajes cuando se comprueba el carrito
Se puede eludir desactivando JavaScriptSíNo

Ninguna de las dos cubre POS ni renovaciones. La mejor configuración usa ambas: mensajes en la tienda para que los compradores vean los límites pronto y una Function de validación como freno definitivo en el checkout.

Lo mismo ocurre con las fechas de entrega. Un selector de fechas atenúa los días completos o cerrados en el navegador, pero los botones exprés y los enlaces directos al checkout se saltan la página donde está el calendario. Solo una Function de validación vuelve a comprobar la fecha elegida en el checkout. Mira cómo se comparan las apps de selector de fecha de entrega para Shopify en validación del checkout.

Cómo la usa OrderRules

OrderRules instala una Function de validación. Tú defines las reglas en la app; la app lleva los recuentos y los escribe en metacampos; la Function los lee en el checkout y bloquea los pedidos que incumplen una regla. Comprueba:

  • Horario de tienda y festivos: cierra el checkout fuera de tu horario.
  • Topes de pedidos: topes diarios para toda la tienda, además de topes semanales y mensuales en los planes de pago.
  • Topes por producto, variante y colección: totales compartidos entre todos los compradores.
  • Cantidad mínima de pedido y cantidad por incrementos: por producto o variante, por pedido.
  • Límites por cliente: pedidos, unidades, gasto o peso por período, para clientes con sesión iniciada.
  • Fechas de entrega y franjas de recogida en el plan Advanced: horas de corte, fechas bloqueadas y topes por franja.

El mensaje de cada tipo de regla se puede editar en Ajustes. Las reglas se comprueban en todas las superficies de la tabla anterior donde se ejecuta la validación. Los pedidos de POS y las renovaciones no se bloquean, pero sí cuentan para tus límites. Los recuentos son instantáneas, así que dos checkouts casi simultáneos por la última plaza pueden pasar los dos.

La aplicación en el checkout está incluida en todos los planes, también en el plan gratuito Starter. Todos los detalles: dónde se comprueban las reglas de OrderRules: compatibilidad y limitaciones.

Lecturas relacionadas

Fuentes

Pruébalo en tu tienda

Instala OrderRules desde la Shopify App Store. La validación del checkout está incluida en todos los planes, y los planes de pago tienen una prueba gratuita de 14 días.

Preguntas frecuentes

Es una API de Shopify Functions, la Cart and Checkout Validation API. Una app instala una pequeña Function que Shopify ejecuta en sus propios servidores cuando cambia un carrito o un checkout. La Function devuelve una lista de errores. Si la lista no está vacía, Shopify muestra los mensajes y el comprador no puede completar el checkout hasta que se resuelva el problema.

No. Las tiendas de cualquier plan pueden usar apps públicas de la App Store que incluyan Functions de validación. Solo las apps personalizadas con Functions requieren Shopify Plus.

Sí. Shopify indica que los checkouts acelerados son compatibles, así que la misma Function se ejecuta con los botones exprés de Shop Pay, Apple Pay, Google Pay y PayPal. También se ejecuta en checkouts headless (Storefront API), checkouts B2B y pedidos borrador.

Shopify indica como no compatibles POS, los pedidos de renovación de suscripciones, las ediciones de pedidos, los pedidos creados con la Create Order API y las opciones de compra de preventa o de probar antes de comprar. Los pedidos de esos orígenes no los bloquea una Function de validación.

No. Una Function de validación solo puede devolver errores. No puede cambiar cantidades, quitar artículos ni editar precios. El comprador ve el mensaje y modifica el carrito por su cuenta.

Por sí sola, no. En las apps públicas una Function no puede hacer llamadas de red, así que la app le pasa los recuentos mediante metacampos y la Function lee una instantánea. No puede reservar stock ni franjas, así que dos checkouts que se completan casi en el mismo momento por la última plaza pueden pasar los dos.

¿Listo para tomar el control de tus pedidos?

Prueba OrderRules gratis