Como conectar o Pix no Flow Gestor: Mercado Pago, FastDePix, Asaas e AtivoPay

Sem o Pix conectado, a cobrança automática para no meio do caminho: a mensagem chega, o cliente abre a fatura, toca em "Pagar R$ 29,90 com Pix" e recebe um erro. Você volta a conferir extrato e dar baixa na mão. A página "API Pix" resolve isso em três blocos: o link da área do cliente, o provedor que gera os códigos e uma aba para cada provedor. Este artigo faz parte da série sobre cobrança automática no Flow Gestor.

O que muda quando o Pix está conectado

O botão "Pagar R$ 29,90 com Pix" (o valor é o da fatura) aparece em toda fatura em aberto, com ou sem provedor. Sem conta ativa no Mercado Pago, que é o provedor padrão, o cliente toca e vê "Não foi possível gerar o Pix" e "Credenciais do Mercado Pago nao configuradas pelo vendedor". Com provedor válido, o Flow Gestor cria a cobrança na hora, mostra o QR e o código copia e cola e fica conferindo o pagamento. Quando o dinheiro cai, a fatura vira paga, o vencimento avança e a mensagem de confirmação sai no WhatsApp. O que acontece depois está em Pix caiu.

Duas coisas que a API Pix não faz. Ela não tem relação com o "Enviar botao PIX nativo" das mensagens: aquele botão usa a chave cadastrada no servidor, como explica o artigo sobre servidores por fatura ou chave Pix. E o provedor escolhido aqui não muda o cartão: a seção "Cartao de Credito" da mesma página sempre usa o Mercado Pago.

O erro que todo mundo comete é salvar a chave e nunca abrir uma fatura de teste. Abra a fatura de um cliente e veja o QR aparecer antes de ligar a cobrança automática.

"Provedor PIX Ativo" e "Provedor para Clientes Novos"

O bloco "Provedor PIX Ativo" tem quatro botões: Mercado Pago, FastDePix, Asaas e AtivoPay. O selecionado gera os novos códigos. Mercado Pago está sempre disponível; os outros três só destravam depois que a chave da aba correspondente foi salva e validada.

Logo abaixo, "Provedor para Clientes Novos" começa em "Mesmo do padrao". Se você escolher outro, ele vale para quem ainda não tem nenhum Pix aprovado com você; depois do primeiro pagamento confirmado, o cliente passa ao provedor ativo. Exemplo: a PlayHub mantém a base no Mercado Pago e manda os clientes novos para a AtivoPay.

A troca vale para códigos gerados dali em diante. Um QR que já estava na tela de um cliente continua sendo conferido no provedor que o criou.

Mercado Pago: contas, credenciais e "Modo de Distribuicao"

Na aba "Mercado Pago", clique em "Configurar Conta" (ou "Adicionar Conta", quando já existe uma). O card "Como obter suas credenciais" resume o caminho: entre em mercadopago.com.br/developers, clique em "Suas aplicacoes", crie uma aplicação selecionando CHECKOUT PRO e, em "Credenciais de producao", copie o Access Token. Outras opções de aplicação não funcionam.

A janela "Nova Conta Mercado Pago" tem estes campos:

• "Nome da Conta": só para você identificar.
• "Access Token": começa com APP_USR. Ao salvar, o sistema testa o token no Mercado Pago. Se passar, o card da conta mostra "Ativa"; se não, "Inativa" com o motivo.
• "Public Key": necessária para cartão. Se você não preencher, o sistema tenta buscar sozinho.
• "Assinatura Secreta (Webhook)": recomendado. Na sua aplicação, aba Webhooks, modo de produção, cole a URL https://gestorflow.com.br/api/webhooks/mercadopago, marque os eventos "Pagamentos" e "Planos e assinaturas" e copie a "Assinatura secreta" para este campo.

Você pode cadastrar várias contas. "Contas Ativas" mostra quantas passaram na validação, e o "Modo de Distribuicao" decide qual recebe cada Pix gerado. Ele só entra em ação com duas ou mais contas ativas; até lá o card mostra a etiqueta "Requer 2+ contas" e tudo vai para a única conta. Os modos:

• "Sequencial": a cada código, a próxima conta da fila.
• "Aleatorio": sorteia uma conta a cada pagamento.
• "Porcentagem": cada conta ganha um "Peso de Distribuicao (%)" na janela de edição. Com 80 e 20, a primeira recebe cerca de quatro em cada cinco Pix. Sem peso em nenhuma conta, vira sorteio.

FastDePix: API Key, valor mínimo, CPF do titular e estorno

Na aba "FastDePix", o card "Status FastDePix" mostra "Nao Configurado" até você salvar. Cole a chave em "API Key" e clique em "Salvar". Ela precisa começar com fdpx_, é testada na API da FastDePix e o webhook é registrado sozinho. O card "Como obter sua API Key" mostra o caminho no painel deles: "Gerenciar Chaves API", "Criar Nova Chave API", um nome e copiar a chave, que é exibida uma vez só.

Três regras da FastDePix aparecem na fatura:

• Valor mínimo de R$ 10,00 por transação. Abaixo disso a fatura recusa com "FastDePix requer valor minimo de R$ 10,00". Os planos da PlayHub começam em R$ 29,90, então passam.
• Acima de R$ 100,00, a fatura pede nome e CPF ou CNPJ de quem vai pagar antes de gerar o código. O Anual de R$ 299,90 pede; o Mensal de R$ 29,90 sai sem documento.
• O Pix precisa sair de uma conta desse titular. Se sair de outro CPF, o pagamento fica em análise e o valor volta para quem pagou em até 24 horas. A fatura explica isso e oferece "Gerar novo Pix com o CPF certo".

Asaas

A aba "Asaas" segue o mesmo desenho: "Status Asaas", campo "API Key" (a chave começa com $aact_) e "Salvar". A chave sai de "Minha Conta", depois "Integracoes", botão "Gerar chave de API". Antes de cobrar, cadastre uma chave Pix na sua conta Asaas: sem ela o QR não é gerado.

Ao salvar, o Flow Gestor registra o webhook na sua conta Asaas. Se não conseguir, ele avisa que o cadastro precisa ser feito à mão. Com a chave salva, a aba passa a mostrar o card "Webhook" com "URL" e "Token de autenticacao", que é o que você cola no painel do Asaas nesse caso.

Duas diferenças. Toda cobrança no Asaas fica vinculada a um cliente com CPF ou CNPJ, então a fatura sempre pede o documento do titular, em qualquer valor. E o QR não expira junto com o vencimento: continua pagável, e o pagamento é confirmado quando cair.

AtivoPay

Na aba "AtivoPay", cole a chave gerada na área de API do painel da AtivoPay em "API Key" e clique em "Salvar". Não há prefixo fixo: quem valida é a própria API. Também não há webhook para cadastrar, porque o endereço de aviso vai dentro de cada cobrança. Como no Asaas, cadastre uma chave Pix na conta antes de cobrar.

O cliente paga sem informar CPF. Em compensação, o código expira de verdade em 1 dia; depois disso ele gera outro na fatura. Enquanto o código atual vale, a fatura devolve o mesmo em vez de criar um segundo.

Webhook e conferência de pagamentos pendentes

Como o sistema sabe que o Pix caiu? Por três caminhos que se cobrem:

1. O webhook do provedor, o aviso mais rápido. No Mercado Pago você cadastra a URL na aplicação; na FastDePix e no Asaas o registro é automático; na AtivoPay ele vai em cada cobrança.
2. A própria fatura. Aberta na tela, ela confere o status a cada 5 segundos nos primeiros 3 minutos e a cada 15 segundos depois, e na hora quando o cliente volta do aplicativo do banco. Essa conferência consulta o provedor de novo.
3. A conferência de pendentes. A cada 2 minutos, uma rotina revisa os Pix pendentes criados entre 1 minuto e 24 horas atrás, os mais antigos primeiro, 50 por vez.

Nenhum aviso vira fatura paga sem autenticação: assinatura no Mercado Pago (com a "Assinatura Secreta (Webhook)" preenchida) e na FastDePix, token no Asaas, e reconsulta na API do provedor no Mercado Pago e na AtivoPay.

"Mensagem de confirmacao de pagamento"

Na aba "Mercado Pago" existe o card "Mensagem de confirmacao de pagamento" com o botão "Configurar". Ele leva à página WhatsApp, bloco "Por onde suas mensagens saem", seção "Confirmação de pagamento". Ali você escolhe "Qual mensagem enviar" entre suas mensagens cadastradas, ou "Não enviar confirmação", e em "Por qual canal" define se ela sai pelo envio comum, pela API Oficial ou pelo WhatsApp QR. Vale para todos os meios de pagamento, assim que o pagamento cai.

"Link da Area do Cliente"

No topo da página fica o "Link da Area do Cliente", no formato https://gestorflow.com.br/cliente/playhub/login. Por padrão o trecho do meio é um código longo; clique nele para trocar por um nome curto, de 3 a 30 caracteres, só letras minúsculas, números e hífens. "Salvar" grava, "Cancelar" fecha sem mudar nada, "Voltar para UUID" apaga o nome curto e devolve o código longo, e "Copiar link para compartilhar" copia o endereço final.

O cliente entra com o "Usuário" e a "Senha" que você preencheu ao cadastrar o cliente e vê a fatura em aberto com o botão "Pagar" e o valor.

Qual provedor escolher

	Mercado Pago	FastDePix	Asaas	AtivoPay
Documento do titular	Não pede	Acima de R$ 100,00	Sempre	Não pede
Valor mínimo no sistema	Nenhum	R$ 10,00	Nenhum	Nenhum
Código após o prazo	Expira	Segue o status da FastDePix	Continua pagável	Expira em 1 dia
Webhook	Cadastro manual	Automático	Automático, manual se falhar	Vai em cada cobrança

Se você já recebe no Mercado Pago e quer cartão junto, comece por ele; é o único com várias contas em rodízio. Se quer que o cliente pague sem digitar CPF e sem criar aplicação, a AtivoPay é o caminho mais curto. Asaas amarra toda cobrança ao CPF do titular; a FastDePix faz o mesmo acima de R$ 100,00.

Erros comuns

• Criar a aplicação do Mercado Pago sem escolher CHECKOUT PRO.
• Conta sem chave Pix cadastrada. No Mercado Pago o cliente vê "O vendedor ainda nao cadastrou uma chave PIX no Mercado Pago"; no Asaas e na AtivoPay o QR não é gerado.
• Plano abaixo de R$ 10,00 com FastDePix como provedor ativo.
• Cliente pagou o Pix da FastDePix ou do Asaas com a conta de outra pessoa. O valor volta e a fatura segue em aberto.
• Pagamento caiu e o cliente não recebeu nada: a confirmação ficou em "Não enviar confirmação".

Perguntas frequentes

Posso usar dois provedores ao mesmo tempo?

Um provedor ativo e, se quiser, outro em "Provedor para Clientes Novos" para quem ainda não pagou nenhum Pix. No Mercado Pago dá para ter várias contas em rodízio.

O cliente precisa ter conta no provedor?

Não. Ele paga pelo aplicativo de qualquer banco, escaneando o QR ou colando o código. Só na FastDePix (acima de R$ 100,00) e no Asaas ele informa nome e CPF ou CNPJ do titular antes.

Escolher Asaas ou AtivoPay muda o cartão de crédito?

Não. O cartão é sempre processado pelo Mercado Pago e precisa de uma conta com "Public Key" preenchida. Veja cartão de crédito e renovação automática.

Posso remover a chave de um provedor?

O Asaas não deixa remover enquanto for o provedor ativo: troque antes. Na FastDePix e na AtivoPay, se eram o provedor ativo, o sistema volta ao Mercado Pago ao remover.

Próximos passos

• A fatura que o cliente recebe
• Pix caiu: confirmação, renovação no painel e mensagem automática
• Cartão de crédito e renovação automática
• Cobrar pelo chatbot: 2ª via e renovação pelo WhatsApp
• Hub: cobrança automática, do cadastro ao Pix na conta