=== PagFin - Gateway de Pagamento ===
Contributors: chemitec
Tags: woocommerce, pagamentos, pix, boleto, criptomoedas, gateway
Requires at least: 5.8
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires Plugins: woocommerce

Aceite Pix, Bolecode, cartão de débito e criptomoedas na sua loja WooCommerce através do checkout hospedado do PagFin.

== Description ==

O plugin PagFin para WooCommerce adiciona um gateway de pagamento que redireciona o comprador,
no momento do checkout, para uma página de pagamento hospedada pelo PagFin (o mesmo modelo do
Stripe Checkout): o comprador escolhe Pix, Bolecode (quando disponível no plano), cartão de
débito ou criptomoedas (quando disponível no plano), paga, e volta automaticamente para a loja.
Nenhum dado de cartão trafega pelo servidor da loja.

A confirmação do pagamento é feita em tempo real via webhook (`invoice.paid` / `invoice.failed`)
e reforçada por uma checagem periódica (cron) que consulta o status do pedido diretamente na
API do PagFin, cobrindo o caso raro de o webhook não chegar.

**Principais recursos**

* Checkout hospedado (redirect) — sem PCI-DSS para a loja.
* Confirmação automática do pedido via webhook com verificação de assinatura HMAC-SHA256.
* Fallback de consulta periódica de status (cron a cada hora).
* Compatível com HPOS (High-Performance Order Storage) do WooCommerce.
* Ambiente sandbox para testes de ponta a ponta sem cobranças reais.
* Chave de idempotência por pedido, evitando cobrança duplicada em retentativas de rede.

== Installation ==

1. Envie a pasta `pagfin-woocommerce` para `wp-content/plugins/` (ou instale o `.zip` pelo
   admin do WordPress em Plugins > Adicionar novo > Enviar plugin).
2. Ative o plugin em Plugins.
3. Acesse WooCommerce > Configurações > Pagamentos > PagFin.
4. Gere uma chave de API e um segredo de webhook no painel PagFin, em `/t/integrations`
   (veja detalhes no README.md).
5. Preencha a chave de API, o segredo do webhook e escolha o ambiente (sandbox ou produção).
6. Copie a URL do webhook exibida na própria tela de configurações e cadastre-a no painel
   PagFin, marcando os eventos `invoice.paid` e `invoice.failed`.
7. Salve e faça um pedido de teste em ambiente sandbox.

== Frequently Asked Questions ==

= O plugin armazena dados de cartão de crédito? =

Não. O pagamento acontece inteiramente na página hospedada do PagFin; a loja nunca recebe nem
armazena dados de cartão.

= Como confirmo se o webhook está funcionando? =

Faça um pedido de teste com uma chave sandbox: toda cobrança sandbox é aprovada automaticamente
e o webhook `invoice.paid` é disparado assim que o pedido é criado. Verifique a nota adicionada
ao pedido no WooCommerce ("PagFin: pagamento confirmado via webhook...").

= O que acontece se o webhook não chegar? =

O plugin também consulta periodicamente (a cada hora, via WP-Cron) o status de pedidos
"aguardando pagamento" diretamente na API do PagFin, como reforço.

== Changelog ==

= 1.0.0 =
* Versão inicial: checkout hospedado, webhook com verificação HMAC, fallback de consulta de
  status, compatibilidade com HPOS.
