Faturamento
Controle se o seu Fluxo auto-hospedado usa o Polar para faturamento e medição, e entenda o que muda ao desativar o faturamento.
Comece pela visão geral de auto-hospedagem se você quiser antes o panorama completo do deploy. Esta página foca no Polar, na aplicação dos planos e na medição de créditos de IA.
Por que o Polar vem ativado por padrão
O Fluxo vem com o Polar ativado por padrão porque esse é o mesmo comportamento do qual o produto hospedado depende:
- as mudanças de plano para cima e para baixo passam pelo Polar
- as assinaturas dos sites são resolvidas a partir do estado do cliente no Polar
- os créditos de IA são medidos pelo Polar
- as páginas de faturamento e os fluxos do portal do cliente pressupõem que o Polar está disponível
Esse padrão é importante porque mantém o repositório alinhado ao comportamento da nuvem gerenciada sem precisar mexer em nada.
A substituição para auto-hospedagem
Se você não quer nenhuma dependência do Polar no seu deploy, desative-o explicitamente:
POLAR_ENABLED=falseA leitura do valor é estrita:
- se
POLAR_ENABLEDestiver ausente, o Polar continua ativado POLAR_ENABLED=truemantém o Polar ativado- qualquer outro valor desativa o Polar
O que acontece quando o faturamento está desativado
Com POLAR_ENABLED=false, o Fluxo passa a um modo auto-hospedado com o
faturamento desativado.
Isso significa:
- o checkout do Polar e os fluxos do portal do cliente são ignorados
- os webhooks do Polar não são montados
- criar uma organização não cria clientes no Polar
- criar um site não provisiona assinaturas gratuitas
- excluir um site não tenta revogar assinaturas do Polar
- a medição de créditos de IA fica desativada
- os limites de plano e os controles de funcionalidade passam a ser, na prática, ilimitados
Na prática, o app resolve internamente um plano sintético self_hosted. Esse
plano serve para manter simples o resto do app:
- os limites numéricos são tratados como ilimitados
- as funcionalidades com controle booleano são tratadas como ativadas
- a espera entre treinamentos da IA passa a ser imediata
- os limites rígidos do plano não são aplicados
Assim, o código de cada funcionalidade continua chamando os mesmos utilitários
de plano e permissões que já usa. O modo de faturamento fica centralizado em vez
de espalhar verificações if/else por todo o produto.
O que o painel mostra
Quando o faturamento está desativado:
- a página de plano mostra um estado de auto-hospedagem em vez dos textos de preço do produto hospedado
- as ações de upgrade e de faturamento ficam ocultas
- a rota de faturamento explica que a gestão de assinaturas está desativada neste deploy
- o uso de IA aparece como não medido, em vez de como uma queda ou um problema de sincronização de créditos
Padrão recomendado ao auto-hospedar
Se você roda o Fluxo inteiramente na sua própria infraestrutura e não quer o comportamento de faturamento do produto hospedado, defina:
POLAR_ENABLED=falseSe você quer que o seu deploy auto-hospedado mantenha o mesmo comportamento de
faturamento e medição do Fluxo Cloud, deixe POLAR_ENABLED sem definir ou
defina como true.
O modo com o faturamento desativado concede permissões ilimitadas em todo o deploy. Ele é feito para quem opera a instância auto-hospedada inteira, não como uma forma de burlar a aplicação dos planos em um serviço hospedado multi-inquilino. Antes de mudar um deploy existente, teste em um ambiente de homologação os dados de clientes e assinaturas, a remoção dos webhooks, as mudanças de permissões e a reversão.
Esta página foi útil?
Abra uma issue de documentação já preenchida para que a equipe possa agir.