Problemas comunes
Soluciones para problemas frecuentes de CheckoutOS
Última actualización: 2025-01-16
Esta guía cubre los problemas más comunes y sus soluciones. Si no encuentras el tuyo, consulta los códigos de error o contacta con soporte.
Las ofertas de venta adicional no aparecen
Si las ofertas posteriores a la compra no aparecen, revisa lo siguiente:
Verificar que la campaña esté activa
Revisar reglas de segmentación
Confirmar integración con Shopify
Probar con un pedido real
Crea una campaña sin reglas de segmentación, visible para todos, con un 100 % de descuento en un producto de poco valor. Haz un pedido de prueba para verificar el proceso.
Las extensiones del checkout no aparecen
Si no ves insignias de confianza, barras de progreso u otras extensiones:
Requisito de Shopify Plus
Las extensiones nativas requieren una de estas opciones:
- Plan Shopify Plus, o
- Acceso beta a Checkout Extensibility, disponible para algunas tiendas sin Plus
Consulta el plan en Shopify Admin → Settings → Plan.
Ubicación de las extensiones
Verifica que estén en un lugar visible:
- Ve a Shopify Admin → Settings → Checkout → Customize
- Busca las extensiones de CheckoutOS entre los bloques disponibles
- Arrástralas a la posición deseada en el checkout
- Guarda y previsualiza los cambios
Conflictos de descuentos
Los descuentos de CheckoutOS pueden entrar en conflicto con otros de Shopify o de apps. Los síntomas habituales incluyen:
- No se aplica el descuento de venta adicional
- Se muestra un importe incorrecto
- Se acumulan varios descuentos inesperadamente
Shopify limita las combinaciones de descuentos. Si el cliente ya aplicó un código, puede que no se apliquen los descuentos de CheckoutOS. Configura las reglas en Dashboard → Settings → Discount Functions.
Pasos para resolverlo
Revisar descuentos activos
Revisar combinaciones
Configurar prioridad de CheckoutOS
Carga lenta o tiempo de espera agotado
Si las funciones tardan en cargar o agotan el tiempo:
Problemas de red
- Comprueba la estabilidad de internet
- Prueba a borrar la caché y las cookies
- Prueba en una ventana privada o de incógnito
- Desactiva temporalmente las extensiones del navegador
Conflictos de apps
Otras apps de Shopify pueden entrar en conflicto ocasionalmente:
- Desactiva temporalmente otras apps relacionadas con el checkout
- Busca errores JavaScript en la consola del navegador
- Revisa las apps recientes que puedan afectar al checkout
// Open browser developer tools (F12) and check the Console tab
// Look for errors mentioning:
// - chargezen
// - checkoutos
// - checkout-extension
// Common error patterns:
// "Failed to load resource" - Network/CORS issue
// "undefined is not a function" - JavaScript conflict
// "Extension blocked" - CSP or ad blocker issueLos análisis no registran datos
Si el panel no muestra datos o las métricas son incorrectas:
Retraso de datos
Las métricas del panel tienen 15 minutos de retraso. Para datos en tiempo real, usa la sección Analytics, que se actualiza en directo.
Verificar el registro
Revisar integración
Revisar webhooks
Hacer un pedido de prueba
Problemas de visualización en teléfonos
Si las funciones no se muestran bien en teléfonos:
- Prueba en dispositivos reales, no solo en el emulador
- Revisa Dashboard → Settings → Store → Mobile Behavior
- Busca problemas de puntos de adaptación en el CSS personalizado
- Asegúrate de que el tema de Shopify se adapte a teléfonos
¿Sigues teniendo problemas?
¿Necesitas más ayuda? Contactar con soporte