Sistema de Planes
y Suscripciones

Cómo controlar qué módulos puede usar cada empresa, cómo cobrar por ello y dónde encajan las pasarelas de pago en Growth54.

¿Qué es un plan de suscripción?

Un plan define exactamente qué puede hacer una empresa dentro de la plataforma. No es solo un precio — es una lista de permisos.

Los 4 planes de Growth54

Diseñados para escalar desde el primer cliente hasta empresas con operación completa asistida por IA.

Qué módulo tiene cada plan

Cada módulo tiene un slug que se almacena en el JSON del plan. Si el slug está en la lista, el módulo está habilitado.

{
  "modules":       ["company_profile", "auditoria_inicial", "keywords", "articulos"],
  "max_keywords":  50,
  "max_articulos": 20,
  "rrss":          false,
  "agentes_ia":    false
}

Diseño simple del sistema de planes

El plan lo tiene el usuario, no la empresa. El usuario puede gestionar N empresas según su plan. Simple, sin tablas extra.

El modelo en una imagen

Tablas en base de datos

{
  "max_companies":  5,      ← cuántas empresas puede tener
  "modules": [
    "company_profile",
    "auditoria_inicial",
    "keywords",
    "articulos",
    "rrss",
    "agentes_ia"
  ],
  "max_keywords":  200,   ← por empresa
  "max_articulos": 100,   ← por empresa por mes
  "rrss":          true,
  "agentes_ia":    true
}

// User.php

public function plan(): BelongsTo
{
    return $this->belongsTo(Plan::class);
}

public function canAccessModule(string $module): bool
{
    if (!$this->plan || !$this->planIsActive()) {
        return false;
    }
    return $this->plan->hasModule($module);
}

public function planIsActive(): bool
{
    if (!$this->plan_expires_at) return true; // sin vencimiento
    return $this->plan_expires_at->isFuture();
}

public function canCreateCompany(): bool
{
    $max = $this->plan->features['max_companies'] ?? 1;
    $owned = $this->companies()->wherePivot('role', 'owner')->count();
    return $owned < $max;
}

Flujo de verificación de acceso a un módulo

Código del middleware

// app/Http/Middleware/EnsureUserHasModule.php

public function handle(Request $request, Closure $next, string $module): Response
{
    $user = $request->user();

    if (!$user->canAccessModule($module)) {
        return response()->json([
            'message' => 'Tu plan no incluye este módulo.',
            'upgrade' => true,
        ], 403);
    }

    return $next($request);
}

Control al crear empresa

// OnboardingController::createCompany() — validación que se agrega al inicio

if (!$user->canCreateCompany()) {
    return response()->json([
        'message' => 'Has alcanzado el límite de empresas de tu plan.',
        'upgrade' => true,
        'max_companies' => $user->plan->features['max_companies'],
    ], 403);
}

Cómo se procesa una suscripción de pago

El flujo completo desde que el usuario elige un plan hasta que su empresa tiene acceso activo.

Opciones de pasarelas de pago

Cada pasarela tiene sus ventajas según el mercado objetivo, la moneda y la complejidad técnica.

¿Dónde va cada pieza en el proyecto?

Modificar planes sin tocar código

Los planes se pueden crear y editar directamente desde la API con un token de administrador. No se necesita desplegar código.

# POST /api/admin/plans
{
  "slug":          "starter",
  "name":          "Starter",
  "price":         29.00,
  "duration_days": 30,
  "is_active":     true,
  "features": {
    "modules": [
      "company_profile",
      "auditoria_inicial",
      "keywords",
      "articulos",
      "paginas"
    ],
    "max_keywords":  50,
    "max_articulos": 20,
    "rrss":          false,
    "agentes_ia":    false
  }
}

# PATCH /api/admin/plans/2
{
  "features": {
    "modules": [
      "company_profile",
      "auditoria_inicial",
      "keywords",
      "articulos",
      "paginas",
      "rrss"  ← se agregó este módulo
    ],
    "max_keywords":  50,
    "max_articulos": 20,
    "rrss":          true,  ← se habilitó
    "agentes_ia":    false
  }
}

Asignar un plan a una empresa manualmente

Esto se hace cuando se activa una cuenta nueva o se cambia el plan de forma manual (sin pasarela de pago).

# POST /api/admin/companies/5/subscriptions   (endpoint por implementar)
{
  "plan_id":   2,
  "status":    "active",
  "starts_at": "2026-05-06",
  "ends_at":   "2026-06-06"
}

Qué existe y qué falta implementar

Un checklist honesto del estado del sistema de planes en Growth54 hoy.

Orden de implementación recomendado

La pregunta que define todo

Antes de programar el sistema de planes hay que responder esto con el equipo. No es técnico — es estratégico.

Resumen ejecutivo para presentar al equipo