Beschrijving
Aceite PagSeguro e PagBank (Pix, Cartão de Crédito, Boleto) em sua loja WooCommerce.
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 tarifas oficiais do PagBank. Receba no crédito à vista a partir de 3,05% + R$0,00 de taxa de intermediação. Veja tabela completa.
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 suporta 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
- Suporte a PIX, Cartão de Crédito e Boleto
- Suporte a recorrência (assinaturas), sem depender de outros plugins
- Integração com Envio Fácil (economize até 70% no frete com Correios e Jadlog) sem precisar de contrato
- Suporte a autenticação 3D Secure (reduza chargebacks e aumente suas aprovações)
- Diversas opções de parcelamento
- Suporte a descontos no boleto e pix
- Permite definir validade de boletos e código PIX
- 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
- 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. - 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
- 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.
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.
- Ao clicar no modelo de recebimento desejado, você será levado(a) 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 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.
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.
Schermafdrukken
FAQ
-
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.
- 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.
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.
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.
Beoordelingen
Bijdragers & ontwikkelaars
“PagBank / PagSeguro Connect para WooCommerce” is open source software. De volgende personen hebben bijgedragen aan deze plugin.
Bijdragers“PagBank / PagSeguro Connect para WooCommerce” is vertaald in 1 taal. Dank voor de vertalers voor hun bijdragen.
Vertaal “PagBank / PagSeguro Connect para WooCommerce” naar jouw taal.
Interesse in ontwikkeling?
Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.
Changelog
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).