3M Docs
Pagamentos e créditos

Saldo, ativação e consumo ficam presos à conta de cada cliente.

O billing não é só um painel visual. Ele participa da execução real do sistema: saldo baixo trava geração, saldo zerado desativa o uso licenciado do site.

CréditosRecargaLicençaConta por cliente
Crédito inicial

Cada conta pode nascer com saldo configurável via DEFAULT_ACCOUNT_CREDITS ou via payload de criação.

Recarga manual

O admin consegue somar saldo pela rota de créditos sem trocar a chave do cliente.

Consumo por geração

A geração de site já desconta o custo configurado em SITE_GENERATION_CREDIT_COST.

Regras atuais

A implementação atual já deixa a regra operacional pronta.

  • saldo por conta em accounts.json
  • histórico recente de grant e consume
  • validação de site contra saldo e status
  • API key própria por cliente, sem depender da sua chave mestre

Ativação de pagamento

O próximo passo natural é conectar um gateway para automatizar a recarga.

Entrada

checkout, assinatura ou recarga avulsa por evento confirmado

Processo

webhook financeiro chama a recarga e atualiza o saldo da conta

Saída

site e recursos voltam a responder assim que a conta tiver saldo válido

Ligar billing com a API

A página da API mostra exatamente onde o saldo entra na emissão de conta, licença e geração.

Ver API