Cobre mais de quem gasta mais IA, com fatura pronta
O Lago é um motor de cobrança de código aberto. Funciona igual relógio de luz: o cliente usa, o seu sistema avisa o Lago, e ele mede, aplica o seu preço, gera a fatura e cuida do pagamento. Assim você não precisa programar a cobrança do zero.
Cobrar pelo que cada cliente gasta: tokens (a unidade que mede o uso da IA), chamadas ao seu sistema, processamento, armazenamento ou qualquer outro uso do produto.
Montar o preço do seu jeito: por uso, mensalidade, pré-pago, porcentagem, por faixas, por pacote, com valor mínimo ou misturando tudo.
Gerar as faturas sozinho, de acordo com o plano de cada cliente.
Receber antes com crédito pré-pago: o cliente compra créditos, o saldo fica numa carteira e é descontado das faturas.
Evitar cobrança em dobro: se o mesmo registro de uso chegar duas vezes, o Lago reconhece e cobra uma vez só.
02O que você precisa
Docker Desktop (programa que liga o Lago no seu computador; já vem com o Docker Compose)
Git (programa que baixa o projeto): git-scm.com
Um produto que consiga avisar o Lago de cada uso. Quem programa, ou um agente de IA, faz essa parte
Conta na Stripe, Adyen ou GoCardless, pra receber pagamento de verdade
03Passo a passo
Instale o Docker Desktop pelo link abaixo e instale também o Git. Depois abra o Docker Desktop e deixe ele ligado.
https://docs.docker.com/get-docker/
Abra o terminal (a janela de comandos do computador) e baixe o projeto. Rode as duas linhas:
git clone --depth 1 https://github.com/getlago/lago.git
cd lago
Gere a chave de segurança do seu Lago. Ela fica guardada num arquivo chamado .env, dentro da pasta. Atenção no Windows: o site oficial não traz uma versão própria desse comando, e ele foi escrito pro terminal de Mac e Linux.
Abra o endereço abaixo no navegador e crie a sua conta: nome da organização, e-mail de cobrança da empresa e uma senha de administrador.
http://localhost
Agora monte a cobrança. Crie o que vai ser medido (nome, código e como somar o uso) e um plano com o seu preço. Depois vá em Customers, clique em Add a customer, preencha e confirme em Create customer. Dentro do cliente, na aba Overview, clique em Add a plan. Por último, abra Developer no menu lateral, depois a aba API keys, e clique em Copy: essa é a chave que o seu produto usa pra avisar o Lago.
04Pedidos prontos pra colar no seu agente de IA
Desenhar o seu preçoAntes de mexer no Lago: cole em qualquer IA pra sair com o plano pronto
Tenho um produto chamado [NOME DO PRODUTO] que usa IA para [O QUE ELE FAZ]. Hoje cobro [PREÇO ATUAL] e cada cliente gasta em média [GASTO DE IA POR CLIENTE].
Vou cobrar pelo uso com o Lago. Me ajude a definir:
1. O que medir (por exemplo tokens ou número de pedidos), com nome e código pra cada medida.
2. Se a cobrança deve ser só por uso, mensalidade com uso incluído, por faixas ou por pacote, e por quê.
3. Uma tabela com 3 clientes de exemplo (pequeno, médio e grande) mostrando quanto cada um pagaria.
Explique em português simples, sem termos técnicos.
Ligar o seu produto ao LagoCole no agente de IA que mexe no código do seu produto, ou mande pra quem programa
Quero que este projeto avise o Lago toda vez que um cliente usar [RECURSO QUE VOU COBRAR].
O Lago está em http://localhost:3000 e os avisos vão para /api/v1/events, com a chave de acesso no cabeçalho Authorization: Bearer.
Cada aviso precisa ter: transaction_id único, external_subscription_id igual a [ID DA ASSINATURA DO CLIENTE], code igual a [CÓDIGO DA MEDIDA] e, em properties, a quantidade usada em [NOME DO CAMPO, EXEMPLO tokens].
Se o envio falhar, reenvie o mesmo aviso sem mudar nada, pra não cobrar em dobro.
Guarde a chave no arquivo .env, nunca dentro do código.
Antes de mexer, me mostre um plano curto do que vai mudar.
Montar o crédito pré-pagoPra vender pacotes e receber antes. Depois é só ir em Customers, escolher o cliente, abrir a aba Wallets e clicar em Add wallet & credits
Quero vender crédito pré-pago no [NOME DO PRODUTO]. Meu cliente típico gasta [VALOR] por mês.
Monte 3 pacotes em português com: quanto vale 1 crédito, quantos créditos o cliente compra, quantos eu dou de bônus e se os créditos têm validade.
Considere que crédito sem validade passa pro mês seguinte até o saldo zerar.
Diga qual pacote eu devo destacar e por quê.
Testar que não cobra em dobroPelo terminal, depois do passo 6. Troque os colchetes e rode o comando duas vezes: a segunda volta com erro 422, sinal de que o Lago recusou a repetição. Tirei a hora do exemplo oficial porque ela é opcional: sem ela, o Lago usa a hora em que recebeu
A licença é AGPLv3, que tem regras próprias. Leia antes de usar num produto comercial, principalmente se for alterar o código.
Instalar pelo GitHub é só o começo. O site oficial não mostra preço do Lago Cloud (a versão hospedada por eles) nem do Premium: é preciso falar com a equipe.
Alguns recursos são Premium, como ver o saldo da carteira em tempo real. Confira antes de prometer isso ao seu cliente.
As páginas oficiais que consultamos não falam de nota fiscal brasileira nem de cobrança em real. Fale com o seu contador antes de usar com clientes no Brasil.
No seu computador é só teste. Pra usar com cliente de verdade, siga o guia oficial de instalação e troque as senhas e chaves padrão (a senha do banco de dados vem como changeme).
O Lago recebe pagamento por meio de serviços como Stripe, Adyen e GoCardless, então as taxas e as regras de cada um também valem.
A versão instalada envia dados básicos de uso do Lago pra empresa por padrão. Segundo eles, sem dados pessoais de clientes nem financeiros. Dá pra desligar seguindo a página oficial sobre isso.
Cada cliente pode ter até 6 carteiras ativas. Os créditos não valem em faturas avulsas, e encerrar uma carteira apaga o saldo restante sem volta.
Resumindo: baixa o projeto, gera uma chave, liga tudo com um comando e configura o preço. O seu produto avisa cada uso e o Lago transforma isso em fatura.
