Utilizamos os cookies para melhorar a sua experiência. Para cumprir com a nova diretiva de privacidade, nós precisamos pedir seu consentimento para definir os cookies. Saiba mais.
Módulo PIX para Magento 2: Integração Direta com Inter, C6 Bank, Itaú e Cielo
-
Alberto Braschi - Blog HEX E-commerce Solutions
- 25 de ago. de 2026 views
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
- 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).
- 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.
- 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.
- 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ério | Inter | C6 | Itaú | Cielo |
|---|---|---|---|---|
| Provedor | Banco direto | Banco direto | Banco direto | Adquirente |
| Custo típico da operação | API Pix custo zero (PJ) | Pix PJ sem tarifa (declaração pública) | Tarifa por modalidade/plano | % sobre transação (~0,99%) |
| Refund online | Parcial (devolução SPI) | Total | — | Parcial |
| Conciliação | Automática (fila) | Automática | Automática | Automática |
| Sandbox | Produção | Sim | Produção | — |
| Certificado digital | Sim (fora do webroot) | Sim | Sim | Não |
Não precisa escolher só um: muitos clientes rodam dois ou três provedores simultaneamente e priorizam pelo custo e disponibilidade do momento.
Leia também
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.





