A fatura do Flow Gestor: o que o cliente vê e como paga

A régua disparou, a mensagem chegou no WhatsApp e a Ana Paula Ribeiro tocou no link. O que ela encontra do outro lado decide se o Pix cai em dois minutos ou se ela pergunta "como eu pago?" no seu privado. Este é o passo 9 da série sobre cobrança automática: a fatura pública, parte por parte.

De onde vem a fatura

Três origens, uma só página:

• Automática. Uma rotina roda uma vez por dia e cria a fatura de quem vence nos próximos 5 dias. Também repesca cliente ativo que venceu há até 30 dias sem fatura. Só entra quem tem plano e valor no cadastro.
• Antecipada. No histórico do cliente, o botão "Antecipar Próxima Fatura" cria a fatura na hora. Só aparece quando não há fatura em aberto.
• Pelo chatbot. O fluxo de renovação e 2ª via gera ou reaproveita a fatura em aberto, como mostra cobrar pelo chatbot.

Regra única: cada cliente tem no máximo uma fatura em aberto, e o banco de dados bloqueia a segunda. O número segue o formato INV-202609-0007 e o endereço leva o nome do cliente. É ele que a tag "Link Fatura" ({link_cobranca}) coloca na mensagem. Se o servidor cobra por chave Pix, a tag entrega a chave, como explicado em servidores: fatura ou chave Pix.

A página, parte por parte

Uma folha branca, sem menu e sem login. De cima para baixo:

1. Quem cobra. Foto e nome do seu WhatsApp conectado, com o número da fatura. Sem WhatsApp conectado, aparece "Empresa" no lugar do nome.
2. "Cliente" e "Usuário". O nome cadastrado e o usuário do painel.
3. "Total a pagar" e a situação: "Vence em 12 dias" (7 dias ou mais), "Vence sexta-feira" (de 2 a 6 dias), "Vence amanhã", "Vence hoje", "Venceu ontem" ou "Venceu há 3 dias".
4. Os botões "Pagar R$ 29,90 com Pix" e, se você ligou o cartão, "Pagar com cartão". Abaixo: "Não precisa mandar comprovante: o acesso é liberado assim que o pagamento for confirmado."
5. A tabela "Descrição" e "Valor": a linha do plano ("Mensal · 30 dias"), "Cupom PLAY10" com valor negativo, "Gorjeta" (só quando escolhida) e "Total". Com licença de aplicativo ou desconto, entram também "Licença anual" e "Subtotal".
6. "Gorjeta para quem te atende": "Sem", "R$ 2", "R$ 5" ou "R$ 10", somada no mesmo Pix.
7. "Tenho um cupom de desconto", que abre o campo do código.
8. O rodapé, com o link "Área do cliente" e o aviso para tirar dúvidas pelo WhatsApp.

No celular, quando os botões saem da tela, uma barra fixa mostra o "Total" e um "Pagar com Pix". "Área do cliente" é o login com "Usuário" e "Senha" do aplicativo; o endereço se define na página API Pix, em "Link da Area do Cliente".

"Pagar com Pix": código copia e cola, QR e validade

O toque em "Pagar R$ 29,90 com Pix" abre uma folha com o valor, a linha "Código válido por 29:45" em contagem regressiva, o passo 1 "Copie o código" e o passo 2 "Cole no app do seu banco". O botão "Copiar código Pix" vira "Copiado. Agora cole no app do banco." e o código fica numa caixa em que um toque seleciona tudo, útil no navegador interno do WhatsApp, que às vezes bloqueia o copiar. O QR Code vem aberto no computador (com o link "Esconder QR Code") e fechado no celular, atrás de "Mostrar QR Code". Embaixo ficam "Aguardando o pagamento", o link "Já paguei, verificar agora" e a pergunta "O código não funcionou no banco?" com "Gerar outro código".

Por trás, a página consulta o pagamento a cada 5 segundos nos 3 primeiros minutos e a cada 15 depois, só enquanto a aba está visível; ao voltar do aplicativo do banco, ela consulta na hora. "Já paguei, verificar agora" força uma consulta imediata. Quem confirma de verdade é o webhook do provedor, e uma rotina a cada 2 minutos revisa os Pix pendentes se ele atrasar. Fechar a folha não cancela o código: quando o pagamento cai, ela reabre com "Pagamento confirmado" e o botão "Concluir" recarrega a fatura já paga. O que acontece no painel está em Pix caiu: confirmação, renovação e mensagem automática.

A validade vem do provedor; sem essa informação, o Flow Gestor assume 30 minutos no Mercado Pago, 20 na FastDePix e 24 horas na AtivoPay, e no Asaas a contagem vai até o fim do dia. Ao zerar, a folha mostra "Código expirado" e "Gerar novo código". "Gerar outro código" tenta cancelar o anterior no provedor antes de emitir um novo. No Mercado Pago e no Asaas, se o cancelamento falhar, a página mantém o código atual e avisa: "O código anterior ainda vale, então continuamos com ele." A AtivoPay não tem cancelamento, então ali o código atual segue valendo até expirar. Um código válido é melhor que dois: era assim que cliente pagava a mesma fatura duas vezes.

CPF/CNPJ do titular: quando a fatura pede e por quê

Depende do provedor escolhido em conectar o Pix:

Provedor	Pede CPF/CNPJ?
Mercado Pago	Nunca
AtivoPay	Nunca
FastDePix	Só acima de R$ 100,00
Asaas	Sempre

FastDePix e Asaas amarram a cobrança ao documento do titular: Pix vindo de conta com outro CPF é devolvido pelo banco. Nesses casos, "Pagar com Pix" abre antes a tela "Quem vai pagar?", com "Nome de quem vai pagar", "CPF ou CNPJ de quem vai pagar" e o botão "Gerar código de R$ 129,90". Com o código na tela, a folha mostra "Pague com a conta de" seguido do nome e do documento, com o link "Trocar". Se o cliente pagou com a conta de outra pessoa, o título vira "Pagamento em análise" (com o botão "Gerar novo Pix com o CPF certo") ou "Pagamento devolvido" (com "Gerar novo Pix"), e os dois reabrem a tela do titular.

Na FastDePix vale o valor final: R$ 99,90 não pede documento, com R$ 5 de gorjeta pede. Abaixo de R$ 10,00 ela recusa o Pix.

Pagar com cartão (quando está ligado)

O botão "Pagar com cartão" só existe se, na página API Pix, a seção "Cartao de Credito" está ativa e há credencial do Mercado Pago ativa. Ao lado do texto aparece "até 3x" (plano de 90 dias ou mais com parcelas liberadas), "renova sozinho" ("Cobranca Recorrente" ligada) ou, sem nenhum dos dois, "Mercado Pago". Se você cobra acréscimo no cartão, o formulário mostra "Valor da fatura", "Acréscimo do cartão" e "Total no cartão". O formulário pede os dados do cartão, "Nome impresso no cartão", "CPF do titular" e "E-mail". Com recorrência ligada e sem cartão salvo, a caixa "Renovar automaticamente a cada 30 dias neste cartão" vem marcada.

Aprovado, a página recarrega como paga; recusado, a mensagem diz o motivo. Quando a assinatura já vai debitar a fatura, a página nem oferece Pix nem cartão: o rótulo vira "Total desta fatura", a situação mostra "Renovação automática ativa" e o aviso do débito no cartão final 1234 na data marcada, com o lembrete de que trocar o cartão ou cancelar a renovação se faz na área do cliente. Se o débito falhou, os botões voltam com "O cartão final 1234 foi recusado. Pague por aqui normalmente." Detalhes em cartão de crédito e renovação automática.

Cupom na fatura

"Tenho um cupom de desconto" abre o campo "Código do cupom" e o botão "Aplicar". Se o código passar na validação, a página recarrega com o total novo e a linha "Cupom PLAY10". Só cabe um cupom por fatura. Os erros vêm do servidor: "Cupom invalido, expirado ou inativo", "Voce ja usou este cupom anteriormente" e "Este cupom ja foi utilizado". Cupom de indicação dá 100% de desconto, só vale em plano de até 30 dias (em plano maior a fatura responde "Cupom de indicacao so pode ser usado em planos mensais (30 dias)") e marca a fatura como paga na hora, sem Pix. Como criar cada tipo está em cupons de desconto e de indicação.

Fatura paga: o que aparece

Paga, a folha vira comprovante:

• "Total pago" no lugar de "Total a pagar", com o valor em cinza.
• "Paga em 21/09/2026 às 21:15" em verde e "Tudo certo. Seu acesso está liberado."
• Sem botões de pagamento, sem gorjeta e sem cupom.
• No rodapé: "Este comprovante continua disponível neste link."

Vale para Pix, cartão, cupom de indicação e para o "Confirmar Pago" do histórico, quando o cliente pagou por fora.

Fatura vencida e segunda via

Fatura vencida continua em aberto: o link não morre e o valor não muda sozinho, sem juros nem multa. Só entram a linha em vermelho ("Venceu há 5 dias") e o aviso "Depois do vencimento o acesso pode ser suspenso. Pagando agora, ele volta sozinho." Segunda via é o mesmo link, reenviado de três formas: uma cobrança com a tag "Link Fatura"; o botão "Ver Fatura" no histórico do cliente, que abre a fatura em outra aba para você copiar o endereço; ou o chatbot com a ação de consultar fatura, que devolve link e valor a quem pede "2ª via".

Erros comuns

• Cobrar antes de a fatura existir. A fatura nasce 5 dias antes do vencimento; uma cobrança 7 dias antes sai com "Link Fatura" vazio e o envio não é barrado. Alinhe a régua de cobrança com essa janela ou antecipe a fatura.
• Cliente sem plano ou sem valor. Sem os dois, não há fatura nem link.
• Cliente pagando fora da fatura. Pix direto para a sua chave não confirma sozinho: você precisa clicar "Confirmar Pago" no histórico.
• A fatura avisa que quem emitiu a cobrança não cadastrou uma chave Pix. É a sua conta do Mercado Pago sem chave Pix ou sem credencial ativa no Flow Gestor.

Perguntas frequentes

O cliente precisa de login para pagar?

Não. A fatura é pública: quem tem o link abre, vê e paga. O login existe só na "Área do cliente", com o usuário e a senha do aplicativo.

Por que o cliente vê o mesmo código Pix ao reabrir a fatura?

Porque ainda existe um código pendente, válido e com o mesmo valor. A página o reaproveita para não deixar dois códigos pagáveis. Se ele quiser outro, usa "Gerar outro código".

A gorjeta tem limite?

Na tela, as opções são fixas: "Sem", "R$ 2", "R$ 5" ou "R$ 10". No servidor, o valor do Pix não pode ser menor que o total da fatura nem passar do dobro dele.

O link da fatura expira?

Não. Em aberto, o link paga; paga, vira o comprovante no mesmo endereço. O que expira é o código Pix, e basta gerar outro.

Próximos passos

• Pix caiu: confirmação, renovação no painel e mensagem automática
• Conectar o Pix: Mercado Pago, FastDePix, Asaas e AtivoPay
• Cartão de crédito e renovação automática
• Cupons de desconto e de indicação
• Mensagens de cobrança: tags, variações e modelos prontos