Virtuaria – Pagseguro para Woocommerce

Description

Utilizando a API mais moderna Order/Connect de cobrança disponibilizada pelo pagseguro, este plugin permite que sua loja aceite pagamentos no cartão de crédito, além de boleto bancário e Pix.

Atenção: Esta atualização necessita de uma nova autenticação junto ao PagSeguro. O processo está muito mais simples. Favor consultar a aba “Instalação” logo acima para mais detalhes.

  • Fácil de instalar e configurar;
  • Suporte a Crédito, Pix e Boleto Bancário;
  • Opção de parcelamento com ou sem juros (configurável no plugin);
  • Boleto com prazo de validade configurável;
  • Link de segunda via do boleto na tela de confirmação e no e-mail com os detalhes do pedido;
  • Disparo de cobrança extra;
  • Reembolso (total e parcial);
  • Modo de processamento (síncrono ou assíncrono) do checkout;
  • Opção do cliente salvar método de pagamento (sem armazenar o número do cartão do cliente);
  • Checkout Transparente (permite fazer o pagamento sem sair do site);
  • Relatório (log) para consulta a detalhes de transações, incluindo erros;
  • Identificação na fatura para pagamentos via cartão (exibir na fatura);
  • Mudança automática dos status dos pedidos (aprovado, negado, cancelado, etc) via Webhook de retorno de dados dos status no PagSeguro;
  • Detalhamento nas notas do pedido das operações ocorridas durante a comunicação com o PagSeguro (reembolsos, parcelamentos, mudanças de status e valores recebidos/cobrados).

Pix

  • Confirmação automática do pagamento, semelhante a cartão de crédito;
  • Mudança automática dos status dos pedidos (aprovado, negado, cancelado, etc) via Webhook de retorno de dados dos status no Pagseguro;
  • Reembolso total e parcial;
  • Tempo limite para pagamento configurável;
  • “Nova Cobrança Pix”, muito útil para cobrança de valores extras ou nos casos onde o cliente perde o tempo limite de pagamento;
  • Pagamento por QR code ou link de pagamento;
  • Exibe os dados de pagamento no e-mail enviado e na tela de confirmação do pedido.

Com este plugin, você poderá fazer reembolsos totais e parciais através da página de gerenciamento do pedido em sua loja.

É disponibilizado ao lojista uma configuração para ativar o “Salvar Método de Pagamento”. Este recurso não armazena os dados do cartão de crédito do comprador, mas sim um código (token) de compra do cartão, o que é suficiente para o cliente realizar compras futuras sem precisar digitar os dados do cartão novamente.

O plugin conta com a funcionalidade “Cobrança Extra” que permite cobrar um valor extra em pedidos feitos com cartão de crédito. Esta função pode ser útil, por exemplo, para vendas de produtos no peso, pois neste caso o valor final quase sempre é diferente do inicialmente solicitado, algo muito comum em supermercados. Também é útil para os casos onde o cliente solicita a inclusão de novos itens no pedido. Para realizar cobranças extras, é necessário que a função de armazenar dados do pagamento esteja ativa.

Uma novidade desta versão é o modo de processamento do pedido. Com ele a mudança de status do pedido pode ser realizada em background(Assíncrono), o que confere muito mais rapidez ao checkout.

Observação: PagSeguro é um método de pagamento brasileiro desenvolvido pela UOL. Este plugin foi desenvolvido, sem nenhum incentivo do PagSeguro ou da UOL, a partir da documentação oficial do PagSeguro e utiliza a última versão ( 4.0 ) da API de cobranças. Nenhum dos desenvolvedores deste plugin possui vínculos com o Pagseguro ou UOL.

Todas as compras são processadas utilizando o checkout transparente:
Transparente: O cliente faz o pagamento direto no seu site sem precisar ir ao site do PagSeguro.

Observação: Os prints foram feitos em um painel wordpress/woocommerce personalizado pela Virtuaria objetivando otimizar o uso em lojas virtuais, por isso o fundo verde, mas o plugin é 100% compatível com o painel padrão do WordPress.

Para mais informações, acesse virtuaria.com.br – desenvolvimento de plugins, criação e hospedagem de lojas virtuais ou envie um email para tecnologia@virtuaria.com.br

Compatibilidade

Este plugin necessita do WooCommerce Extra Checkout Fields for Brazil para funcionar corretamente.
Compatível com Woocommerce 5.8.0 ou superior

Descrição em Inglês:

Using the newest Order/Connect billing API made available by pagseguro, this plugin has high performance to process your payment and streamline your sales.

  • Easy to install and configure;
  • Credit support, Pix and bank slip;
  • Installment option with or without interest (configurable in the plugin);
  • Billet with configurable expiry date;
  • Link to a copy of the bank slip on the confirmation screen and in the e-mail with the order details;
  • Extra charge;
  • Reimbursement (total and partial);
  • Customer option to save payment method (without storing customer card number);
  • Transparent Checkout, where you make the payment without leaving the site;
  • Report (log) to consult transaction details, including errors;
  • Identification on the invoice for payments via card (display on the invoice);
  • Automatic change of order status (approved, denied, cancelled, etc.) via Webhook to return status data in Pagseguro;
  • Detailing in the order notes of the operations that occurred during communication with PagSeguro (refunds, installments, changes in status and amounts received/charged).

Screenshots

  • Configurações do plugin;
  • Checkout transparente com crédito;
  • Checkout transparente com boleto;
  • Checkout transparente com pix;
  • Reembolso;
  • Reembolso bem sucedido;
  • Armazenamento dos dados de pagamento;
  • Cobrança adicional;
  • Boleto bancário;
  • Boleto bancário no e-mail de novo pedido;
  • Pagamento com Pix;
  • Segunda via do Pix no e-mail de novo pedido.

Installation

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.
  • Navegue para Woocommerce -> Configurações -> Pagamentos, escolha o “Pagseguro” e defina o E-mail da conta pagseguro e clique em conectar.
  • Conceda as permissões.

Pronto, o plugin está pronto para uso.

Requerimentos:

1- Conta no PagSeguro e ter instalado o WooCommerce;
2 – Plugin [WooCommerce Extra Checkout Fields for Brazil] (https://wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/).

Configurações no PagSeguro:

Atenção: Para vendas com Pix, é preciso cadastrar uma chave na conta do vendedor no painel do PagSeguro. Mais informaçõ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 trabalha diretamente com a API do PagSeguro.

Configurações do Plugin:

1 – Com o plugin instalado acesse o admin do WordPress e entre em “WooCommerce” > “Configurações” > “Pagamentos” > “PagSeguro”.
2 – Adicione o seu e-mail e clique em conectar para conceder permissões ao plugin.

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

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

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

FAQ

Qual é a licença do plugin?

Este plugin está licenciado como GPLv3. O código é 100% aberto (Open Source). Não disponibilizamos versões PRO com funcionalidades extras.

O que eu preciso para utilizar este plugin?

  • Ter instalado uma versão atual do plugin WooCommerce.
  • Ter instalado uma versão atual do plugin WooCommerce Extra Checkout Fields for Brazil.
  • Possuir uma conta no PagSeguro.
  • Caso deseje utilizar pagamentos com Pix, é preciso cadastrar uma chave aleatória em seu painel de vendedor no PagSeguro.

PagSeguro recebe pagamentos de quais países?

No momento o PagSeguro recebe pagamentos apenas do Brasil e utilizando o real como moeda.

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

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

São aceitos pagamentos com cartão de crédito, pix e boleto bancário, entretanto você precisa ativá-los na sua conta.

Confira os meios de pagamento e parcelamento.

Como que o 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.

É 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 está certo?

Sim, por padrão em compras pagas o status do pedido muda automaticamente para processando, significa que pode enviar sua encomenda. Porém, definir o status como “concluído” é atribuição do lojista ao final do processo de venda e entrega.

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 está como “processando”.

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

Se você tem certeza que o E-mail 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.

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 grave o erro). Com o log é possível saber exatamente o que está dando 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.

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.

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 está 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 Sandbox do PagSeguro?

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

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.

Este plugin permite o reembolso total e parcial da venda?

Sim, você pode reembolsar pedidos com status processando indo direto a página do pedido no woocommerce e clicar em Reembolso -> Reembolso via Pagseguro e setar o valor seja ele total ou parcial.

Dificuldades ao usar a Sandbox

Em conversa com a equipe de integração do PagSeguro, nos foi informado que a API Orders não é 100% atualizada com a Sandbox. Portanto, é possível que algum dos problemas abaixo aconteça:

  • Transação não aparece no painel sandbox apesar de retorno da API correto;
  • Notificações de mudança de status não chegam à loja;
  • Falha ao reembolsar;
  • Dificuldades ao fazer login no painel da sandbox;
  • Internal Server Error;
  • Transaction is not found;
  • Operation timed out;
  • Bad Gateway;
  • External service error.

Quais valores meus clientes podem pagar com este plugin?

Não há valores máximos para as vendas, porém existem valores mínimo a serem transacionados com o pagseguro, segue lista:

Método | Bandeira | Valor Mínimo (R$) | Parcela Mínima (R$)
Crédito | Visa | 1,00 | 5,00
Crédito | Mastercard | 0,20 | 5,00
Crédito | American Express | 0,20 | 5,00
Crédito | Demais bandeiras | 0,20 | 5,00
Boleto | – | 0,20 | –

FAQ em Inglês:

What is the plugin license?

  • This plugin is released under a GPLv3 license.

What is needed to use this plugin?

  • WooCommerce version 4.5 or later installed and active.
  • Only one account on PagSeguro.

Reviews

January 24, 2023
A dúvida é o que é melhor, o plugin ou o suporte? Ambos são nota máxima, com certeza quem está por traz dele são pessoas dedicadas e que procuram fazer o melhor. Acredito ter um potencial imenso esse plugin, salva cartão e faz o reembolso quando precisar. Hoje ele tem 50 instalações ativas, creio que em 2024 vou voltar aqui e ver pelo menos 1000 ativas. Parabéns!
November 4, 2022
De fácil entendimento, sem muita complicação. Estava faltando no mercado um plugin atualizado que trouxesse as últimas atualizações da API do PagSeguro. O suporte funciona bem e responde rápido. Gostei.
September 15, 2022
Ficamos meio que órfãos desde que a versão do Cláudio Sanches deixou de receber atualizações, agora com este plugin consigo tocar meu negocio usando minha conta Pagseguro.
September 15, 2022
O plugin traz as melhores novidades da última versão da API do PagSeguro. Gostei disto.
Read all 4 reviews

Contributors & Developers

“Virtuaria – Pagseguro para Woocommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0 2022-07-28

  • Versão inicial.

1.0.1 2022-07-29

  • Tradução do plugin para pt-BR.

1.0.2 2022-08-04

  • Atualizando documentação.

1.1.0 2022-09-02

  • Valor mínimo e início dos juros por parcela.

1.1.1 2022-09-08

  • Criptografia RSA para função crédito.

1.1.2 2022-09-13

  • Máscara para data de validade do cartão.

1.1.3 2022-09-15

  • Validação de campos do crédito.

1.2.0 2022-11-10

  • Arquivo de homologação gerado automaticamente.

2.0.0 2023-01-23

  • Suporte a API Orders;
  • Suporte a API Connect;
  • Pagamento com PIX;
  • Modo de processamento Assíncrono;
  • Melhorias no histórico de notas e logs do pedido.

2.0.1 2023-01-24

  • Correção na exibição das abas do checkout.

2.0.2 2023-01-26

  • Melhorando exibição dos meios de pagamento do checkout.