Módulo PIX para Magento 2: Integração Direta com Inter, C6 Bank, Itaú e Cielo

Módulo PIX para Magento 2: Integração Direta com Inter, C6 Bank, Itaú e Cielo
PIX já é o meio de pagamento mais usado do Brasil — mas gateways continuam cobrando por ele. Neste guia, mostramos como integrar o PIX diretamente à sua conta PJ (Banco Inter ou C6 Bank) no Magento 2, com taxa zero por transação, QR Code dinâmico e confirmação automática via webhook.

O PIX já é o meio de pagamento com maior volume do Brasil — e no e-commerce ele tem um detalhe que separa lojas amadoras de operações sérias: a forma de integração. Passar por um gateway significa pagar percentual sobre cada venda e depender de um intermediário para conciliar. A alternativa é a integração direta: sua loja Magento 2 falando com a API oficial do próprio banco.

Neste guia, mostramos como essa integração funciona na prática — e como ela foi implementada nos quatro módulos PIX da HEX para Magento 2: Inter, C6 Bank, Itaú e Cielo.

Por que integrar direto, sem gateway

  • Custo: gateways cobram percentual sobre cada transação. Na conta PJ dos bancos, o PIX básico é gratuito ou tem tarifa irrisória (no Inter, a API Pix tem custo zero divulgado; no C6, o banco declara não cobrar tarifa de Pix para PJ — sempre confirme a tabela vigente do seu banco).
  • Conciliação automática real: o pedido muda de status, ganha fatura e dispara e-mail sem ninguém abrir planilha.
  • Sem aprovação de cadastro em intermediário: você usa a conta PJ que já tem.
  • Rastreabilidade: txid e identificador end-to-end do SPI ficam vinculados ao pedido — auditoria limpa.

Como funciona o fluxo da API de PIX

  1. Criação da cobrança: ao finalizar o pedido, o módulo chama a API do banco gerando uma cobrança imediata — um QR Code dinâmico vinculado àquele pedido específico (valor exato, sem risco de pagamento errado).
  2. QR Code e Copia e Cola: gerados no servidor e exibidos na página de sucesso, com botão de cópia. Isso evita timeout de checkout: o pedido já existe quando o cliente paga.
  3. Confirmação automática: uma rotina agendada consulta o status das cobranças pendentes na API. Confirmado o pagamento, a fatura é criada, o e-mail parte e o pedido vai para processamento — tudo sem intervenção humana.
  4. Expiração inteligente: QR válido por tempo configurável (de 15 minutos a 24 horas). Venceu sem pagamento? O pedido é cancelado automaticamente, com tolerância para pagamentos "na raia".

Checklist: o que exigir de um módulo PIX profissional

  • QR Code dinâmico por pedido — nunca estático.
  • Txid idempotente: retry de criação nunca pode duplicar cobrança.
  • Conciliação automática com controle de carga (fila e limites), não varredura ingênua.
  • Cancelamento automático de expirados, com tolerância de minutos.
  • Fatura e e-mail automáticos na confirmação.
  • Certificados mTLS armazenados fora do diretório público.
  • Compatibilidade com guest checkout e checkouts one-step como Firecheckout.
  • Logs auditáveis sem expor credenciais.

PIX Banco Inter

O módulo PIX Inter para Magento 2 usa a API oficial do banco com SDK dedicado: cobrança com txid determinístico (idempotente por pedido), conciliação assíncrona com fila interna e limite de consultas por minuto, e devolução (refund) online parcial executada direto do admin — a devolução PIX oficial do SPI, com rastreio do identificador end-to-end. Os certificados mTLS ficam em diretório protegido fora do webroot. A conta PJ Inter divulga custo zero para a API Pix.

PIX C6 Bank

O módulo PIX C6 para Magento 2 integra a API Pix do C6 com autenticação mTLS, geração de cobrança imediata e conciliação automática por minuto. Inclui ambiente sandbox para testes antes de ir a produção e devolução online pelo admin. O C6 declara publicamente não cobrar tarifa de PIX para pessoa jurídica — vantagem direta sobre gateways que cobram percentual.

PIX Itaú

O módulo PIX Itaú para Magento 2 conecta a loja à API oficial de PIX Recebimentos do Itaú (sts.itau.com.br + endpoint de cobrança), com certificado digital mTLS, QR e copia-e-cola na página de sucesso e conciliação automática por minuto com fatura e e-mail. Ideal para quem já opera conta PJ no Itaú e quer eliminar o intermediário. As tarifas de recebimento variam por modalidade e plano de serviços — vale conferir seu pacote PJ.

PIX Cielo

O módulo PIX Cielo para Magento 2 usa a API Cielo eCommerce — a mesma infraestrutura robusta dos cartões — com Payment Type Pix: o QR vem pronto da própria adquirente, a expiração é configurável e a conciliação roda por minuto. Suporta devolução parcial online. Diferente dos bancos, não exige certificado digital: apenas MerchantId/MerchantKey. A Cielo pratica tarifa percentual sobre o Pix (divulgada em torno de 0,99% após período promocional — confirme seu contrato).

Comparativo rápido: os 4 módulos HEX PIX

CritérioInterC6ItaúCielo
ProvedorBanco diretoBanco diretoBanco diretoAdquirente
Custo típico da operaçãoAPI Pix custo zero (PJ)Pix PJ sem tarifa (declaração pública)Tarifa por modalidade/plano% sobre transação (~0,99%)
Refund onlineParcial (devolução SPI)Total—Parcial
ConciliaçãoAutomática (fila)AutomáticaAutomáticaAutomática
SandboxProduçãoSimProdução—
Certificado digitalSim (fora do webroot)SimSimNão

Não precisa escolher só um: muitos clientes rodam dois ou três provedores simultaneamente e priorizam pelo custo e disponibilidade do momento.

Instalação e configuração

Todos os módulos instalam via Composer, habilitam como método de pagamento nativo do Magento e pedem apenas as credenciais da sua conta (client_id/secret e chave PIX; certificado mTLS nos bancos). O checkout segue o fluxo padrão — inclusive em one-step checkouts como Firecheckout. A implantação completa, com testes ponta a ponta, faz parte do nosso serviço de implantação.

Perguntas frequentes

O módulo cobra taxa por transação?

Não. É licença única, sem mensalidade nem percentual. As tarifas de recebimento são as do seu próprio banco — em geral muito abaixo das taxas de gateway.

Preciso de certificado digital?

Nos bancos (Inter, C6, Itaú), sim: a autenticação é mTLS com certificado emitido para sua conta PJ. No módulo Cielo, não — bastam MerchantId/MerchantKey.

O cliente vê o QR Code dentro do checkout?

Na página de sucesso, logo após finalizar o pedido. Isso evita timeout de sessão durante o pagamento e permite ao cliente voltar ao pedido depois para copiar o código novamente.

E se o cliente não pagar?

O QR expira no prazo configurado e o pedido é cancelado automaticamente — com estoque devolvido e cliente avisado.

A fatura é criada sozinha quando o pagamento cai?

Sim. A conciliação automática cria a fatura, envia o e-mail e move o pedido para processamento sem intervenção.

Funciona com guest checkout e Firecheckout?

Funciona. Os métodos seguem o fluxo nativo de pagamento do Magento, com guest ou logado, inclusive em checkouts one-step.

Author: Alberto Braschi

Alberto Braschi

Fundador na HEX | Magento • Adobe Commerce • Arquitetura Preditiva

Alberto Braschi é fundador da HEX E-commerce Solutions, consultoria especializada em Magento e Adobe Commerce. Com mais de uma década de experiência em arquitetura de software, ajuda empresas a migrarem do caos reativo para operações preditivas e de alta performance.
^ Powered by Mage-OS © 2026. Todos os direitos reservados. HEX E-commerce Solutions