PHPackages ricardomartins/pagbank-woocommerce - 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-woocommerce ActiveWordpress-plugin[Payment Processing](/categories/payments) ricardomartins/pagbank-woocommerce ================================== Integração PagBank (PagSeguro) WooCommerce com desconto nas taxas oficiais 4.54.0(1mo ago)3114GPL-3.0PHPPHP >=7.4CI passing Since Sep 5Pushed 1mo ago3 watchersCompare [ Source](https://github.com/r-martins/PagBank-WooCommerce)[ Packagist](https://packagist.org/packages/ricardomartins/pagbank-woocommerce)[ RSS](/packages/ricardomartins-pagbank-woocommerce/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (20)Versions (509)Used By (0) PagBank Connect (PagSeguro) - Nova Geração ========================================== [](#pagbank-connect-pagseguro---nova-geração) Com Descontos nas Taxas Oficiais -------------------------------- [](#com-descontos-nas-taxas-oficiais) *Por Ricardo Martins - Parceiro Oficial PagBank desde 2015.* [![Versão mínima do PHP](https://camo.githubusercontent.com/eb773fa94283cbea6c7b192d460983a781ae4a16409af56d109fe3e8e71ab6c9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230372e342d3838393242462e7376673f7374796c653d666c61742d737175617265)](https://php.net/)[![Última versão](https://camo.githubusercontent.com/0c50e631c1f227749acfc4ba7ec69c3aca7626720406c1b3d737dd201467f489/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f722d6d617274696e732f50616742616e6b2d576f6f436f6d6d65726365)](https://github.com/r-martins/PagBank-WooCommerce)[![Último commit (develop)](https://camo.githubusercontent.com/ef6e7d5d7624f4d80022b8ba0f58929f1ddd036dd76e2ec6bcd701a702e20463/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f722d6d617274696e732f50616742616e6b2d576f6f436f6d6d657263652f646576656c6f70)](https://camo.githubusercontent.com/ef6e7d5d7624f4d80022b8ba0f58929f1ddd036dd76e2ec6bcd701a702e20463/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f722d6d617274696e732f50616742616e6b2d576f6f436f6d6d657263652f646576656c6f70)[![WordPress Plugin: Tested WP Version](https://camo.githubusercontent.com/2e3884a0a032dfef22dd9342320bd7c2185c978b1a9900e1c181fd09dea058e8/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f7465737465642f70616762616e6b2d636f6e6e656374)](https://camo.githubusercontent.com/2e3884a0a032dfef22dd9342320bd7c2185c978b1a9900e1c181fd09dea058e8/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f7465737465642f70616762616e6b2d636f6e6e656374)[![Downloads por mês](https://camo.githubusercontent.com/084c114dba997545f7ec8fc507beaa9e95fff8300e5143ca81b3f58aa4817a60/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f646d2f70616762616e6b2d636f6e6e656374)](https://camo.githubusercontent.com/084c114dba997545f7ec8fc507beaa9e95fff8300e5143ca81b3f58aa4817a60/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f646d2f70616762616e6b2d636f6e6e656374)[![Avaliação dos clientes no WordPress](https://camo.githubusercontent.com/13f5cb408b7d8ca3060f953b9be0bf72fa7b2e87348db287394c1596b99aa6c9/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f73746172732f70616762616e6b2d636f6e6e6563743f636f6c6f723d79656c6c6f77)](https://camo.githubusercontent.com/13f5cb408b7d8ca3060f953b9be0bf72fa7b2e87348db287394c1596b99aa6c9/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f73746172732f70616762616e6b2d636f6e6e6563743f636f6c6f723d79656c6c6f77)[![Deploy pro WordPress SVN](https://github.com/r-martins/PagBank-WooCommerce/actions/workflows/releaseToSvnWp.yaml/badge.svg)](https://github.com/r-martins/PagBank-WooCommerce/actions/workflows/releaseToSvnWp.yaml) Conheça a Nova Geração das nossas integrações com PagBank (v. 4.0+). **Aceite Pix, Cartão de Crédito e Boleto de forma transparente e economize nas taxas oficiais.** **Integrado com EnvioFácil (economize até 70% no frete ao usar PagBank)¹** Veja alguns Screenshots (clique aqui para expandir) [![Cartão de Crédito na visão do cliente](https://camo.githubusercontent.com/13b3a6978a4b57816eb0fdcd039fd54c18228bb11097c91d471fdec101a5cc4c/68747470733a2f2f692e696d6775722e636f6d2f6570676d5757722e6a7067 "Cartão de Crédito na visão do cliente")](https://camo.githubusercontent.com/13b3a6978a4b57816eb0fdcd039fd54c18228bb11097c91d471fdec101a5cc4c/68747470733a2f2f692e696d6775722e636f6d2f6570676d5757722e6a7067) [![PIX - Tela de Sucesso](https://camo.githubusercontent.com/cda28454a6626c645660e771edb7966f972f5ebbe7d3633a2ac942fea11f19f7/68747470733a2f2f692e696d6775722e636f6d2f4677547a3733432e6a7067 "PIX - Tela de Sucesso")](https://camo.githubusercontent.com/cda28454a6626c645660e771edb7966f972f5ebbe7d3633a2ac942fea11f19f7/68747470733a2f2f692e696d6775722e636f6d2f4677547a3733432e6a7067) [![Configurações de cartão de crédito](https://camo.githubusercontent.com/807070b4ab405c55c37f8723628965b20f5088bae82c19ac3a73be9b1fca9eba/68747470733a2f2f692e696d6775722e636f6d2f774533594258582e6a7067 "Configurações de cartão de crédito")](https://camo.githubusercontent.com/807070b4ab405c55c37f8723628965b20f5088bae82c19ac3a73be9b1fca9eba/68747470733a2f2f692e696d6775722e636f6d2f774533594258582e6a7067) [![PIX e Boleto - Configurações](https://camo.githubusercontent.com/0b53cf24a48f02df6c3d9153aa3066f7b1639f31f4586a4c79cf938c97e12fc6/68747470733a2f2f692e696d6775722e636f6d2f6e68774d68554f2e6a7067 "PIX e Boleto - Configurações")](https://camo.githubusercontent.com/0b53cf24a48f02df6c3d9153aa3066f7b1639f31f4586a4c79cf938c97e12fc6/68747470733a2f2f692e696d6775722e636f6d2f6e68774d68554f2e6a7067) [![Admin - Tela do Pedido](https://camo.githubusercontent.com/1c0bdc437d469289e353d7d72ae88ebacbaba631b7090cf184e075677dfdd4a6/68747470733a2f2f692e696d6775722e636f6d2f434967544c6e762e6a7067 "Admin - Tela do Pedido")](https://camo.githubusercontent.com/1c0bdc437d469289e353d7d72ae88ebacbaba631b7090cf184e075677dfdd4a6/68747470733a2f2f692e696d6775722e636f6d2f434967544c6e762e6a7067) [![Envio Fácil](https://camo.githubusercontent.com/192cd6ba63c72360eec61915e0bfb8b3fad442e05657eb2912751197d01e771f/68747470733a2f2f692e696d6775722e636f6d2f6e516c4f4266782e6a7067 "Envio Fácil")](https://camo.githubusercontent.com/192cd6ba63c72360eec61915e0bfb8b3fad442e05657eb2912751197d01e771f/68747470733a2f2f692e696d6775722e636f6d2f6e516c4f4266782e6a7067) [![3D Secure](https://camo.githubusercontent.com/f43769010eca638ed03967f9cea67d08eef25de233bc15603ce201789cabe5a1/68747470733a2f2f692e696d6775722e636f6d2f6871686757664d2e6a7067 "3D Secure")](https://camo.githubusercontent.com/f43769010eca638ed03967f9cea67d08eef25de233bc15603ce201789cabe5a1/68747470733a2f2f692e696d6775722e636f6d2f6871686757664d2e6a7067) [![Venda Recorrente com Woo](https://camo.githubusercontent.com/0960d80527c075291990233157f8e7a59ab38069ea9e1c338bb85a996d8639e0/68747470733a2f2f696d6775722e636f6d2f3770514e776b762e6a7067 "Pedidos Recorrentes")](https://camo.githubusercontent.com/0960d80527c075291990233157f8e7a59ab38069ea9e1c338bb85a996d8639e0/68747470733a2f2f696d6775722e636f6d2f3770514e776b762e6a7067) Descrição ========= [](#descrição) [![](https://camo.githubusercontent.com/892f103603819beafb2dcca2a25b9cd3442167cf255f68067adbc296b2d9c229/68747470733a2f2f692e696d6775722e636f6d2f6e797279624e712e6a7067)](https://www.youtube.com/watch?v=L9Oans5dZ7M) Esta é a forma mais fácil de integrar sua loja com PagBank (PagSeguro). Ao instalar e configurar nossa integração, você pode aceitar Pix, Boleto e Cartão de Crédito com o meio de pagamento mais confiado pelos brasileiros. Criado por Ricardo Martins, esta é a 4ª geração das integrações PagSeguro, disponibilizadas desde 2014 no Magento, e desde 2019 no WooCommerce. Mais de 20 mil lojas atendidas e mais de 200 milhões de reais transacionados em nossas integrações. Instalação ========== [](#instalação) WP-CLI (mais fácil e rápido) ---------------------------- [](#wp-cli-mais-fácil-e-rápido) Você pode instalar o plugin usando o [WP-CLI](https://wp-cli.org/). - Basta rodar o comando `wp plugin install pagbank-connect --activate`. Adicione `--allow-root` se estiver rodando o comando como root. - Repita o processo para instalar o plugin [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) com o comando `wp plugin install woocommerce-extra-checkout-fields-for-brazil --activate` caso ainda não tenha ele instalado. Instalação manual ----------------- [](#instalação-manual) - Baixe o [arquivo zip](https://github.com/r-martins/PagBank-WooCommerce/archive/refs/heads/master.zip) - Crie um diretorio em wp-content/plugins chamado rm-pagbank - Descompacte o conteúdo do arquivo no diretório criado - Navegue até Plugins > Plugins instalados, e ative o plugin PagBank Connect - Ative o Checkout em Blocos *ou* Instale o plugin [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) a fim de habilitar campos adicionais de endereço e CPF, que são obrigatórios no PagBank. - Rode o comando `npm install` e `npm run build` na raiz do plugin para compilar os arquivos frontend. Instalação automática --------------------- [](#instalação-automática) - Navegue até Plugins > Adicionar Novo e procure por "PagBank Ricardo Martins" - Clique no botão para instalar e ative o plugin - Repita o processo buscando e instalando o plugin [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) a fim de habilitar campos adicionais de endereço e CPF, que são obrigatórios no PagBank. Configuração ============ [](#configuração) - Ative o meio de pagamento navegando até WooCommerce > Configurações > Pagamentos, e ativando o PagBank Connect - Clique no PagBank Connect para acessar as configurações do módulo - Clique em "Obter Credenciais". Você será levado para nosso site, onde poderá escolher o modelo de recebimento (14 ou 30 dias) e então autorizar nossa aplicação. - Ao clicar no modelo de recebimento desejado, você será levado para o site do PagBank, onde deverá se logar com sua conta e autorizar nossa aplicação. - Em seguida, será levado(a) de volta para nosso site, onde deverá preencher as informações do responsável técnico por sua loja. - Feito isso, sua *Connect Key* será exibida e enviada para o e-mail informado. Use ela nas configurações da sua loja. - 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. Pré-requisitos ============== [](#pré-requisitos) - Ter WooCommerce 4.0 ou superior - PHP 7.4 ou superior - Ter uma conta Vendedor ou Empresarial no PagSeguro/PagBank (e obter a sua Connect Key) - [Autorizar nossa integração](https://pbintegracoes.com/connect/autorizar/?utm_source=github&utm_medium=readme&utm_content=pre-requisitos) em sua conta PagBank. - Usar checkout em Blocos do WooCommerce **ou** Ter instalado o plugin [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) a fim de habilitar campos adicionais de endereço e CPF, que são obrigatórios no PagBank. 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 elas no nosso site. 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://pagsegurotransparente.zendesk.com/hc/pt-br/) e [entre em contato](https://pagsegurotransparente.zendesk.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. 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 plugin, seguir as instruções, e informar sua Connect Key de testes no campo indicado. Um link para mais detalhes sobre como utilizar a Sandbox está disponível na página de configurações do plugin. A equipe do PagBank está trabalhando numa correção. Enquanto isso, você pode testar com dados reais e realizar o estorno. As tarifas e taxas são reembolsadas, não incidindo nenhum custo. Este é um plugin oficial? ------------------------- [](#este-é-um-plugin-oficial) Não. Este é um plugin desenvolvido por Ricardo Martins, 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 GPL v3. 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-WooCommerce). 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&utm_medium=readme&utm_content=terms). Nota aos desenvolvedores ======================== [](#nota-aos-desenvolvedores) Para compilar os arquivos frontend digite `npm run build` no terminal, na raiz do plugin. Se desejar automatizar este processo, copie o arquivo `./git-hooks/post-checkout` para `.git/hooks/` e torne-o executável (`chmod +x .git/hooks/post-checkout`). --- ¹ A Integração com Envio Fácil está disponível apenas para lojas com integração 14 ou 30 dias. Embora utilizemos as APIs do PagSeguro para isso, eles não encorajam o uso dessas APIs. Use com cautela. O PagSeguro não oferece suporte para esta integração. ### Health Score 47 — FairBetter than 94% of packages Maintenance91 Actively maintained with recent releases Popularity11 Limited adoption so far Community16 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 75.8% of commits — single point of failure 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 ~6 days Total 128 Last Release 43d 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 (707 commits)")[![csvitor](https://avatars.githubusercontent.com/u/100157056?v=4)](https://github.com/csvitor "csvitor (132 commits)")[![ligiasalzano](https://avatars.githubusercontent.com/u/20398429?v=4)](https://github.com/ligiasalzano "ligiasalzano (83 commits)")[![marcelowillyan](https://avatars.githubusercontent.com/u/48092889?v=4)](https://github.com/marcelowillyan "marcelowillyan (9 commits)")[![deniscass](https://avatars.githubusercontent.com/u/9366219?v=4)](https://github.com/deniscass "deniscass (2 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/ricardomartins-pagbank-woocommerce/health.svg) ``` [![Health](https://phpackages.com/badges/ricardomartins-pagbank-woocommerce/health.svg)](https://phpackages.com/packages/ricardomartins-pagbank-woocommerce) ``` ### Alternatives [omnipay/paypal PayPal gateway for Omnipay payment processing library 3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto Biblioteca com boletos para o laravel 626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money. 1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php 2Checkout PHP Library 83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data Generate QR code data for SEPA payments 61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy Dummy driver for the Omnipay payment processing library 271.2M33](/packages/omnipay-dummy) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)