Módulo PagSeguro

Módulo PagSeguro

Considere usar o novo plugin para vender mais! 🚀

👉 A nova geração de nossa integração está disponível aqui. 👈

Ela pede menos informações ao consumidor, e tem recursos como PIX transparente, Autenticação 3Ds (aumenta a taxa de aprovação e reduz chargebacks), Recorrência, e muito mais.

Esta versão utiliza uma API do PagSeguro que será descontinuada no futuro por eles.

Veja o passo a passo de instalação para WooCommerce

Adicionar PagSeguro (PagBank) ao WooCommerce

Adicione o PagSeguro (PagBank) 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 uma versão depreciada da API de pagamentos (legado).

Para usar as novas APIs, utilize a Nova Geração de nossa integração.

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 (que é 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).

Novas funcionalidades somente serão adicionadas à nova geração da nossa integração, mas se encontrar problemas ou erros nesta, entre 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.
  • 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.

سوالات متداول

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. O difícil é conseguir fazer a Sandbox do PagSeguro funcionar. Considere usar a nova versão da nossa integração, que usa a nova api.

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.

تصویری برای این آیتم موجود نیست.
نظری برای این آیتم موجود نیست.
0 0 رای ها
امتیازدهی
اشتراک در
اطلاع از
0 نظرات
قدیمی‌ترین
تازه‌ترین بیشترین رأی
نسخه حجم فایل SHA256 تغییرات دانلود
3.16.7 1 مگابایت -
دانلود
×
★★★★★
★★★★★
4.8 /5 (32 نظر)

قیمت:

رایگان

نگارش

3.16.7

آخرین انتشار

14 اردیبهشت 1405

آخرین بروزرسانی

3 ماه پیش

نصب های فعال

1,000+

نگارش وردپرس

وردپرس 4.0+

تست شده از نسخه

وردپرس 6.6.5

نگارش PHP

-

نسخه ها

1 نسخه