Desafio

A Langfuse precisava equilibrar seu compromisso de código aberto com um modelo de negócio de nuvem sustentável. Como qualquer pessoa pode fazer self-host gratuitamente, sua oferta de nuvem precisava ter preço competitivo, ser fácil de entender e estar alinhada ao valor do cliente. A Langfuse começou com um sistema de faturamento próprio que usava uma taxa fixa simples por evento, mas essa configuração não conseguia dar suporte à flexibilidade de preço e à medição precisa de que a empresa precisava à medida que ela crescia.

À medida que a Langfuse cresceu, ficou claro que a empresa precisava de níveis graduados por evento e de planos mensais por nível para que o preço redimensionar-se com o uso e refletir descontos por volume. Clientes variam de conta processando 100.000 eventos por mês a centenas de milhões, e cada evento produz custos marginais para a Langfuse. A empresa queria descontos automáticos por volume para que o preço redimensionar-se sem exigir negociações customizadas.

A equipe também enfrentou vários casos extremos de faturamento. O checkout às vezes mostrava US$ 0 porque o uso é faturado depois, confundindo clientes. Testes enterprise exigiam dados de pagamento antecipadamente, mas o fluxo de checkout padrão não dava suporte a isso. Mudanças de plano podiam encerrar o ciclo de faturamento atual, fazendo clientes perderem dias pagos antecipadamente. A Langfuse também precisava de ferramentas confiáveis e de testes para comportamento complexo de upgrade ou downgrade e queria alertas de gasto expressos em valores em dólar, em vez de contagens de eventos. Ao mesmo tempo, a Langfuse precisava de uma abordagem confiável para recuperar pagamentos com falha sem cobrança manual e de uma solução global unificada para impostos e pagamentos para poder faturar clientes em diferentes regiões.

Solução

Para permitir faturamento medido confiável e escalável que vincula uso a valor, a Langfuse implementou um modelo híbrido com a cobrança por uso do Stripe Billing. Clientes assinam planos mensais por nível, e cada assinatura inclui um produto separado de uso medido do Langfuse Cloud que registra eventos. Os planos por nível atendem a diferentes necessidades de clientes, enquanto o produto de uso medido rastreia a ingestão de eventos de forma consistente em todos os planos para que o preço redimensionar-se com o uso. A Langfuse publica contagens horárias de eventos do seu data store ClickHouse/OLAP para a API de uso medido da Stripe, para faturamento preciso com visibilidade quase em tempo real.

A equipe escolheu Stripe Checkout para criar assinaturas e o Billing para produzir uma fatura única com itens de linha separados: a taxa SaaS antecipada (cobrada no início do ciclo) e o uso ao final do período. Isso elimina checkouts de US$ 0 e a confusão do cliente, ao mesmo tempo que captura dados de pagamento durante o cadastro para atender requisitos de compras enterprise. Cronogramas de assinatura e os controles de rateio da Stripe permitem que a Langfuse aplique upgrades imediatamente enquanto preserva a acumulação de uso e programe downgrades para manter acesso pago durante o período atual de faturamento.

Como os alertas nativos não atendiam às necessidades baseadas em dólar da Langfuse, a equipe usa o recurso de prévia de fatura da Stripe a cada hora para calcular a exposição em dólar. Quando limites do cliente são excedidos, o sistema dispara notificações por e-mail e no app. Webhooks sincronizam o estado de assinatura e de pagamento para o produto da Langfuse. Para analytics e reconciliação, a Langfuse sincroniza dados da Stripe para o BigQuery via Airbyte e combina com analytics do produto (dbt, Metabase); eventos operacionais de webhook também alimentam um canal do Slack para visibilidade em tempo real.

Para recuperação de pagamento, a Langfuse usa a lógica de novas tentativas automatizadas incorporada da Stripe e e-mails de acompanhamento, em vez de cobrança manual. A equipe monitora pagamentos com falha no Stripe Dashboard e sincroniza estados de assinatura (past_due, unpaid) via webhooks para exibir banners no app que solicitam que clientes atualizem dados de pagamento.

Para gerenciar impostos globalmente, a Langfuse usa Stripe Tax junto com a plataforma de pagamento global da Stripe, que calcula impostos aplicáveis, dá suporte a formas de pagamento locais e fornece uma integração única para faturamento transfronteiriço.

Resultados

O preço é claro, e descontos por volume são automatizados

A Langfuse implementou um modelo híbrido claro em duas semanas: uma taxa SaaS antecipada mais cobranças graduadas por evento na Stripe. Níveis graduados se aplicam automaticamente conforme o uso cresce, removendo a necessidade de negociações individuais de volume.

Upgrades rateiam imediatamente enquanto preservam a continuidade de uso

Usando cronogramas de assinatura da Stripe e faturamento flexível, a Langfuse rateia upgrades e fatura os valores rateados imediatamente, enquanto mantém o uso acumulado e o progresso de nível intactos. Downgrades são programados para entrar em vigor ao final do período de faturamento, para que clientes mantenham acesso a recursos pagos até então.

A Stripe lida com uso medido em escala

A Langfuse ingere contagens de eventos por hora na API de uso medido da Stripe, gerenciando até 200 milhões de eventos por mês para conta únicas e centenas de milhões a bilhões em todos os clientes. O faturamento medido garante que o uso seja registrado e faturado por meio da Stripe.

Alertas de gasto em dólar usam prévias de fatura

A Langfuse gera prévias de fatura por hora via Stripe e compara valores em dólar com limites configurados por usuário, disparando notificações por e-mail e no app quando os limites são excedidos. Webhooks da Stripe mantêm dados de assinatura e de estado de pagamento sincronizados para as equipes de produto e operações.

Ferramentas nativas da Stripe reduzem despesas gerais de manutenção

A equipe está progressivamente substituindo recursos de faturamento customizados por capacidades nativas da Stripe. A reformulação mais recente, de ponta a ponta, usando faturamento flexível e uso medido da Stripe levou um mês.