Piggly Dev

caiquearaujo

<h3>Pix por Piggly v2.1.2</h3>
<blockquote>
<p>Compatível com WooCommerce Blocks e PHP 8.0+.</p>
</blockquote>
<p>O melhor plugin para pagamentos via Pix no Woocommerce. Na versão 2.0.0 o plugin está melhor mais dinâmico e muito mais responsivo. Veja mais detalhes.</p>
<p><strong>Sempre atualize para continuar aproveitando</strong></p>
<p>O <strong>Pix</strong> é o mais novo método de pagamento eletrônico criado pelo Banco Central do Brasil. Você encontra todos os detalhes na <a href="https://www.bcb.gov.br/estabilidadefinanceira/pix" rel="nofollow ugc">página oficial</a> do Pix.</p>
<p>O plugin é permitir que você utilize o método de pagamento Pix em sua loja <strong>Woocommerce</strong> sem qualquer custo de forma simples, rápida e direta. Acesse as configurações do plugin em <code>Pix por Piggly</code> no menu lateral.</p>
<blockquote>
<p>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 <code>aae2196f-5f93-46e4-89e6-73bf4138427b</code> ❤.</p>
<p>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.</p>
</blockquote>
<h3>Recursos que só o Pix por Piggly tem</h3>
<ul>
<li>✅ Tratamento automático de dados, não se preocupe com o que você digita. O plugin automaticamente detecta melhorias;</li>
<li>✅ Permita que o cliente envie o comprovante por uma página segura, pelo Whatsapp e/ou Telegram;</li>
<li>✅ Atualize automaticamente o pedido quando um comprovante for enviado;</li>
<li>✅ Defina uma data de expiração de pagamento do Pix;</li>
<li>✅ 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;</li>
<li>✅ Teste o seu Pix a qualquer hora, antes mesmo de habilitar o plugin;</li>
<li>✅ Aplique desconto automático, sem criação de cupons, ao realizar o pagamento via Pix;</li>
<li>✅ Visualize os dados do Pix gerado na página do pedido;</li>
<li>✅ Importe os dados Pix de uma chave Pix válida e preencha os dados da Conta Pix automaticamente;</li>
<li>✅ Utilize <strong>Merge Tags</strong>, em campos disponíveis, para substituir variáveis e customizar ainda mais as funções do plugin;</li>
<li>✅ Páginas dedicadas para o pagamento do Pix e envio de comprovantes, que podem ser acessados via “Minha Conta”;</li>
<li>✅ Suporte a API do Woocommerce.</li>
</ul>
<h3>Versão `2.0.0`</h3>
<p>Na versão <strong>2.0.0</strong> promovemos várias mudanças no formato no plugin, tanto para facilitar quando para deixar o fluxo de pagamento mais simples e dinâmico. Algumas opções foram removidas, enquanto outras foram mantidas. Leia abaixo em detalhes tudo que está diferente.</p>
<h4>E-mails</h4>
<h4>👎 Antes</h4>
<p>👉 Era possível escolher o modelo de e-mail na qual o pagamento Pix seria anexado e, ainda, escolher a posição deste pagamento.</p>
<h4>❌ Por que mudamos?</h4>
<p>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 <code>action</code> localizada no modelo de e-mail selecionado para carregar os dados do Pix.</p>
<h4>👍 Agora</h4>
<p>👉 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.</p>
<p>👉 Não anexamos mais as informações do Pix no e-mail para evitar <strong>SPAM</strong> e compartilhamento desnecessário dos dados. Criamos um link único para o cliente acessar e visualizar todos os dados de pagamento novamente.</p>
<h4>Comprovantes</h4>
<p>👎 Antes =</p>
<p>👉 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 <code>[pix-por-piggly-form]</code> para utilizar o recurso nativo do plugin para recebimento de comprovantes.</p>
<h4>❌ Por que mudamos?</h4>
<p>Alguns clientes enviavam de forma errada ou a forma como o shortcode <code>[pix-por-piggly-form]</code> era utilizado prejudicava a experiência criando diversos comprovantes desnecessários e produzindo muito lixo na pasta de uploads.</p>
<h4>👍 Agora</h4>
<p>👉 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.</p>
<p>👉 O comprovante enviado será automaticamente associado ao Pix relacionado ao pedido e sempre será considerado o último comprovante enviado.</p>
<h4>Pedidos</h4>
<h4>👎 Antes</h4>
<p>👉 Ao selecionar o Pix, o pedido automaticamente migrava o status para <code>Aguardando o Pagamento</code>, também era possível utilizar o status <code>Comprovante Pix Recebido</code> quando o comprovante era enviado.</p>
<h4>❌ Por que mudamos?</h4>
<p>Alguns usuários acharam o status <code>Comprovante Pix Recebido</code> muito complicado e tinham rotinas que impediam o uso.</p>
<p>Migrar para o status <code>Aguardando o Pagamento</code> também não é mais uma opção, uma vez que os Pix podem ser confirmados tanto por API quanto por comprovantes.</p>
<h4>👍 Agora</h4>
<p>👉 Agora, por padrõa, o pedido ficará como <code>Pendente</code> atéq ue o cliente envie o comprovante ou que uma API Pix atualize o Pix como pago.</p>
<p>👉 Quando o cliente enviar um comprovante, o status é migrado para sair da situação como <code>Pendente</code>.</p>
<p>👉 Também foi adicionado um recurso para atualizar automaticamente o status do pedido para <code>Pago</code> quando o Pix for pago.</p>
<p>👉 Tanto o status para Comprovante Enviado quanto para Pedido Pago podem ser configurados. <strong>Não recomendamos que o Comprovante Enviado marque o pedido como pago…</strong></p>
<h4>Endpoints</h4>
<h4>👍 Agora</h4>
<p>👉 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.</p>
<p>👉 Os endpoints podem ser acessados a qualquer momento desde que o cliente tenha autorização e eles estejam liberados para acesso.</p>
<h4>Templates</h4>
<h4>👍 Agora</h4>
<p>👉 Atualizamos todos os templates, será necessário revisá-los para que eles funcionem corretamente caso você tenha realizado alguma personalização.</p>
<h4>Filtros e Ações</h4>
<p>A partir da versão <strong>2.0.0</strong> é possível utilizar os filtros e as ações abaixo:</p>
<h4>👍 Filtros</h4>
<ul>
<li><code>pgly_wc_piggly_pix_discount_applied</code> Personaliza o valor calculado para o desconto antes de aplicar;</li>
<li><code>pgly_wc_piggly_pix_payload</code> Personaliza ou altera o objeto Payload do Pix antes de gerar o código;</li>
<li><code>pgly_wc_piggly_pix_pending_status</code> Personaliza o status de <code>pending</code> ao criar um pedido com pagamento Pix;</li>
<li><code>pgly_wc_piggly_pix_process</code> Personaliza o objeto <code>PixEntity</code> antes de processar o Pix.</li>
</ul>
<h4>👍 Ações</h4>
<ul>
<li><code>pgly_wc_piggly_pix_webhook</code> Executa o webhook do Pix;</li>
<li><code>pgly_wc_piggly_pix_to_pay</code> Logo após o Pix ser criado e associado ao pedido;</li>
<li><code>pgly_wc_piggly_pix_after_save_receipt</code> Logo após criar (e salvar) o comprovante do Pix;</li>
<li><code>pgly_wc_piggly_pix_close_to_expires</code> Quando o Pix está próximo da expiração.</li>
</ul>
<h4>Principais melhorias</h4>
<ul>
<li>✅ Alteração da cor do ícone do Pix;</li>
<li>✅ Formulário integrado para envio de comprovante;</li>
<li>✅ (Opcional) Atualização automática do pedido com comprovante recebido;</li>
<li>✅ Desconto automático para pagamento via Pix.</li>
<li>✅ Reformulação das configurações;</li>
<li>✅ Criação da metabox Pix nos pedidos pagos via Pix;</li>
<li>✅ Otimização para geração dos QR Codes;</li>
<li>✅ Desconto automático para pagamento via Pix.</li>
</ul>
<h3>Performance</h3>
<p>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.</p>
<h3>Como funciona?</h3>
<p>Assim como é feito atualmente com uma transferência eletrônica no Woocommerce, o <strong>Pix por Piggly</strong> 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.</p>
<p>Bem simples né?</p>
<p>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 <a href="https://www.bcb.gov.br/content/estabilidadefinanceira/forumpireunioes/Anexo%20I%20-%20QRCodes%20-%20Especifica%C3%A7%C3%A3o%20-%20vers%C3%A3o%201-1.pdf" rel="nofollow ugc">Especificações Técnicas</a>. Utilizamos a nossa bibliteca <a href="https://github.com/piggly-dev/php-pix" rel="nofollow ugc">piggly/php-pix</a> para manipular e gerar os códigos pix.</p>
<p>Dessa forma, nosso plugin gera os três principais métodos de pagamento Pix:</p>
<ol>
<li>Um <strong>QR Code</strong> com o código Pix;</li>
<li>O código Pix em formato de texto para utilização da função <strong>Pix Copia & Cola</strong>;</li>
<li>Pagamento manual com os dados Pix fornecidos.</li>
</ol>
<p>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.</p>
<blockquote>
<p>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.</p>
</blockquote>
<h3>Testes realizados</h3>
<p>O código Pix gerado por esse plugin, incluindo a função <strong>QR Code</strong> e <strong>Pix Copia & Cola</strong>, foi testado nos seguintes aplicativos de banco:</p>
<ul>
<li>Banco do Brasil;</li>
<li>Banco Inter;</li>
<li>BMG;</li>
<li>Bradesco;</li>
<li>C6;</li>
<li>Itaú;</li>
<li>Mercado Pago;</li>
<li>Nubank;</li>
<li>PagPank;</li>
<li>Santander.</li>
</ul>
<p>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 <a href="https://wordpress.org/support/plugin/pix-por-piggly/" rel="ugc">thread</a> no Suporte do Plugin ou enviar um e-mail para <strong><a href="mailto:dev@piggly.com.br" rel="nofollow ugc">dev@piggly.com.br</a></strong>.</p>
<h3>Perguntas Frequentes</h3>
<h4>Qual é a licença do plugin?</h4>
<p>Este plugin esta licenciado como GPLv2. Ele é distrubuido de forma gratuita.</p>
<h4>O que eu preciso para utilizar este plugin?</h4>
<ul>
<li>Ter instalado o WordPress 4.0 ou superior;</li>
<li>Ter instalado o plugin WooCommerce 3.0 ou superior;</li>
<li>Utilizar a versão 7.2 do PHP;</li>
<li>Ter a extensão <code>gd</code> para PHP habilitada, veja detalhes <a href="https://www.php.net/manual/pt_BR/book.image.php" rel="nofollow ugc">aqui</a>;</li>
<li>Possuir uma conta bancária com Chave Pix.</li>
</ul>
<h4>Posso utilizar com outros gateways de pagamento?</h4>
<p>Sim, esse plugin funciona apenas como um método de pagamento adicional, assim como acontece com o método de transferência eletrônica.</p>
<h4>Como aplicar desconto automático?</h4>
<p>Na página de configurações do Plugin, acesse <strong>Pedidos</strong> 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.</p>
<h4>Como conferir o pagamento Pix?</h4>
<p>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.</p>
<p>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.</p>
<p>= Não tem como atualizar o pagamento Pix automaticamente?</p>
<p>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 <a href="mailto:dev@piggly.com.br" rel="nofollow ugc">dev@piggly.com.br</a> para que possamos implementar a solução.</p>
<h4>Gerei o código Pix, mas não consigo efetuar o pagamento. E agora?</h4>
<p>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 <a href="mailto:dev@piggly.com.br" rel="nofollow ugc">dev@piggly.com.br</a>.</p>
<h4>Como customizar os templates?</h4>
<p>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”.</p>
<blockquote>
<p><strong>AVISO</strong>: 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. <strong>Não prestaremos suporte para customizações</strong>.</p>
</blockquote>
<h3>Como instalar?</h3>
<h4>No diretório oficial do WordPress</h4>
<p>A página oficial do plugin pode ser encontrada em: <a href="https://wordpress.org/plugins/pix-por-piggly/" rel="ugc">wordpress@pix-por-piggly</a>.</p>
<h4>No repositório do Github</h4>
<p>Vá para <a href="https://github.com/piggly-dev/piggly-views-wordpress/releases" rel="nofollow ugc">Releases</a> neste repositório e faça o download em <code>.zip</code> da versão mais recente.</p>
<p>Então, no <strong>Painel Administrativo</strong> do WordPress, vá em <code>Plugins > Adicionar novo</code> e clique em <code>Upload plugin</code> no topo da página para enviar o arquivo <code>.zip</code>.</p>
<blockquote>
<p>Você precisará, posteriormente, ir até a pasta do plugin no terminal do seu servidor Web e executar o comando <code>composer install</code> caso escolha essa opção.</p>
</blockquote>
<h4>Da origem</h4>
<p>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:</p>
<pre><code>git clone https://github.com/piggly-dev/wc-piggly-pix.git
</code></pre>
<blockquote>
<p>Você precisará, posteriormente, executar o comando <code>composer install</code> caso escolha essa opção.</p>
</blockquote>
<h3>Como utilizar?</h3>
<p>Após a instalação do plugin, vá até <code>Plugins > Plugins instalados</code>, ative o plugin <strong>Pix por Piggly para Woocommerce</strong>. Assim que você ativar, o plugin já estará disponível em <code>Woocommerce > Configurações > Pagamentos</code> e você poderá inserir todas as configurações pertinentes.</p>
<p><strong>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.</strong></p>


Pix por Piggly (para Woocommerce)

Funciona perfeitamente. Obrigado pelo plugin.

Pix por Piggly (para Woocommerce) vs PagBank / PagSeguro Connect para WooCommerce