Eu sou o Dante Testa e, neste passo a passo, vou te mostrar exatamente como eu criei uma landing page funcional, com botão de compra, checkout simplificado e integração automática com PIX usando a Pagou — tudo com a ajuda de uma ferramenta de inteligência artificial do windsurf editor que me auxiliou a gerar o projeto em PHP e ainda automatizou a edição dos arquivos. Se você quer vender e-books, infoprodutos ou qualquer arquivo digital e deixar o processo no piloto automático, esse guia prático é para você.
O que você vai aprender
- Como estruturar uma landing page simples com botão de compra;
- Como criar uma tela de checkout para coletar nome, e-mail e CPF;
- Como integrar a geração de código PIX via Pagou e monitorar o status do pagamento;
- Como liberar automaticamente um arquivo para download após a confirmação do pagamento;
- Como testar o fluxo com um valor mínimo (R$5) para não gastar muito em testes;
- Como subir o projeto para um servidor (usei Napoleon Host) via FTP direto da ferramenta de edição;
- Dicas extras para evoluir o checkout com notas fiscais, integração via CEP e campos adicionais.
Por que usar Pagou?
A Pagou é uma solução simples para integrar pagamentos por PIX e boleto. No momento do tutorial ela não oferecia cartão de crédito, mas para quem quer automatizar vendas de produtos digitais via PIX a Pagou é uma opção muito prática. A integração é simples e, com a documentação certa, você consegue fazer tudo funcionar de primeira.
Um ponto importante: a chave API da Pagou só aparece depois que você conclui o cadastro e envia os documentos exigidos pela plataforma. Sem isso, você não consegue gerar transações via API.
Ferramentas usadas
- Editor com IA (no meu fluxo eu usei o editor com plugin de inteligência artificial, selecionei “Claude Sonnet 4.5 Promo” como modelo)
- Pagou para geração de PIX e controle de pagamentos
- Servidor de hospedagem (usei Napoleon Host)
- Extensão FTP no editor para subir arquivos diretamente ao servidor
- PHP para a lógica do back-end
Visão geral do fluxo
- Usuário chega na landing page e vê o produto (nome, imagem, preço) e clica em Comprar;
- Usuário é direcionado ao checkout onde preenche nome, e-mail e CPF;
- No checkout o usuário clica em Gerar PIX — o sistema chama a API da Pagou e cria um PIX temporário;
- O cliente faz o pagamento via QR Code ou copiando a chave PIX;
- O sistema monitora o retorno da Pagou para verificar se o PIX foi confirmado;
- Se o pagamento for confirmado, o sistema libera automaticamente o download do arquivo (e-book, etc.).
Preparando o ambiente local
Primeiro passo: crie uma pasta no seu computador para conter o projeto. Eu criei uma pasta chamada LPX — pode chamar do jeito que você quiser. Abra essa pasta na sua ferramenta de edição com IA.
No editor eu uso o painel com duas áreas: Code (para codar) e Chat (para interagir com a IA). Coloquei no modo Code e, no chat com IA, solicitei que a ferramenta criasse a estrutura da landing page e do checkout em PHP. Você também pode abrir o seu projeto HTML já existente e pedir para a IA apenas integrar o botão de compra com o checkout e a API Pagou.
Estrutura básica de arquivos
A IA me forneceu a estrutura inicial com arquivos como:
- index.php (ou index.html com integração para redirecionar ao checkout)
- checkout.php (formulário de nome, e-mail e CPF e botão gerar PIX)
- api/pagamento.php (classe/rotina para chamar a API da Pagou e gerar PIX)
- webhook.php (endpoint para receber notificações ou polling para checar status do pagamento)
- config.php (onde fica a chave da API da Pagou, preço do produto, caminho do arquivo de download, etc.)
- pasta downloads/ (onde você coloca o arquivo a ser liberado após pagamento)
- assets/ (imagens e demais recursos visuais)
Documentação no GitHub e como usá-la
Eu preparei uma documentação simples no GitHub descrevendo os endpoints da Pagou e como montar as requisições. No meu fluxo eu colei esse link da documentação no editor e pedi para a IA ler e executar com base nela — a IA leu, montou um to-do list e começou a criar os arquivos em PHP seguindo as regras daquela documentação.
Ter uma documentação bem feita acelera tudo. Se você não tem um doc preparado, pode usar a documentação oficial da Pagou e ajustar os parâmetros no config.php do projeto.
Configurando a chave API da Pagou
Depois que a IA montou o projeto, ao testar no servidor local a geração do PIX retornou erro — isso porque eu ainda não havia colocado a chave da API. Para obter essa chave, faça o cadastro na Pagou, envie os documentos e, depois que sua conta estiver verificada, a chave aparecerá no painel.
Copie o token e coloque no arquivo config.php ou no local indicado pelo projeto. A IA pode alterar esse arquivo para você se você mandar o token por mensagem — no meu caso eu falei ao editor: “Essa é a minha chave de API da Pagou. Edita para mim o arquivo.” A IA inseriu a chave no config. Feito isso, ao gerar o PIX o sistema já retornou um payload válido.
Teste com valor mínimo (R$5)
Importante: para testar sem gastar muito eu alterei o preço do produto para R$5. Fazer isso é simples — basta editar o valor no config ou instruir a IA para alterar o preço.
A Pagou aceita transações de valores baixos, então use R$5 como valor de teste para simular todo o fluxo e confirmar que, após o pagamento, o arquivo é liberado. Eu já fiz o teste de produção direto e o dinheiro cai na conta, então é bom usar um valor pequeno se for só para validar.
Colocando o arquivo de download
O arquivo que será liberado pós-pagamento precisa estar dentro da pasta downloads do projeto. Nos testes eu arrastei meu e-book para dentro da pasta downloads no projeto. Em seguida pedi para a IA editar o config para apontar para esse arquivo — ela alterou o caminho e tudo ficou pronto.
Se quiser, proteja o arquivo com um token temporário ou gere links exclusivos para cada compra. No exemplo básico que eu mostrei, o arquivo está disponível após a confirmação do pagamento e o link é servido pelo próprio back-end em PHP, que valida se a transação foi confirmada.
Melhorando a aparência: adicionando imagem do produto
Para deixar a landing page mais atrativa, peguei a URL de uma imagem do meu site, pedi para a IA baixar a imagem, colocá-la na pasta assets e inserir a referência na hero section. A IA fez todo esse processo: baixou a imagem, salvou localmente e editou o código HTML para mostrar a foto no hero.
Você também pode usar imagens locais ou recursos do envato/flipik, caso tenha assinatura ou créditos. No Napoleon Host, por exemplo, existem benefícios que oferecem downloads diários de recursos — ótimo para quem cria materiais visuais.
Rodando localmente e preview
Depois que os arquivos foram gerados, usei a função de preview do editor para subir um servidor local. Às vezes o preview dá problemas (ele avisa que é necessário dar run), mas, no geral, dá para ver a página funcionando, clicar em Comprar, ser levado para o checkout e gerar o PIX.
No checkout preenchi nome, e-mail e CPF e gerei o PIX. Se tudo estiver configurado, você verá o QR Code e a informação para pagamento aparecer na tela. Nesse momento você pode escanear com seu app de banco e pagar de verdade para testar o processo de confirmação e liberação do arquivo.
Monitorando o pagamento: webhook vs polling
Existem duas formas comuns de detectar que o PIX foi pago:
- Webhook: a Pagou envia uma notificação para o seu endpoint quando o pagamento for confirmado.
- Polling: seu servidor consulta periodicamente a API da Pagou para verificar o status da transação.
No projeto básico eu usei uma rotina que monitora o retorno da Pagou (pode ser webhook ou polling conforme a documentação). Quando o status muda para pago/confirmed, o PHP libera o link para download. Se você quer escalabilidade, prefira webhook, pois é mais eficiente e em tempo real.
Subindo para o servidor (Napoleon Host)
Depois de testar localmente, é hora de colocar a landing page no ar. Eu usei a Napoleon Host e criei um subdomínio para o projeto (ex: ebook.dantflix.com.br). Em seguida, gerei uma conta FTP associada a esse subdomínio.
No painel da Napoleon Host você configura o diretório raiz do usuário FTP para apontar exatamente para a pasta do subdomínio. Copie os dados da conta FTP (host, usuário, senha, porta) e volte ao editor onde instalei uma extensão de FTP.
Configuração do FTP no editor
- Instale a extensão FTP do editor;
- Crie uma configuração nova (nomeie como quiser, por exemplo “ebook”);
- Escolha o tipo “FTP” e cole os dados que copiou do painel da hospedagem;
- Salve e teste a conexão;
- Ao conectar, faça upload de todos os arquivos do projeto para a pasta do subdomínio.
Com tudo enviado, acesse a URL do subdomínio para verificar se a página carregou. Clique no botão comprar, gere o PIX e faça o teste. A lógica que funcionou localmente geralmente funciona também no servidor se todas as variáveis e a chave da API estiverem corretamente configuradas.
Testando na produção
Eu fiz dois testes reais: primeiro no meu ambiente local e depois já no subdomínio hospedado na Napoleon Host. Para verificar o processo final eu escaneei o QR Code com o celular e paguei. Em poucos instantes a Pagou confirmou o pagamento e o sistema liberou o botão de download do e-book. Foi uma demonstração prática de vender no piloto automático.
Dicas avançadas e possibilidades de evolução
O fluxo que mostrei é básico, ideal para quem quer vender e-books ou arquivos digitais rapidamente. Mas dá para evoluir muito:
- Adicionar mais campos no checkout (WhatsApp, endereço, opção de pessoa jurídica/CNPJ);
- Integração com ViaCEP para preenchimento automático do endereço;
- Gerar nota fiscal automaticamente (integração com serviços de NF-e ou emissão por API);
- Gerar links de download temporários e exclusivos para cada compra;
- Adicionar controle de acesso e área do cliente para permitir re-download;
- Enviar e-mail automático com link do produto após confirmação do pagamento;
- Implementar segurança extra (assinatura HMAC, verificação de IP dos webhooks, tokens expirados).
Se você quiser um checkout mais completo com emissão de nota, integração com serviços de CEP e verificação de CNPJ, dá para montar isso. Só demora mais tempo e envolve outras APIs. Eu ensino esse tipo de integração em vídeos exclusivos para membros e em consultorias VIP.
Segurança e boas práticas
Algumas recomendações importantes para colocar em produção:
- Nunca exponha sua chave de API em repositórios públicos. Use variáveis de ambiente ou arquivos de configuração fora do alcance do público;
- Valide todos os dados recebidos do cliente e da API antes de liberar o download;
- Use HTTPS no seu servidor para proteger a troca de dados;
- Se usar webhook, valide a origem para evitar chamadas falsificadas;
- Evite armazenar arquivos sensíveis em pastas públicas sem proteção;
- Considere gerar links expiráveis para downloads;
- Implemente logs para monitorar erros e falhas nas integrações.
Problemas comuns e como resolver
Algumas dores que você pode encontrar e como resolvê-las:
- API retorna erro: verifique se o token está correto e se a conta da Pagou está ativa e verificada;
- PIX não aparece no app do banco: verifique se os dados do QR Code estão corretos e se o payload foi gerado adequadamente;
- Webhook não é recebido: confirme se o endpoint está público e acessível (sem autenticação que bloqueie a Pagou); use ferramentas como ngrok para testes locais;
- Arquivo não é liberado: analise os logs do servidor e verifique se o status retornado pela Pagou foi tratado corretamente pelo seu script;
- Upload FTP falha: confirme credenciais, pasta destino e permissões na hospedagem.
Por que essa solução é poderosa?
Porque permite que você venda sem precisar operar manualmente a cada pedido. A jornada é automática: visitante entra, compra, paga e recebe o produto sem intervenção humana. Para quem tem muitos infoprodutos, e-books ou materiais digitais, ter esse fluxo é transformar vendas em processo escalável.
Além disso, com a ajuda da inteligência artificial eu consegui acelerar bastante a montagem do projeto: a IA gerou arquivos, editou configurações, baixou imagens e até configurou o arquivo de FTP no meu ambiente — tudo com instruções simples no chat.
Oferta de suporte e cursos
Se você preferir que eu te ajude diretamente, ofereço consultoria VIP via WhatsApp (link disponível na descrição dos meus materiais). Também tenho cursos e conteúdos pagos que aprofundam integração com APIs, WordPress, Elementor, JetEngine e outras ferramentas para criadores e desenvolvedores.
Para quem quer aprender a fazer esses fluxos com segurança e qualidade, recomendo acompanhar os conteúdos semanais que eu publico e considerar a área de membros para acesso a vídeos exclusivos com passo a passo detalhado.
Checklist rápido para montar sua landing page com PIX via Pagou
- Criar pasta do projeto e abrir no editor (com IA, se preferir);
- Gerar estrutura: index, checkout, api/pagamento.php, webhook.php, config.php, pasta downloads;
- Fazer cadastro na Pagou e enviar documentos para obter token API;
- Inserir token no config.php;
- Adicionar arquivo de download na pasta downloads e apontar no config;
- Adicionar imagem do produto em assets e referenciar na hero;
- Testar localmente: gerar PIX, escanear QR Code e pagar;
- Configurar FTP no painel da hospedagem e subir arquivos;
- Testar no ambiente de produção com valor mínimo (R$5);
- Ajustar segurança, logs e webhooks conforme necessário.
Exemplo de fluxo técnico (resumido)
- Usuário envia formulário no checkout -> POST para pagamento.php;
- pagamento.php chama a API da Pagou com os dados e cria cobrança PIX -> retorna QR Code e ID da cobrança;
- Mostra na tela o QR Code para o usuário;
- Webhook ou polling detecta alteração de status para “pago” -> server marca a compra como confirmada;
- Servidor gera link de download ou libera botão de download na tela;
- Usuário baixa o arquivo.
Conclusão
Se você queria uma forma prática e rápida de vender e-books e outros produtos digitais por PIX, a combinação Pagou + um back-end em PHP + IA para acelerar a criação do projeto resolve muito bem. Em poucas horas você pode ter um fluxo completamente automático: landing page, checkout, pagamento por PIX e entrega do produto.
Com documentos e chaves bem configuradas, tudo funciona de primeira. Use R$5 para testar, proteja suas chaves, implemente webhooks e, se quiser evoluir para notas fiscais e integrações mais completas, vá adicionando APIs como ViaCEP e serviços de emissão de nota fiscal.
Se tiver dúvidas, quer que eu revise seu código ou montar isso ao seu lado, me chama no WhatsApp para uma consultoria VIP. Se curtiu o conteúdo, deixe um like, comente e considere se tornar membro para acessar vídeos exclusivos com integrações e automações avançadas. Boa sorte no seu projeto e boas vendas!
Contato/Recursos: Para suporte e consultoria entre em contato pelo WhatsApp. Se quiser a documentação que usei como base, eu a disponibilizei e ela facilita demais a integração com a Pagou.
