Configurar Pagos

TalentBricksAI usa Stripe como procesador principal. Los planes de precios se gestionan desde el Admin Panel — no hay que tocar código ni variables de entorno para cambiar precios.

Otros procesadores de pago

Si prefieres usar Lemon Squeezy o Polar, consulta la Visión General de Integraciones de Pago para comparar opciones.

Planes actuales

Personales (/pricing)

Plan ID	Tipo	Precio	Período
monthly-subscription	Suscripción	$19/mes	Mensual
annual-subscription	Suscripción	$190/año	Anual
credits-10	Créditos	$10 (único)	One-time

Equipos (/teams)

Plan ID	Seats máx	Precio ref.	Estado
team-10	10	$99/mes	ACTIVE
team-50	50	$399/mes	ACTIVE
team-100	100	$699/mes	ACTIVE
enterprise	ilimitado	Precio custom	ACTIVE
team-10-annual	10	~$950/año	DRAFT
team-50-annual	50	~$3820/año	DRAFT
team-100-annual	100	~$6700/año	DRAFT

Planes archivados

hobby y pro existen en DB con estado ARCHIVED. No aparecen en ninguna página pública.

Variables de entorno requeridas

Solo estas dos variables son obligatorias para que Stripe funcione:

app/.env.server

STRIPE_API_KEY=sk_test_51...
STRIPE_WEBHOOK_SECRET=whsec_...

Los Price IDs de Stripe ya no son variables de entorno requeridas — se gestionan desde el Admin Panel. Si los tienes en .env.server, el seed los migra automáticamente a la base de datos la primera vez.

# Opcionales — solo necesarios durante la migración inicial
PAYMENTS_MONTHLY_SUBSCRIPTION_PLAN_ID=price_xxx
PAYMENTS_ANNUAL_SUBSCRIPTION_PLAN_ID=price_xxx
PAYMENTS_CREDITS_10_PLAN_ID=price_xxx

Flujo de configuración inicial

1. Crear los productos en Stripe

En el Dashboard de Stripe (Product catalog > Products) o con el CLI, crea un producto por plan con su precio correspondiente. Copia el price_xxx de cada uno.

# Ejemplo con Stripe CLI
stripe products create --name="Monthly Subscription" --description="Acceso mensual a todos los cursos"
stripe prices create --product=prod_XXX --unit-amount=1900 --currency=usd --recurring[interval]=month

stripe products create --name="Annual Subscription" --description="Acceso anual a todos los cursos"
stripe prices create --product=prod_YYY --unit-amount=19000 --currency=usd --recurring[interval]=year

stripe products create --name="10 Credits" --description="Pack de 10 créditos"
stripe prices create --product=prod_ZZZ --unit-amount=1000 --currency=usd

2. Migrar Price IDs a la base de datos

Opción A — Seed automático desde env vars (recomendado para primera vez):

1. Agrega los Price IDs al .env.server (temporalmente)
2. Ejecuta: wasp db seed seedPricingPlans
3. El seed detecta que stripePriceId está vacío en DB y lo migra desde el env var
4. Puedes quitar las vars del .env.server — ya no son necesarias

Opción B — Desde el Admin Panel (cualquier momento):

1. Ve a /admin/pricing
2. Edita el plan (monthly-subscription, etc.)
3. Pega el price_xxx en el campo Stripe Price ID
4. Guarda

Opción C — Botón Sync en el Admin Panel:

1. Ve a /admin/pricing → edita un plan
2. Haz clic en Sync con Stripe
3. El sistema crea el producto y precio en Stripe automáticamente y guarda el ID en DB

Sync es idempotente

Si haces clic en Sync varias veces, el sistema verifica si el Price ya existe en Stripe y está activo — si es así, no crea un duplicado. Solo crea un nuevo Price si el anterior no existe o fue archivado.

3. Configurar webhooks

Desarrollo local:

stripe listen --forward-to localhost:3001/payments/stripe-webhook
# Copia el whsec_... a STRIPE_WEBHOOK_SECRET en .env.server

Producción:

1. Stripe Dashboard → Developers → Webhooks → Add endpoint
2. URL: https://tu-dominio.com/payments/stripe-webhook
3. Eventos requeridos:
   • checkout.session.completed
   • customer.subscription.created
   • customer.subscription.updated
   • customer.subscription.deleted
   • invoice.payment_succeeded
   • invoice.payment_failed

Gestionar precios desde el Admin Panel

Ver todos los planes

Ve a /admin/pricing. Hay tres tabs: Todos / Personal / Equipos.

La columna Stripe muestra:

• ✅ verde con price_xxx → plan sincronizado con Stripe, listo para checkout
• ⚠️ amarillo “No configurado” → falta el Stripe Price ID, el checkout fallará

Editar un plan

1. Clic en Editar en cualquier plan
2. Campos disponibles:
   • Precio — actualiza el precio en la DB (no afecta Stripe automáticamente)
   • Stripe Price ID — pega aquí el price_xxx de Stripe
   • Stripe Product ID — se rellena automáticamente al hacer Sync
   • Estado — DRAFT (oculto), ACTIVE (visible), ARCHIVED, HIDDEN
   • Es mejor oferta — muestra badge destacado en la página de precios

Stripe es inmutable

Los Prices en Stripe no se pueden editar una vez creados. Si cambias el precio, debes:

1. Crear un nuevo Price en Stripe con el precio correcto
2. Pegar el nuevo price_xxx en el Admin Panel El Price anterior queda activo hasta que lo archives manualmente en Stripe.

Activar planes anuales de equipos

Los planes team-10-annual, team-50-annual y team-100-annual están en estado DRAFT. Para activarlos:

1. Crea los productos y precios en Stripe Dashboard (con facturación anual)
2. En /admin/pricing, edita cada plan anual
3. Pega el price_xxx en Stripe Price ID
4. Cambia estado de DRAFT a ACTIVE

Lógica de checkout

Usuario compra un plan →
  1. Busca el plan en DB por planId
  2. Si existe y tiene stripePriceId → usa ese Price ID para el checkout ✅
  3. Si existe pero stripePriceId es null → fallback al env var
  4. Si el env var también está vacío → error 500 claro para el admin
  5. Si el plan no existe en DB → error 404

Esta arquitectura permite cambiar los Price IDs desde el Admin Panel sin reiniciar el servidor.

Modelo de suscripción exclusiva

Un usuario no puede tener una suscripción personal y de equipo al mismo tiempo. Si intenta comprar, recibe un error claro en la página de precios.

Estados de suscripción (usuario)

payment/plans.ts

export enum SubscriptionStatus {
  Active = "active", // Suscripción activa — badge verde
  CancelAtPeriodEnd = "cancel_at_period_end", // Cancela al vencimiento — badge amarillo
  PastDue = "past_due", // Pago fallido — badge rojo
  Deleted = "deleted", // Suscripción terminada — badge gris
}

Página “Mi Plan”

/account → sección de plan actual. Permite al usuario:

• Ver estado de su suscripción
• Acceder al Stripe Customer Portal para cancelar, actualizar pago o ver facturas

Habilitar el Customer Portal en Stripe Dashboard: Settings → Billing → Customer portal.

Recursos adicionales

• Integración detallada con Stripe
• Configuración local
• Despliegue a producción
• Stripe Dashboard
• Stripe Testing Cards