Ayuda
Iniciar sesión

Solucionar problemas con el contenido de Checkout Blocks

El contenido de Checkout Blocks puede no mostrarse como esperas por varias razones, lo que puede hacer que algunos elementos desaparezcan o no funcionen correctamente. Entre los problemas comunes están el incumplimiento de las reglas de visualización, configuraciones erróneas de permisos o discrepancias entre la configuración del propio bloque y la forma en que se agregó en el editor de pago y cuentas.

Esta guía te ayuda a diagnosticar y resolver por tu cuenta los problemas comunes de Checkout Blocks. Si después de revisar los pasos de esta guía el problema continúa, ponte en contacto con atención al cliente de Shopify para obtener ayuda.

En esta página

Solucionar problemas con bloques

Los bloques son elementos de personalización que muestran contenido en el pago, como campos personalizados, contenido dinámico y banners. Si un bloque no funciona como esperas, usa las siguientes secciones para identificar y resolver el problema.

El bloque no se muestra en el pago

Solucionar bloque no agregado al editor

Crear un bloque en la app Checkout Blocks no lo agrega automáticamente al pago. Debes agregar el bloque a la configuración del pago con el editor de pago y cuentas.

Pasos:

  1. Desde el panel de control de Shopify, ve a Configuración > Pago.
  • En la sección Configuraciones, haz clic en Personalizar junto a la configuración que quieres modificar.
  • Ve a la página de pago donde quieres que se muestre el bloque.
  • Haz clic en ⊕ Agregar bloque y selecciona el tipo de bloque correspondiente.
  • Configura el ID del bloque para que coincida con el ID del bloque que creaste en Checkout Blocks.
  • Haz clic en Guardar.
    • Solucionar bloque no establecido como Activo

    Para que un bloque se muestre en el pago, debe estar configurado como Activo. Los bloques en borrador no se muestran a los clientes.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Bloques.
  • Haz clic en el bloque que quieres activar.
  • En la sección Estado, selecciona Activo.
  • Haz clic en Guardar.
    • Solucionar bloque no publicado en Mercados o páginas

    Si el bloque tiene una configuración de publicación específica para Mercados, solo se mostrará en los Mercados que seleccionaste. Si el bloque está publicado solo en páginas de pago específicas, no se mostrará en otras páginas.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Bloques.
  • Haz clic en el bloque que quieres revisar.
  • En la sección Publicación, confirma que el bloque esté publicado en todos los Mercados correspondientes.
  • En la sección Páginas de pago, confirma que el bloque esté configurado para mostrarse en todas las páginas de pago correspondientes.
  • Haz clic en Guardar.
    • Solucionar cuando no se cumplen las reglas de visualización

    Display rules definen las condiciones que deben cumplirse para que un bloque se muestre en el proceso de pago. Si estas condiciones no se cumplen durante la sesión de pago del cliente, el bloque no se muestra.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Bloques.
  • Haz clic en el bloque que no se muestra.
  • Revisa las reglas de visualización configuradas para el bloque.
  • Verifica si el pago de prueba cumple todas las condiciones requeridas, como los umbrales del total del carrito, los tipos de producto o el estado de inicio de sesión del cliente.
  • Si configuraste Mostrar solo cuando: todas las reglas se cumplen, asegúrate de que se cumplan todas las reglas. Si configuraste Mostrar solo cuando: se cumple cualquier regla, asegúrate de que se cumpla al menos una regla.
    • Solucionar discrepancia del ID del bloque

    Cada tipo de bloque en el editor de pago y cuentas tiene una configuración de ID del bloque. El ID del bloque en el editor debe coincidir con el ID del bloque que creaste en la aplicación Checkout Blocks. Si los ID no coinciden, el bloque no se muestra.

    Por ejemplo, si el bloque tiene un ID del bloque de 4 en la aplicación Checkout Blocks, el bloque en el editor de pago y cuentas también debe tener su ID del bloque configurado en 4.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Bloques.
  • Haz clic en el bloque que no se muestra y toma nota de su ID del bloque.
  • Ve a Configuración > Pago.
  • En la sección Configuraciones, haz clic en Personalizar junto a la configuración que quieres revisar.
  • Haz clic en el bloque del editor que debe mostrar el contenido.
  • En la Configuración del bloque, confirma que el ID del bloque coincida con el ID del paso 3.
  • Si los ID no coinciden, actualiza el ID del bloque para que coincida.
  • Haz clic en Guardar.
    • Solucionar que el campo ID de bloque de vista previa tenga un valor

    El campo ID de bloque de vista previa (para pruebas) en el editor de pago y cuentas es solo para pruebas. Si este campo tiene un valor después de guardar la configuración del pago, puede anular las reglas de visualización del bloque y provocar comportamientos inesperados.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Configuración > Pago.
  • En la sección Configuraciones, haz clic en Personalizar junto a la configuración que quieres revisar.
  • Haz clic en el bloque que no se muestra correctamente.
  • En el campo ID de bloque de vista previa (para pruebas), elimina cualquier valor para dejarlo vacío.
  • Haz clic en Guardar.
    • Solucionar que se muestre otro bloque con mayor prioridad

    Si tienes varios bloques del mismo tipo con reglas de visualización superpuestas, solo se muestra el bloque con mayor prioridad. Más información sobre la prioridad de los bloques.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Bloques.
  • Haz clic en ⇅ Editar prioridad.
  • Selecciona el tipo de bloque que no se está mostrando.
  • Revisa el orden de prioridad. Los bloques con un número menor tienen mayor prioridad.
  • Ajusta los números de Prioridad para cambiar qué bloque se muestra primero.
  • Haz clic en Guardar.
    • Soluciona el límite de bloques activos alcanzado

    Checkout Blocks admite hasta 30 bloques activos por tipo de bloque. Si tienes más de 30 bloques activos de un solo tipo, como 35 bloques de campo personalizado activos, solo los primeros 30 se pueden mostrar en el pago.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Bloques.
  • Filtra por el tipo de bloque que estás revisando.
  • Cuenta cuántos bloques activos hay.
  • Si tienes más de 30 bloques activos, desactiva o elimina los que ya no necesitas.

    • Un bloque se muestra varias veces en el pago

    Soluciona el bloque agregado a una sección compartida

    Según dónde agregues un bloque en el editor de pago y cuentas, puede mostrarse en todos los pasos del pago. La sección Resumen del pedido y el área junto al botón Continuar o regresar son consistentes en todas las páginas del pago.

    Para mostrar un bloque solo en un paso específico, agrega el bloque al área de contenido principal de ese paso.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Configuración > Pago.
  • En la sección Configuraciones, haz clic en Personalizar junto a la configuración que quieres modificar.
  • Haz clic en el bloque que se muestra varias veces.
  • Observa en qué sección está el bloque. Si está en Resumen del pedido o junto al botón Continuar o regresar, el bloque se muestra en todas las páginas del pago.
  • Para mostrar el bloque solo en una página específica, quita el bloque de la sección actual y agrégalo al área de contenido principal de la página de pago deseada.
  • Haz clic en Guardar.
    • Soluciona varias instancias de bloque agregadas

    Algunos tipos de bloque, como los bloques de edición de artículo, por lo general solo necesitan agregarse una vez en el pago. El bloque usa reglas de visibilidad para mostrar contenido diferente en distintos escenarios. Si el contenido del bloque está duplicado, es posible que hayas agregado el bloque más veces de lo necesario por accidente.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Configuración > Pago.
  • En la sección Configuraciones, haz clic en Personalizar junto a la configuración que quieres revisar.
  • Recorre cada página del pago y revisa los bloques que se agregaron.
  • Si encuentras bloques duplicados del mismo tipo y con el mismo ID del bloque, elimina los sobrantes haciendo clic en el bloque y seleccionando Eliminar bloque.
  • Haz clic en Guardar.

    • Soluciona errores cuando creas o guardas bloques

    Si aparece un error cuando intentas crear o guardar un bloque, revisa las siguientes secciones.

    Solucionar el error "There were some issues with your form submission"

    Este error suele indicar que la cuenta para empleado no tiene los permisos necesarios para crear bloques en Checkout Blocks.

    Permisos necesarios:

    • Permisos de la tienda > Contenido: el personal debe tener permisos para Ver y Crear y editar definiciones de metaobjeto, así como Ver y Crear y editar entradas.
    • Permisos de la tienda > Configuración de la tienda: el personal debe tener el permiso Gestionar la configuración.
    • Permisos de la aplicación: el personal debe tener al menos permisos para Checkout Blocks.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Configuración > Usuarios y permisos.
    2. Haz clic en la cuenta para empleado que tiene el error.
    3. En Permisos de la tienda, expande la sección Contenido.
    4. Confirma que Definiciones de metaobjeto tenga seleccionados los permisos Ver y Crear y editar.
    5. Confirma que Entradas tenga seleccionados los permisos Ver y Crear y editar.
    6. En Configuración de la tienda, confirma que Gestionar la configuración esté seleccionado.
    7. En Permisos de la aplicación, confirma que Checkout Blocks esté seleccionado.
    8. Haz clic en Guardar.

    Si no tienes permiso para modificar los permisos del personal, contacta al propietario de tienda o a alguien del personal con permisos para gestionar usuarios.

    Resolución de problemas de descuentos personalizados

    Es posible que los descuentos personalizados creados en Checkout Blocks no se apliquen como se espera por varios factores.

    Soluciona el límite de descuentos automáticos activos alcanzado

    Shopify permite un máximo de 25 descuentos automáticos activos a la vez, incluidos los descuentos de todas las aplicaciones instaladas. Este límite se aplica a toda la tienda, no solo a Checkout Blocks.

    Si intentas activar el descuento automático número 26, no se aplicará en el pago.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Descuentos.
    2. Filtra para mostrar solo los descuentos Automáticos.
    3. Cuenta cuántos descuentos automáticos están activos actualmente.
    4. Si tienes 25 o más descuentos automáticos activos, desactiva o elimina los que ya no necesitas antes de activar nuevos.

    Más información sobre las limitaciones al combinar descuentos.

    Solucionar descuento inactivo

    Un descuento personalizado debe estar en Activo para que se aplique en el pago. Además, debe estar vigente según las fechas de inicio y fin configuradas.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Descuentos.
  • Haz clic en el descuento que no se está aplicando.
  • En la sección Estado, confirma que el descuento esté configurado como Activo.
  • En la sección Fechas activas, confirma que la fecha actual esté dentro de las fechas de inicio y fin configuradas.
  • Haz clic en Guardar.
    • Solucionar reglas del descuento no cumplidas

    Los descuentos personalizados en Checkout Blocks pueden tener reglas condicionales detalladas que determinan cuándo se aplica el descuento. Si estas condiciones no se cumplen durante la sesión de pago del cliente, el descuento no se aplicará.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Descuentos.
  • Haz clic en el descuento que no se está aplicando.
  • Revisa las reglas y condiciones configuradas para el descuento.
  • Verifica si el pago de prueba cumple todas las condiciones requeridas, como el valor mínimo del pedido, productos o colecciones específicos o los requisitos de elegibilidad del cliente.
  • Ajusta las reglas de descuento según sea necesario.
  • Haz clic en Guardar.

    • Resolución de problemas de personalizaciones de formas de entrega y de pago

    Si las formas de entrega o de pago no se ocultan, no cambian de nombre o no se reordenan como esperas, revisa las siguientes secciones.

    Solucionar personalización inactiva

    Para que se aplique en el pago, una personalización de forma de entrega o de pago debe estar en estado Activa.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Functions.
  • Haz clic en la personalización que no funciona.
  • En la sección Estado, confirma que la personalización esté configurada como Activa.
  • Haz clic en Guardar.
    • Solucionar límite de funciones activas alcanzado

    Shopify Functions tiene límites en la cantidad de funciones activas por tipo. Puedes activar un máximo de 25 funciones de personalización de pagos en cada tienda. Si superas este límite, es posible que aparezca el error: Failed to enable customization. Please try again or contact support.

    Estos límites ayudan a garantizar que el pago mantenga un alto rendimiento. Debes combinar o eliminar personalizaciones para mantenerte por debajo del límite.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Functions.
  • Cuenta cuántas personalizaciones activas de formas de entrega tienes (si el problema es de entrega) o cuántas personalizaciones activas de formas de pago tienes (si el problema es de pago).
  • Si alcanzaste el límite para ese tipo, desactiva o elimina las personalizaciones que ya no necesitas.
  • Intenta activar nuevamente la nueva personalización.
    • Solucionar reglas de personalización que no se cumplen

    Las personalizaciones de formas de entrega y de pago dependen de reglas que determinan cuándo se aplican. Si esas condiciones no se cumplen durante la sesión de pago del cliente, la personalización no surtirá efecto.

    Pasos:

    1. Desde el panel de control de Shopify, ve a Aplicaciones > Checkout Blocks.
  • Haz clic en Functions.
  • Haz clic en la personalización que no funciona.
  • Revisa las reglas configuradas para la personalización.
  • Verifica si el pago de prueba cumple todas las condiciones requeridas.
  • Ajusta las reglas según sea necesario.
  • Haz clic en Guardar.

    • Validar los cambios con un pago de prueba

    Antes de usar las personalizaciones de Checkout Blocks en un entorno de producción, valida con un pago de prueba que funcionen como esperas.

    Pasos:

    1. Desde la tienda online, agrega productos al carrito que cumplan las condiciones de los bloques, descuentos o personalizaciones que quieres probar.
    2. Ve al pago, pero no completes la compra.
    3. Revisa cada paso del pago y verifica lo siguiente:
      • Los bloques se muestran en las ubicaciones correctas con el contenido correcto.
      • Los descuentos personalizados se aplican cuando se cumplen los requisitos de elegibilidad.
      • Las personalizaciones de formas de entrega y de pago funcionan como se espera.
    4. Si estás probando reglas de visualización basadas en el total del carrito, prueba distintos valores de carrito para confirmar que los bloques aparecen y desaparecen en los umbrales correctos.
    5. Si estás probando reglas de visualización basadas en el cliente, prueba tanto el pago con sesión iniciada como el pago como invitado.

    Preguntas frecuentes

    ¿Cuántos bloques puedo tener activos al mismo tiempo?

    Puedes tener hasta 30 bloques activos por tipo de bloque. Por ejemplo, puedes tener 30 campos personalizados activos, 30 bloques de contenido dinámico activos y 30 bloques de edición de líneas de artículo activos al mismo tiempo. Puedes crear más de 30 bloques de un mismo tipo, pero solo los primeros 30 bloques activos pueden mostrarse en el pago.

    ¿Por qué necesito permisos específicos para el personal para usar Checkout Blocks?

    Checkout Blocks crea definiciones de metaobjeto para almacenar las configuraciones de los bloques. El personal necesita permisos para crear y editar definiciones y entradas de metaobjeto para poder guardar bloques en la app. Además, el personal necesita Administrar la configuración dentro de Configuración de la tienda y Permisos de la app explícitos para Checkout Blocks.

    ¿Puedo usar Checkout Blocks si no tengo el plan Shopify Plus?

    Los comerciantes con el plan Basic Shopify o superior pueden usar los bloques de contenido dinámico y contenido estático solo en las páginas de agradecimiento y de estado del pedido. Todas las demás funciones de Checkout Blocks, incluidos los campos personalizados, los descuentos personalizados y las personalizaciones de entrega y formas de pago, requieren el plan Shopify Plus.

    ¿Cómo sé qué ID de bloque usar?

    Cuando creas un bloque en la app Checkout Blocks, se le asigna un ID de bloque (el valor predeterminado es 0). Cuando agregas ese tipo de bloque al pago en el editor, debes establecer el mismo ID de bloque para que el editor sepa qué bloque específico mostrar. Si quieres mostrar bloques diferentes del mismo tipo en ubicaciones distintas, asigna a cada bloque un ID de bloque único y usa esos ID correspondientes en el editor. Más información sobre los ID de bloque.

    ¿Puedo combinar los descuentos de Checkout Blocks con otros descuentos?

    Los descuentos personalizados creados en Checkout Blocks son descuentos automáticos basados en Shopify Functions. Siguen las mismas reglas de combinación de descuentos que otros descuentos automáticos. Puedes tener un máximo de 25 descuentos automáticos activos en toda la tienda, incluidos los creados en Checkout Blocks y en otras apps.

    Antes de contactar a atención al cliente de Shopify sobre Checkout Blocks

    Si ya probaste los pasos de resolución de problemas anteriores y el problema con Checkout Blocks continúa, puedes ponerte en contacto con atención al cliente de Shopify para obtener ayuda. Antes de comunicarte con atención al cliente de Shopify, reúne la siguiente información específica de Checkout Blocks para ayudar a resolver el problema más rápido:

    • Detalles del bloque: el nombre, el tipo (como campo personalizado, contenido dinámico o edición de línea de artículo) y el ID de bloque del bloque que no funciona
    • Capturas de pantalla de la configuración: capturas de pantalla de la configuración del bloque en la aplicación Checkout Blocks, incluidas las reglas de visualización, la configuración de publicación y el estado
    • Capturas de pantalla del editor: capturas de pantalla de cómo está configurado el bloque en el editor de pago y de cuentas, incluidos los campos ID de bloque e ID de bloque de vista previa
    • Mensajes de error: capturas de pantalla o texto exacto de cualquier mensaje de error que recibas cuando crees, guardes o previsualices bloques
    • URL de pago de prueba: un enlace a un pago de prueba o a un pedido abandonado donde se pueda reproducir el problema, junto con el contenido del carrito utilizado para activar las reglas de visualización
    • Comportamiento esperado versus real: una descripción clara de lo que esperabas que sucediera frente a lo que realmente está sucediendo en el pago
    • Pasos de resolución de problemas realizados: qué secciones de esta guía ya revisaste y qué intentaste
    • Permisos del personal: Confirmación de que la cuenta tiene los permisos necesarios para contenido (definiciones y entradas de metaobjeto), configuración de la tienda (administrar la configuración) y permisos de apps (Checkout Blocks)

    Tener lista esta información específica de Checkout Blocks ayuda a la atención al cliente de Shopify a diagnosticar y resolver el problema de forma más eficiente.