PagSeguro / PagBank Connect para WooCommerce Plugin

Aceite PagSeguro e PagBank (Pix, Cartão de Crédito, Boleto) em sua loja WooCommerce.

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 (Parceiro oficial PagBank/PagSeguro desde 2015), 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.

Features

• 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
• Atualiçõ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.

Saiba mais.

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.

1. 

   Cartão de Crédito na visão do cliente

2. 

   PIX - Tela de Sucesso

3. 

   Configurações de cartão de crédito

4. 

   PIX e Boleto - Configurações

5. 

   Admin - Tela do Pedido

6. 

   Envio Fácil

7. 

   Autenticação 3D Secure

8. 

   Pedidos Recorrentes (assinaturas)

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.

4.9.3

• Correção: quando usado em conjunto com alguns plugins, chamadas ao jQuery falhavam e impediam a finalização do checkout com erros na criptografia do cartão, entre outras coisas.
• Correção: quando linhas em branco eram inseridas pelo wp-load ou um de seus arquivos/plugins, a imagem dinâmica dos ícones das formas de pagamento não eram exibidas corretamente.
• Correção: ao desativar o plugin um modal de feedback é exibido. No entanto, se a pessoa mudasse de ideia e clicasse em Cancelar, nada acontecia.

4.9.2

• Correção: ícones muito grandes em alguns temas
• Correção: ao clicar em “Configurar” na lista de pagamentos (ao invés de ir em PagBank > Configurações) nenhuma alteração feita era salva.

4.9.1

• Correção: quando exibir meios de pagamento de forma separada estava ativada, os meios de pagamento apareciam mesmo quando desativados.

4.9.0

• Agora é possível exibir os meios de pagamento de forma individual (ideal para caso você aceite outros meios de pagamento além do PagBank)
• Agora quando um carrinho for recorrente (contiver produtos recorrentes PagBank), somente os meios PagBank suportados serão exibidos.

4.8.0

• Agora é possível exibir informações de parcelamento na página do produto em 3 formatos diferentes

4.7.2

• Melhoria: agora ao desativar o plugin damos a opção de você adicionar um comentário com mais detalhes sobre o motivo da desativação.
• Melhoria: agora exibimos um aviso no admin caso o checkout em blocos esteja em uso.

4.7.1

• Melhorias gerais no JavaScript do plugin
• Melhoria: adicionado métodos de criptografia no Helper do plugin. Por enquanto usado somente em um caso específico na página de pagamento avulso (order-pay).
• Correção: cálculo de parcelas poderia falhar em alguns cenários quando usado em modo Sandbox, exibindo uma opção com mensagem “undefined…”.
• Correção: ao fazer um pedido com pix ou boleto e navegar até a área de meus pedidos, o cliente pode clicar em Pagar e escolher outro meio de pagamento. No entanto, pagamento com cartão e 3Ds não funcionava nesta página. Refizemos algumas coisas para tornar isso possível. Isso também traz compatibilidade a plugins de autorização de pedido (como Order Approval for Woocommerce). Reportado por Tiago da Tikovolpe.
• Melhoria: instalação via composer agora sugere que habilite extensão openssl do PHP, a fim de ter melhor criptografia. No momento a criptografia só é usada para o número do pedido, na página de pagamento avulso (/order-pay).
• Melhorias: code standards

4.7.0

• Melhoria: cliente passa a receber e-mail informando que o pedido foi cancelado automaticamente após expiração do PIX. Sugerido por Fellipe (The Growth Space).
• Melhoria: agora é possível excluir o valor frete ao dar desconto em boleto e pix, aplicando o desconto somente aos produtos. Sugerido por Fabio (Kaizen Digital).

4.6.3

• Melhoria/Correção: quando determinada configuracao do php era realizada, os ícones dos meios de pagamento não eram exibidos. Reportado por Daniel Carvalho.

4.6.2

• Adicionado suporte ao WooCommerce 6.5
• Adicionado dependencia do plugin Brazilian Market on WooCommerce, evitando erros de campos obrigatórios em algumas lojas
• Pequenas melhorias de segurança (wp standards compliance)

4.6.1

• Correção: quando o cliente digitava um cartão inválido ou incompleto e tentava finalizar o pedido, ocasionando falha na criptografia do cartão, o pedido ainda era submetido para o backend e gerando outros erros desnecessários, especialmente se outros campos também estivessem errados ou faltando. O mais clássico era o erro 40002 de encrypted_card.id incorreto.
• Correção: ao desativar e ativar novamente o plugin, um erro de SQL era gerado internamente devido a um bug no WordPress e uma mensagem de que o plugin teria gerado cerca de 1400 caracteres de saída inesperada durante a ativação era exibida no backend.

4.6.0

• Pedidos PIX agora são cancelados automaticamente após periodo de expiração se não forem pagos
• Em alguns checkouts com plugins personalizados (ex: cartflows) o CSS de nosso plugin não era inserido corretamente, ocasionando quebra de layout e ignorando as cores dos ícones configuradas.
• Ao desativar nosso plugin, agora exibimos uma pergunta sobre o motivo da desativação, para que possamos melhorar o plugin.

4.5.0

• Adicionado suporte a HPOS (High-Performance Order Storage) para ambientes com este recurso ativado.
• Correção de problemas relacionados aos campos de endereço quando HPOS está ativo.
• Correção em erro 40002 quando o campo complemento de endereço não foi preenchido

4.4.4

• Correção: em alguns cenários, quando havia algum erro e o cliente tentava finalizar um pedido com cartão novamente, um erro 40002 em payment_method.card.encrypted era exibido
• Melhoria em mensagem específica de erro quando o e-mail do cliente está incorreto

4.4.3

• Correção: ao tentar pagar um pedido novamente descontos de PIX ou Boleto eram re-aplicados. Reportado por Fabio (Kaizen digital) e Igor Onofri.

4.4.2

• Correção: ao tentar finalizar pagamentos com Boleto usando CNPJ um erro 40002 era exibido. Reportado por Patrick (ctec).

4.4.1

• Melhoria: Quando o usuário começava a digitar um cartão, o sistema detectava a bandeira como Visa, mesmo que não fosse um cartão deste tipo. Só após o sexto dígito é que a bandeira correta era identificada. Reportado por Lucas Melo.
• Correção: Logo PagBank aparecia muito pequeno em dispositivos móveis. Reportado por Jhonny Robson
• Correção: o campo de Adicionar X dias à estimativa de frete trazia o cep da loja como placeholder. (oops) Embora pudesse causar certa confusão, o valor não era somado (indevidamente) à estimativa.
• Correção: em alguns cenários de compra de Produtos Virtuais, atributos de endereço de cobrança não eram repassados corretamente para o endereço de envio, ocasionando erro na finalização de compra (Bairro, Numero, etc). Reportado por Marcio Gazetta.

4.4.0

• Agora é possível adicionar X dias ao cálculo de frete (Envio Fácil)
• Agora é possível ajustar o preço do frete de forma fixa ou percentual, como desconto ou acréscimo (Envio Fácil)
• Redução de requisições ajax no checkout com 3d
• Melhoria para contornar erro de credit_car_bin not found quando estamos testando em Sandbox (já que o PagBank não atualiza os cartões de teste).
• Pequenos ajustes estéticos de código e espaçamentos, e conformidade com padrões do PCP.
• Melhorias de segurança.
• Correção de erro em payment_method.authentication_method.id invalid_parameter quando alguns pagamentos em 3D com parcelamento maior que 1 parcela era finalizado.
• Corrige problema com exibição de validade do código pix quando era maior que 60 minutos e menos que 1 dia. Nesses cenários a validade do Pix não era informada ao cliente no frontend.
• Corrigindo erro Call to undefined function wp_add_notice em alguns cenários no admin.
• Melhoria em mensagens de erro de e-mail inválido, nome do titular do cartão inválido e cartão criptografado com problema.

4.3.1

• Correção em erro grave que eliminava CSS de várias páginas causando quebras de layout em vários cenários, mesmo onde o plugin não era inserido (Reportado por William T. e outros). O problema foi introduzido na versão 4.3.0.
• Ajustes no CSS de configuracao de cor dos icones, logo e afins
• Agora é possível escolher a cor dos ícones via admin
• Corrigido css que fazia o nome ou logo do PagBank aparecerem abaixo do radio button
• Em algumas situações, era provável que uma autenticação 3D fosse rejeitada ocorrendo erro ‘authentication_method.id’ invalido. É provável que isso ocorresse quando um consumidor esperasse mais de 11 minutos para preencher e concluir os dados do checkout, e somente quando um outro cliente chegou ao checkout há menos de 20 minutos mas não concluiu uma compra (Reportado por William T.). Também melhoramos a mensagem de erro nestes casos, recomendando atualização de página.
• Melhoria na forma como os ícones são inseridos para possibilitar personalização via css (não usarmos mais <img..)
• Correção em aviso de depreciação do jQuery .change (embora isso não afetava o funcionamento do plugin)
• Ao invés de mostrar JOSÉ DA SILVA como placeholder do campo de titular de cartão, agora exibimos “como gravado no cartão”, e o nome sempre será em caixa alta
• Ícones de pagamento podem ter ficado maior em alguns checkouts. Instruções para personalização foram adicionados ao admin.

4.3.0

• Adicionado suporte a venda recorrente (clube de assinatura) sem depender de outros plugins

4.2.14

• Correção: dependendo do valor total do pedido, quando a autenticação 3d estava ativada, o erro ‘amount.value must be an integer’ era exibido
• Melhoria: pequeno ajuste na mensagem de erro acima
• Melhoria: algumas atualizações do plugin não surtiam efeito para alguns usuários devido a cache forçado do navegador ou configuração de outros plugins

4.2.13

• Correção: Parametro inválido (payment_method.card.encrypted) era exibido em alguns cenários, impedindo a finalização da compra.
• Correção: tags html eram exibidas nas configurações do Envio Facil no admin. Não afetava o funcionamento, mas era feio. 🙂
• Melhoria: na ferramenta de diagnóstico, para exibir configurações de 3d secure

4.2.12

• Correção/Melhoria: quando usado em conjunto com alguns plugins, em alguns casos não era exibido na lista de meios de pagamento disponíveis, e as configurações do plugin não eram carregadas. (Reportado por Leonardo)

4.2.11

• Correção: imagem e códigos pix e boleto não eram exibidos se recurso de High-performance order storage (HPOS) estivesse ativado

4.2.10

• Correção: compras com CNPJ exibiam erro 40002. (Reportado por Therus)

4.2.9

• Re-correção do problema anterior. Algo deu errado na publicação.

4.2.8

• Correção: após 4.2.6, ao desabilitar o 3d secure, o cartão de crédito deixava de ser exibido no checkout. (Reportado por Junior Marins)

4.2.7

• Correção: Erro era exibido no admin após última atualização. :O (Fatal error: Uncaught Error: Call to a member function get_total() on null)

4.2.6

• Melhoria: PagBank deixa de ser exibido se valor total do pedido for menor que R$1,00, evitando erro 40002 charges[0].amount.value is invalid. PagBank não aceita pedidos abaixo deste valor.
• Correção: Sempre usávamos kg como medida de peso para cálculo do envio fácil, fazendo com que lojas que configuraram o peso em outra medida tivesse o cálculo incorreto (geralmente não devolvendo nenhuma cotação).
• Correção: quando um cliente decide pagar um pedido posteriormente indo em Minha conta > Pedidos > Pagar, o dropdown de parcelas do cartão não carregava como esperado. (Reportado por Therus)
• Correção: em warning logado (undefined index $active[‘boleto’] e $active[‘pix’]
• Correção: exceção era gerada se a API do 3D Secure estiver fora do ar e o recurso ativo.
• Melhoria: caso a opção de 3D Secure esteja ativo, mas a API 3D estiver fora do ar, o cartão de crédito não será exibido para o cliente caso a opção de “Permitir concluir” não estiver marcada. Nestes casos, um aviso será exibido pedindo que recarregue a página. (Reportado por Martin)

4.2.5

• Correção: em versões antigas do WooCommerce (ex: 6.4), em pedidos com cartao, o checkout era recarregado ao tentar finalizar compra, sem concluir o pedido. (#2)
• Melhorias e refatoracao no JS de cartão de crédito, que agora não é mais inserido na página de sucesso desnecessariamente.
• Mais melhorias em possíveis mensagens de erro no retorno de validações 3DSecure.
• Mais ajustes pequenos em traduções, solicitados pela equipe do WordPress

4.2.2

• Ajustes diversos para compatibilidade com requisitos do WP Marketplace
• Corrigido problema onde, em alguns cenários, logo após desativar a autenticação 3D, o plugin ainda tentava autenticar usando este método e gerando erro

4.2.1

• Pequenos ajustes de compatibilidade para estar de acordo com os requisitos do marketplace do WP Marketplace

4.2.0

• Adicionado suporte a autenticação 3D Secure, reduzindo drasticamente seus custos com chargebacks, e aumentando significativamente a taxa de aprovação.
• Passamos a cachear algumas chamadas repetidas, aumentando significativamente a performance do processo de checkout.

4.1.5

• Corrigido problema no carregamento inicial de parcelas. Uma mudança no PagBank fez com que as parcelas iniciais não fossem carregadas até que o cliente informasse o número do cartão.

4.1.3

• Corrigido problema que ocorria em alguns checkouts (ex: FunnelKit) onde, ao atualizar o meio de frete, o valor da parcela do cartão não era atualizado corretamente. Reportado por Philippe.

4.1.2

• Corrigido problema onde EnvioFacil não era suportado em aplicações autorizadas no modelo de recebimento em 30 dias (Reportado por Ligia Salzano)

4.1.1

• Corrigido problema de erro com unit.amount nos casos onde um ou mais produtos com valor zero está presente
• Administrador da loja agora recebe e-mail de novo pedido

4.1.0

• Mensagens mais amigáveis de erro ajudam o cliente a saber que parâmetro precisa ser corrigido
• Agora há opção de ocultar o endereço de entrega, evitando erros de validação de endereço em vários cenários.

4.0.0

• Lançamento da primeira versão Connect, com suporte a PIX, Cartão de crédito, e Boleto.