Pix direto no banco ou gateway: qual escolher e como integrar

O Pix virou o meio de pagamento padrão de muita empresa brasileira. Depois do QR Code no balcão e da chave enviada por WhatsApp, alguém do financeiro pergunta: dá para o sistema gerar a cobrança e dar baixa sozinho quando o cliente pagar?

Dá, e por dois caminhos bem diferentes. Um é integrar o sistema direto com a API Pix do banco onde a empresa tem conta. O outro é passar por um gateway de pagamento ou outro provedor de serviços de pagamento (PSP), que oferece Pix junto com cartão, boleto e outras ferramentas numa interface só.

Os dois funcionam. A diferença está no que vem junto: quem segura o dinheiro, quem cuida do certificado, como a conciliação acontece e o que muda quando a empresa resolve aceitar cartão ou montar um marketplace. Este texto mostra onde cada caminho se sai melhor.

Resposta curta

Se a empresa recebe quase tudo por Pix, trabalha com um ou dois bancos e quer o dinheiro caindo direto na própria conta, com conciliação feita pelo próprio sistema, a integração direta com a API Pix do banco costuma ser a escolha mais simples e com menos intermediários. Se a empresa precisa de cartão, boleto, assinatura, split entre recebedores ou de vários bancos numa mesma interface, um gateway ou PSP tende a compensar, porque entrega essas peças prontas e já integradas entre si.

Os dois caminhos: API Pix do banco e gateway de pagamento

API Pix do banco

O Banco Central definiu uma especificação de API para o Pix, e os bancos e instituições participantes oferecem suas implementações a partir dela. Na prática, seu sistema conversa direto com o banco: cria a cobrança, recebe um QR Code e o "copia e cola", e é avisado por webhook quando o pagamento cai.

O ponto central é que o dinheiro entra na conta da empresa naquele banco, sem passar por terceiros. A cobrança tem um identificador próprio (o txid), que o seu sistema define e usa para saber exatamente qual pedido ou fatura foi paga.

Os bancos seguem a mesma base, mas cada um tem particularidades de autenticação, ambiente de testes e recursos adicionais. Integrar com dois bancos não é o dobro do trabalho, mas também não é copiar e colar.

Gateway ou PSP

O gateway é uma camada entre o seu sistema e os meios de pagamento. Com uma única integração, o sistema passa a gerar Pix, boleto e cobrança no cartão, e recebe notificações padronizadas para todos eles. Muitos provedores oferecem também assinatura, link de pagamento, divisão de valores entre recebedores e painel para o financeiro.

O modelo de custódia varia. Em vários provedores o dinheiro entra primeiro numa conta dentro do próprio provedor e depois é transferido para a conta bancária da empresa, conforme regras de repasse definidas em contrato. Em outros, a liquidação pode ir direto para a conta do lojista. Esse detalhe muda fluxo de caixa e conciliação, então vale confirmar o modelo atual com cada fornecedor antes de decidir.

Se a opção for por gateway, o checklist de integração com gateway de pagamento ajuda a não esquecer estornos, webhooks e conciliação.

Certificados, credenciais e homologação no banco

Esse é o trecho em que a integração direta exige mais da empresa.

Para usar a API Pix de um banco, normalmente é preciso:

• Habilitar o produto na conta. Nem toda conta vem com acesso à API liberado. Costuma ser necessário pedir ao gerente ou ativar pelo internet banking empresarial.
• Gerar credenciais de aplicação. Um identificador e um segredo de cliente, usados para obter tokens de acesso com validade curta.
• Instalar um certificado digital de cliente. A comunicação usa autenticação mútua (mTLS): o banco só aceita a conexão se ela for autenticada com o certificado emitido para a sua aplicação. Esse certificado tem validade e precisa ser renovado antes de vencer.
• Configurar o webhook. O endereço que vai receber os avisos de pagamento precisa ser registrado no banco, ser acessível pela internet e, em muitos casos, também validar o certificado do banco.
• Passar pelo ambiente de testes. Cada banco tem o seu, e nem sempre ele reproduz a produção com perfeição.

Nada disso é complicado para um time técnico experiente, mas é trabalho que fica com a empresa. O certificado vencido numa sexta à noite é um incidente clássico: a cobrança para de ser gerada e ninguém percebe até o cliente reclamar. A integração direta pede monitoramento e alerta de vencimento.

Com gateway, essa parte fica majoritariamente com o provedor. A empresa lida com uma chave de API e com a assinatura dos webhooks do provedor, que costuma ser mais simples. Em troca, passa a depender da disponibilidade e das regras de outra empresa.

Cobrança com vencimento, Pix Automático e devolução

O Pix já não é só o pagamento instantâneo de balcão. Três recursos pesam na decisão.

Cobrança com vencimento

A especificação prevê uma cobrança com data de vencimento, com possibilidade de multa, juros e desconto, que funciona como substituto do boleto em muitos casos. Na integração direta, você usa esse recurso conforme o banco o disponibiliza. No gateway, ele pode aparecer com outro nome, embalado numa "fatura" que também aceita boleto e cartão. Confirme se o provedor gera a cobrança com vencimento nativa do Pix ou uma composição própria, porque isso afeta como o pagador vê a cobrança no aplicativo do banco.

Pix Automático

O Pix Automático permite cobranças recorrentes com autorização prévia do pagador, sem que ele precise aprovar cada pagamento. Para assinaturas, mensalidades e contratos de serviço, isso muda a régua de cobrança. A oferta e o formato de integração variam entre bancos e provedores, e o recurso ainda está sendo adotado pelo mercado, então vale checar o que cada um oferece hoje. O passo a passo de cobrança recorrente com Pix Automático detalha autorização, retentativas e baixa.

Devolução

Devolver um Pix recebido é uma operação da API: o sistema pede a devolução, total ou parcial, referenciando o pagamento original. Na integração direta, sua aplicação precisa implementar esse fluxo, com permissão restrita e registro de quem pediu. No gateway, a devolução costuma ficar no mesmo lugar do estorno de cartão, o que simplifica para o atendimento.

Há ainda o Mecanismo Especial de Devolução, acionado em casos de fraude ou falha operacional. Em qualquer caminho, o financeiro precisa saber como esses eventos chegam ao sistema.

Conciliação e baixa automática: onde cada caminho ajuda

A promessa é a mesma nos dois caminhos: o cliente paga, o sistema dá baixa sozinho e o financeiro não confere extrato linha por linha. O jeito de chegar lá muda.

Na integração direta, o txid que o seu sistema associou à cobrança volta no webhook e na consulta de Pix recebidos pela API. A baixa é imediata e a conciliação bancária fica limpa: cada crédito na conta corresponde a um pagamento, sem repasse agrupado no meio. Se o banco cobra tarifa por Pix recebido, ela segue o contrato da conta e é lançada conforme a regra de cada banco. O trabalho é garantir que o webhook seja processado de forma confiável, com reprocessamento quando falhar, e que exista uma rotina de consulta para pegar o que o webhook não entregou. Se o conceito ainda é novo para a equipe, o texto sobre webhook explica o funcionamento.

No gateway, a baixa do pedido é igualmente rápida, porque o provedor avisa o pagamento. A conciliação, porém, tem duas etapas: o pagamento confirmado no gateway e, depois, o repasse que cai na conta bancária, muitas vezes agrupando vários pagamentos e já descontando tarifas. Para o financeiro, isso significa conciliar o pedido com a transação do gateway e a transação com o repasse no banco.

Nenhuma das duas é problema se for desenhada desde o início. O guia de conciliação bancária automática mostra como tratar Pix, boleto e cartão na mesma rotina, deixando para a equipe só as exceções.

Se a empresa ainda usa remessa e retorno em arquivo para boleto, vale planejar junto a migração para API. O texto sobre integração bancária via API e CNAB mostra como fazer isso sem interromper a cobrança.

Vários meios de pagamento, split e marketplace

Aqui o gateway costuma levar vantagem clara.

Cartão de crédito e débito. A API Pix do banco não processa cartão. Se a empresa vende parcelado, tem assinatura no cartão ou atende cliente que prefere cartão, vai precisar de um adquirente ou gateway de qualquer forma. Nesse cenário, concentrar Pix no mesmo provedor simplifica a integração e o painel do financeiro.

Boleto. Muitos bancos oferecem API de boleto, mas aí são duas integrações a manter.

Split de pagamento. Quando o valor de uma venda precisa ser dividido entre a plataforma e outros recebedores (vendedores de um marketplace, franqueados, profissionais parceiros), o gateway costuma oferecer divisão automática e subcontas. Fazer isso com Pix direto no banco exige que a empresa receba o valor inteiro e faça os repasses depois, o que envolve questões regulatórias e fiscais que precisam ser avaliadas com o jurídico e a contabilidade. Quem está planejando uma plataforma desse tipo encontra o desenho completo no guia sobre como desenvolver um marketplace B2B.

Vários bancos. Com contas em mais de um banco, seria uma integração direta para cada um. O gateway abstrai isso, ao custo de intermediar o recebimento.

Um desenho que funciona bem em muitas empresas é híbrido: Pix direto no banco para a maior parte do recebimento e gateway só para cartão. Para isso funcionar sem bagunça, o sistema precisa de uma camada interna de pagamentos que trate os dois provedores de forma parecida. É uma decisão de arquitetura de software, não só de contrato comercial.

Tabela comparativa: Pix direto no banco x gateway

Recursos e condições comerciais mudam com frequência, de um lado e de outro. Use a tabela como mapa e confirme os detalhes atuais diretamente com o banco e com os provedores.

Quando escolher cada um

Sinais de que Pix direto no banco é o melhor caminho

• A maior parte do faturamento já chega por Pix e não há plano de aceitar cartão em volume.
• A empresa concentra a operação em um ou dois bancos e tem bom relacionamento com eles.
• O fluxo de caixa importa: o dinheiro precisa estar na conta no momento do pagamento, sem prazo de repasse.
• O financeiro quer conciliação simples, com o crédito no extrato igual ao valor do pedido.
• Existe equipe técnica, interna ou parceira, capaz de cuidar de certificado, webhook e monitoramento.

Sinais de que o gateway compensa

• A empresa aceita, ou quer aceitar, cartão, boleto e Pix na mesma jornada de pagamento.
• Há assinatura, cobrança recorrente com várias formas de pagamento ou link de pagamento enviado por vendedores.
• O modelo de negócio exige split: marketplace, rede de franquias, plataforma com parceiros recebendo parte da venda.
• A empresa não quer manter certificados e homologações em vários bancos.
• O time técnico é pequeno e prefere concentrar esforço no produto, não na infraestrutura de pagamento.

Nesse segundo grupo, o gateway é a escolha mais sensata e não há motivo para construir do zero o que o provedor entrega pronto. O trabalho sob medida, aí, está em integrar bem o gateway ao seu ERP e aos seus processos.

O caminho híbrido entra quando o Pix domina, o cartão ainda pesa nas vendas e já existe, ou vai existir, um sistema próprio com camada de pagamentos bem definida.

Antes de escolher, também vale olhar como o pagamento vai conversar com o restante da operação. Se a baixa precisa refletir no ERP, o texto sobre como integrar seu sistema com o ERP ajuda a evitar o pagamento confirmado num lugar e pendente no outro. Outros temas de integração estão reunidos na categoria de integrações.

Perguntas frequentes

O que é txid no Pix?

O txid é o identificador da cobrança Pix, definido pelo próprio sistema da empresa no momento em que a cobrança é criada. Ele volta no webhook e na consulta de Pix recebidos, e é por ele que o sistema sabe exatamente qual pedido ou fatura foi pago e dá a baixa automática, sem conferir extrato linha por linha.

Precisa de certificado digital para usar a API Pix do banco?

Normalmente, sim. A API Pix dos bancos usa autenticação mútua (mTLS), e o banco só aceita a conexão autenticada com o certificado emitido para a sua aplicação, além das credenciais de cliente. Esse certificado tem validade e precisa ser renovado antes de vencer, com alerta configurado, ou a geração de cobranças para sem aviso.

O banco cobra tarifa para receber Pix pela API?

Depende do contrato da conta. Na integração direta, a tarifa por Pix recebido, quando existe, segue o que foi negociado com o banco. No gateway, as tarifas são definidas no contrato com o provedor e podem vir descontadas no repasse. Compare as condições atuais diretamente com o banco e com cada provedor antes de decidir.

Dá para receber Pix direto no banco e cartão pelo gateway no mesmo sistema?

Dá, e é um desenho comum: Pix direto no banco para a maior parte do recebimento e gateway só para cartão. Para isso funcionar sem bagunça, o sistema precisa de uma camada interna de pagamentos que trate os dois provedores de forma parecida, com conciliação e baixa no mesmo fluxo. É uma decisão de arquitetura.

Como a Pervian Tech ajuda a decidir e a integrar o recebimento

Começamos com um diagnóstico inicial gratuito: olhamos o mix de meios de pagamento, os bancos em uso, o volume e o formato das cobranças, a rotina de conciliação do financeiro e os sistemas que precisam saber que o pagamento caiu. A partir disso, recomendamos o caminho com franqueza. Quando um gateway de mercado atende bem, dizemos isso e ajudamos a integrá-lo ao seu sistema. Quando a integração direta com o banco, ou o modelo híbrido, faz mais sentido, desenhamos e construímos a camada de pagamentos sob medida.

Nos dois casos, cuidamos do que costuma ficar esquecido: renovação de certificado, reprocessamento de webhook, devoluções com registro e conciliação por exceção. Esse trabalho faz parte da nossa solução de integração de sistemas. Cronograma e investimento são definidos sob consulta, depois de entender a operação.

Se a sua empresa ainda dá baixa em Pix olhando o extrato, fale com a gente.