Pix por Piggly (para Woocommerce)

Description

Pix por Piggly v2.1.2

Compatível com WooCommerce Blocks e PHP 8.0+.

O melhor plugin para pagamentos via Pix no Woocommerce. Na vers?o 2.0.0 o plugin está melhor mais dinamico e muito mais responsivo. Veja mais detalhes.

Sempre atualize para continuar aproveitando

O Pix é o mais novo método de pagamento eletr?nico criado pelo Banco Central do Brasil. Você encontra todos os detalhes na página oficial do Pix.

O plugin é permitir que você utilize o método de pagamento Pix em sua loja Woocommerce sem qualquer custo de forma simples, rápida e direta. Acesse as configura??es do plugin em Pix por Piggly no menu lateral.

Se você apreciar a fun??o deste plugin e quiser apoiar este trabalho, sinta-se livre para fazer qualquer doa??o para a chave aleatória Pix aae2196f-5f93-46e4-89e6-73bf4138427b ?.

N?o esque?a de deixar a sua avalia??o sobre o plugin! Isso nos incentivará a lan?ar mais atualiza??es e continuar prestando um suporte de qualidade.

Recursos que só o Pix por Piggly tem

• ? Tratamento automático de dados, n?o se preocupe com o que você digita. O plugin automaticamente detecta melhorias;
• ? Permita que o cliente envie o comprovante por uma página segura, pelo Whatsapp e/ou Telegram;
• ? Atualize automaticamente o pedido quando um comprovante for enviado;
• ? Defina uma data de expira??o de pagamento do Pix;
• ? Envio de e-mails para os eventos: quando o Pix estiver próximo de expirar, quando o Pix expirar, quando o Pix for pago e quando o Pix for criado para pagamento;
• ? Teste o seu Pix a qualquer hora, antes mesmo de habilitar o plugin;
• ? Aplique desconto automático, sem cria??o de cupons, ao realizar o pagamento via Pix;
• ? Visualize os dados do Pix gerado na página do pedido;
• ? Importe os dados Pix de uma chave Pix válida e preencha os dados da Conta Pix automaticamente;
• ? Utilize Merge Tags, em campos disponíveis, para substituir variáveis e customizar ainda mais as fun??es do plugin;
• ? Páginas dedicadas para o pagamento do Pix e envio de comprovantes, que podem ser acessados via “Minha Conta”;
• ? Suporte a API do Woocommerce.

Vers?o `2.0.0`

Na vers?o 2.0.0 promovemos várias mudan?as no formato no plugin, tanto para facilitar quando para deixar o fluxo de pagamento mais simples e dinamico. Algumas op??es foram removidas, enquanto outras foram mantidas. Leia abaixo em detalhes tudo que está diferente.

E-mails

?? Antes

?? Era possível escolher o modelo de e-mail na qual o pagamento Pix seria anexado e, ainda, escolher a posi??o deste pagamento.

? Por que mudamos?

Muitos relatavam conflitos e dificuldades para gerenciar o conteúdo do e-mail, enquanto outros utilizavam plugins desatualizados que quebravam os e-mails. Isso acontecia, pois dependiamos de uma action localizada no modelo de e-mail selecionado para carregar os dados do Pix.

?? Agora

?? Criamos diversos modelos de e-mails, entre eles: quando o Pix estiver próximo de expirar, quando o Pix expirar, quando o Pix for pago e quando o Pix for criado para pagamento.

?? N?o anexamos mais as informa??es do Pix no e-mail para evitar SPAM e compartilhamento desnecessário dos dados. Criamos um link único para o cliente acessar e visualizar todos os dados de pagamento novamente.

Comprovantes

?? Antes =

?? Era possível selecionar uma página para enviar o comprovante e utilizar qualquer formulário desejado. Também era possível utilizar o shortcode [pix-por-piggly-form] para utilizar o recurso nativo do plugin para recebimento de comprovantes.

? Por que mudamos?

Alguns clientes enviavam de forma errada ou a forma como o shortcode [pix-por-piggly-form] era utilizado prejudicava a experiência criando diversos comprovantes desnecessários e produzindo muito lixo na pasta de uploads.

?? Agora

?? Será utilizado um link permanente exclusivo para que o usuário fa?a o envio do comprovante Pix, garantindo todas as valida??es necessárias para que o usuário envie sempre para o pedido correto.

?? O comprovante enviado será automaticamente associado ao Pix relacionado ao pedido e sempre será considerado o último comprovante enviado.

Pedidos

?? Antes

?? Ao selecionar o Pix, o pedido automaticamente migrava o status para Aguardando o Pagamento, também era possível utilizar o status Comprovante Pix Recebido quando o comprovante era enviado.

? Por que mudamos?

Alguns usuários acharam o status Comprovante Pix Recebido muito complicado e tinham rotinas que impediam o uso.

Migrar para o status Aguardando o Pagamento também n?o é mais uma op??o, uma vez que os Pix podem ser confirmados tanto por API quanto por comprovantes.

?? Agora

?? Agora, por padr?a, o pedido ficará como Pendente atéq ue o cliente envie o comprovante ou que uma API Pix atualize o Pix como pago.

?? Quando o cliente enviar um comprovante, o status é migrado para sair da situa??o como Pendente.

?? Também foi adicionado um recurso para atualizar automaticamente o status do pedido para Pago quando o Pix for pago.

?? Tanto o status para Comprovante Enviado quanto para Pedido Pago podem ser configurados. N?o recomendamos que o Comprovante Enviado marque o pedido como pago…

Endpoints

?? Agora

?? Foram criados dois endpoints exclusivos dentro do ambiente “Minha Conta” do Woocommerce. Um para o realizar o pagamento pendente do Pix e outro para enviar o comprovante de pagamento.

?? Os endpoints podem ser acessados a qualquer momento desde que o cliente tenha autoriza??o e eles estejam liberados para acesso.

Templates

?? Agora

?? Atualizamos todos os templates, será necessário revisá-los para que eles funcionem corretamente caso você tenha realizado alguma personaliza??o.

Filtros e A??es

A partir da vers?o 2.0.0 é possível utilizar os filtros e as a??es abaixo:

?? Filtros

• pgly_wc_piggly_pix_discount_applied Personaliza o valor calculado para o desconto antes de aplicar;
• pgly_wc_piggly_pix_payload Personaliza ou altera o objeto Payload do Pix antes de gerar o código;
• pgly_wc_piggly_pix_pending_status Personaliza o status de pending ao criar um pedido com pagamento Pix;
• pgly_wc_piggly_pix_process Personaliza o objeto PixEntity antes de processar o Pix.

?? A??es

• pgly_wc_piggly_pix_webhook Executa o webhook do Pix;
• pgly_wc_piggly_pix_to_pay Logo após o Pix ser criado e associado ao pedido;
• pgly_wc_piggly_pix_after_save_receipt Logo após criar (e salvar) o comprovante do Pix;
• pgly_wc_piggly_pix_close_to_expires Quando o Pix está próximo da expira??o.

Principais melhorias

• ? Altera??o da cor do ícone do Pix;
• ? Formulário integrado para envio de comprovante;
• ? (Opcional) Atualiza??o automática do pedido com comprovante recebido;
• ? Desconto automático para pagamento via Pix.
• ? Reformula??o das configura??es;
• ? Cria??o da metabox Pix nos pedidos pagos via Pix;
• ? Otimiza??o para gera??o dos QR Codes;
• ? Desconto automático para pagamento via Pix.

Performance

Toda a estrutura e código do plugin foram atualizados para garantir a melhor performance, agora todos os dados de um Pix criado s?o salvos em uma tabela de dados que evita a recria??o do Pix. Os QR Codes e os comprovantes também s?o associados ao Pix que permite um único arquivo de cada, mantendo a biblioteca de uploads sempre limpa.

Como funciona?

Assim como é feito atualmente com uma transferência eletr?nica no Woocommerce, o Pix por Piggly permite aos consumidores escolherem o método de pagamento Pix, ent?o eles recebem as instru??es de pagamento e enviam o comprovante. Você também pode aplicar um desconto automático para pagamentos via Pix.

Bem simples né?

Para permitir isso, nosso plugin segue todas as propostas do padr?o EMV?1, implementado pelo Banco Central do Brasil, você pode ler mais sobre isso em Especifica??es Técnicas. Utilizamos a nossa bibliteca piggly/php-pix para manipular e gerar os códigos pix.

Dessa forma, nosso plugin gera os três principais métodos de pagamento Pix:

1. Um QR Code com o código Pix;
2. O código Pix em formato de texto para utiliza??o da fun??o Pix Copia & Cola;
3. Pagamento manual com os dados Pix fornecidos.

Nosso plugin gera de forma automática o código Pix com base nas informa??es do Pedido e nas informa??es preenchidas na configura??o do plugin.

N?o importa como você digita a chave Pix, ela será automaticamente convertida para os formatos apropriados, okay? Caso ela esteja inválida, de acordo com o formato escolhido, você será notificado.

Testes realizados

O código Pix gerado por esse plugin, incluindo a fun??o QR Code e Pix Copia & Cola, foi testado nos seguintes aplicativos de banco:

• Banco do Brasil;
• Banco Inter;
• BMG;
• Bradesco;
• C6;
• Itaú;
• Mercado Pago;
• Nubank;
• PagPank;
• Santander.

Como o código utiliza o padr?o do Pix é possível que funcione em todos os bancos. Mas, caso encontre problemas ou dificuldades n?o hesite em abrir uma thread no Suporte do Plugin ou enviar um e-mail para [email protected].

Perguntas Frequentes

Qual é a licen?a do plugin?

Este plugin esta licenciado como GPLv2. Ele é distrubuido de forma gratuita.

O que eu preciso para utilizar este plugin?

• Ter instalado o WordPress 4.0 ou superior;
• Ter instalado o plugin WooCommerce 3.0 ou superior;
• Utilizar a vers?o 7.2 do PHP;
• Ter a extens?o gd para PHP habilitada, veja detalhes aqui;
• Possuir uma conta bancária com Chave Pix.

Posso utilizar com outros gateways de pagamento?

Sim, esse plugin funciona apenas como um método de pagamento adicional, assim como acontece com o método de transferência eletr?nica.

Como aplicar desconto automático?

Na página de configura??es do Plugin, acesse Pedidos e insira um valor e um rótulo para o desconto Pix. O desconto será automaticamente aplicado quando o cliente escolher o método de pagamento Pix.

Como conferir o pagamento Pix?

A conferência do Pix ainda é manual, assim como acontece em uma transferência eletr?nica. Para facilitar, o plugin gera os Pix com um código identificador. Esse código possuí um valor estático de 25 caracteres.

Abra o pedido criado no Woocommerce e verifique o código identificador do Pix, ao abrir o aplicativo do seu banco, você poderá ver detalhes sobre o recebimento Pix e, na maioria dos bancos, o pagamento estará identificado com o código identificador do Pix.

= N?o tem como atualizar o pagamento Pix automaticamente?

Para validar se um Pix foi pago a maioria dos bancos emissores ir?o cobrar taxas, assim como os intermediadores de pagamento. Se você faz parte de um banco emissor que já implementa a API Pix, pode entrar em contato com a gente em [email protected] para que possamos implementar a solu??o.

Gerei o código Pix, mas n?o consigo efetuar o pagamento. E agora?

Nas configura??es do Plugin acesse “Suporte” e verifique a se??o “O plugin gera o QR Code, mas n?o consigo pagá-lo”, lá estar?o algumas dicas automáticas que podem ajudar você. Se ainda sim precisar de algum suporte, abra um chamado enviando um e-mail para [email protected].

Como customizar os templates?

Nas configura??es do Plugin acesse “Suporte” e verifique a se??o “Como substituir os templates de e-mail e da página de obrigado”.

AVISO: Ao customizar os templates você pode perder funcionalidades importantes do plugin e comportamentos pré-existentes nos templates originais. Tenha certeza sobre o que está fazendo para garantir que tudo funcione como deve ser. N?o prestaremos suporte para customiza??es.

Como instalar?

No diretório oficial do WordPress

A página oficial do plugin pode ser encontrada em: wordpress@pix-por-piggly.

No repositório do Github

Vá para Releases neste repositório e fa?a o download em .zip da vers?o mais recente.

Ent?o, no Painel Administrativo do WordPress, vá em Plugins > Adicionar novo e clique em Upload plugin no topo da página para enviar o arquivo .zip.

Você precisará, posteriormente, ir até a pasta do plugin no terminal do seu servidor Web e executar o comando composer install caso escolha essa op??o.

Da origem

Você precisará do Git instalado para contruir da origem. Para completar os passos a seguir, você precisará abrir um terminal de comando. Clone o repositório:

git clone https://github.com/piggly-dev/wc-piggly-pix.git

Você precisará, posteriormente, executar o comando composer install caso escolha essa op??o.

Como utilizar?

Após a instala??o do plugin, vá até Plugins > Plugins instalados, ative o plugin Pix por Piggly para Woocommerce. Assim que você ativar, o plugin já estará disponível em Woocommerce > Configura??es > Pagamentos e você poderá inserir todas as configura??es pertinentes.

Preencha corretamente a sua chave Pix. Você pode testar nas configura??es do plugin o funcionamento do Pix mesmo que o módulo esteja desativado.

Screenshots

Reviews

Muito obrigado

alessandrovicente October 19, 2024

ótimo plugin!!

ótimo, funcionando 100%

ávila June 2, 2024

Instalei no site; sou desenvolvedor de sites e presto suporte/servi?o mensal aos meus clientes, e essa ferramenta de pagamento via PIX, foi a melhor alterativa e o único plugin relacionado a PIX que realmente funcionou! Gratid?o por proporcionar essa ferramenta a nós. é de gra?a, porém recomendo que fa?am uma doa??o pra eles pra ajudar eles, pois o plugin é gratuito conforme já citado.

N?o funcionou o QR Code

T E C H Z I L May 23, 2024

Lamentavelmente, comigo n?o funcinou. O QR Code n?o é gerado, aparece a mininatura de uma imagem cortada. O Pix Copia e Cola até é gerado, mas o QR Code n?o é gerado. Tentei enviar um email para o suporte mas deu erro. Esse plugin era a minha esperan?a de n?o pagar mais taxa de PIX para o mercado pago, mas n?o tive sorte.

Funciona mas o desconto do pix é aceito no cartao

webde5igner March 25, 2024

Funciona mas o desconto do pix é aceito no cartao, parece um bug pois já revisei tudo e n?o deveria acontecer, desconto do pix tem que servir para pix.

Parou de funcionar

Loreta Labarca February 17, 2024

Infelizmente parou de funcionar e buga toda a experiência do usuário na hora de pagar. é uma pena. Era um excelente plugin.

PAROU DE FUNCIONAR

jajacaraujo November 28, 2023

Parou de funcionar na nova vers?o do wordpress ou woocommerce

Contributors & Developers

Changelog

2.1.2

• Suporte a metabox e flag de pagamento Pix nos pedidos para WooCommerce 8.4+.

2.1.1

• Corrigido os problemas de envio do comprovante.

2.1.0

• Suporte ao PHP 8.0;
• Corre??o de bugs;
• Suporte ao WooCommerce Checkout Blocks.

2.0.28

• Corre??es do WordPress.

2.0.27

• Corre??es do WordPress.

2.0.26

• Corre??o de problema na atualiza??o de configura??o do Pix.

2.0.25

• Adi??o do menu “Processamento do Pix” para maior controle da cronjob e do processamento imediato do Pix.
• Novos avisos adicionados e nomenclatura dos Pix alterada.

2.0.24

• Pequenas corre??es.

2.0.23

• Pequenas corre??es;
• Preven??o de cancelamento automático.

2.0.22

• Limpeza dos logs;
• Alerta de Modo Debug ativo;
• Filtragem básica dos Pix criados.

2.0.21

• Bug na atualiza??o do Pix.

2.0.20

• Melhorias nas mensagens de retorno de erro e sucesso;
• Desabilita??o da limpeza automática;
• Atualiza??o automática do Pix com bot?o “Já realizei o pagamento” para APIs do Pix.

2.0.19

• Corre??o de permiss?o de logs durante execu??o da cronjob;
• Corre??o na data de atualiza??o do Pix;
• Corre??o no envio de notifica??o de Pix próximo a expira??o;
• Remo??o do Pix ao remover o pedido;
• Atualiza??o automática para a página de pedido concluído, quando em uso da API do Pix;
• Corre??o da atualiza??o da Cron Job para executar a cada minuto;
• A??o para executar os webhooks da API do Pix;
• Exibi??o do e2eid identificando o pagamento do Pix, quando em uso da API do Pix;
• Rotina para limpeza dos Pix expirados ou cancelados;
• Reorganiza??o do menu Pix por Piggly.

2.0.18

• Corre??o da detec??o de Pix próximo à expira??o;
• Habilita??o da API do Woocommerce para pedidos Pix;
• Melhoria nos logs de debug para identificar envio dos e-mails.

2.0.17

• Corre??o nos modelos de e-mails;

2.0.16

• E-mail quando o Pix for criado;
• Exibi??o da data de expira??o no template de pagamento;
• Melhorias na interface de configura??o;
• Melhorias de comunica??o nas páginas do plugin.

2.0.15

• Corre??o de bug na metabox do pedido.

2.0.14

• Personaliza??o do destinatário dos e-mails administrativos;
• Corre??o no ícone do Pix;
• Op??o para cancelar o pedido quando o Pix expirar;
• Recria??o da cronjob ao atualizar.

2.0.12/2.0.13

• Corre??o de bugs nas configura??es do plugin;
• Adi??o da personaliza??o do status de aguardando o pagamento.

2.0.11

• Op??o para reduzir o estoque do pedido assim que o Pix é criado;
• Posi??o dos links de comprovante;
• Estoque reduzido assim que o comprovante Pix é enviado;
• Op??o de ocultar valor do Pix antes dos dados Pix.

2.0.9/2.0.10

• Micro-corre??es.

2.0.8

• Corre??o no banco de dados.

2.0.7

• Corre??o no banco de dados.
• Notifica??o sobre atualiza??o dos Links permanentes.

2.0.6

• Corre??o para salvar informa??es de desconto Pix.

2.0.4/2.0.5

• Corre??o no banco de dados.

2.0.3

• Corre??o para aceitar a ausência de banco no Pix.

2.0.2

• Notifica sobre atualiza??o dos endpoints.

2.0.1

• Micro corre??es.

2.0.0

• Novo release com mudan?as substanciais no núcleo do plugin.

1.3.14

• Bug no shortcode [pix-por-piggly] que n?o retorna o template;
• Bug no desconto de pagamento e valor corrigido quando há cupom de desconto aplicado;
• Libera??o da tela para APIs;
• Acionamento de actions e filters.

1.3.13

• Aumento de seguran?a na valida??o dos arquivos enviados como comprovantes;
• Corre??o de bug na página de “Comprovantes Pix”;
• Outras melhorias e corre??es.

1.3.12

• Pequenas corre??es e melhorias.

1.3.11

• Corre??o de exibi??o duplicada dos shortcodes;
• Melhorias no sistema de upload dos comprovantes;
• Redirecionamento após comprovante recebido com sucesso;
• Outras corre??es e melhorias.

1.3.10

• Valida??o dos arquivos .htaccess;
• Corre??o de problemas com valores Pix.

1.3.9

• Bug na exibi??o do desconto no HTML;
• Formato numérico corrigido na página de pagamento via Pix.

1.3.8

• Gest?o eficiente e otimizada dos comprovantes Pix para exclus?o e busca de comprovantes.

1.3.7

• Corre??o no arquivo .htaccess que gera um erro 403 ao acessar os comprovantes.

1.3.6

• Descri??o avan?ada com Pix com passos para pagamento.

1.3.5

• Escolher cor do ícone para o Pix;
• Ocultar o status “Comprovante Pix Recebido” no painel de pedidos;
• Corre??es e melhorias indicadas no suporte.

1.3.4

• Corre??o do bug para a primeira instala??o do plugin, retornando valores vazios.

1.3.3

• A mudan?a do status para “Comprovante Pix Recebido” tornou-se opcional.

1.3.2

• Corre??o para ocultar o bot?o “Enviar Comprovante”.

1.3.1

• Corre??o do erro fatal no método remove_qr_image.

1.3.0

• Suporte a formulário nativo para envio dos comprovantes;
• Melhorias no shortcode [pix-por-piggly];
• Melhorias e corre??es em gerais.

1.2.4

• Atualiza??o dos paineis de configura??o;
• Melhoria na cria??o dos arquivos de QR Code contra erros de cachê;
• Suporte a API do Woocommerce;
• Corre??o da leitura de telefones internacionais no campo de Telefone do Whatsapp.

1.2.3

• Corrige avisos do PHP e permite o ID da transa??o vazio como ***.

1.2.2

• Corre??o da ausência do bot?o em Teste seu Pix.

1.2.1

• Auto corrige automaticamente os campos do dados Pix baseado no Banco selecionado.

1.2.0

• Reformula??o das configura??es;
• Cria??o da metabox Pix nos pedidos pagos via Pix;
• Otimiza??o da gera??o dos QR Codes;
• Desconto automático para pagamento via Pix.

1.1.14

• Dicas de apoio para preenchimento do Pix;
• Corre??es dos bot?es Whatsapp e Telegram no e-mail;
• Link para ver o pedido no e-mail ao invés do link para pagamento;
• Corre??es ao salvar configura??es;
• Adi??o do caminho para sobrescrever os templates.

1.1.13

• Adi??o do bot?o de configura??o e ajustes na importa??o;

1.1.12

• Corre??es de bugs;

1.1.11

• Melhorias no texto de apoio e captura de erros com textos de apoio;

1.1.10

• Corre??o de bug no envio de e-mail;

1.1.9

• Corre??o de bugs para vers?es 7.3- do PHP;

1.1.8

• Corre??o de bugs, melhorias da documenta??o, controle de erros e inser??o nas instru??es via e-mail;

1.1.7

• Corre??es e melhorias;

1.1.6

• Corre??o do bug no campo Whatsapp, corre??o dos bugs com chaves vazias, controladores de e-mail e status;

1.1.5

• Atualiza??o da formata??o do campo Identificador;

1.1.4

• Bot?es para Whatsapp e Telegram, além de melhorias no layout;

1.1.3

• Suporte para o PHP 7.2 (conforme solicitado por muitos utilizadores);

1.1.2

• Atualiza??o da biblioteca piggly/php-pix e do painel de configura??es;

1.1.1

• Atualiza??o da biblioteca piggly/php-pix;

1.1.0

• Corre??es de bugs;
• Melhorias na exibi??o do Pix no e-mail e na tela;
• Ajuste de visualiza??es com base nas op??es selecionadas;
• Melhorias no núcleo do plugin;

1.0.3/1.0.4

• Corre??es de bugs e reposicionamento das descri??es;

1.0.2

• Melhorias no design das informa??es de pagamento;

1.0.1

• Melhorias no design das informa??es de pagamento;
• Corre??es de pequenos bugs;
• Inclus?o para encaminhar até a página para upload de arquivos;
• Inclus?o da página “Teste seu Pix”.

1.0.0

• Vers?o inicial do plugin.