Claudio Sanches – PagSeguro for WooCommerce

Description

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 desenvolvido pela UOL.

Este plugin foi desenvolvido sem nenhum incentivo do PagSeguro ou da UOL. Nenhum dos desenvolvedores deste plugin possuem vínculos com estas duas empresas.

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

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

• Padr?o: 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.

Além que é possível utilizar o novo sandbox do PagSeguro.

Compatibilidade

Compatível com vers?es atuais do WooCommerce.

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).

Instala??o

Confira o nosso guia de instala??o e configura??o do PagSeguro na aba Installation.

Integra??o

Este plugin funciona perfeitamente em conjunto com:

• WooCommerce Extra Checkout Fields for Brazil.
• WooCommerce Multilingual.

Dúvidas?

Você pode esclarecer suas dúvidas usando:

• A nossa sess?o de FAQ.
• Utilizando o nosso fórum no Github.
• Criando um tópico no fórum de ajuda do WordPress.

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.

Screenshots

Installation

• 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.

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“.

Apenas com isso já é possível receber os pagamentos e fazer o retorno automático de dados.

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“.

é possível escolher entre três op??es de pagamento que s?o:

• Checkout no PagSeguro (padr?o): O cliente e redirecionado para o site do PagSeguro
• 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.

Note que é necessário aprova??o do PagSeguro para utilizar o Checkout Transparente, saiba mais em “Como receber pagamentos pelo PagSeguro“.

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

FAQ

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 uma vers?o atual do plugin WooCommerce.
• Possuir uma conta no PagSeguro.
• Gerar um token de seguran?a no 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 causa 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 tópico no fórum do plugin 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 siga o tutorial do PagSeguro:

• N?o recebi o POST do retorno automático. O que devo fazer?

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.
Note que é necessário aprova??o do PagSeguro para utilizar o Checkout Transparente, saiba mais em “Como receber pagamentos pelo PagSeguro“.

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, abra um tópico no fórum do plugin 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.

Reviews

Plugin muito bom e fácil de usar

Lemund September 16, 2024

Cláudio Sanches faz os melhores plugins pra e-commerce haha sempre salva!

Sensacional!

oiakstore June 2, 2024

Vale a pena utilizar

Claudio Sanches-Pagseguro para woocommerce-vers?o 2.14.0

gruponeto May 26, 2024

plugin de excelente qualidade, recomendo

Facil de usar

dcolestore January 2, 2024

<font _mstmutation=”1″ _msttexthash=”28054″ _msthash=”472″>Cfa</font><font _mstmutation=”1″></font>

Excelente Plugin

jcarlospa November 15, 2023

Excelente Plugin, só falta acompanhar as atualiza??es do WordPress

Perfeito

gabasj October 16, 2023

ótimo plugin, nunca falhou! Fácil instala??o, sem amarras. Poderia ter alguma forma de customizar um pouco, mas quanto ao funcionamento, 100%!

Contributors & Developers

Changelog

2.14.0 – 2019/09/20

• Atualizado o nome do plugin de “WooCommerce PagSeguro” para “Claudio Sanches – PagSeguro for WooCommerce”.

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

• Adicionado suporte ao WooCommerce 3.0.
• Alterado o tipo dos campos para tel no Checkout Transparente. (Possível com a ajuda de Thiago Guimar?es).
• Corre??o nas máscaras do campos devido a mudan?a do plugin no woocommerce-extra-checkout-fields-for-brazil. (Possível com a ajuda de Thiago Guimar?es).