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.

Muito bom!

linknacional

<p>Integrate <strong>Pix</strong>, Brazil’s revolutionary instant payment system, into your <a href="https://www.linknacional.com.br/wordpress/woocommerce/" rel="nofollow ugc">WooCommerce</a> store with our powerful and flexible gateway plugin.</p>
<p>Offer your customers a fast, secure, and modern checkout experience. This plugin allows you to receive Pix payments through three different methods, giving you the flexibility to choose what works best for your business.</p>
<h3>Features</h3>
<ul>
<li>
<p><strong>Three Integration Modes:</strong> Choose the best way to receive Pix payments.</p>
<ul>
<li><strong>Direct Pix Key:</strong> The simplest setup. Just enter your registered Pix key (CPF/CNPJ, E-mail, Phone, Randon Code) and you’re ready to sell. The plugin generates a “copy and paste” code and a QR Code for your customers.</li>
<li><strong>PagHiper Gateway:</strong> Automate your sales with <a href="https://www.paghiper.com" rel="nofollow ugc">PagHiper</a>. This integration provides a robust gateway to generate charges and automatically confirm payments, giving you and your customers more security and convenience.</li>
<li><strong>C6 Bank Integration:</strong> Perfect for C6 Bank clients. Connect your account directly for seamless Pix charge generation and real-time automatic payment confirmation.</li>
</ul>
</li>
<li>
<p><strong>Automatic QR Code Generation:</strong> A dynamic QR Code is generated for every order.</p>
</li>
<li><strong>“Pix Copia e Cola” Button:</strong> A one-click button for customers on desktop to easily copy the payment code.</li>
<li><strong>Automatic Order Confirmation:</strong> Integrations with PagHiper and C6 Bank handle payment confirmation automatically, updating the order status in WooCommerce.</li>
<li><strong>Easy to Configure:</strong> A clean and intuitive settings panel to get you started in minutes.</li>
</ul>
<p>Start selling with Pix today and boost your conversions in the Brazilian market!</p>
<h3>Recommended Integrations</h3>
<p>Please note that this plugin provides a direct integration for Pix Key, PagHiper, and C6 Bank. If you need to process Pix payments through other major Brazilian gateways, we recommend the following official plugins:</p>
<ul>
<li><strong>Cielo:</strong> To accept Pix payments through the Cielo gateway, we recommend using the <a href="https://br.wordpress.org/plugins/lkn-wc-gateway-cielo/" rel="nofollow ugc">Cielo para WooCommerce</a> plugin.</li>
<li><strong>eRede (Itaú):</strong> For processing Pix payments with the eRede (Itaú) gateway, we recommend the <a href="https://wordpress.org/plugins/woo-rede/" rel="ugc">Rede para WooCommerce</a> plugin.</li>
</ul>
<h3>Minimum Requirements</h3>
<p>For this plugin to work correctly, you will need:</p>
<ul>
<li>WordPress version 5.0 or later.</li>
<li>WooCommerce version 5.0 or later.</li>
<li>PHP version 7.4 or later.</li>
<li>An active SSL Certificate is highly recommended for secure transactions.</li>
</ul>
<h3>Usage</h3>
<p>Configuring the plugin is straightforward. Follow these steps to set up your desired Pix payment method.</p>
<h4>Activating the Payment Method</h4>
<ol>
<li>In your WordPress admin area, go to <strong>WooCommerce > Settings</strong>.</li>
<li>Click on the <strong>Payments</strong> tab.</li>
<li>You will see a list of all available payment gateways. Locate the one you want to configure:
<ul>
<li><strong>Pix Key</strong></li>
<li><strong>Pix with PagHiper</strong></li>
<li><strong>Pix C6</strong></li>
</ul>
</li>
<li>Enable your chosen method by using the toggle switch.</li>
<li>Click the <strong>Manage</strong> button to enter its specific settings.</li>
</ol>
<h4>Configuration Details</h4>
<p>After clicking <strong>Manage</strong>, you will need to fill in the required information for your chosen method:</p>
<ul>
<li>
<p><strong>For Pix Key:</strong></p>
<ol>
<li>Enter a <strong>Title</strong> and <strong>Description</strong> that will be shown to your customer at checkout.</li>
<li>Add your registered <strong>Pix Key</strong> (e.g., your e-mail, phone number, or CNPJ).</li>
<li>Click <strong>Save changes</strong>.</li>
</ol>
</li>
<li>
<p><strong>For Pix with PagHiper:</strong></p>
<ol>
<li>Enter the <strong>Title</strong> and <strong>Description</strong>.</li>
<li>Input your PagHiper <strong>API Key</strong> and <strong>Token</strong> (found in your PagHiper dashboard).</li>
<li>Configure any other available settings to your preference.</li>
<li>Click <strong>Save changes</strong>.</li>
</ol>
</li>
<li>
<p><strong>For Pix C6:</strong></p>
<ol>
<li>Enter the <strong>Title</strong> and <strong>Description</strong>.</li>
<li>Input your C6 Bank API credentials: <strong>Client ID</strong> and <strong>Client Secret</strong>.</li>
<li>Adjust additional settings as needed.</li>
<li>Click <strong>Save changes</strong>.</li>
</ol>
</li>
</ul>
<p>Your configured Pix method will now be available for customers at checkout.</p>
<h3>Enjoying the Plugin?</h3>
<p>If you find the <strong>Pix Payment Gateway for WooCommerce</strong> plugin useful, please consider leaving a 5-star review on WordPress.org.</p>
<p>Your feedback is invaluable to us. It not only helps other store owners discover the plugin but also motivates us to continue developing and improving it. A positive review is the best way to show your support for our work.</p>
<p><a href="https://wordpress.org/support/plugin/payment-gateway-pix-for-woocommerce/reviews/#new-post" rel="ugc"><strong>Leave your review here!</strong></a></p>
<p>Thank you for being a part of our community!</p>
<h3>Support</h3>
<p>If you need help or have questions, please post them in the <a href="https://wordpress.org/support/plugin/payment-gateway-pix-for-woocommerce/" rel="ugc">support forum</a> for the plugin on WordPress.org. We will be happy to assist you there.</p>


Pix for WooCommerce

Easily accept Pix payments in your WooCommerce store via Pix Key, PagHiper, or C6 Bank. The complete Pix solution for Brazil.

Pix por Piggly (para Woocommerce) vs Pix for WooCommerce