PagBank / PagSeguro Connect para WooCommerce
| 开发者 | martins56 |
|---|---|
| 更新时间 | 2026年4月16日 13:43 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | 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: 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.