Módulo PagSeguro

Açıklama

Add PagSeguro gateway to WooCommerce

This plugin adds PagSeguro gateway to WooCommerce.

Please notice that WooCommerce must be installed and active.

Contribute

You can contribute to the source code in our GitHub page.

Descrição em Português:

Adicione o PagSeguro como método de pagamento em sua loja WooCommerce.

PagSeguro é um método de pagamento brasileiro oferecido pela UOL.

Este plugin foi desenvolvido a partir da documentação oficial do PagSeguro e utiliza a última versão da API de pagamentos.

Descontos nas taxas

Graças a uma parceria com o PagSeguro, as transações realizadas por este módulo, possuem condições especiais junto ao PagSeguro.

Ao usar nossa integração, você não pagará mais a taxa de intermediação do PagSeguro (tipicamente R$0,40/pedido aprovado) e passará a pagar uma taxa de transação menor que a taxa oficial (tipicamente 4,99% para recebimento em 14 dias ou 3,99% para recebimento em 30 dias).

Caso sua conta PagSeguro possua uma taxa ou condição negociada melhor que a nossa, e seu faturamento seja superior a R$20 mil/mês, entre em contato conosco antes de usar nossa integração.

Você não paga nada a mais por isso e ainda ajuda este e outros projetos.

Estão disponíveis as seguintes modalidades de pagamento:

  • Redirect: Cliente é redirecionado ao PagSeguro para concluir a compra.
  • Lightbox: Uma janela do PagSeguro é aberta na finalização para o cliente fazer o pagamento.
  • Transparente: O cliente faz o pagamento direto no seu site sem precisar ir ao site do PagSeguro.

Para usar a Sandbox do PagSeguro, consulte nossa documentação.

Compatibilidade

Compatível com versões posteriores ao WooCommerce 3.0.

Este plugin também é compatível com o WooCommerce Extra Checkout Fields for Brazil, desta forma é possível enviar os campos de “CPF”, “número do endereço” e “bairro” (para o Checkout Transparente é obrigatório o uso deste plugin).

Estamos sempre trabalhando para garantir melhores funcionalidades e máxima compatibilidade. Se mesmo assim tiver problemas, não hesite em entrar em contato conosco.

Instalação

Confira o nosso passo a passo de instalação e configuração.

Integração

Este plugin funciona perfeitamente em conjunto com:

Dúvidas?

Você pode esclarecer suas dúvidas usando:

  • A nossa sessão de FAQ.
  • Na Central de Ajuda.
  • Entrando em contato na Central de Ajuda no link acima.

Colaborar

Você pode contribuir com código-fonte em nossa página no GitHub.

Agradecimentos

  • Leandro Matos ajudou com o layout e os ícones do Checkout Transparente.

Yükleme

  • Upload plugin files to your plugins folder, or install using WordPress built-in Add New Plugin installer;
  • Activate the plugin;
  • Navigate to WooCommerce -> Settings -> Payment Gateways, choose PagSeguro and fill in your PagSeguro Email and Token.

Instalação e configuração em Português:

Instalação do plugin:

  • Envie os arquivos do plugin para a pasta wp-content/plugins, ou instale usando o instalador de plugins do WordPress.
  • Ative o plugin.
  • Lembre-se de autorizar nossa aplicação junto ao PagSeguro para obter sua chave e configurar o módulo.

Requerimentos:

É necessário possuir uma conta no PagSeguro e ter instalado o WooCommerce.

Configurações no PagSeguro:

No PagSeguro é necessário desativar a opção de “Pagamento via Formulário HTML”, você pode fazer isso em “Preferências” > “Integrações“.

Com isso já é possível receber os pagamentos e receber notificações do PagSeguro para atualizar seus pedidos automaticamente.

Atenção: Não é necessário configurar qualquer URL em “Página de redirecionamento” ou “Notificação de transação”, pois o plugin é capaz de comunicar o PagSeguro pela API quais URLs devem ser utilizadas para cada situação.

Configurações do Plugin:

Com o plugin instalado acesse o admin do WordPress e entre em “WooCommerce” > “Configurações” > “Finalizar compra” > “PagSeguro”.

Habilite o PagSeguro, adicione o seu e-mail e o token do PagSeguro. O token é utilizado para gerar os pagamentos e fazer o retorno de dados.

Você pode conseguir um token no PagSeguro em “Integrações” > “Token de Segurança“.

PagSeguro App Key: Autorize nossa aplicação junto ao PagSeguro para obter sua chave e usufruir das novas taxas de recebimento e maior conversão.

É possível escolher entre três opções de pagamento que são:

  • Redirecionar (padrão): O cliente e redirecionado para o site do PagSeguro onde pode pagar com PIX, Saldo PagSeguro, e outros meios de pagamento.
  • Checkout em Lighbox: O cliente permanece no seu site é aberto um Lightbox do PagSeguro onde o cliente fará o pagamento
  • Checkout Transparente: O cliente faz o pagamento direto em seu site na página de finalizar pedido utilizando a API do PagSeguro.

Você ainda pode definir o comportamento da integração utilizando as opções:

  • Enviar apenas o total do pedido: Permite enviar apenas o total do pedido no lugar da lista de itens, esta opção deve ser utilizada apenas quando o total do pedido no WooCommerce esta ficando diferente do total no PagSeguro.
  • Prefixo de pedido: Esta opção é útil quando você esta utilizando a mesma conta do PagSeguro em várias lojas e com isso você pode diferenciar os pagamentos pelo prefixo.

Checkout Transparente

Para utilizar o checkout transparente é necessário utilizar o plugin WooCommerce Extra Checkout Fields for Brazil.

Com o WooCommerce Extra Checkout Fields for Brazil instalado e ativado você deve ir até “WooCommerce > Campos do Checkout” e configurar a opção “Exibir Tipo de Pessoa” como “Pessoa Física apenas”.

Isto é necessário porque é obrigatório o envio de CPF para o PagSeguro, além de que o PagSeguro aceita apenas CPF para documento do titular do cartão.

Pronto, sua loja já pode receber pagamentos pelo PagSeguro.

SSS

What is the plugin license?

  • This plugin is released under a GPL license.

What is needed to use this plugin?

  • WooCommerce version 3.0 or latter installed and active.
  • Only one account on PagSeguro.

FAQ em Português:

Qual é a licença do plugin?

Este plugin esta licenciado como GPL.

O que eu preciso para utilizar este plugin?

  • Ter instalado o plugin WooCommerce 3.0 ou mais recente.
  • Possuir uma conta no PagSeguro.
  • Gerar um token de segurança no PagSeguro (logo não será necessário).
  • Autorizar nossa integração junto ao PagSeguro
  • Desativar a opção “Pagamento via Formulário HTML” em integrações na página do PagSeguro.

PagSeguro recebe pagamentos de quais países?

No momento o PagSeguro recebe pagamentos apenas do Brasil.

Configuramos o plugin para receber pagamentos apenas de usuários que selecionarem o Brasil nas informações de pagamento durante o checkout.

Quais são os meios de pagamento que o plugin aceita?

São aceitos todos os meios de pagamentos que o PagSeguro disponibiliza, entretanto você precisa ativa-los na sua conta.

Confira os meios de pagamento e parcelamento.

Como que plugin faz integração com PagSeguro?

Fazemos a integração baseada na documentação oficial do PagSeguro que pode ser encontrada nos “guias de integração” utilizando a última versão da API de pagamentos.

Instalei o plugin, mas a opção de pagamento do PagSeguro some durante o checkout. O que fiz de errado?

Você esqueceu de selecionar o Brasil durante o cadastro no checkout.

A opção de pagamento pelo PagSeguro funciona apenas com o Brasil.

É possível enviar os dados de “Número”, “Bairro” e “CPF” para o PagSeguro?

Sim é possível, basta utilizar o plugin WooCommerce Extra Checkout Fields for Brazil.

O pedido foi pago e ficou com o status de “processando” e não como “concluído”, isto esta certo?

Sim, esta certo e significa que o plugin esta trabalhando como deveria.

Todo gateway de pagamentos no WooCommerce deve mudar o status do pedido para “processando” no momento que é confirmado o pagamento e nunca deve ser alterado sozinho para “concluído”, pois o pedido deve ir apenas para o status “concluído” após ele ter sido entregue.

Para produtos baixáveis a configuração padrão do WooCommerce é permitir o acesso apenas quando o pedido tem o status “concluído”, entretanto nas configurações do WooCommerce na aba Produtos é possível ativar a opção “Conceder acesso para download do produto após o pagamento” e assim liberar o download quando o status do pedido esta como “processando”.

Ao tentar finalizar a compra aparece a mensagem “PagSeguro: Um erro ocorreu ao processar o seu pagamento, por favor, tente novamente ou entre em contato para obter ajuda.” o que fazer?

Esta mensagem geralmente aparece por que não foi configurado um Token válido.
Gere um novo Token no PagSeguro em “Preferências” > “Integrações” e adicione ele nas configurações do plugin.

Outro erro comum é gerar um token e cadastrar nas configurações do plugin um e-mail que não é o proprietário do token, então tenha certeza que estes dados estão realmente corretos!

Note que caso você esteja utilizando a opção de sandbox é necessário usar um e-mail e token de testes que podem ser encontrados em “PagSeguro Sandbox > Dados de Teste“.

Se você tem certeza que o Token e Login estão corretos você deve acessar a página “WooCommerce > Status do Sistema” e verificar se fsockopen e cURL estão ativos. É necessário procurar ajuda do seu provedor de hospedagem caso você tenha o fsockopen e/ou o cURL desativados.

Para quem estiver utilizando o Checkout Transparente é obrigatório o uso do plugin WooCommerce Extra Checkout Fields for Brazil para enviar o CPF ao PagSeguro, caso o contrário será impossível de finalizar o pedido, veja no guia de instalação como fazer isso.

Por último é possível ativar a opção de Log de depuração nas configurações do plugin e tentar novamente fechar um pedido (você deve tentar fechar um pedido para que o log será gerado e o erro gravado nele).
Com o log é possível saber exatamente o que esta dando de errado com a sua instalação.

Caso você não entenda o conteúdo do log não tem problema, você pode me abrir um chamado na central de ajuda com o link do log (utilize o pastebin.com ou o gist.github.com para salvar o conteúdo do log).

O status do pedido não é alterado automaticamente?

Sim, o status é alterado automaticamente usando a API de notificações de mudança de status do PagSeguro.

Caso os status dos seus pedidos não estiverem sendo alterados clique aqui e veja algumas soluções para testar e corrigir o problema.

A seguir uma lista de ferramentas que podem estar bloqueando as notificações do PagSeguro:

  • Site com CloudFlare, pois por padrão serão bloqueadas quaisquer comunicações de outros servidores com o seu. É possível resolver isso desbloqueando a lista de IPs do PagSeguro.
  • Plugin de segurança como o “iThemes Security” com a opção para adicionar a lista do HackRepair.com no .htaccess do site. Acontece que o user-agent do PagSeguro esta no meio da lista e vai bloquear qualquer comunicação. Você pode remover isso da lista, basta encontrar onde bloquea o user-agent “jakarta” e deletar ou criar uma regra para aceitar os IPs do PagSeguro).
  • mod_security habilitado, neste caso vai acontecer igual com o CloudFlare bloqueando qualquer comunicação de outros servidores com o seu. Como solução você pode desativar ou permitir os IPs do PagSeguro.

Funciona com o Lightbox do PagSeguro?

Sim, basta ativar esta nas opções do plugin.

Funciona com o checkout transparente do PagSeguro?

Sim, funciona. Você deve ativar nas opções do plugin.
Com a nossa integração não é necessário autorização para utilizar o mesmo.

Funciona com o Sandbox do PagSeguro?

Sim, funciona e basta você ativar isso nas opções do plugin, além de configurar o seu e-mail e token de testes“.

O total do pedido no WooCommerce é diferente do enviado para o PagSeguro, como eu resolvo isso?

Caso você tenha este problema, basta marcar ativar a opção Enviar apenas o total do pedido na página de configurações do plugin.

Quais URLs eu devo usar para configurar “Notificação de transação” e “Página de redirecionamento”?

Não é necessário configurar qualquer URL para “Notificação de transação” ou para “Página de redirecionamento”, o plugin já diz para o PagSeguro quais URLs serão utilizadas.

Mais dúvidas relacionadas ao funcionamento do plugin?

Por favor, caso você tenha algum problema com o funcionamento do plugin, entre em contato conosco com o link arquivo de log (ative ele nas opções do plugin e tente fazer uma compra, depois vá até WooCommerce > Status do Sistema, selecione o log do pagseguro e copie os dados, depois crie um link usando o pastebin.com ou o gist.github.com), desta forma fica mais rápido para fazer o diagnóstico.

İncelemeler

22 Haziran 2022
Fiz uma sugestão para a equipe desenvolvedora do plugin. O próprio Ricardo retornou em menos de 24h inserindo uma melhoria que permite agora fazermos conciliação de pagamentos, estamos muito contentes e impressionados com essa agilidade. Obrigado Ricardo!
9 Mart 2022
Passei um bom tempo utilizando este plugin, mas metade das tentativas de compras eram rejeitadas. Hoje instalei o plugin do claudio sanches original e com ele as rejeições das compras estão bem menores.
20 Ocak 2022
Parabéns Ricardo! o melhor ! sempre atualizado, sempre se preocupando com os problemas. Continue assim.Vida longa..
13 incelemeyi oku

Katkıda Bulunanlar ve Geliştiriciler

“Módulo PagSeguro” açık kaynaklı yazılımdır. Aşağıdaki kişiler bu eklentiye katkıda bulunmuşlardır.

Katkıda bulunanlar

“Módulo PagSeguro” 1 dile çevrildi. Katkıda bulundukları için çevirmenlere teşekkürler.

“Módulo PagSeguro” eklentisini dilinize çevirin.

Geliştirmeyle ilgilenir misiniz?

Kodu görüntüle, SVN deposuna göz at veya RSS ile geliştirme günlüğüne abone ol.

Değişiklik Kaydı

3.6.0 – 21/Jun/2022

  • Agora exibimos mais informações sobre o meio de pagamento na tela do pedido. Para pedidos com cartão, agora é possível ver o NSU, TID, código de autorização, e outras informações. Para pagamentos com Redirect, agora é possível ver qual meio de pagamento foi escolhido no PagSeguro.

3.5.3 – 10/Mai/2022

  • Testes e suporte a WordPress 6.0 e 6.1 adicionados
  • Atualização de instruções no arquivo principal

3.5.2 – 16/Fev/2022

  • Correção: Ao habilitar a sandbox, o campo “PagSeguro App Key” era exibido novamente como “Token PagSeguro”, confundindo quem realizasse a configuração.

3.5.1 – 15/Fev/2022

  • Melhoria: em algumas situações, quando a loja falha em receber uma das notificações do PagSeguro e/ou quando um pedido tem seu status alterado para ‘Disponível’ sem passar pelo status ‘Pago’ o pedido não tinha seu status atualizado. Agora se o pedido estiver como ‘pendente’ ou ’em espera’ ele será atualizado com sucesso. (Reportado por Rodrigo Roncaglio)

3.5.0 – 8/Fev/2022

  • Melhoria: agora é possível definir o valor da parcela mínima sem juros. Saiba mais em https://bit.ly/34927gh.

3.4.0 – 3/Fev/2022

  • Adicionado suporte a Sandbox
  • Melhorias e correções nas traduções incluindo remoção de arquivos de tradução não utilizados

3.3.9 – 14/Jan/2022

  • Correção: suporte a atualização de pedidos feitos com PIX não tinha sido aplicada corretamente. Agora sim, pedidos com PIX serão atualizados automaticamente quando forem pagos.

3.3.8 – 23/Dec/2021

  • Correção: suporte a atualização de pedidos feitos com PIX. Antes pedidos com PIX não eram atualizados automaticamente quando pagos.

3.3.7 – 11/Dec/2021

  • Melhoria: quando uma mensagem de erro que não temos tradução vier do PagSeguro, mostraremos ela junto com a mensagem de erro padrão a fim de facilitar a resolução

3.3.6 – 29/Sep/2021

  • Correção da constante com o número de versão do módulo. (São muitos lugares pra se alterar a versão no WP e esquecemos deste)

3.3.5 – 29/Sep/2021

  • Compatibilidade: apenas atualizando notas de versão após teste de compatibilidade com WordPress 5.8.1 e WooCommerce 5.7.1
  • Melhoria: alteração em mensagens de erro com linguagem muito informal.

3.3.4 – 12/Mai/2021

  • Melhoria: criamos um espelho (Cloudfront) dos arquivos estáticos do PagSeguro a fim de reduzir indisponibilidade que fazia com que os meios de pagamento transparente nunca terminassem de carregar no checkout de algumas lojas.

3.3.3 – 18/Jan/2021

  • Correção: Erro “Undefined index: method in class-wc-pagseguro.php” aparecia em alguns casos após desativar e reativar o módulo.

3.3.2 – 6/Out/2020

  • Correção: URL de sucesso não era enviado quando meio “Redirect” era usado fazendo com que o usuário não retornasse para loja.

3.3.1 – 14/Set/2020

  • Correção do senderIp sendo enviado vazio quando não conseguia obter o senderIP, causando erro na finalização de pedidos
  • Correção de undefined index method que ocorria após instalação do módulo, quando não se tinha os valores de configuração preenchidos e salvos

3.3.0 – 07/Set/2020

  • Adicionado URL para auto diagnóstico, exibindo principais configurações do módulo
  • Melhoria: Agora o IP do cliente é enviado ao PagSegurom, reduzindo transações negadas por suspeita de fraude
  • Compatibilidade com WordPress 5.5.1 e WooCommerce 4.4.1 verificada

3.2.7 – 15/Jun/2020

  • Correção: pedidos feitos informando CNPJ com meio de pagamento Boleto não eram finalizados

3.2.6 – 17/Mai/2020

  • Módulo duplicado corrigido – O módulo aparecia duplicado para quem fazia a instalação/download pelo site do wordpress ao invés do github.

3.2.5 – 11/Mai/2020

  • Corrige falha na atualização automática de pedidos, pois os pedidos estavam sendo enviados sem o código de referência, e desta forma não conseguiam ser encontrados quando o PagSeguro tentava atualizá-los.

3.2.4 – 5/Mai/2020

  • Corrige problema de pedidos com mais de 1 produto no checkout transparente ou Redirect que só enviava 1 produto
  • Testado compatibilidade com WordPress 5.4 e WooCommerce 4.0

3.2.3 – 21/Nov/2019

  • Corrige problema quando produtos ou cliente possuí acento no nome
  • Adiciona headers com informações sobre a plataforma e versão do módulo

3.2.2 – 11/Nov/2019

  • Corrige problema na URL de notificação enviada ao PagSeguro. Este bug impedia o PagSeguro de atualizar o status dos pedidos na loja, visto que a url de notificação era ignorada.

3.2.1 – 30/10/2019

  • Corrige problema com finalização de pedido quando valor do frete é zero.

3.2.0 – 30/10/2019

  • Agora o link para pagamento de boleto/tef aparece na página de sucesso
  • Melhoria no esquema de tradução (espera-se que o marketplace agora exiba que o módulo é traduzido para o portugues)
  • Correção nos logs que não exibiam o parâmetros sendo enviados ao pagseguro (mostrava ‘Array’)

3.x – 09/2019

  • Versão no modelo de aplicação (por Ricardo Martins), que adiciona descontos às taxas do PagSeguro

2.13.1 – 2018/08/03

  • Corrigido alerta do PHP sobre variável inexistente.

2.13.0 – 2018/08/02

  • Força o campo “Bairro” como obrigatório quando checkout transparente está ativado.
  • Implementada baixa automática de estoque ao comprar por boleto (funciona apenas no WooCommerce 3 ou superior).
  • Estoque é restaurado automaticamente quando alguma notificação do PagSeguro marca o pedido como reembolsado ou cancelado (funciona apenas no WooCommerce 3 ou superior).
  • Corrigida a mudança de status do pedido de Cancelado para Processando (funciona apenas no WooCommerce 3 ou superior).
  • Adicionadas informações sobre a taxa de intermédio do PagSeguro nos meta dados do pedido.

2.12.7 – 2018/06/21

  • Removido métodos do Itaú e Banrisul em débito online no checkout transparente, ambos não são mais suportados pelo PagSeguro.

2.12.6 – 2018/05/09

  • Adicionado valor total ao parcelamento no checkout transparente para tornar mais prático para o cliente a visualização do juros. Mais detalhes em #75.

2.12.5 – 2017/05/11

  • Corrigido valor total das parcelas do cartão de crédito no checkout transparente, o valor tinha parado de ser atualizado no WooCommerce 3.0.

2.12.4 – 2017/04/12

  • Corrigido icones no checkout transparente.

2.12.3 – 2017/04/10

  • Corrigido ndash que aparecia no nome dos itens listados no PagSeguro.

2.12.2 – 2017/04/07

  • Adicionado suporte ao novo sistema de logs do WooCommerce 3.0, assim permitindo que seja utilizado sistema de logs personalizados.
  • Adicionado validação e higienização no código de transação do PagSeguro antes de salvar.

2.12.1 – 2017/04/04

  • Correção dos títulos dos campos personalizados salvos ao fazer um pedido.

2.12.0 – 2017/04/03