O que é um gateway de pagamentos PIX
Um gateway de pagamentos PIX é a camada de software que conecta o checkout da sua loja online ao Banco Central, aos adquirentes e à rede SPI. Quando alguém compra no seu site e escolhe pagar com PIX, é o gateway que gera o QR Code dinâmico em milissegundos, monitora a confirmação do pagamento na infraestrutura do Bacen e dispara um webhook para o seu servidor liberar o pedido — tudo isso em segundos, sem você precisar lidar com homologação DICT, certificado ICP-Brasil ou conformidade direta com o Banco Central.
Tecnicamente, um gateway moderno entrega quatro coisas: uma API REST para criar cobranças, webhooks assinados para notificar mudanças de status, um painel de gestão para acompanhar volume e conciliação, e infraestrutura de retentativas para garantir que nenhuma notificação se perca. Sem isso, sua loja vira refém de bugs operacionais, fila de suporte e reconciliação manual.
Como funciona o fluxo PIX no checkout
O fluxo completo de uma cobrança PIX num gateway moderno tem 6 etapas e roda em segundos:
- Sua loja chama a API com o valor em centavos, dados do cliente e um
external_idúnico do pedido. - O gateway gera o QR Code dinâmico e devolve o payload copia-e-cola + a URL pública do PNG do QR.
- Você renderiza o QR no checkout. O cliente abre o app do banco, escaneia ou cola, paga.
- O Banco Central confirma a transação ao gateway via SPI em até 10 segundos.
- O gateway envia um webhook assinado com HMAC-SHA256 para o seu servidor com
status: PAID. - Seu sistema libera o produto (envia o e-mail, libera o acesso, dispara o envio físico).
Para o cliente final, é a experiência mais rápida possível: ele abre o app, paga, e em menos de 10 segundos recebe a confirmação. Para você, é um único POST + um único endpoint de webhook. Veja o tutorial completo em como integrar PIX na sua loja online em 4 passos.
Gateway, adquirente e sub-adquirente: qual a diferença
Esses três termos viram sinônimo na propaganda, mas representam papéis distintos:
- Adquirente — a instituição financeira credenciada pelas bandeiras e pelo Bacen para liquidar transações (Cielo, Rede, Stone). Assume risco financeiro.
- Sub-adquirente — o intermediador que se conecta a um ou mais adquirentes e oferece o serviço empacotado para lojas menores. Simplifica o onboarding.
- Gateway — a camada técnica (APIs, webhooks, painel). Pode estar acoplada a um adquirente ou ser standalone.
O modelo que melhor funciona para a maioria das lojas online é o sub-adquirente que também é gateway — você integra uma API só e fala com um time só. Detalhamos cada papel no artigo Diferença entre gateway, adquirente e sub-adquirente.
Como escolher um gateway de pagamentos
Olhe para sete critérios objetivos, nessa ordem:
- Taxa por transação aprovada — é o número que mais pesa no longo prazo. Bons gateways cobram entre 0,5% e 2% por transação PIX. Fuja de quem cobra mensalidade fixa de centenas de reais.
- Tempo de saque — saque PIX deveria cair em minutos, no máximo 1 hora útil. Se o gateway segura o saldo por D+1 ou D+30, você está perdendo capital de giro.
- Qualidade da API — documentação clara em português, exemplos cURL prontos, sandbox público, webhooks assinados com HMAC. Veja o nosso padrão de documentação.
- Antifraude integrado — score de risco em tempo real, bloqueio automático de tentativas suspeitas. Como PIX é irreversível, isso não é opcional.
- Split de pagamentos nativo — se você opera marketplace ou afiliados, divisão automática evita conciliação manual.
- Suporte humano — bug em produção às 2 da manhã não pode esperar fila de chatbot.
- Estabilidade comprovada — uptime acima de 99,9%, status page pública, retentativas de webhook automatizadas.
Quanto custa um gateway de pagamentos PIX
O modelo de cobrança mudou bastante nos últimos anos. Hoje os parceiros sérios cobram apenas por transação aprovada — sem mensalidade, sem adesão, sem letras miúdas. As faixas atuais no mercado brasileiro:
| Volume mensal | Taxa típica por PIX |
|---|---|
| Até R$ 50.000 | 1,49% – 1,99% |
| R$ 50.000 – R$ 500.000 | 0,99% – 1,49% |
| R$ 500.000 – R$ 2 mi | 0,79% – 0,99% |
| Acima de R$ 2 mi | Negociado caso a caso |
Além da taxa por transação, alguns gateways cobram taxa fixa por saque PIX (R$ 1,90 – R$ 4,90 é a faixa comum). A Vanilla Pag negocia taxas caso a caso e não cobra mensalidade nem adesão. Veja mais em Quanto custa um gateway de pagamentos no Brasil.
Como integrar passo a passo
Quatro passos, qualquer linguagem:
- Pegue sua chave de API em Projetos no painel.
- Faça um POST para
/v1/payment-transaction/createcom valor e cliente. - Renderize o QR no seu checkout.
- Escute o webhook, verifique a assinatura HMAC, libere o pedido.
Tutoriais detalhados:
- Como integrar PIX em 4 passos (com cURL)
- Verificar webhook HMAC-SHA256 em Node, PHP e Python
- Como gerar o QR Code do PIX programaticamente
- Documentação completa da API
Antifraude: o item que diferencia gateway profissional de amador
PIX é irreversível. Diferente de cartão, não tem chargeback de 90 dias para você se proteger. Por isso, antifraude tem que rodar antes da cobrança ser gerada, não depois.
Um motor decente combina sinais de identidade (CPF/CNPJ válido, histórico de uso), comportamento (velocidade de checkout, número de tentativas), rede (reputação do IP, geolocalização), e padrão (ticket médio vs histórico). O score resultante determina três caminhos: aprovação direta, análise extra (60s), ou bloqueio.
Detalhes em Antifraude PIX: como funciona e quando o gateway bloqueia.
Split de pagamentos para marketplaces
Se você opera marketplace, plataforma de afiliados ou qualquer modelo de receita compartilhada, split é obrigatório. Dividir o valor automaticamente no momento da cobrança evita TED manual no D+1, erro contábil e atraso pro seller.
Na Vanilla Pag, split é nativo na criação da cobrança — você passa um array splits com percentual ou valor fixo, e o dinheiro cai direto na conta de cada recebedor quando o status vai para PAID. Detalhes em Split de pagamentos PIX para marketplaces.
Saques PIX: como sair do gateway pro seu banco
O saque PIX é a contrapartida da cobrança: você tem saldo na conta gateway e quer transferir para sua conta bancária. Um gateway decente processa o saque em até 1 hora útil, direto pra qualquer chave PIX (CPF, CNPJ, e-mail, telefone, aleatória).
Fuja de gateway que segura saldo por D+1 ou D+30 — isso era prática válida quando dependia de TED, mas hoje, com PIX, não tem desculpa.
Regulação Bacen e conformidade LGPD
Sub-adquirentes que operam PIX são regulados pelo Banco Central via Resolução BCB nº 80/2021 e atualizações posteriores. Antes de contratar, verifique se o parceiro está homologado no DICT e mantém capital de giro proporcional ao volume processado. Em paralelo, todo o tratamento de dados pessoais deve respeitar a LGPD (Lei nº 13.709/2018) — incluindo direito de acesso, portabilidade e eliminação, criptografia em trânsito e em repouso, e contrato de tratamento de dados quando o gateway é operador.
Comparações diretas com competidores
Cobrimos como a Vanilla Pag se compara com os principais gateways do mercado brasileiro:
- Vanilla Pag vs Stripe — taxas, payout no Brasil, suporte regional
- Vanilla Pag vs Mercado Pago — saque PIX, reserva técnica, qualidade da API
- Vanilla Pag vs PagBank — modelo de cobrança, cross-sell, foco em gateway puro
Para entender os termos usados nessas comparações, consulte nosso glossário com 15 verbetes: chargeback, MED, sub-adquirente, split, HMAC e mais.
Por que escolher a Vanilla Pag
A Vanilla Pag é sub-adquirente e gateway — você integra uma API só, fala com um time só, e cobre toda a cadeia (autorização, liquidação, webhooks, antifraude, painel). Sem mensalidade, sem adesão, com saque PIX em até 1 hora útil e suporte humano em português.
- Cadastro grátis em minutos
- Taxa transparente por transação aprovada
- Antifraude integrado com score de risco em tempo real
- Split nativo de pagamentos
- Webhooks assinados com HMAC-SHA256 + retry automático
- API REST documentada em português
Criar conta grátis · Ver a API · Falar com vendas