=== Pagou - Payments for WooCommerce ===
Contributors: pagoupagamentos, alissonic
Donate link: https://pagou.com.br/
Tags: woocommerce, pagou, pagamentos, pix, boleto
Requires at least: 6.6
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Accept PIX and Brazilian bank slips (boleto) in WooCommerce through the Pagou payment gateway.

== Supported Languages ==
* English (en_US)
* Portuguese (Brazil) (pt_BR)

== Description ==

Pagou for WooCommerce connects your store to the Pagou payment gateway, so you can accept the two most used payment methods in Brazil: PIX (instant bank transfer) and boleto bancário (bank slip).

**Main features**

* PIX payments with automatic confirmation: the customer pays and the order is updated on its own, with no need to send a receipt.
* Boleto bancário with barcode, digitable line and PDF, including optional late fee and interest.
* Discount per payment method: offer, for example, 5% off for customers who pay with PIX (percentage or fixed amount). This is configured by the store owner and applied to the amount actually charged.
* Payment screen with the amount in focus, expiration countdown, one-click copy button and step-by-step instructions.
* PIX code and boleto digitable line included in the order emails, so the customer never loses the code.
* Automatic reconciliation every 15 minutes: if a payment notification fails to reach the store, the plugin queries Pagou and confirms the order anyway.
* Signed webhooks (HMAC-SHA256) with replay protection, amount verification and idempotency.
* Compatible with the classic checkout, the Cart and Checkout Blocks and HPOS (High-Performance Order Storage).

**Requirements**

A Pagou account and API key, plus the WooCommerce and Brazilian Market on WooCommerce plugins.

**Em português**

O plugin integra o WooCommerce ao gateway de pagamento Pagou, permitindo receber por PIX e Boleto Bancário, com confirmação automática do pagamento, desconto configurável por meio de pagamento e conciliação automática. Precisa de uma conta Pagou, do WooCommerce e do plugin Brazilian Market on WooCommerce.

== External services ==

Este plugin utiliza os seguintes serviços externos:

1. **Pagou API**
   - **Uso:** Processamento de pagamentos via PIX e boleto usando ambiente de homologação e produção.
   - **Dados Enviados:** Informações de transações financeiras, incluindo valores, produtos e dados do cliente.
   - **Quando:** Durante a criação, consulta e reembolso de pagamentos.
   - **Termos de Uso:** [Link para os termos de uso da Pagou](https://pagou.com.br/termos).
   - **Política de Privacidade:** [Link para a política de privacidade da Pagou](https://pagou.com.br/privacidade).
   - **Dados enviados para:** [Homolog](https://sandbox-api.pagou.com.br) ou [produção](https://api.pagou.com.br) da Pagou.

2. **ViaCEP**
   - **Uso:** Busca de endereço a partir do CEP informado.
   - **Dados Enviados:** CEP digitado pelo usuário.
   - **Quando:** No momento do preenchimento do endereço no checkout.
   - **Termos de Uso:** [Termos de Uso do ViaCEP](https://viacep.com.br/sobre/).

== Política de Privacidade e Termos de Uso ==
- [Termos de Uso do Pagou](https://pagou.com.br/termos)
- [Política de Privacidade do Pagou](https://pagou.com.br/privacidade)

== Installation ==
1. Faça o upload do plugin para o diretório `/wp-content/plugins/`.
2. Ative o plugin através do menu "Plugins" no WordPress.
3. Acesse as configurações de WooCommerce para configurar os métodos de pagamento Pagou (PIX e Boleto).

== Frequently Asked Questions (FAQ) ==
= Como configuro os pagamentos via PIX e Boleto? 
Após ativar o plugin, vá até as configurações de pagamento do WooCommerce e habilite as opções de pagamento "Pagou" para PIX e Boleto.

= Quais são os requisitos mínimos para usar o plugin? =
Você precisa de pelo menos o WordPress 6.6 e PHP 7.4 para rodar o plugin.

= Como ofereço desconto para quem pagar com PIX? =
Vá em WooCommerce > Configurações > Pagamentos > PIX e preencha o "Valor do desconto" (por exemplo, 5) escolhendo o tipo "Percentual (%)" ou "Valor fixo (R$)". O desconto incide sobre o subtotal dos produtos, aparece no checkout ao lado do nome do meio de pagamento e já é aplicado no valor cobrado. O mesmo vale para o Boleto.

= E se a notificação de pagamento não chegar na minha loja? =
O plugin consulta a Pagou automaticamente a cada 15 minutos e confirma os pedidos que já foram pagos, mesmo que a notificação tenha se perdido.

== Changelog ==
= 1.3.1 =
* Correção: pagamentos deixavam de ser gerados em lojas cujo checkout não preenche o campo "tipo de pessoa", com a mensagem "Falha ao validar os dados enviados: Nome Completo e Documento (CPF/CNPJ)". O documento do cliente agora é localizado em qualquer checkout e o tipo de pessoa é identificado pelo próprio CPF ou CNPJ.
* Correção: descontos em percentual terminados em zero apareciam errados no checkout (10% era exibido como 1%, 20% como 2%). O valor cobrado sempre esteve correto; o problema era apenas na exibição.
* Melhoria: se o CPF ou CNPJ estiver ausente ou inválido, o cliente recebe uma mensagem clara em vez do erro genérico devolvido pela API.

= 1.3.0 =
* Novo: desconto por meio de pagamento. Configure, por exemplo, 5% de desconto no PIX (percentual ou valor fixo) e aumente a conversão do checkout.
* Novo: o desconto aparece junto ao nome do meio de pagamento no checkout, como "PIX (5% de desconto)".
* Novo: ícones do PIX e do boleto na lista de meios de pagamento, no checkout clássico e no checkout em blocos.
* Melhoria: os meios de pagamento passam a se chamar "Pix Instantâneo" e "Boleto Bancário" por padrão, com textos de checkout mais claros. Nome e descrição continuam totalmente editáveis nas configurações de cada meio de pagamento; lojas que já personalizaram esses campos não são afetadas.
* Novo: conciliação automática a cada 15 minutos, que confirma pagamentos caso alguma notificação (webhook) não chegue à loja.
* Novo: registro de log das chamadas à API e dos webhooks em WooCommerce > Status > Logs, ativado pelo "Modo Debug".
* Novo: tela de pagamento redesenhada. O pagamento aparece antes dos detalhes do pedido, com valor em destaque, contagem de expiração do código, botão de copiar com confirmação e passo a passo.
* Novo: a tela identifica o pagamento sozinha e se atualiza, sem o cliente precisar recarregar nem enviar comprovante.
* Novo: o código Pix e a linha digitável do boleto passam a ir nos e-mails do pedido, com link para a tela de pagamento.
* Novo: boletos da Pagou aceitam Pix, e a tela agora oferece essa opção para quem quiser confirmação imediata.
* Melhoria: boleto pago em atraso, com multa e juros, passa a ser confirmado normalmente, registrando o valor efetivamente pago.
* Melhoria: textos do checkout deixam claro que falta pagar, em vez de sugerir que o pedido já está concluído.
* Correção: o endereço no checkout em blocos não exibe mais marcadores como {number} e {neighborhood} quando o plugin Brazilian Market on WooCommerce está ativo. Nos e-mails e no painel o endereço continua completo, com número e bairro.
* Correção: o QR Code do Pix mantém o tamanho correto mesmo se a folha de estilo do plugin não carregar (cache do navegador, plugins de otimização).
* Melhoria: a tela de pagamento ganhou estilos de impressão, com o código completo e sem os elementos que não fazem sentido no papel.

= 1.2.0 =
* Segurança: validação da assinatura HMAC (X-Pagou-Signature) em todos os webhooks, com proteção contra repetição (replay).
* Segurança: a chave de API deixou de ser gravada nos metadados do pedido.
* Correção: confirmação de pagamento passa a localizar o pedido de forma confiável (por id da cobrança/QRCode), corrigindo pedidos que ficavam presos em "aguardando".
* Correção: conferência do valor pago antes de concluir o pedido.
* Correção: estorno via PIX não é mais disparado com valor incorreto; estorno via boleto passa a detectar erros da API corretamente.
* Correção: geração de boleto no checkout em blocos (Cart/Checkout Blocks), incluindo endereço do pagador.
* Correção: tipo de pessoa (Física/Jurídica) e documento no checkout em blocos.
* Correção: carregamento das traduções e do hook de ativação.
* Compatibilidade declarada com HPOS (High-Performance Order Storage) e com o checkout em blocos.
* Ajustes de tempo de expiração padrão do PIX e diversas correções menores.

= 1.1.2 =
* Ajustes nos logs de erros.

= 1.1.1 =
* Ajustes na geração dos boletos.

= 1.1.0 =
* Configuração manual de tempo de expiração do PIX.

= 1.0.6 =
* Remoção de bibliotecas sem uso.

= 1.0.5 =
* Atualizações de compatibilidades.

= 1.0.4 =
* Atualizações de bibliotecas.
 
= 1.0.3 =
* Ajustes de compatibilidade com checkout legacy, blocks e Elementor.

= 1.0.21 =
* Atualizações com Wordpress.

= 1.0.2 =
* Atualização de bibliotecas e configurações de segurança.

= 1.0.1 =
* Corrigido o domínio de tradução para corresponder ao slug do plugin.
* Adicionada a documentação do uso de serviços externos no arquivo readme.
* Adicionada verificação de `ABSPATH` para evitar acesso direto aos arquivos PHP.

= 1.0.0 =
* Versão inicial do plugin, integração com métodos de pagamento PIX e Boleto via Pagou.

== Upgrade Notice ==
= 1.3.1 =
Corrige falha na geração de pagamentos em checkouts personalizados e a exibição de descontos como 10% e 20%. Atualização recomendada.

= 1.2.0 =
Atualização de segurança importante e correção da confirmação automática de pagamentos. Recomendada para todas as lojas.

= 1.1.2 =
Novos recursos e verificações de erros.

== License ==
Este plugin está licenciado sob a GPLv2 ou posterior.
