PagBank / PagSeguro Connect para WooCommerce
| 开发者 | martins56 |
|---|---|
| 更新时间 | 2026年5月7日 10:08 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv3 |
| 版权网址: | 版权信息 |
标签
下载
详情介绍:
屏幕截图:
常见问题:
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% respectivamente e estará isento da taxa de R$0,40 por transação. Sem mensalidades. Taxas menores também são aplicadas para transações parceladas, PIX e Boleto. PIX e Boleto também possuem prazos menores de recebimento. Por exemplo, com PIX a taxa é de apenas 0,99% e o valor estará disponível em sua conta PagBank na hora.
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 o status do mesmo direto no site oficial. Se estiver tendo problemas com atualizações dos pedidos, consulte este artigo. Ele contém várias soluções para identificar e corrigir qualquer problema desta natureza.
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 (e colaboradores), 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.
Qual diferença deste plugin pro oficial?
Nosso plugin está em constante evolução, possui recursos exclusivos e é desenvolvido por um parceiro oficial PagBank desde 2014. Além disso você conta com um suporte profissional e eficiente. Por estas e outras razões, muitos lojistas e agências profissionais preferem nossa integração.
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.
O plugin funciona com lojas físicas (POS)?
Não, este plugin é exclusivo para vendas online (e-commerce) via WooCommerce.
Posso aceitar pagamentos internacionais?
O plugin aceita cartões internacionais, mas os pagamentos são processados em reais (BRL) através da conta PagBank brasileira e exige um CPF/CNPJ para finalização. Ainda estamos analisando junto ao PagBank uma forma de contornar essa exigência.
Como funciona o reembolso?
Você pode fazer reembolsos parciais ou totais diretamente do painel do WooCommerce. O valor é estornado automaticamente na conta do cliente.
O plugin funciona offline?
Não. É necessário conexão com internet para processar pagamentos, pois a comunicação é feita em tempo real com as APIs do PagBank.
Posso customizar a aparência do checkout?
Sim! O plugin segue o estilo do seu tema e você pode usar CSS customizado para ajustes adicionais.
Funciona com produtos digitais/virtuais?
Sim! O plugin funciona perfeitamente com produtos físicos, digitais, agrupados, baixáveis e virtuais.
Como funciona a confirmação automática de pagamento PIX?
O plugin verifica automaticamente o status do pagamento PIX e atualiza o pedido em tempo real, sem necessidade de intervenção manual. A confirmação é exibida ainda na tela de sucesso, e pode opcionalmente disparar eventos adicionais ou redirect.
Posso oferecer descontos diferentes por método de pagamento?
Sim! Você pode configurar descontos percentuais ou fixos para PIX e Boleto diretamente nas configurações do plugin.
更新日志:
- Correção: classe css no campo de Parcelas poderia quebrar em alguns cenários/tema no Chrome, necessitando customizações adicionais de CSS. Reportado por Lincoln da Digital Forms.
- Correção: quando usado em conjunto com plugins que forçam a ordem de carregamento de classes (ex: Nitropack), um erro fatal (WC_PaymentGateway_CC not found) poderia ocorrer.
- Adicionado suporte ao WordPress 7.0
- Melhoria: agora exibimos informações de parcelamento na tela de sucesso e e-mail, além de dar a opção de personalizar a forma como o nome do meio de pagamento é exibido nas APIs, podendo incluir informações de parcelamento detalhadas para facilitar integrações
- Melhoria: Campos de cartão e CPF/CNPJ agora mostram teclado numérico no checkout em blocos em dispositivos moveis.
- Melhoria: Regras avançadas de desconto agora podem ser criadas com novos filtros. Veja documentação detalhada e crie a sua regra personalizada agora mesmo usando AI.
- Melhoria: o método que obtém informações de configuração de cartão de crédito agora fará fallback no valor padrão do plugin, sem depender de ter que salvar novamente as configurações para desfrutar de campos novos (deveremos fazer isso com outras áreas em breve)
- Correção de problema com classe do EnvioFacil, onde em alguns cenários poderia ser carregada mesmo sem a existência de classes essenciais do WooCommerce como WC_Shipping
- Adicionamos o WooCommerce como dependência do plugin, evitando que instale o plugin sem ter o WooCommerce ativo
- Melhoria: depreciamos campos do tipo tel a fim de forçar o teclado numérico, pois notamos que alguns navegadores/extensoes adicionavam dropdown para selecionar código do país/área. O teclado numérico segue a ser usado na experiência mobile.
- Correção: no checkout em blocos, quando um desconto era aplicado as parcelas do cartão não eram atualizadas, e a autenticação 3D falhava em alguns cenários pedindo para recarregar a página
- Correção: no checkout em blocos, quando o usuário falhava em digitar uma das informações corretamente e o 3D falhava apontando o erro, mesmo que o comprador corrigisse o problema ainda não conseguiria finalizar o checkout
- Adicionamos sourcemaps nos arquivos js do checkout em blocos a fim de facilitar o desenvolvimento futuro.
- Correção: No checkout em blocos se o PIX com desconto fosse o meio padrão selecionado seus descontos não eram exibidos nos totais. E em outros cenários, ao selecionar cartão de crédito o desconto pix permanecia aplicado (e impedindo a finalização de compra).
- Melhoria: filtro de split adicionado a fim de permitir pagamento de afiliados automática com novo plugin PB Afiliados.
- Melhorias e correções no ícone de pagamento. Definido utf-8 para caracteres especiais no SVG; Sanitização do $_GET que era inutilizado; Validação de existência do arquivo ícone; Controle explícito de formatação e espaços no load do SVG no DOM; Elimina duplicações da tag svg e remove declaração de XML e DOCTYPE. (contribuição de Matheus Vale)
- Correção: em doações recorrentes com valor especificado pelo comprador o valor não era replicado no item, causando falha e cancelamento da assinatura no segundo ciclo da recorrencia.
- Correção: desconto pix nem sempre era exibido pois o checkout nem sempre atualizava o total
- Melhoria/correção na forma como descontos de PIX e Boleto eram aplicados. Agora o desconto será exibido nos totais em todos os lugares devidos, sem exigir configurações adicionais nem remendos, e ampliando a compatibilidade com plugins de terceiros como Funnel kit.
- Removemos a funcionalidade/opção de exibir descontos pix junto aos totais já que isso ocorrerá organicamente em todos os lugares devidos quando houver desconto (PIX ou BOLETO).
- Melhoria: Agora é possível esconder os ícones de pagamento (interessante se tiver problemas com css e não quiser ajustar)
- Workaround: alguns plugins sobrescrevem a ordem de plugins de pagamentos que são carregados, fazendo com que o nosso não seja exibido, incluindo algumas abas de nossas configurações que deixam de ser exibidas.
- Correção: ao fazer upgrade do plugin, em alguns cenários uma das migrações poderia resetar algumas configurações, tornando alguns meios de pagamento não mais "ativos" até que a pessoa salvas se sua configuração novamente
- Correção: ferramenta de diagnóstico não exibia valores corretamente quando os valores-padrão estavam em uso ou quando o usuário não havia realizado nenhuma mudança
- Correção: escondemos os descontos pix nos totais caso pix nno seja o selecionado + atualizamos o total com o desconto pixx
- Correção: split de pagamentos recorrentes com Dokan Marketplace terminava em falha por conta de parâmetro liable não suportado.
- Melhoria: Agora é possível exibir os totais com desconto PIX no checkout e carrinho. Basta ativar nas configurações.
- Atualização de segurança para dependencia de desenvolvimento (phpunit/phpunit) que impedia nosso último update de ser lançado. Não afeta a segurança de lojas de produção, somente em ambientes de desenvolvimento com instalação via composer --require-dev.
- Correção: erro fatal poderia ocorrer em versões do Woo anteriores a 7.1 ao verificarmos se o HPOS estava ativo.
- Removidas mensagens desnecessárias dos logs relacionados ao split de pagamentos e dokan que eram exibidas no log mesmo sem tais recursos estarem em uso/ativos
- Correção: em alguns cenários de race conditions, pedidos vindos de assinaturas poderiam ser gerados em duplicidade, especialmente em lojas que não configuraram o cron corretamente.
- Correção: botões de ação como copiar código, exibir boleto, etc não mais serão exibidos se o pagamento for negado pelo antifraude
- Pequena mudança nos headers enviados para o PagBank a fim de contornar problemas e bloqueios
- Melhoria: na geração de boletos, quando nome da empresa e CNPJ forem informados, usaremos estas informações como dados do pagador.
- Correção que impedia integração com Dokan ser ativada em alguns cenarios
- Melhoria: agora é possível filtrar assinaturas por e-mail do cliente
- Melhoria: e-mail do cliente é exibido nos detalhes da assinatura no admin, facilitando o gerenciamento
- Melhoria: quando não há ações a serem executadas em uma assinatura, agora explicamos isso, ao invés de deixar a área de Ações vazia
- Melhoria: passamos a exibir a hora da criação, atualização e próxima cobrança de uma assinatura
- Correção: dia do vencimento do boleto podia ser exibido e/ou gerado com margem de erro de 1 dia dependendo do horário em que foi gerado.
- Correção: Instruções PIX/Boleto não apareciam em checkout legado quando payment_method não correspondia ao gateway ID. Adiciona hook fallback para garantir exibição. Impacta lojas com checkout legado.
- Melhoria: adicionado medidas de segurança, evitando que: 1) usuários adicionem mais de 5 cartões salvos; 2) bots realizem testes de cartão ao adicionar cartões em intervalos menores que 2 minutos ou sem estarem logados; 3) nonce adicionado ao formulário de cartão (área logado) evitando que bots explorem diretamente este endpoint
- Correção: erro fatal poderia ocorrer ao finalizar uma compra com assinatura por conta de uma tentativa de inserir registros duplicados. Na ausência da chave única na tabela, assinatura e cobranças duplicadas poderiam ser geradas. (Reportado por Ricardo Alves B.)
- Correção: mesmo com opção de salvar cartão desabilitada, ainda era possível salvar cartão em Minha Conta > Meios de Pagamento
- Correção/Melhoria: Erro fatal poderia ocorrer ao tentar finalizar um pedido com Boleto (métodos getter retornam null (retorna string vazia)) e melhorado phpdoc de alguns métodos do objeto Address.
- Correção: Erro Fatal poderia ocorrer na primeira vez a configuração de uma das áreas do plugin fosse salva, dependendo de como o plugin foi reinstalado/reconfigurado no passado.
- Correção: em cenários específicos, o form de cartão de crédito não era exibido no checkout em blocos (TypeError).
- Adicionado suporte a divisão de pagamentos (split) nativa.
- Adicionado suporte a Dokan Marketplace para divisão de pagamentos entre múltiplos vendedores (split, multivendor).
- Adicionado opção para habilitar/desabilitar opção de salvar cartão de crédito para compras futuras. Desativado por padrão.
- Correção/melhoria: Mais assertibilidade no mapeamento de atributos de endereço, garantindo etiquetas corretas no Envio Facil
- Correção: "Cliente não identificado" aparecia no nome do cliente em toda assinatura na tela de relatorios se HPOS estivesse ativo
- Suporte ao WordPress 6.9 adicionado
- Melhoria: agora é possível definir uma rota alternativa para as notificações/atualizações do PagBank, caso seu provedor bloqueie asas requisições padrão.
- Correção: em alguns cenários, se o nome do produto contivesse caracteres ilegais como tags html, o pedido não era criado corretamente ocasionando erro no pagamento.
- Compatibilidade: Alguns métodos depreciados no Woo 10.3 poderiam exibir warnings no log. Corrigido.
- Correção: compatibilidade com PHP 8.1+ substituindo função depreciada de sanitização de caracteres especiais.
- Correção: em alguns cenários as mensagens de erro de validação da connect key não são exibidas prop riamente no admin, nas configs do plugin.
- Correção: adicionada dependência jquery-blockui para corrigir erro de validação 3DS que impedia finalização de pedido de forma silenciosa em alguns cenários de customização/temas que removiam tal componente.