Billing

Nuvem usa Stripe para el procesamiento de pagos. Podés gestionar tu plan desde el dashboard o via API.

Planes

Plan	Precio	Database	Storage	Functions	AI Tokens
Free	$0/mes	500 MB	1 GB	100K invocaciones	100K tokens
Builder	$29/mes	10 GB	50 GB	5M invocaciones	5M tokens
Scale	$149/mes	100 GB	Ilimitado	Ilimitadas	50M tokens

Todos los precios en USD. Facturación mensual. Sin contratos anuales obligatorios.

Endpoints

Estado actual

GET /v1/billing/subscription
Authorization: Bearer <admin_jwt>

Respuesta:

{
  "plan": "builder",
  "status": "active",
  "currentPeriodEnd": "2026-05-12T00:00:00.000Z",
  "cancelAtPeriodEnd": false,
  "usage": {
    "database": { "used": 2048, "limit": 10240, "unit": "MB" },
    "storage": { "used": 5120, "limit": 51200, "unit": "MB" },
    "aiTokens": { "used": 1200000, "limit": 5000000 }
  }
}

Uso del período actual

GET /v1/billing/usage
Authorization: Bearer <admin_jwt>

Upgrade de plan

POST /v1/billing/upgrade
Authorization: Bearer <admin_jwt>
{
  "plan": "scale",
  "currency": "usd"
}

Retorna una URL de Stripe Checkout para completar el pago.

Portal de facturación

POST /v1/billing/portal
Authorization: Bearer <admin_jwt>

Retorna URL al portal de Stripe para gestionar métodos de pago, facturas y cancelación.

Webhooks de Stripe

Nuvem procesa automáticamente los webhooks de Stripe en: POST /v1/billing/webhook (no requiere auth — firma HMAC)

Alertas de uso

Desde el dashboard podés configurar alertas cuando el uso supere umbrales:

POST /v1/admin/monitoring/alerts
{
  "type": "billing_usage",
  "threshold": 80,
  "resource": "ai_tokens",
  "channel": "email"
}

Facturas

Las facturas se generan automáticamente al final de cada período. Podés descargarlas desde el portal de Stripe o desde el dashboard en Settings > Billing > Invoices.

Cancelación

Al cancelar, el plan se mantiene activo hasta el fin del período actual. Los datos se retienen por 30 días después de la cancelación.

Preguntas frecuentes

¿Puedo cambiar de plan en cualquier momento? Sí. El upgrade es inmediato y se proratea. El downgrade aplica al siguiente período.

¿Qué pasa si supero el límite de mi plan? Recibirás una alerta por email. Las requests seguirán funcionando (no cortamos el servicio) pero se facturará el exceso según las tarifas de uso.

¿Hay descuentos para startups LATAM? Sí. Contactá a hola@nuvem-latam.com para el programa de startups.