Virtuaria – PagSeguro Crédito, Pix e Boleto

Description

Fácil de instalar e configurar, permite pagamentos no Cartão de Crédito, Pix e Boleto na sua loja virtual Woocommerce com confirmação automática do pagamento nos 3 métodos. Suporta disparo de cobranças extras, além de reembolso total e parcial. Também permite armazenar método de pagamento para agilizar compras recorrentes.

  • Suporte a Crédito, Pix e Boleto Bancário;
  • Opção de parcelamento com ou sem juros (configurável no plugin);
  • 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);
  • 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;
  • 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);
  • Permite que a mesma conta do PagSeguro seja usada em várias lojas virtuais diferentes.

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 Copia e Cola;
  • Exibe os dados de pagamento no e-mail enviado e na tela de confirmação do pedido;
  • Desconto percentual configurável para pagamento no Pix;
  • Confirmação automática de pagamento na tela do pedido “ver mais“.

Atenção: Para vendas com Pix, é necessário que exista uma chave Pix cadastrada na conta do vendedor no painel do PagSeguro. Mais informações

Ativação

Este plugin, utiliza a API mais moderna Order/Connect de cobrança disponibilizada pelo pagseguro, o que permite configuração e ativação muito mais simples e segura, sem necessidade de gerar chaves via painel ou chamado junto ao PagSeguro.

Salvar Método de Pagamento

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

Cobrança Extra

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.

Processamento Assíncrono

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ções:

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.

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

Em caso de atualização a partir da versão 1.x, é necessária uma nova autenticação junto ao PagSeguro. O processo está muito mais simples. Favor consultar a aba “Instalação” logo acima para mais detalhes.

Compatibilidade

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

Contribuição

Se desejar contribuir com o desenvolvimento do plugin, nos envie um pull request no Github.

Suporte Individualizado

Caso precise de suporte individualizado relacionado ao plugin Virtuaria PagSeguro, incluindo: Instalação e configuração; Análise e ajustes no seu código fonte para correção de bugs; Desenvolvimento ou personalização de funcionalidades sob demanda, entre em contato conosco pelo email tecnologia@virtuaria.com.br para fazermos uma proposta.

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”,escolha o ambiente (produção ou sandbox), preencha o email da sua conta no PagSeguro e clique em salvar;
  • Clique em conectar;
  • Conceda as permissões;
  • Clique em salvar novamente;

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

Atenção:### Para vendas com Pix, é necessário que exista uma chave Pix cadastrada na conta do vendedor no painel do PagSeguro. Mais informações

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

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.

Tela de configuração do Plugin:

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

FAQ

1 – 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.

2 – 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.

3 – 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.

4 – 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.

5 – 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.

6 – É 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“.

7 – 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”.

Se os dados 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.

8 – Tem confirmação automática dos pagamentos? O status do pedido é alterado automaticamente?

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

9 – Situações comuns para bloqueio no recebimento de notificações do PagSeguro pelo plugin

O motivo mais comum é algum plugin de segurança, firewall ou ferramenta no servidor onde a loja está rodando estar bloqueando as notificações. Neste caso, basta desativar o bloqueio ou incluir uma exceção para não barrar as notificações que tem o PagSeguro como origem.
Exemplos:
* 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.

10 – 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

.
Lembrando que, se estiver fazendo testes na Sandbox, é comum ocorrerem instabilidades e isto pode fazer com que o PagSeguro não envie até o plugin as atualizações de status.

11 – 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.

12 – 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.

13 – 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 | –
Pix | – | 1,00 | –

14 – 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.

15 – Tem valor mínimo para reembolso?

Sim, o valor mínimo para reembolso via loja virtual é R$ 1,00.

16 – Onde encontro o log do plugin ?

No menu “Woocommerce > Status > Logs”.

Também é possível gerar um relatório detalhado do sistema no menu “Woocommerce > Status”, através do botão “Obter Relatório do Sistema”.

17 – Qual o formato correto do campo “Nome na Fatura” do cartão?

O PagSeguro não permite que o campo “Nome na Fatura” possua mais de 17 caracteres. Também não permite o uso de caracteres especiais ou espaços em branco. Isso pode gerar a mensagem “PagSeguro: Verifique os dados digitados e tente novamente”. A partir da versão 2.3.0, a configuração do plugin não permite que o limite de caracteres seja excedido, então, caso tenha preenchido este campo em uma versão antiga e o nome esteja fora do padrão, basta ajustar o campo e salvar a configuração.

Reviews

June 3, 2023
Só queria agradecer aos devs por esse plugin que integra muito bem o pagseguro ao woocommerce, que tem sido atualizado com novas funcionalidades constantemente e o suporte é extremamente atencioso e solicito.
May 31, 2023
Pensar em um dos melhores plugin desenvolvido, foi esse! Plugin que trouxe muita solução para o nosso woocoomerce. O suporte muito ótimo super atencioso. Nota mil é pouco pela eficiencia deste plugin! Quero parabenizar está equipe maravilhosa
April 24, 2023
Funciona conforme descrito. O melhor plugin do pagseguro. Equipe tá de parabéns.
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.
Read all 6 reviews

Contributors & Developers

“Virtuaria – PagSeguro Crédito, Pix e Boleto” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

2.3.0 2023-05-30

  • Confirmação automática de pagamento Pix na tela de pedido recebido.
  • Correção na validação de acesso quando a opção do Woocommerce, criar conta no checkout estiver ativada.

2.2.8 2023-05-25

  • Exibindo no checkout o valor do pagamento com desconto Pix;
  • Retirada da obrigatoriedade do preenchimento da descrição do plugin para que os campos apareçam.
  • Ajuste no texto informativo sobre o Boleto bancário.

2.2.7 2023-05-05

  • Correção no total do pix quando o desconto está ativo;

2.2.6 2023-05-02

  • Desconto Pix usando total do carrinho sem contar o valor de frete.
  • Identificação do titular do cartão no histórico(notas) do pedido.
  • Limite de tamanho nos campos de endereço do cliente.
  • Otimização na configuração Conectar / Desconectar com o PagSeguro.

2.2.5 2023-03-27

  • Correção do problema ao exibir cobrança adicional em ambientes com php 8.0.
  • Correção na apresentação do valor do item no relatório do PagSeguro.

2.2.4 2023-03-23

  • Correção do problema “Pagseguro: must be between 100 and 999999900” em compras no Pix.

2.2.3 2023-03-22

  • Limpar inconsistências do banco de dados quando ocorrer falha ao conectar/desconectar.

2.2.2 2023-03-22

  • Correção na aplicação do desconto Pix no QR Code.
  • Prefixo para uso de transações em várias lojas com a mesma conta.

2.2.1 2023-03-21

  • Desconto em pagamentos com Pix.
  • Aviso sobre ausência do módulo Brazilian Market on WooCommerce.

2.2.0 2023-03-10

  • Reconhecimento de bandeira de cartão de crédito e exibição de ícone no checkout.
  • Ajuste na altura do checkout quando o crédito não está ativo.
  • Ao sair do campo “Validade”, no checkout, converter data de expiração de MM/AA para MM/AAAA.
  • Nova cobrança Pix – reembolso para primeiro pagamento efetivado e ajuste para prevenir cancelamento do pedido quando a cobrança adicional tiver sido paga.
  • Identificação da forma de pagamento na lista de pedidos.
  • Melhorias no recebimento de webhooks e notas do histórico do pedido.

2.1.0 2023-02-14

  • Opção para configurar layout dos campos do checkout (crédito).
  • Melhoria no layout da configuração de autorização.

2.0.4 2023-02-07

  • Correção de problema de compatibilidade com php 8.2.
  • Compatibilidade com venda para pessoa jurídica(PJ).
  • Melhoria no espaçamento do e-mail com pedidos via Pix.
  • Campo Bairro (billing_neighborhood) obrigatório.
  • Melhoria visual na apresentação do QR code na página de agradecimento do pedido.
  • Melhorias visuais no checkout transparente.

2.0.3 2023-02-01

  • Correção na exibição do valor mínimo da parcela.
  • Novo campo “Observações” para exibir informações extras abaixo da descrição do método de pagamento.

2.0.2 2023-01-26

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

2.0.1 2023-01-24

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

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.

1.2.0 2022-11-10

  • Arquivo de homologação gerado automaticamente.

1.1.3 2022-09-15

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

1.1.2 2022-09-13

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

1.1.1 2022-09-08

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

1.1.0 2022-09-02

  • Configuração de valor mínimo e início dos juros por parcela.

1.0.2 2022-08-04

  • Atualizando documentação.

1.0.1 2022-07-29

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

1.0 2022-07-28

  • Versão inicial.