Troubleshooting

Demoras de sincronizacion con Stripe

Resolver plan stale despues de Checkout o Billing Portal.

Stripe es la fuente de eventos de suscripcion. Polaris procesa webhooks, actualiza billing_subscriptions y refresca limites del workspace.

Despues de Checkout

Al regresar de Stripe, Polaris muestra un estado de sincronizacion y refetchea subscription, limits y plan context. Si el webhook tarda unos segundos, el usuario puede actualizar estado manualmente.

Estados comunes

  • active: acceso normal.
  • trialing: acceso normal con contexto de trial.
  • past_due: warning y grace; no downgrade inmediato.
  • canceled: features pagadas bloqueadas y acceso minimo.
  • incomplete: pago pendiente o fallido.
  • incomplete_expired: checkout expirado.

Eventos duplicados

Los webhooks son idempotentes. Si Stripe reenvia el mismo event.id, Polaris debe responder como duplicado sin reprocesar side effects.