PHPackages                             ricardomartins/pagbank-magento1 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. ricardomartins/pagbank-magento1

ActiveMagento-module[Payment Processing](/categories/payments)

ricardomartins/pagbank-magento1
===============================

Módulo PagBank/PagSeguro Nova Geração para Magento 1.x e OpenMage LTS

4.13.0(3mo ago)21043OSL-3.0PHPPHP &gt;=5.6

Since Apr 8Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/r-martins/PagBank-Magento1)[ Packagist](https://packagist.org/packages/ricardomartins/pagbank-magento1)[ Docs](https://pbintegracoes.com/)[ RSS](/packages/ricardomartins-pagbank-magento1/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (148)Used By (0)

[![Minimum PHP Version](https://camo.githubusercontent.com/dcd4b4aec2c1709157fa6a2c050f709d75cde9552a79cfff0b70a97fad7281ae/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230372e312d3838393242462e7376673f7374796c653d666c61742d737175617265)](https://php.net/)[![GitHub release](https://camo.githubusercontent.com/775ca3ea853d91590ba9dc13d9592573833121322f9a7e335efad531fabaf7ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f722d6d617274696e732f50616742616e6b2d4d6167656e746f31)](https://github.com/r-martins/PagBank-Magento1)[![GitHub last commit (branch)](https://camo.githubusercontent.com/f8ece5171d1180716bfae2ab4912df2e472a5a34030b391cef718e5031fe1d3d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f722d6d617274696e732f50616742616e6b2d4d6167656e746f312f646576656c6f70)](https://camo.githubusercontent.com/f8ece5171d1180716bfae2ab4912df2e472a5a34030b391cef718e5031fe1d3d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f722d6d617274696e732f50616742616e6b2d4d6167656e746f312f646576656c6f70)

Módulo PagBank(PagSeguro) Connect para Magento1
===============================================

[](#módulo-pagbankpagseguro-connect-para-magento1)

### Compatível com OpenMage e Maho Commerce

[](#compatível-com-openmage-e-maho-commerce)

[![Módulo PagBank para Magento 1, OpenMage ou Maho Commerce](https://camo.githubusercontent.com/b3af4fcfa0d2078c408bf864101ef629633c32a215228325452a9bcac16f5512/68747470733a2f2f692e6962622e636f2f776b71626a67322f42616e6e65722d4d6167656e746f312d5061672d42616e6b2d313534347835303070782e6a70673f313d31)](https://camo.githubusercontent.com/b3af4fcfa0d2078c408bf864101ef629633c32a215228325452a9bcac16f5512/68747470733a2f2f692e6962622e636f2f776b71626a67322f42616e6e65722d4d6167656e746f312d5061672d42616e6b2d313534347835303070782e6a70673f313d31)

Nova Geração - Novas APIs, Novos Recursos, Mais Estabilidade
------------------------------------------------------------

[](#nova-geração---novas-apis-novos-recursos-mais-estabilidade)

Aceite mais de 30 cartões de crédito, PIX e boleto em sua loja [Magento 1.x](https://www.magenteiro.com/blog/magento-1/magento1-download/?utm_source=github&utm_content=pagbank-magento1), [OpenMage LTS](https://www.openmage.org/) ou [Maho Commerce](https://mahocommerce.com/?utm_source=github-rmartins-pagbank-magento1), usando o meio de pagamento mais aceito pelos brasileiros.

Chega de reprovações e chargebacks! Nosso novo módulo tem suporte a PIX transparente e [3D Secure](https://ajuda.pbintegracoes.com/hc/pt-br/articles/22375922278157-Autentica%C3%A7%C3%A3o-3DS-Sua-prote%C3%A7%C3%A3o-contra-Chargeback), alcançando até 99% de aprovação no cartão de crédito sem necessidade de antifraude.

Agora usando as Novas APIs do PagBank.

A integração mais usada do Brasil, agora com mais recursos, mais estabilidade e ainda mais segurança.

Recursos
========

[](#recursos)

- Aceite pagamentos com Cartão de Crédito, PIX ou Boleto de forma transparente (sem sair da loja)
- [Autenticação 3D Secure](https://ajuda.pbintegracoes.com/hc/pt-br/articles/22375922278157-Autentica%C3%A7%C3%A3o-3DS-Sua-prote%C3%A7%C3%A3o-contra-Chargeback) para evitar chargebacks e aumentar aprovação
- PIX e Boleto com validades configuráveis
- Atualização automática do status do pedido
- Pagamento em 1x ou parcelado, com várias configurações de parcelamento
- Opção de [ocultar itens do pedido](https://ajuda.pbintegracoes.com/hc/pt-br/articles/28100721158413-Ocultar-itens-do-pedido) ou [e-mail do comprador](https://ajuda.pbintegracoes.com/hc/pt-br/articles/28100677681677-Ocultar-e-mail-do-cliente-hash-pagbankconnect-pag)
- Identificador do nome da loja na fatura
- [Descontos nas taxas](https://pbintegracoes.com/compare/?utm_source=github&utm_content=readme) oficiais do PagBank (ou use suas taxas)
- Suporte a Sandbox
- Link direto para a transação disponível no admin
- Suporte a todos os tipos de produtos
- Suporte a multi-loja
- Desenvolvido nos padrões Magento por desenvolvedores certificados pela Adobe 🏆
- Compatível com os principais checkouts do mercado (OneStepCheckout Inovarti, IWD, FireCheckout, etc)

 Veja alguns Screenshots (clique aqui para expandir) [![Cartão de crédito PagBank(PagSeguro) no front end](https://camo.githubusercontent.com/5a9d76a35be4ee1cd2cf9ca4d22a16cfc41436831d1dd55d9196fc3cbc7a7421/68747470733a2f2f692e6962622e636f2f636333766d5634532f73637265656e73686f742d312e776562703f313d31 "Cartão de crédito PagBank(PagSeguro) no front end")](https://camo.githubusercontent.com/5a9d76a35be4ee1cd2cf9ca4d22a16cfc41436831d1dd55d9196fc3cbc7a7421/68747470733a2f2f692e6962622e636f2f636333766d5634532f73637265656e73686f742d312e776562703f313d31) [![PIX - Tela de Sucesso](https://camo.githubusercontent.com/dd9d49566ec881a0f14fa3220d1db04ae03c94938da7df462a547e43bede941c/68747470733a2f2f692e6962622e636f2f64344b74464766622f73637265656e73686f742d322e776562703f313d31 "PIX - Tela de Sucesso")](https://camo.githubusercontent.com/dd9d49566ec881a0f14fa3220d1db04ae03c94938da7df462a547e43bede941c/68747470733a2f2f692e6962622e636f2f64344b74464766622f73637265656e73686f742d322e776562703f313d31) [![Configurações de cartão de crédito](https://camo.githubusercontent.com/1a3bd09455c6e04164c8bb646426ecdf5aa7f89107aa87b8aca79c6c7b195a5c/68747470733a2f2f692e6962622e636f2f77466451465035382f73637265656e73686f742d332e776562703f313d31 "Configurações de cartão de crédito")](https://camo.githubusercontent.com/1a3bd09455c6e04164c8bb646426ecdf5aa7f89107aa87b8aca79c6c7b195a5c/68747470733a2f2f692e6962622e636f2f77466451465035382f73637265656e73686f742d332e776562703f313d31) [![PIX - Configurações Magento 1](https://camo.githubusercontent.com/b4866a5eac5011f2045a835008e4c4d4aa154a6fcf85cb250105823b041b07ba/68747470733a2f2f692e6962622e636f2f763463393366354e2f73637265656e73686f742d342e776562703f313d31 "PIX - Configurações Magento 1")](https://camo.githubusercontent.com/b4866a5eac5011f2045a835008e4c4d4aa154a6fcf85cb250105823b041b07ba/68747470733a2f2f692e6962622e636f2f763463393366354e2f73637265656e73686f742d342e776562703f313d31) [![Admin - Tela do pedido](https://camo.githubusercontent.com/ac1d0e18cc13ef820f4509fce88452cf709ef08ef832706f49ef66f69698c7be/68747470733a2f2f692e6962622e636f2f675a3273346263442f73637265656e73686f742d352e776562703f313d31 "Admin - Tela do pedido")](https://camo.githubusercontent.com/ac1d0e18cc13ef820f4509fce88452cf709ef08ef832706f49ef66f69698c7be/68747470733a2f2f692e6962622e636f2f675a3273346263442f73637265656e73686f742d352e776562703f313d31) [![Autenticação 3D Secure](https://camo.githubusercontent.com/6af01c8e5696a24829a3ec23ac4ab42aee26a0c0462795ecb72e1a170a922d5b/68747470733a2f2f692e6962622e636f2f4e364a487239526e2f73637265656e73686f742d362e776562703f313d31 "Autenticação 3D Secure")](https://camo.githubusercontent.com/6af01c8e5696a24829a3ec23ac4ab42aee26a0c0462795ecb72e1a170a922d5b/68747470733a2f2f692e6962622e636f2f4e364a487239526e2f73637265656e73686f742d362e776562703f313d31) [![Compatibilidade com OpenMage e os principais checkouts do mercado](https://camo.githubusercontent.com/8c209d00afbdb39db6ec2640a58fb60bbfa37a3bd28bcfdedbe3f20073ec8158/68747470733a2f2f692e6962622e636f2f423570336d7a79742f73637265656e73686f742d372e776562703f313d31 "Compatibilidade com OpenMage e os principais checkouts do mercado")](https://camo.githubusercontent.com/8c209d00afbdb39db6ec2640a58fb60bbfa37a3bd28bcfdedbe3f20073ec8158/68747470733a2f2f692e6962622e636f2f423570336d7a79742f73637265656e73686f742d372e776562703f313d31)Pré-requisitos
==============

[](#pré-requisitos)

- OpenMage LTS (recomendado) ou Magento 1.7.x a 1.9.x
- PHP 7.1 ou superior (recomendado 7.4 ou superior) / PHP 5.6 é suportado, mas não recomendado
- Extensão PHP [mbstring habilitado](https://pt.stackoverflow.com/a/200646/331)

Instalação
==========

[](#instalação)

Escolha uma das formas de instalação abaixo:

Instale com Composer
--------------------

[](#instale-com-composer)

- Certifique-se que você [configurou seu Magento para ter suporte a composer](https://www.magenteiro.com/blog/magento-1/magento-e-composer-como-gerenciar-melhor-seus-modulos-e-pacotes/).
- Digite o comando `composer require ricardomartins/pagbank-magento1` na raiz da sua instalação Magento.
- Limpe o cache do Magento

Instalação manual
-----------------

[](#instalação-manual)

- Baixe a versão mais recente do módulo [aqui](https://github.com/r-martins/PagBank-Magento1/archive/refs/heads/master.zip)
- Extraia o arquivo baixado e copie as pastas para a raiz da sua instalação Magento
- - As pastas `app`, `lib` e `skin`, `js`, etc devem ser copiadas para a raiz da instalação mesclando-se com as pastas existentes e não substituindo-as
- Limpe o cache do Magento
- ou...

Instalação com modman
---------------------

[](#instalação-com-modman)

Você pode usar [modman](https://github.com/colinmollenhour/modman) para instalar o módulo. Para isso, siga os passos abaixo:

- Digite o comando `modman clone https://github.com/r-martins/PagBank-Magento1.git` na raiz da sua instalação Magento.
- Limpe o cache do Magento

Configuração do Módulo PagBank(PagSeguro) Connect
=================================================

[](#configuração-do-módulo-pagbankpagseguro-connect)

- Navegue até Lojas &gt; Configurações &gt; Vendas &gt; Formas de Pagamento &gt; **PagBank - Ricardo Martins**.
    - Clique em "Obter Connect Key" ou "Obter Connect Key para Testes" e siga as instruções para obter sua Connect Key e preenche-la no campo indicado logo abaixo.
    - Salve as configurações e você está pronto para vender.
- Se desejar, configure opções de parcelamento, e validade do boleto e código pix de acordo com suas necessidades.
- Em Clientes &gt; Configurações &gt; Opções de Nome e Endereço, configure o campo "Número de Linhas p/ Endereço" para 4.

Criptografia do cartão no checkout ℹ️
-------------------------------------

[](#criptografia-do-cartão-no-checkout-ℹ️)

Dependendo do checkout que estiver utilizando ou de customizações no tema, você também precisará [configurar o "Identificador CSS do botão de Finalizar Compra"](https://ajuda.pbintegracoes.com/hc/pt-br/articles/360039820711-Configurando-o-bot%C3%A3o-de-Finalizar-Compra).

Isso é necessário para que o módulo possa criptografar os dados do cartão de crédito antes de enviá-los ao PagBank e também para o correto funcionamento do recurso de 3D Secure (quando ativado).

Site Oficial do Módulo
======================

[](#site-oficial-do-módulo)

[https://pbintegracoes.com/](https://pbintegracoes.com/?utm_source=github-m1&utm_medium=readme)

Disponível também para [Magento 2.x](https://pbintegracoes.com/magento2/?utm_source=github=m1&utm_content=readme) e [WooCommerce](https://pbintegracoes.com/woocommerce/?utm_source=github=m1&utm_content=readme).

Cursos Magento
==============

[](#cursos-magento)

Em [Magenteiro.com/cursos](https://www.magenteiro.com/cursos?___store=default&utm_source=github-m1&utm_medium=readme&utm_campaign=readme.md) você encontra uma dezena de cursos pagos e gratuitos sobre Magento, inclusive o famoso curso gratuito [Sua loja com PagSeguro e OneStepCheckout](https://www.magenteiro.com/sua-loja-com-pagseguro-e-onestepcheckout?___store=default&utm_source=github-m1&utm_medium=readme&utm_campaign=readme.md).

Veja tamém o [canal Magenteiro no YouTube](https://youtube.com/@Magenteiro).

Central de ajuda e suporte
==========================

[](#central-de-ajuda-e-suporte)

Autores
=======

[](#autores)

- Ligia Salzano (@ligiasalzano) - [Adobe Certified Professional - 3x](https://www.credly.com/users/ligia-salzano) 🏆🏆🏆
- Ricardo Martins (@magenteiro) - [Adobe Certified Professional](https://www.credly.com/badges/8a2af83e-60c6-447a-b8e5-9154dd97751b) 🏆

\* Estes são os autores da versão inicial. Novos autores e colaboradores não certificados podem vir a contribuir com futuras versões e podem ser encontrados [aqui](https://github.com/r-martins/PagBank-Magento1/graphs/contributors).

Perguntas Frequentes (FAQ)
==========================

[](#perguntas-frequentes-faq)

Como funcionam os descontos nas taxas?
--------------------------------------

[](#como-funcionam-os-descontos-nas-taxas)

Ao usar nossas integrações no modelo de recebimento em 14 ou 30 dias, ao invés de pagar 4,99% ou 3,99%, você pagará cerca de 0,60% a menos e estará isento da taxa de R$0,40 por transação.

Taxas menores são aplicadas para transações parceladas, PIX e Boleto.

Consulte mais sobre as taxas atualizadas no [nosso site](https://pbintegracoes.com/).

Eu tenho uma taxa ou condição negociada menor que estas. O que faço?
--------------------------------------------------------------------

[](#eu-tenho-uma-taxa-ou-condição-negociada-menor-que-estas-o-que-faço)

Ao usar nossa integração, nossas taxas e condições serão aplicadas ao invés das suas. Isto é, nas transações realizadas com nosso plugin.

É importante notar que taxas negociadas no mundo físico (moderninhas) não são aplicadas no mundo online.

Se mesmo assim você possuir uma taxa ou condição melhor, e se compromete a faturar mais de R$20 mil / mês (pedidos aprovados usando nossa integração), podemos incluir sua loja em uma aplicação especial. Basta selecionar o modelo "Minhas taxas" quando obter sua Connect Key.

Tenho outra pergunta não listada aqui
-------------------------------------

[](#tenho-outra-pergunta-não-listada-aqui)

Consulte nossa [Central de ajuda](https://ajuda.pbintegracoes.com/hc/pt-br/) e [entre em contato](https://ajuda.pbintegracoes.com/hc/pt-br/requests/new) conosco se não encontrar sua dúvida respondida por lá.

A maioria das dúvidas estão respondidas lá. As outras são respondidas em até 2 dias após entrar em contato.

O plugin atualiza os status automaticamente?
--------------------------------------------

[](#o-plugin-atualiza-os-status-automaticamente)

Sim.

E quando há uma transação no PagBank, um link para ela é exibida na página do pedido. Assim você pode confirmar novamente o status do mesmo.

Certifique-se de [configurar seu Firewall (ou Cloudflare)](https://ajuda.pbintegracoes.com/hc/pt-br/articles/115002699823-Usu%C3%A1rios-Cloudflare-e-CDN-s) para permitir conexões de entrada em sualoja.com/pagbank/notification/ para evitar problemas.

Como posso testar usando a Sandbox?
-----------------------------------

[](#como-posso-testar-usando-a-sandbox)

Basta clicar no botão 'Obter Connect Key para Testes' localizado nas configurações do módulo e seguir as instruções.

Depois é só informar sua Connect Key de testes no campo "Chave Connect".

Utilize estes [cartões de teste](https://ajuda.pbintegracoes.com/hc/pt-br/articles/22375426666253) de acordo com as configurações e cenário que deseja testar.

Note que há diferenças entre cartões de teste e cartões para testar compras com 3D Secure habilitado.

Este é um plugin oficial?
-------------------------

[](#este-é-um-plugin-oficial)

Não. Mas sim por um parceiro oficial. Este é um plugin desenvolvido por Ligia Salzano, Ricardo Martins (e equipe/colaboradores), assim como outros para Magento e WooCommerce desenvolvidos no passado.

Apesar da parceria entre o desenvolvedor e o PagBank que concede descontos e benefícios, este NÃO é um produto oficial.

PagSeguro e PagBank são marcas do UOL.

Posso modificar e comercializar este plugin?
--------------------------------------------

[](#posso-modificar-e-comercializar-este-plugin)

O plugin é licenciado sob OSL 3.0 Você pode modificar e distribuir, contanto que suas melhorias e correções sejam contribuidas de volta com o projeto.

Você deve fazer isso através de Pull Requests ao [repositório oficial no github](https://github.com/r-martins/PagBank-Magento1).

Garantia
========

[](#garantia)

Conhecido como "software livre", este plugin é distribuido sem garantias de qualquer tipo.

O desenvolvedor ou PagBank não se responsabilizam por quaisquer danos causados pelo uso (ou mal uso) deste plugin.

Esta é uma iniciativa pessoal, sem vínculo com PagBank. PagBank é uma marca do UOL.

Este não é um produto oficial do PagBank.

Ao usar este plugin você concorda com os [Termos de Uso e Política de Privacidade](https://pbintegracoes.com/terms/?utm_source=github-m1&utm_content=readme).

Links úteis
===========

[](#links-úteis)

- [Site Oficial das Integrações PagBank por Ricardo Martins](https://pbintegracoes.com/?utm_source=github-m1&utm_content=readme)
- [Central de Ajuda](https://ajuda.pbintegracoes.com/hc/pt-br/)
- [Termos de Uso e Política de Privacidade](https://pbintegracoes.com/terms/?utm_source=github-m1&utm_content=readme)
- [Vídeos no Youtube](https://www.youtube.com/@Magenteiro/search?query=pagseguro)
- [Artigos](https://www.magenteiro.com/blog/tag/pagseguro)

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance82

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~16 days

Recently: every ~43 days

Total

42

Last Release

96d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/cc001164ed8af49820c2e2289141ad0168a056ef6fbe019f18d1847b8829417a?d=identicon)[r-martins](/maintainers/r-martins)

---

Top Contributors

[![r-martins](https://avatars.githubusercontent.com/u/191149?v=4)](https://github.com/r-martins "r-martins (134 commits)")[![ligiasalzano](https://avatars.githubusercontent.com/u/20398429?v=4)](https://github.com/ligiasalzano "ligiasalzano (103 commits)")[![csvitor](https://avatars.githubusercontent.com/u/100157056?v=4)](https://github.com/csvitor "csvitor (38 commits)")[![zpvini](https://avatars.githubusercontent.com/u/9328453?v=4)](https://github.com/zpvini "zpvini (1 commits)")

---

Tags

magento-extensionmagento-modulemagento1magento1-extensionmagento1-modulemahoopenmage-extensionopenmage-modulepagamentopagamento-magentopagbankpagbank-phppagseguropagseguro-transparentepayment-integrationmagentopaymentgatewayPagsegurocheckouttransparentopenmagepixmagento1transparente3dspagbank

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ricardomartins-pagbank-magento1/health.svg)

```
[![Health](https://phpackages.com/badges/ricardomartins-pagbank-magento1/health.svg)](https://phpackages.com/packages/ricardomartins-pagbank-magento1)
```

###  Alternatives

[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4845.9k](/packages/sebdesign-laravel-viva-payments)[abdala/omnipay-pagseguro

PagSeguro gateway for OmniPay

2523.3k1](/packages/abdala-omnipay-pagseguro)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
