O Pix caiu: o que o Flow Gestor faz sozinho depois do pagamento

Ana Paula Ribeiro recebeu a cobrança da PlayHub, abriu a fatura e pagou os R$ 29,90 do plano Mensal pelo app do banco. A partir desse segundo, você não faz nada: a fatura vira "Paga em", o vencimento anda 30 dias, o painel renova quando o servidor é integrado, o pagamento entra no Financeiro e ela recebe a confirmação no WhatsApp.

Aqui está a ordem exata, o que é garantido, o que é "melhor esforço" e onde você ainda entra. O artigo faz parte da série sobre cobrança automática no Flow Gestor.

Como o sistema descobre o pagamento

São três caminhos, todos para a mesma rotina.

1. Webhook do provedor. Mercado Pago, FastDePix, Asaas e AtivoPay avisam o Flow Gestor assim que o Pix cai. É o caminho normal, configurado quando você conecta o provedor. Antes de baixar a fatura, o sistema confere que o aviso veio mesmo do provedor: Mercado Pago e AtivoPay são reconsultados na API, FastDePix é validado pela assinatura e Asaas pelo token do webhook.
2. A própria fatura. Depois de gerar o Pix, a página consulta o status a cada 5 segundos nos 3 primeiros minutos e a cada 15 segundos depois, enquanto a aba está visível (ao voltar do app do banco, consulta na hora). O botão "Já paguei, verificar agora" faz a mesma consulta imediatamente; se ainda não constar, aparece "Ainda não apareceu por aqui." Como a consulta vai direto na API do provedor, a fatura confirma o pagamento sem depender do webhook.
3. Conferência periódica. A cada 2 minutos uma rotina varre os Pix pendentes criados nas últimas 24 horas (menos os do último minuto) e pergunta ao provedor se caíram. É a rede de segurança para webhook perdido e aba fechada.

Os três podem chegar juntos sem duplicar nada: só um deles marca a fatura como paga, os outros param.

A ordem do que acontece

1. Fatura paga. O cliente vê "Paga em", com data e hora, e "Tudo certo. Seu acesso está liberado."; na folha do Pix, "Pagamento confirmado".

2. Vencimento renovado. Se o vencimento ainda estava no futuro, o novo é o vencimento atual mais os dias do plano. Se já era hoje ou passou, é a data do pagamento (horário de Brasília) mais os dias do plano. Carlos Eduardo Lima vence em 22 de setembro e pagou dia 21: vai para 22 de outubro. Rafael Martins estava "VENCIDO" desde 18 de setembro e pagou dia 21: vai para 21 de outubro. A marca de teste some e "VENCE HOJE" vira "ATIVO".

3. Registro no Financeiro. Na mesma operação entra uma transação "Renovação" (ou "Novo Cliente", se o cliente ainda era teste em um painel integrado), com o método do provedor: na tabela do Financeiro aparece o código (PIX_MERCADOPAGO, PIX_FASTDEPIX, PIX_ASAAS, PIX_ATIVOPAY) e no gráfico "Formas de Pagamento", "Mercado Pago", "FastDePix", "Asaas" ou "AtivoPay". O valor é o total da fatura, já com cupom. O custo vem do servidor: "Custo por Crédito (R$)" vezes as "Conexões" do cliente, vezes os meses do plano (no Warez, o semestral conta 5 créditos e o anual 10); se a fatura tem licença de app com custo, ele soma. Se o crédito custa R$ 8,00, o Mensal de R$ 29,90 entra com lucro de R$ 21,90. Mais em Financeiro.

4. Renovação no painel. Se o cliente existe em um servidor integrado (Warez, Sigma, PlayFast, GOAT ou Unitv), o Flow Gestor renova a linha lá. A data que o painel devolve substitui a local só se for mais adiantada. Se o painel falhar, o cliente fica com renovação pendente e a rotina de 2 minutos tenta de novo até completar 8 tentativas, cerca de 16 minutos. Depois disso a renovação fica com você. A conversão de teste para oficial não é repetida sozinha.

5. Mensagem de confirmação no WhatsApp. Sai depois do painel, de propósito: assim a tag {vencimento} já carrega a data nova.

6. Conversão para a Meta. Com "Enviar conversões para a Meta" configurado na página "Meta Anúncios" (o "Conjunto de dados da conta do WhatsApp" e o "Token da Meta"), a fatura paga de um cliente que chegou por anúncio de clique para o WhatsApp entra na fila de eventos Purchase, com o valor da fatura. Sem essa configuração, ou sem identificador de clique no cliente, nada sai.

O que é "best-effort" e o que nunca falha

Os passos 1, 2 e 3 acontecem em uma única operação no banco: ou os três entram, ou nenhum. Se ela falhar, o webhook responde com erro e o provedor costuma reenviar o aviso. Não existe fatura paga sem vencimento novo e lançamento no Financeiro.

Os passos 4, 5 e 6 são "best-effort": cada um roda protegido, e uma falha vai para o registro de erros sem desfazer o pagamento. O que muda é o depois:

• Painel: as 8 tentativas automáticas.
• Mensagem: sem reenvio automático. Se o canal escolhido recusar o envio, o sistema tenta pelo outro (API Oficial ou WhatsApp QR); a exceção é o contato frio que o "Seguir o envio comum" mandou de propósito pela API Oficial, que não cai para o QR. Se o envio estourar o tempo, não repete, para o cliente não receber duas.
• Meta: o evento fica na fila e o envio é tentado a cada minuto, até 5 vezes; depois de 7 dias ele é descartado.

Ou seja: um cliente pode estar pago e ainda não renovado no painel. Se ele reclamar do acesso, confira o painel primeiro.

A mensagem de confirmação

A escolha fica na página "WhatsApp", no cartão "Por onde suas mensagens saem", bloco "Confirmação de pagamento", e vale para qualquer meio de pagamento. São dois campos: "Qual mensagem enviar", com as suas mensagens e a opção "Não enviar confirmação", e "Por qual canal", com "Seguir o envio comum" (que mostra entre parênteses o canal do envio comum), "API Oficial" e "WhatsApp QR". Na página "API Pix", o cartão "Mensagem de confirmacao de pagamento" tem o botão "Configurar", que leva para lá.

A mensagem é criada em "Mensagens", como qualquer outra, com as mesmas tags da cobrança. No envio, elas são preenchidas com os dados já renovados: {saudacao} ("Bom dia" das 5h às 11h59, "Boa tarde" das 12h às 17h59, "Boa noite" no resto, horário de Brasília), {nome}, {plano}, {valor} (o valor antes do desconto, no formato 29,90, sem "R$"), {subtotal} (o total pago), {vencimento} (a data nova) e {area_cliente}.

Um modelo que funciona para a PlayHub: "{saudacao}, {nome}! Recebemos seu pagamento de R$ {subtotal} do plano {plano}. Seu acesso está renovado até {vencimento}. Qualquer dúvida, é só responder aqui."

Com "Ativar variacoes de mensagem" ligado, uma das variações é sorteada. Pela "API Oficial", a mensagem precisa ter um modelo aprovado pela Meta; sem isso, o envio cai para o WhatsApp QR. Toda confirmação enviada fica registrada na conversa do cliente, em "Conversas".

Servidor sem integração: o que você ainda faz na mão

Se o servidor não é Warez, Sigma, PlayFast, GOAT ou Unitv, o Flow Gestor faz tudo, menos o passo 4. Quem renova o acesso no seu painel é você, usando o vencimento já atualizado no cadastro.

O segundo caso é o servidor configurado para cobrar por chave Pix em vez de fatura. Quando o cliente paga na sua chave, nenhum provedor avisa e nada acontece sozinho: vira um pagamento manual.

Pagamento manual (quando o cliente paga fora da fatura)

O cliente pagou na sua chave, em dinheiro ou pela chave do servidor. Dois jeitos de registrar, os dois com a mesma rotina de vencimento, Financeiro, painel e mensagem.

"Renovar", na página de clientes. Abre o diálogo "Renovar Cliente". Você confere o plano, o "Valor Cobrado (R$)" e o "Custo do Cliente (R$)", decide se "Enviar Mensagem de Renovação" fica ligado, escolhe a "Mensagem de Renovação" e clica em "Renovar Cliente". A fatura em aberto (ou vencida) mais recente é marcada como paga; sem fatura, o sistema cria uma já paga, com o método PIX ("PIX Manual" no filtro do Financeiro). Uma segunda renovação em menos de 2 minutos é bloqueada com "Renovação já processada. Não foi cobrado novamente."

"Confirmar Pago", no histórico do cliente. No ícone "Histórico", cada fatura "Em Aberto" tem o botão "Confirmar Pago". Ele baixa aquela fatura e mostra "Pagamento registrado!" com o lucro.

Não use "Criar Pagamento", na página Financeiro, para isso: ele só registra entrada, saída ou venda de créditos e não toca no vencimento, no painel nem na mensagem.

Erros comuns

• Nenhuma mensagem em "Qual mensagem enviar". O pagamento é processado, mas o cliente não recebe nada. Quem tinha mensagem escolhida na versão antiga da página "API Pix" continua atendido por ela.
• "Enviar botao PIX nativo" ligado na confirmação. Se o servidor do cliente cobra por chave Pix e a confirmação sai pelo WhatsApp QR, o cliente recebe um botão de pagar logo depois do "recebemos seu pagamento". Deixe esse botão para as cobranças.
• Clicar em "Renovar" para quem já pagou pelo Pix. A fatura já estava paga, então o sistema cria outra paga e lança de novo no Financeiro. Confira o histórico antes.
• Cliente pagou com a conta de outra pessoa. Nos provedores que pedem o documento do pagador, a folha do Pix mostra "Pagamento em análise" ou "Pagamento devolvido". O valor volta para quem pagou, e o cliente gera um novo Pix com o CPF certo.

Perguntas frequentes

Quanto tempo leva para a fatura ser confirmada?

Segundos, pelo webhook ou pela própria página da fatura. Se os dois falharem, a conferência de 2 minutos pega o pagamento na rodada seguinte, por até 24 horas.

O cliente que paga adiantado perde dias?

Não. Com o vencimento ainda no futuro, o novo prazo é contado a partir dele; só quem paga no dia ou atrasado conta do dia do pagamento.

A fatura está paga, mas o painel não renovou. E agora?

O sistema tenta de novo a cada 2 minutos, até completar 8 tentativas. Se depois disso o acesso continua parado, renove no painel manualmente. Pagamento, vencimento e Financeiro já estão certos.

Isso vale para pagamento com cartão?

Vale. O cartão passa pela mesma rotina de fatura paga, vencimento, Financeiro, painel e mensagem. A diferença é a cobrança recorrente, explicada em cartão de crédito e renovação automática.

Próximos passos

• Hub: cobrança automática, do cadastro ao Pix na conta
• Conectar o Pix: Mercado Pago, FastDePix, Asaas e AtivoPay
• A fatura que o cliente recebe
• Financeiro: pagamento manual, lucro, MRR e churn
• Cartão de crédito e renovação automática