---

title: "Limites de uso e avisos" description: "Como o Zenovay rastreia o uso em relação ao seu plano e notifica em 80% / 95% para você não atingir seu limite por surpresa."

Limites de uso e avisos

Todo plano pago do Zenovay tem três recursos pay-as-you-go (PAYG) acompanhados mensalmente:

Quando você ultrapassa 80% de qualquer um destes, o painel dispara um toast único. Um segundo toast é disparado em 95%. Depois que o aviso é mostrado para o período, ele não volta a disparar até o primeiro dia do próximo mês do calendário (UTC).

Ler o uso atual

GET /api/billing/usage
Authorization: Bearer ZV_xxx

Retorna o uso atual com limites e porcentagem:

{
  "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"
    }
  }
}

Ler quais avisos já foram disparados

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 é indexado por recurso. O array contém os limiares em porcentagem (80 e/ou 95) que já foram disparados neste período de cobrança.

Reconhecer um aviso programaticamente

O painel faz isso automaticamente quando um toast é exibido. Se você está construindo uma UI personalizada, pode fazer o POST você mesmo:

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

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

O endpoint é idempotente — se a combinação (team, period, resource, threshold) já estiver registrada, você ainda recebe um 200 OK.

O que acontece a 100%

Leitura voltada ao cliente

• Ajuda: Avisos de limite de uso
• Ajuda: Excedente do limite de eventos
• Ajuda: Preços PAYG