Para integrar um sistema de pagamento no site, você contrata um gateway de pagamento, escolhe entre o checkout pronto dele ou a integração direta pela API, e programa o seu sistema para receber a confirmação do pagamento por webhook. Pix, cartão e boleto passam pelo mesmo gateway; o que muda é o fluxo de cada um e o cuidado com os dados do cliente.
Parece simples, e em parte é. O que trava a maioria das integrações não é chamar a API, mas o que acontece depois: pedido pago que não baixa no estoque, boleto vencido que continua em aberto, Pix confirmado duas vezes. Abaixo está o caminho completo, do que decidir antes de escrever a primeira linha de código até os testes que evitam prejuízo no primeiro dia de venda.
O que é um gateway de pagamento e por que você precisa de um?
O gateway de pagamento é o intermediário técnico entre o seu site e o sistema financeiro. Ele recebe os dados do pagamento, conversa com a bandeira do cartão, com o banco emissor ou com o arranjo do Pix, e devolve para o seu sistema uma resposta: aprovado, recusado, pendente.
Sem um gateway, você teria que se credenciar com cada adquirente, assumir sozinho as exigências de segurança de dados de cartão e manter integrações separadas para cada forma de pagamento. Para quase todo negócio, isso não compensa. O gateway concentra tudo em uma API só e, em muitos casos, também atua como intermediador, recebendo o dinheiro e repassando para a sua conta.
Na prática, você vai encontrar três tipos de solução no mercado brasileiro:
- Intermediadores com checkout pronto, como Mercado Pago e PagSeguro/PagBank. Cadastro rápido, pouca exigência técnica, boa opção para começar.
- Gateways com foco em API, como Pagar.me e Stripe. Mais controle sobre a experiência de compra e sobre as regras de cobrança, mais trabalho de integração.
- Plataformas de cobrança recorrente, como Asaas e similares. Fortes em boleto, Pix e assinaturas, com emissão de cobrança e régua de lembretes.
Os nomes acima são exemplos, não recomendação. Taxas, prazos de recebimento e condições mudam com frequência e variam por volume e segmento: consulte as taxas atuais na página oficial de cada um antes de decidir e, se possível, negocie.
Quais formas de pagamento integrar no site?
A resposta depende de quem compra de você, mas no Brasil três formas de pagamento cobrem a grande maioria das vendas online. Cada uma tem um comportamento diferente na integração, e é isso que você precisa entender antes de escolher o gateway.
| Forma de pagamento | Como a confirmação chega | Ponto de atenção na integração |
|---|---|---|
| Pix | Em segundos, por webhook do gateway | QR Code com prazo de expiração e conciliação automática do valor pago |
| Cartão de crédito | Na hora, na resposta da API (com análise antifraude em alguns casos) | Tokenização, parcelamento, estorno e chargeback |
| Cartão de débito | Na hora, geralmente com autenticação do banco | Fluxo de autenticação 3DS, que pode redirecionar o cliente |
| Boleto | Dias depois, quando o banco compensa | Pedido fica pendente; precisa de regra para vencimento e cancelamento |
| Pix Automático / recorrência | A cada cobrança, por webhook | Autorização prévia do pagador e tratamento de falhas |
Pix
O Pix é o meio de pagamento instantâneo criado pelo Banco Central do Brasil, lançado oficialmente em novembro de 2020 e disponível 24 horas por dia, todos os dias. Para o seu site, isso significa confirmação quase imediata e nenhum risco de chargeback como no cartão.
Na integração, o gateway gera uma cobrança com QR Code e código copia e cola, com prazo de validade. Quando o cliente paga, o gateway avisa o seu sistema. Seu trabalho é garantir que o pedido seja liberado só depois desse aviso, e não quando o cliente clica em "já paguei".
Para assinaturas e mensalidades, existe o Pix Automático, que começou a funcionar em junho de 2025: o cliente autoriza uma vez e as cobranças seguintes acontecem sem nova confirmação. Verifique se o gateway escolhido já oferece esse recurso, porque nem todos oferecem.
Cartão de crédito e débito
O cartão continua sendo o meio preferido para compras parceladas e para assinaturas. É também a forma de pagamento que mais exige cuidado: envolve dados sensíveis, análise antifraude, parcelamento com ou sem juros, estornos e contestações (chargeback).
O ponto central é a tokenização. Em vez de o número do cartão passar pelo seu servidor, o formulário do gateway, ou a biblioteca JavaScript dele, envia os dados direto para o gateway e devolve um token. É esse token que o seu sistema usa para cobrar. Assim, você nunca armazena nem trafega o número do cartão, o que reduz muito a sua responsabilidade de segurança.
Boleto
O boleto ainda é usado por quem não tem cartão ou não quer usar crédito, e é comum em vendas entre empresas. A diferença para a integração é o tempo: a confirmação só chega depois que o banco compensa o pagamento, o que pode levar dias úteis. Seu sistema precisa saber manter um pedido como pendente, reservar ou não o estoque, e cancelar automaticamente o que vencer sem pagamento.
Checkout pronto ou integração via API?
Essa é a decisão que mais influencia o custo e o prazo da integração. Existem basicamente três caminhos, e nenhum é melhor em todos os casos.
| Modelo | Como funciona | Quando faz sentido |
|---|---|---|
| Link ou botão de pagamento | O cliente é enviado para uma página do gateway | Poucas vendas, catálogo pequeno, validar a ideia |
| Checkout hospedado ou embutido | Página ou componente pronto do gateway, com a sua marca | Loja virtual que quer rapidez e segurança sem desenvolver o formulário |
| Checkout transparente (via API) | O cliente paga dentro do seu site; o gateway tokeniza os dados do cartão | Quando a experiência de compra e a conversão justificam o desenvolvimento |
Se você usa uma plataforma de loja pronta, normalmente basta instalar o plugin ou módulo do gateway e configurar as chaves. Se o site ou sistema é feito sob medida, a integração passa pela API, e aí entram as decisões de arquitetura descritas a seguir.
Como integrar o sistema de pagamento, passo a passo
Com o gateway escolhido e o modelo de checkout definido, o trabalho técnico segue uma ordem previsível. Pular etapas é o que gera retrabalho depois.
- Crie a conta e valide o cadastro. O gateway pede dados da empresa e conta bancária para repasse. A aprovação pode levar alguns dias; comece por aqui.
- Obtenha as credenciais de teste e de produção. Guarde as chaves secretas no servidor, em variável de ambiente, nunca no código que vai para o navegador ou para o repositório.
- Modele o pedido no seu sistema. Defina os estados (aguardando pagamento, pago, cancelado, estornado) e o que cada um libera: estoque, nota fiscal, acesso, envio.
- Crie a cobrança pela API. O seu servidor envia valor, itens, cliente e forma de pagamento; o gateway devolve o identificador da transação, o QR Code do Pix ou a linha digitável do boleto.
- Implemente o webhook. É o endereço do seu sistema que o gateway chama quando o status muda. É ele, e não a tela de "obrigado", que deve confirmar o pagamento.
- Trate os casos ruins. Cartão recusado, Pix expirado, boleto vencido, estorno, chargeback, cliente que paga duas vezes. Cada um precisa de uma ação definida.
- Teste no ambiente de testes (sandbox). Todo gateway oferece cartões e cenários de teste. Simule aprovação, recusa e atraso antes de virar a chave.
- Publique e acompanhe. Nos primeiros dias, confira manualmente se cada venda no painel do gateway bateu com um pedido pago no seu sistema.
O que é webhook e por que ele importa tanto?
O webhook é a forma de o gateway avisar o seu sistema que algo aconteceu: um Pix foi pago, um boleto compensou, um cartão foi estornado. Sem webhook, o seu site depende de o cliente voltar para a página certa, o que não acontece sempre. Ele fecha a aba, a internet cai, o pagamento do boleto é feito três dias depois.
A documentação de webhooks da Stripe resume bem as boas práticas, que valem para qualquer gateway:
- Verifique a origem. Confira a assinatura ou o token que o gateway envia em cada aviso. Sem isso, qualquer pessoa pode chamar o seu endereço e "pagar" um pedido.
- Responda rápido. Devolva o código de sucesso logo que receber e processe o restante em segundo plano, para o gateway não considerar a entrega como falha.
- Prepare-se para avisos repetidos. O mesmo evento pode chegar mais de uma vez. Registre os identificadores já processados para não liberar o mesmo pedido duas vezes.
- Não conte com a ordem. Os eventos podem chegar fora de sequência. Na dúvida, consulte o status atual da transação na API antes de agir.
Como garantir a segurança dos pagamentos no site?
Quem armazena, processa ou transmite dados de cartão está sujeito ao PCI DSS, o padrão de segurança do setor de cartões de pagamento. Cumprir o padrão inteiro é caro e trabalhoso; por isso a recomendação prática é reduzir ao máximo o contato do seu sistema com esses dados.
- Use a tokenização do gateway. O número do cartão vai do navegador direto para o gateway. Seu servidor só vê o token.
- Nunca guarde número de cartão ou código de segurança em banco de dados, log ou planilha, nem para "facilitar a próxima compra". Para isso existe o cartão salvo no próprio gateway.
- Site inteiro em HTTPS, com certificado válido, e não apenas a página de pagamento.
- Chaves de API no servidor, com acesso restrito e troca periódica.
- Antifraude ligado nas vendas com cartão, com regras revisadas conforme o seu perfil de venda.
- Dados pessoais tratados conforme a LGPD: colete só o necessário para cobrar e entregar.
Integrar o pagamento com o resto da operação
O pagamento confirmado é o começo de outros processos. Em uma operação organizada, ele dispara a baixa no estoque, a emissão da nota fiscal, a liberação do envio ou do acesso e o lançamento no financeiro. Se cada uma dessas etapas depende de alguém copiar dados de uma tela para outra, o gargalo só mudou de lugar.
Por isso, em sistemas sob medida, a integração com o gateway costuma andar junto com a integração com ERP, emissor de nota e logística. É esse tipo de trabalho que fazemos em integração de sistemas, com projetos a partir de R$ 15.000. Quando o problema é o site em si, lento, sem checkout próprio ou difícil de manter, o ponto de partida é o desenvolvimento de sites; e quando a regra de cobrança é muito específica, como planos, comissões e repasses entre vendedores, o caminho é desenvolvimento de software sob medida.
Erros comuns ao integrar formas de pagamento no site
- Confirmar o pedido na página de retorno em vez de esperar o webhook. Funciona no teste e falha em produção.
- Não tratar o boleto vencido. O estoque fica reservado para sempre e o relatório de vendas mente.
- Misturar chaves de teste e de produção, ou publicar o site ainda apontando para o sandbox.
- Ignorar o estorno e o chargeback. O dinheiro sai, mas o pedido continua marcado como pago.
- Esconder o custo total. Frete, juros do parcelamento e taxas devem aparecer antes do botão de pagar; surpresa no checkout derruba a conversão.
- Formulário longo demais. Peça só os dados que o gateway e a nota fiscal exigem.
- Não conciliar. Sem comparar periodicamente o painel do gateway com os pedidos, divergências só aparecem no fechamento do mês.
Quanto tempo e quanto custa integrar um gateway de pagamento?
Depende muito do ponto de partida. Em uma loja virtual de plataforma pronta, instalar o módulo oficial do gateway e configurar Pix, cartão e boleto pode ser questão de dias, a maior parte esperando a aprovação do cadastro.
Em sistema próprio, o esforço cresce com o que vem junto: checkout transparente, recorrência, divisão de pagamento entre vendedores, integração com ERP e nota fiscal. Nesses casos, vale começar com um escopo fechado, que liste os fluxos de pagamento, os estados do pedido e os sistemas envolvidos, antes de pedir qualquer orçamento. Na Devuptime, as entregas acontecem em geral a cada 15 dias, o código é do cliente e a garantia é definida em contrato, com padrão de 90 dias.
Perguntas frequentes
Preciso de CNPJ para integrar um sistema de pagamento?
Muitos intermediadores aceitam pessoa física para começar, mas recursos como checkout transparente, boleto registrado com a sua marca e condições comerciais melhores costumam exigir CNPJ e análise de cadastro. Confira os requisitos no site do gateway.
Posso usar mais de um gateway ao mesmo tempo?
Pode. Algumas empresas usam um gateway para cartão e outro para Pix e boleto, ou mantêm um segundo como alternativa em caso de instabilidade. O custo é a complexidade: mais integrações, mais painéis e mais conciliação.
Qual é o gateway de pagamento mais barato?
Não existe resposta fixa. A taxa muda por forma de pagamento, prazo de recebimento, volume e negociação. Compare o custo total, incluindo antecipação e taxas por transação, com base nas tabelas oficiais atuais de cada empresa.
Integrar pagamento no aplicativo é diferente do site?
A lógica é a mesma: gateway, tokenização e webhook no servidor. A diferença está nas regras das lojas de aplicativos para venda de conteúdo e serviços digitais dentro do app, que podem exigir o sistema de compras da própria loja. Para produtos físicos e serviços prestados fora do app, o gateway funciona normalmente.
O Pix precisa de integração com o banco?
Não necessariamente. O gateway ou intermediador já está conectado ao Pix e entrega a cobrança pronta pela API. A integração direta com a API Pix de um banco é possível, mas faz mais sentido para volumes grandes ou necessidades específicas de conciliação.
Por onde começar
Liste as formas de pagamento que o seu cliente realmente usa, defina o que deve acontecer quando um pagamento é aprovado, recusado ou estornado, e só então compare gateways. Com essas respostas no papel, integrar o sistema de pagamento deixa de ser uma aposta e vira um projeto com prazo e escopo claros.
