外掛說明
Aceite PagSeguro e PagBank (Pix, Cartão de Crédito, Boleto) em sua loja WooCommerce.
Economize nas tarifas oficiais do PagBank. Receba no crédito à vista a partir de 3,05% + R$0,00 de taxa de intermediação e PIX na hora por 0,99%. Veja tabela completa.
Esta é a forma mais fácil e gratuita 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.
⭐️Agora com taxas ainda menores (desde Agosto), válidas para lojas antigas e novas.⭐️
Economize nas taxas ⚡
Ao invés de pagar 3,99% + R$0,40 ou 4,99% + R$0,40 por transação aprovada no Cartão de Crédito, você pode optar por:
1. Recebimento em 30 dias: 3,05% + R$0,00 por transação aprovada no Cartão de Crédito
2. Recebimento em 14 dias: 3,97% + R$0,00 por transação aprovada no Cartão de Crédito
3. PIX: sempre 0,99% com recebimento na hora
4. Boleto: sempre 1,99% com recebimento em 2 dias
Se você tiver taxas negociadas ou condições negociadas melhores que estas, você também pode utilizá-las.
Consulte mais sobre elas e compare no nosso site.
Criado por Ricardo Martins (Parceiro oficial PagBank/PagSeguro desde 2014), 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.
Além disso, você também pode aceitar pagamentos recorrentes e criar clubes de assinatura sem depender de plugins de terceiros.
Problemas com aprovação de pagamentos e chargebacks em transações com cartão de crédito?
Nossa integração possui autenticação 3D Secure, que reduz drasticamente seus custos com chargebacks, e aumenta significativamente a taxa de aprovação.
Tudo pra você vender mais com PagBank(PagSeguro) sem sequer precisar se preocupar em contratar um serviço de antifraude.
- Termos de uso e softwares terceiros
Ao instalar o plugin PagBank Connect, você concorda com as Regras de uso do PagBank, seu Contrato de Serviço, Termos de Segurança, Privacidade e Compartilhamento, bem como os Termos de uso e Política de Privacidade do desenvolvedor.
⚡️ RECURSOS PRINCIPAIS
- Suporte a PIX, Cartão de Crédito e Boleto
- Suporte a recorrência (assinaturas), sem depender de outros plugins
- OnlyFans – Restrição de conteúdo só para assinantes. Restrinja o acesso à páginas e categorias somente pra quem é assinante. Saiba mais.
- Integração com Envio Fácil (economize até 70% no frete com Correios e Jadlog) sem precisar de contrato
- Suporte nativo ao checkout em Blocos do WooCommerce (sem gambiarras com iframes)
- Suporte a autenticação 3D Secure (reduza chargebacks e aumente suas aprovações)
⚡️ RECURSOS ADICIONAIS
- Diversas opções de parcelamento
- Suporte a descontos no boleto e pix (percentual ou fixo)
- Permite definir validade de boletos e código PIX (em dias ou minutos)
- Reembolso parcial ou total direto do painel do WooCommerce
- Atualizações automáticas de status de pedidos
- Configure como quer exibir o nome da loja na fatura do cartão de crédito
- Diversas opções de configuração de endereço
- Suporte a High-Performance Order Storage (HPOS): Este plugin é otimizado para ambientes com High-Performance Order Storage, garantindo um manuseio rápido e eficiente de seus pedidos WooCommerce.
- Exibição de informações de parcelas na página de produto em 3 formatos diferentes
- Permite exibir os meios de pagamento de forma individual ou agrupada (melhor experiência)
- Hooks disponíveis para facilitar integrações e modificações que você queira fazer sem sobrescrever o plugin. Veja documentação.
Instalação automática via painel
- Navegue até Plugins > Adicionar Novo e procure por “PagBank Ricardo Martins”
- Clique no botão para instalar e ative o plugin
- Se você não estiver usando o checkout em blocos (nativo do Woo), 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.
WP-CLI
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. - Se você não estiver usando o checkout em blocos (nativo do Woo), 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 e descompacte ele em sua máquina
- Faça upload dos arquivos na pasta /wp-content/plugins/pagbank-connect, usando seu FTP
- Navegue até Plugins > Plugins instalados, e ative o plugin PagBank Connect
- Se você não estiver usando o checkout em blocos (nativo do Woo), 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.
- No terminal, navegue até a pasta do plugin (wp-content/plugins/pagbank-connect) e rode
npm install
para instalar as dependências do plugin. Em seguida, rodenpm run build
para compilar os arquivos do plugin.
A gente instala pra você 🙀
Se você preferir, podemos instalar e configurar o plugin para você sem nenhum custo.
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 Connect Key”. Você será levado para nosso site, onde poderá escolher o modelo de recebimento (14 ou 30 dias) e então autorizar nossa aplicação sem nenhum custo ou mensalidade.
- No nosso site, selecione o modelo de recebimento desejado (14 ou 30 dias – ou suas condições negociadas) e preencha as informações do responsável técnico por sua loja.
- Você será levado para o site do PagBank, onde poderá se logar e autorizar nossa aplicação em sua conta.
- Em seguida, sua Connect Key será exibida e enviada para o e-mail informado no passo anterior. Use ela nas configurações da sua loja.
- Salve as configurações e sua loja está pronta para vender.
- Se desejar, configure opções de parcelamento, e validade do boleto e código pix de acordo com suas necessidades.
- Conheça os recursos disponíveis na sua integração para aproveitar ao máximo dela e vender ainda mais.
螢幕擷圖
常見問題集
-
PagSeguro ou PagBank?
-
Em 2023 o PagBank e o PagSeguro se tornaram uma única empresa: PagBank.
E não se preocupe, os serviços que você usa não serão afetados.
-
Quais os requisitos para usar esta integração?
-
- Ter WooCommerce 4.0 ou superior
- PHP 7.4 ou superior
- Ter uma conta Vendedor ou Empresarial no PagSeguro/PagBank
- Autorizar nossa integração em sua conta PagBank.
- Usar o Checkout em Blocos (nativo) 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.
-
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á 3,97% ou 3,05% e estará isento da taxa de R$0,40 por transação.
Taxas menores também são aplicadas para transações parceladas, PIX e Boleto. PIX e Boleto também possuem prazos menores de recebimento.
-
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.
Ao autorizar sua conta, escolha a opção “Suas condições e taxas”.
Sua Connect key será gerada respeitando as taxas e condições negociadas que você tem com o PagSeguro/PagBank.
-
Estou tendo muitas transações negadas. O que fazer?
-
Consulte este artigo e entre em contato conosco se o problema persistir.
-
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.
Caso utilize Cloudflare ou CDN, certifique-se de configurá-lo corretamente e liberar os IPs do PagSeguro para evitar bloqueios nas notificações.
-
Posso testar usando a Sandbox?
-
Sim. 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.
Você também 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, parceiro PagBank desde 2014.
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.
-
O plugin é compatível com o WooCommerce Subscriptions?
-
Você não precisa do plugin WooCommerce Subscriptions ou nenhum outro para aceitar pagamentos recorrentes com nossa integração.
-
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.
使用者評論
參與者及開發者
變更記錄
4.25.3
- Corrige erro na exibição de lista de pedidos associados a uma assinatura quando um dos pedidos foi reembolsado. Reportado por Dennis (Sysney Informática).
4.25.2
- Cartflows: corrigido erro de valor inválido no payment_method.card.encrypted quando usado com o plugin Cartflows.
4.25.1
- Correção: Possível erro ao finalizar compras de pedidos recorrentes sem restrição de conteúdo (array_merge argument 2 must be array). Reportado por Dennis (Sysney Informática).
4.25.0
- Recorrência agora tem suporte a restrição de conteúdo só para assinantes. Você pode restringir o acesso à páginas e categorias somente pra quem é assinante.
- Correções e melhorias diversas no recurso de assinaturas. Corrigimos um problema onde uma assinatura pendente de cancelamento não era cancelada, tratamos algumas exceções que poderiam atrasar a cobrança de outras assinaturas, e muito mais.
- Adicionamos detalhes aos logs sobre a assinatura que foi cancelada. Seja por conta de um cancelamento esperado como por um erro no pagamento da recorrência.
- Adicionamos novas actions na recorrência que podem ser úteis para quem deseja estender esta funcionalidade em outros plugins.
- Adicionada opção para marcar pedidos como completo quando só tiver produtos virtuais
4.24.1
- Correção Recorrência: quando a primeira tentativa de fechar um pedido falhava (ex: cartao negado) o pedido era criado de forma insuficiente, impossibilitando o processamento da recorrência para futuros pedidos.
4.24.0
- Recorrência: agora é possível configurar o plugin para excluir outros produtos do carrinho, evitando que a mensagem de que produtos recorrentes devem ser comprados sozinhos seja exibida.
- Envio Fácil só exibia uma forma de envio (geralmente a mais cara) ao invés de exibir todas disponíveis.
- Correção: em alguns temas o cálculo de parcelas era chamado na tela de sucesso, fazendo com que uma msg de erro fosse logada no pagbank-connect.log.
4.23.0
- Adicionado suporte ao WP 6.7 e WooCommerce 9.4.
- Melhoria: agora você não precisa mais de plugins de terceiros para disparar e-mail de novo pedido com código PIX ou Boleto. Basta ativar a opção nas configurações.
- Pequena correção de notice de payment_method não definido em algumas situações quando usado com checkout em blocos.
- Melhoria: notamos que algumas lojas enviavam ou permitiam enviar o campo Estado com letras minúsculas, ocasionando erro na finalização da compra. Agora tratamos isso no próprio plugin antes do envio.
4.22.2
- Ajuste: devido a um bug no plugin
pix-por-piggly
algumas lojas tiveram problemas com nossa última atualização. Refizemos a última correção de outra forma, a fim de não ser mais impactado pelo bug no outro plugin.
4.22.1
- Ajuste: logo após a instalação do plugin, uma falha na validação da disponibilidade de usar icones com cored dinâmicas tornava o admin bem lento por alguns segundos. Refatoramos o momento que a validação é feita evitando problemas com loops. 🙂
4.22.0
- Melhoria: detecção automática de bandeira no checkout em bloco
- Melhoria: não exibimos mais o seletor de parcelas em pagamentos recorrentes (já que era sempre 1x)
- Melhoria: agora os ícones dos meios de pagamento também aparecem no checkout em blocos
- Melhoria: removemos o efeito hover nos campos do plugin no checkout em blocos, que substituia os placeholders por / (por exemplo)
- Melhoria: campo de data de validade do cartão adicionará 0 quando o primeiro número digitado for maior que 1. Ex: 2, ficará 02/, assim como ocorre no form nativo no Woocommerce legado.
- Mudança interna: removemos os arquivos da pasta build do nosso git. Se você instala nosso plugin via git ou composer, precisará compilá-los manualmente com npm run build. Mais detalhes no README.md.
- Correção: dependendo da configuração da loja, o checkout em blocos permitia o envio do formulário e checkout em pedidos menores que R$1,00, ocasionando erro de CPF/CNPJ
4.21.1
- Pequena correção no dropdown de parcelas em pagamentos recorrentes (quebrado na última versão)
- Normalizamos a nomenclatura de “sem juros” que antes aparecia “sem acréscimo” em alguns casos no dropdown de parcelamento
4.21.0
- Adicionado suporte ao novo Checkoutem Blocks do WooCommerce
4.20.2
- Correção importante: em alguns casos uma falha de arredondamento na autenticação 3d em compras parceladas fazia com que o pedido não pudesse ser concluído, ocasionando erro ‘payment_method.authentication_method.id (Autenticação 3D – Recarregue e tente novamente)’.
4.20.1
- Correção: instruções de boleto e pix pararam de ser adicionadas na tela de sucesso após nossa última atualização
4.20.0
- Suporte a reembolso parcial ou total via painel do WooCommerce
- Correção: problema de compatibilidade com alguns plugins ocasionavam falha na finalização de pedidos com cartão de crédito (40002 – Valor inválido. Parâmetro: charges[0].payment_method.card.encrypted (Criptografia do cartão)).
- Bling: agora o Bling identificará em quantas parcelas um pedido com cartão de crédito foi feito. Veja como integrar.
- Nota importante: a partir desta versão o
payment_method
salvo no pedido não será maisrm-pagbank
para todos os métodos, e terá o sufixo -cc, -pix ou -boleto para identificar o método de pagamento. Isso pode afetar integrações que dependem deste campo.
4.19.0
- Melhoria: agora exibimos que um pedido foi pago ainda na tela de sucesso se ele for pago nos primeiros 10 minutos.
- Melhoria: atendendo a pedidos, o ícone de Copiar exibido na tela de sucesso de PIX e Boleto passou a ser um botão ao invés de ícone.
4.18.1
- Performance: um problema na forma como lidávamos com as configurações e cache do parcelamento na página de produto afetavam significativamente a performance da loja em várias páginas, mesmo que o recurso estivesse desabilitado. Mudamos totalmente a forma como limpávamos o cache (que afetava lojas com muitos produtos) quando uma configuração de parcelamento era realizada e a quantidade de vezes que isso era feito
- Correção: Chamar o load_text_domain no plugins_loaded ficou depreciado e warnings passarão a ser exibidos.
4.18.0
- Correção/Melhoria: em algumas situações onde um erro acontecia no retorno do PagBank no backend, o pedido era finalizado com sucesso. Isso fazia com que pedidos com PIX e Boleto fossem gerados sem QrCode ou QrCode Inválido. O mesmo ocorria em pedidos trial em recorrência e em outros cenários. Agora começamos a tratar os erros e exibi-los para o cliente de forma amigável.
- Adicionado link para os Logs no menu PagBank (quando em DEBUG mode).
4.17.1
- Correção: em alguns cenários onde o ícone dinamico não era acessível, a validacao interna falhava dizendo que era acessivel, fazendo com que o ícone dos pagamentos permanecesse quebrado (imagem invalida).
4.17.0
- Melhoria: Se por algum motivo os ícones com cores personalizadas não puderem ser exibidos (ex: plugin de segurança afetando funcionamento), usaremos a imagem estática e exibiremos um aviso no admin ao salvar as configs do pagbank.
4.16.0
- Melhoria: agora informações do PIX ou do Boleto também são enviadas no e-mail transacional
- Melhoria: alguns administradores digitavam o token PagBank (nunca solicitado) no campo da Connect Key. Agora validamos isso e avisamos ele sobre o engano.
- Melhoria: fazemos validação no último pedido pix a fim de ver se há erro de chave pix inválida causada pela não existência de chaves aleatórias na conta PagBank. Agora fazemos isso com bem menos frequência, ou uma vez só se estiver tudo certo. Isso deve melhorar a performance do plugin na área administrativa.
- Correção: em lojas com HPOS desabilitado e com WooCommerce 9.2.0 ou superior, um Notice era gravado (ou exibido) dizendo que o método
WC_Order_Data_Store_CPT::query
foi chamado incorretamente.
4.15.0
- Melhorias gerais de código, performance, e boas práticas em todo plugin. Trata-se de uma grande mudança na forma como o plugin é estruturado internamente e nos possibilitará evolui-lo com mais segurança e menos bugs.
- Mudança: descontinuamos a opção de exibir os métodos de pagamento de forma agrupada. Agora eles são exibidos de forma individual, o que é mais amigável e intuitivo para o admin.
- Correção: na conversão de minutos da expiração do PIX para o usuário (ex: 43200 minutos era exibido como 7 dias)
4.14.0
- Melhoria: Mensagem amigável e opção de esconder os meios de pagamento para pedidos inferiores a R$1,00
- Melhoria: truncamos alguns campos como nome do cliente e alguns campos de endereço a fim de evitar erros na finalização do pedido quando o valor informado é maior que o permitido pelo PagBank.
- Correção de Uncaught Error: Call to a member function get_edit_order_url() on bool na listagem de assinaturas ativas do admin em alguns cenários
- Correção: quando desabilitávamos a opção de pausar ou cancelar assinatura (para o usuário), as opções também deixavam de ser exibidas para o administrador em alguns cenários
4.13.0
- Agora é possível definir período de teste e opções de descontos para assinaturas.
- APIs: obtenha informações detalhadas dos pagamentos feitos com pagbank nos metadados do pedido via API Rest do próprio WordPress/Woo
4.12.0
- Agora é possível remover os botões de Cancelar ou Pausar assinatura na área do cliente
- Agora o administrador pode alterar o valor de uma assinatura no admin
4.11.7
- Melhoria: adicionado NSU e Authorization code aos meta dados do pedido, para facilitar conciliação
- Melhoria: agora validamos o order_id do pedido quando uma notificação é recebida, evitando que pedidos com mesmo ID sejam atualizados erroneamente e em alguns casos alterando pedidos pagos para cancelados.
- Correção: símbolo da moeda (R$) aparecia duplicado no formulário de pagamento em vendas recorrentes
4.11.6
- Melhoria: agora quando você marca para exibir meios de pagamento separadamente, a opção de selecionar como o titulo sera exibido é omitida, evitando confusão (já que esta opção não terá efeito algum)
- Corrige erro no tamanho dos ícones quando meios de pagamento eram exibidos individualmente, em alguns checkouts como Porto
- Mudamos a forma como obtemos o preço do produto na finalização de compra, a fim de corrigir erros de compatibilidade com alguns plugins e tornar o processo mais enxuto e rápido
4.11.5
- Pequena melhoria: adicionamos alguns hooks com filters e actions para facilitar integrações e modificações que você queira fazer sem sobrescrever o plugin. Veja documentação.
4.11.4
- Correção: alguns plugins de terceiros não utilizam filtros corretamente, fazendo com que nosso css não seja inserido e o checkout apresente problemas, como ícones grandes e afins. Contornamos o problema aqui.
4.11.3
- Correção em falha que impedia o EnvioFacil de ser habilitado
4.11.2
- Correção: em alguns cenários, o campo de CPF, número do endereço e bairro não eram enviados corretamente ocasionando falha no fechamento do pedido (especialmente em Boletos).
4.11.1
- Correção: nosso validador de chaves pix adicionado na versão anterior apontava para pedidos não-pix
- Correção: a mensagem de validação do pix não era ignorada em alguns cenários após dispensá-la
4.11.0
- Melhoria: agora o plugin exibe uma mensagem de erro no admin caso o código PIX esteja sendo gerado incorretamente por conta de algum problema em sua conta PagBank (geralmente porque você não cadastrou a chave aleatória).
- Correção: o valor dos produtos era informado de forma incorreta ao PagBank quando múltiplos do mesmo item estavam presentes no pedido (embora o valor cobrado estivesse correto).
4.10.2
- Correção em erro no cálculo de parcelas. Em alguns cenários, dependendo das regras de parcelamento, quando o total de parcelas sem juros era = 1, poderia ocasionar erro na pagina de produto (se as parcelas estivessem sendo exibidas la) e no dropdown de parcelamento do checkout.
- Correções diversas em warnings e notices em versões mais novas do PHP 8.1 e 8.2 que poderiam aparecer no admin, e em algumas etapas do pedido quando modo debug estava ativo.
4.10.1
- Correção de erro “get_cart was called incorrectly” era exibido quando usado em conjunto com alguns outros plugins (como Mercado Pago), em alguns casos quebrando o carrinho.
- Alteramos a forma como o uso de shortcode de parcelamento é usado. Agora você deve habilitar ele nas configurações. Isso evita que ele seja adicionado em duplicidade.
- Corrigido falha na compra de produto recorrente quando meios de pagamento eram configurados para ser exibidos de forma separada. A mensagem Método de pagamento inválido era exibida.
- Melhoramos a descrição de alguns dos campos de configuração de cartão de crédito, a fim de deixar mais claro o que cada um faz e com mais links para documentação.
4.10.0
- Emails: agora o administrador e cliente só receberão e-mails notificando que um pedido foi criado se o mesmo tiver sido pago.
- Correção/Mudança: agora pessoas com permissão de gerente de loja e administradores poderão ter acesso ao menu PagBank. Antes somente administradores tinham acesso.
- Agora é possível usar o shortcode [rm_pagbank_credit_card_installments] para exibir as parcelas de um produto em layouts personalizados.
- Corrigido Erro na exibição das parcelas quando opção ‘Texto com parcela máxima’ era selecionado em alguns cenários.