ricardomartins/pagbank-woocommerce

Integração PagBank (PagSeguro) WooCommerce com desconto nas taxas oficiais

4.25.6 2024-12-16 00:37 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-dom: *
• ext-json: *

Requires (Dev)

• codeception/codeception: ^5.1
• codeception/module-asserts: ^3.0
• codeception/module-webdriver: ^4.0
• dealerdirect/phpcodesniffer-composer-installer: ^1.0
• lucatume/wp-browser: ^4.3
• phpstan/phpstan: ^1.11
• squizlabs/php_codesniffer: ^3.10
• wp-coding-standards/wpcs: ^3.0
• yoast/phpunit-polyfills: ^2.0

Suggests

• ext-openssl: Enabling the OpenSSL extension allows you to use secure encryption and decryption functions.

GPL-3.0

• Ricardo Martins

README

Com Descontos nas Taxas Oficiais

Por Ricardo Martins - Parceiro Oficial PagBank desde 2015.

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)

Descrição

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

WP-CLI (mais fácil e rápido)

Você pode instalar o plugin usando o WP-CLI.

• 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 com o comando wp plugin install woocommerce-extra-checkout-fields-for-brazil --activate caso ainda não tenha ele instalado.

Instalação manual

• Baixe o arquivo 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 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

• 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 a fim de habilitar campos adicionais de endereço e CPF, que são obrigatórios no PagBank.

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

• 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 em sua conta PagBank.
• Usar checkout em Blocos do WooCommerce ou Ter instalado o plugin Brazilian Market on WooCommerce a fim de habilitar campos adicionais de endereço e CPF, que são obrigatórios no PagBank.

Perguntas Frequentes (FAQ)

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?

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

Consulte nossa Central de ajuda e entre em contato 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?

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?

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?

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?

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.

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.

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.