Se a sua loja ainda cobra por PagSeguro usando aquele módulo Transparente que todo mundo instalava em 2019, é hora de trocar. Aquele repositório não recebe commit desde 20 de setembro de 2023, e a descrição dele no GitHub diz, com todas as letras, que está obsoleto.
O substituto é do mesmo autor, usa as APIs novas do PagBank e está vivo: última versão publicada em 29 de junho de 2026.
Por que o antigo não serve mais
O PagSeguro-Magento-Transparente-M2 falava com a geração anterior da API do PagSeguro. Sem manutenção, sem correção de compatibilidade com PHP novo e sem os recursos que hoje decidem a venda: 3D Secure, Pix com validade configurável, cartão salvo pelo Vault do Magento.
Vale saber que existem duas opções vivas hoje, e elas não são a mesma coisa. O pagseguro/payment-magento é o módulo oficial mantido pela própria empresa. O ricardomartins/pagbank-magento2 é feito pela PagBank Integrações, parceira oficial desde 2014 — não é código do PagBank, e o próprio README avisa isso. A diferença prática que pesa no bolso: usando a integração do parceiro, valem as taxas negociadas por ele, não as suas. Se você já tem taxa boa negociada, faça a conta antes.
Instalando
Requisitos: Magento 2.4.4 ou superior e PHP de 8.1 a 8.5. A licença é GPL-3.0, o pacote está no Packagist e a versão atual é a 4.8.1.
composer require ricardomartins/pagbank-magento2
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy pt_BR -f
bin/magento cache:flushA configuração fica em Stores > Configuration > Sales > Payment Methods > Soluções Recomendadas > PagBank. Lá tem um botão de Obter Connect Key que leva ao fluxo de autorização — é ele que liga a sua conta PagBank à loja. Sem a Connect Key, nada funciona.
Aviso de sempre: o módulo instala com o modo sandbox ligado. Depois de testar, lembre de virar para produção e trocar a chave.
Cada método liga separado
Essa é a pegadinha que mais gera chamado. Instalar não coloca nada no checkout, porque no config.xml do módulo todos os meios de pagamento nascem desativados:
| Método | Código | Padrão útil |
|---|---|---|
| Cartão de crédito | ricardomartins_pagbank_cc | 3DS vem desligado |
| Pix | ricardomartins_pagbank_pix | validade de 480 minutos |
| Boleto | ricardomartins_pagbank_boleto | validade de 7 dias |
| Cartão salvo | ricardomartins_pagbank_cc_vault | depende do cartão estar ligado |
Ligue um de cada vez e teste um de cada vez. Boleto de 7 dias, aliás, é bastante coisa: pedido que fica uma semana pendurado segura estoque. Eu costumo baixar para 3.
O que conferir antes de ir para produção
O endereço. O módulo separa logradouro, número, complemento e bairro pelas linhas do campo de endereço do Magento. Loja com duas linhas manda (bairro não informado) para a API do PagBank. Antes de testar pagamento, ajuste o número de linhas do endereço para 4.
O CPF. O módulo aceita pegar o documento do formulário de pagamento ou do cadastro do cliente, e a escolha muda a experiência do checkout. O padrão é pedir no próprio formulário de pagamento.
O cron. A atualização de status de Pix depende de tarefa agendada. Se o cron da loja não roda, o cliente paga o Pix e o pedido fica pendente para sempre — e aí o problema não é o módulo.
Para quem está saindo de outro gateway, o teste que eu faço sempre antes de virar a chave: um pedido real de valor baixo com cartão, um com Pix e um com boleto, conferindo o status no admin e no painel do PagBank. Sandbox não reproduz tudo.
Perguntas rápidas
Esse módulo é oficial do PagBank?
Não. Ele é feito pela PagBank Integrações, parceira oficial desde 2014, e o próprio README deixa isso claro. O módulo oficial mantido pela empresa é o pagseguro/payment-magento, que é outro pacote.
Dá para usar as minhas taxas negociadas com o PagBank?
Nas transações feitas por esse plugin valem as taxas da integração do parceiro, não as suas. Existe um modelo alternativo chamado Minhas Taxas na hora de gerar a Connect Key, com exigência de faturamento mínimo. Confira antes de migrar se você já tem condição especial.
Posso rodar o módulo antigo e o novo ao mesmo tempo?
Tecnicamente até sobe, mas não faça. Os dois disputam configuração de pagamento e confundem o histórico do pedido. Migre, teste e remova o antigo com composer remove.