Documentación
docs

Solución de problemas

Errores comunes en Shipabase y cómo resolverlos: tokens inválidos, webhooks de Stripe que no llegan y productos que no aparecen.

Antes que nada: ejecuta npm run check. El preflight detecta la mayoría de los problemas de configuración y te dice exactamente cómo resolverlos. Si el problema persiste, sigue esta guía.

Errores "Invalid token"

  • Verifica que las claves de Supabase en .env.local son correctas y del proyecto correcto
  • Si regeneraste las claves en Supabase, actualízalas en todos los entornos
  • Borra las cookies del sitio y vuelve a iniciar sesión

Los webhooks de Stripe no funcionan

  • Confirma que STRIPE_WEBHOOK_SECRET es el correcto para el entorno (el de stripe listen en local, el del Dashboard en producción — son distintos)
  • En local, verifica que la CLI está corriendo: npm run stripe:listen
  • Revisa qué eventos están configurados en el webhook (deben incluir checkout, customer, product, price y subscription)
  • En el Stripe Dashboard, Developers → Webhooks → tu endpoint muestra cada intento de entrega con su respuesta — es el mejor lugar para depurar

Los productos no aparecen en la página de precios

  • Verifica que los productos están marcados como active en Stripe
  • Los productos se sincronizan vía webhook al crearse o modificarse: si los creaste antes de configurar el webhook, edítalos y guárdalos de nuevo para forzar la sincronización
  • Confirma que aparecen en las tablas products y prices de Supabase

El proyecto de Supabase no responde

  • Los proyectos del plan gratuito se pausan tras una semana de inactividad: revisa tus proyectos y reactívalo
  • Si acabas de crearlo, espera un par de minutos a que termine el aprovisionamiento

¿Sigues atascado?

Escríbenos con el resultado de npm run check y la descripción del problema — respondemos a todos los compradores.