Uso e cobrança

O Kisenon mede o que você realmente usa e consolida por organização. O console mostra o seu uso, e o uso além da sua franquia mensal gratuita é faturado conforme o contrato de preços — veja Status da cobrança abaixo.

O que medimos

O control plane amostra três dimensões por projeto e as agrega por organização:

Dimensão	Unidade	Como é medida
Compute	CU-horas	Recalculado a cada minuto a partir do runtime do lado do servidor de cada endpoint (Postgres `now()`), agrupado por hora e ponderado pelo tamanho do compute.
Storage	GB-meses	Coletado a cada 5 minutos do tamanho por projeto da camada de storage.
Branches	branch-meses	Amostrado uma vez por dia às 02:00 UTC por projeto.

Compute é a que se move: um endpoint que suspende em ociosidade para de acumular CU-horas no momento em que para, então um projeto que dorme a maior parte do dia custa uma fração de um que roda a todo vapor. Contagens de storage e branch são estáveis dentro das suas janelas de amostragem, então uma cadência mais grosseira é suficiente.

As amostras se consolidam em uma única visão por organização de uso de compute, storage e branch para o ciclo de cobrança atual — os números que a página de cobrança renderiza.

O tier gratuito

Toda organização começa com uma franquia mensal gratuita. Um limite de contagem de projetos também pode ser aplicado por organização: quando o limite está habilitado, uma organização sem método de pagamento cadastrado fica restrita a um número fixo de projetos; uma vez atingido, criar outro projeto retorna free_allowance_exhausted (HTTP 403). Organizações com um método de pagamento cadastrado não têm limite. O limite exato é uma configuração de implantação em vez de um número fixo no código, então ele pode ser ajustado com o tempo.

À medida que o uso medido de um ciclo sobe, o console mostra um banner crescente acima do conteúdo principal em três limiares — as mesmas porcentagens 80 / 95 / 100 que o control plane registra em seu log de notificações por ciclo:

80% — um aviso amarelo: "Você usou mais de 80% do seu tier gratuito neste período."
95% — um alerta âmbar para adicionar um método de pagamento antes que o serviço seja interrompido.
100% — um estado vermelho de esgotamento: o compute pode ser pausado até que um método de pagamento seja adicionado.

Cada banner é dispensável durante a sessão e leva a Adicionar um método de pagamento.

A página de cobrança da organização

Toda organização tem uma página de cobrança em /orgs/{id}/billing, acessível a partir da navegação da organização. Quando há dados de uso disponíveis, ela renderiza, por dimensão, uma barra usado / franquia (verde abaixo de 80%, âmbar 80–95%, vermelho em/acima de 95%) mais um marcador opcional de fim de período projetado, uma linha de fatura projetada, e o plano e método de pagamento atuais.

Gerenciar cobrança

A cobrança self-service está ativa. Uma vez que um método de pagamento esteja cadastrado, a página de cobrança da organização (Settings → Billing) mostra um botão Manage billing que abre o Customer Portal hospedado pela Stripe. No portal você pode:

Atualizar ou substituir o método de pagamento.
Ver faturas e recibos.
Editar seu endereço de cobrança e IDs fiscais.
Cancelar.

Antes de um cartão ser adicionado, a página mostra um botão Checkout em vez disso (adicione um método de pagamento); os dois são mutuamente exclusivos.

Quem pode: apenas o owner da organização ou o papel billing — não admin, member ou viewer.

Para referência, o control plane expõe:

POST /v1/billing/portal-session → { url }

que retorna uma URL para o Customer Portal; o portal sempre retorna você para a página de cobrança da organização depois.

Custo por projeto (showback)

A página de cobrança inclui um card Cost by project que detalha o seu uso por projeto. Ele reporta quatro dimensões medidas por projeto:

Dimensão	Unidade
Compute	CU-horas
Storage	GB-meses
Branches	branch-meses
Egress	GB

Um toggle Include credits & discounts alterna a visão entre bruto e líquido — a visão líquida aplica uma alocação pro-rata da franquia gratuita e do desconto por volume. É uma lente de exibição: o rodapé sempre mostra o subtotal bruto, a franquia gratuita, o desconto por volume e o total líquido.

Os dados têm granularidade diária: o período é chaveado por uma data de início completa (YYYY-MM-DD). O uso é obtido de um store global de medição, então os custos de um projeto permanecem visíveis mesmo após o projeto ser excluído.

Status da cobrança

O uso medido é coletado por projeto, agregado por organização e faturado através da Stripe conforme o contrato de preços:

O uso dentro da sua franquia mensal gratuita não é cobrado; o uso além dela é medido por unidade, com um desconto por volume automático no uso intenso.
O endpoint de cobrança do control plane (/v1/billing/customer) alimenta o banner de uso e a página de cobrança da organização — ambos leem da mesma fonte, então ambos refletem os números reais do ciclo atual.
Adicione um método de pagamento na página de cobrança da organização para remover o limite de projetos do tier gratuito e continuar além da franquia gratuita.

Relacionados

Organizações — a unidade em que o uso é consolidado.
Endpoints — suspender em ociosidade é o que mantém as CU-horas baixas.
Preços — a franquia gratuita, as tarifas por unidade e o desconto por volume.