---

title: "Límites de uso y avisos" description: "Cómo Zenovay rastrea el uso contra tu plan y te notifica al 80% / 95% para que no alcances tu límite por sorpresa."

Límites de uso y avisos

Cada plan de pago de Zenovay tiene tres recursos pay-as-you-go (PAYG) que se rastrean mensualmente:

Cuando superas el 80% de cualquiera de estos, el panel dispara un toast único. Un segundo toast se dispara al 95%. Tras mostrar el aviso para el período, no volverá a dispararse hasta el primer día del siguiente mes calendario (UTC).

Leer el uso actual

GET /api/billing/usage
Authorization: Bearer ZV_xxx

Devuelve el uso actual con límites y porcentaje:

{
  "success": true,
  "data": {
    "websites": { "used": 2, "limit": 5, "percentage": 40 },
    "visitors": { "used": 18234, "limit": 100000, "percentage": 18 },
    "tier": { "name": "Pro 100K", "price": 35, "features": ["..."] },
    "period": {
      "start": "2026-04-01T00:00:00.000Z",
      "end":   "2026-04-30T00:00:00.000Z"
    }
  }
}

Leer qué avisos ya se dispararon

GET /api/billing/usage-warnings?teamId=<team-uuid>
Authorization: Bearer ZV_xxx

{
  "success": true,
  "data": {
    "billing_period_start": "2026-04-01",
    "warnings_shown": {
      "events":       [80],
      "apiEvents":    [],
      "proxyEvents":  []
    }
  }
}

warnings_shown está indexado por recurso. El array contiene los umbrales en porcentaje (80 y/o 95) que ya se dispararon en este período de facturación.

Reconocer un aviso programáticamente

El panel lo hace automáticamente cuando se muestra un toast. Si estás construyendo una UI personalizada, puedes hacer el POST tú mismo:

POST /api/billing/usage-warning-acknowledge
Authorization: Bearer ZV_xxx
Content-Type: application/json

{ "teamId": "<uuid>", "resource": "events", "threshold": 80 }

El endpoint es idempotente — si la combinación (team, period, resource, threshold) ya está registrada, igual recibes un 200 OK.

Qué pasa al 100%

Lectura para el cliente

• Ayuda: Avisos de límite de uso
• Ayuda: Excedente de límite de eventos
• Ayuda: Precios PAYG