Atomti InfinitePay para WooCommerce

=== Atomti InfinitePay para WooCommerce === Contributors: atomti Tags: woocommerce, infinitepay, pix, cartao, checkout Requires at least: 6.0 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

Integração da InfinitePay (Checkout Integrado) com o WooCommerce. Aceite Pix (taxa zero) e Cartão de Crédito em até 12x.

== Description ==

Este plugin adiciona dois métodos de pagamento ao seu WooCommerce usando o Checkout Integrado da InfinitePay:

• Pix (InfinitePay) — taxa zero.
• Cartão de Crédito (InfinitePay) — parcelamento em até 12x.

O cliente é redirecionado para o ambiente hospedado da InfinitePay, finaliza o pagamento e retorna à sua loja com o pedido atualizado automaticamente via webhook. Nenhum dado sensível de cartão passa pelo seu servidor.

Recursos:

• Configuração 100% em português.
• Um único cadastro de InfiniteTag (handle) compartilhado entre Pix e Cartão.
• Verificação server-side do pagamento via POST /payment_check — nenhum pedido é liberado apenas com base em webhook ou params de URL.
• Suporte a HPOS (High-Performance Order Storage).
• Suporte a WooCommerce Blocks (novo checkout) e ao checkout clássico.
• Envio opcional de dados do cliente (nome, e-mail, telefone) e endereço para acelerar o checkout hospedado.
• Envio correto de itens, frete, taxas e descontos com sanity check de arredondamento.
• Logs detalhados em WooCommerce → Status → Logs (opcional).
• Idempotência no webhook — reprocessamento seguro.
• Actions Scheduler nativo (com fallback pra wp-cron): quando disponível — WooCommerce 3.5+ e obrigatório em WC 10/11 — o plugin usa o Actions Scheduler para reconciliar pagamentos a cada 5 minutos. Você acompanha as execuções em Ferramentas → Ações Agendadas (grupo woo-atomti-infinitepay).
• Compatível com WooCommerce 10/11 e HPOS obrigatório: nenhum uso de get_post_meta/update_post_meta; todas as queries usam wc_get_orders com meta_query; todas as URLs administrativas adaptam-se automaticamente ao modo HPOS.
• Metabox no pedido: exibe todos os identificadores da InfinitePay, link do comprovante e um formulário para verificar o pagamento manualmente informando transaction_nsu e slug (útil quando o webhook nunca chegou).
• Aviso admin caso os gateways estejam habilitados sem a InfiniteTag configurada.

== Instalação ==

1. Envie a pasta woo-atomti-infinitypay para wp-content/plugins/.
2. Ative o plugin em Plugins.
3. Acesse WooCommerce → Configurações → Pagamentos.
4. Habilite InfinitePay — Pix e/ou InfinitePay — Cartão de Crédito.
5. Informe sua InfiniteTag (o handle é compartilhado entre os dois gateways).
6. Salve.

== Como pegar minha InfiniteTag ==

A integração do Checkout Integrado da InfinitePay não usa API key nem client secret. O único dado que você precisa é a sua InfiniteTag (@handle), que é o seu nome de usuário no app.

Passo a passo:

1. Baixe o app InfinitePay — Android ou iOS e crie a conta (CNPJ ou CPF).
2. Encontre sua InfiniteTag — abra o menu do app (canto superior esquerdo). Logo abaixo do seu nome aparece a tag começando com $, por exemplo $minhaloja.
3. Ative o Checkout Integrado no app: Configurações → Checkout, aceite os termos e ligue a opção.
4. Configure aqui: cole a tag sem o cifrão (só minhaloja, não $minhaloja) no campo InfiniteTag (handle) nas configurações do gateway.
5. Salve. Pronto — a mesma tag serve para Pix e Cartão.

Onde meus pagamentos caem?

Todos os recebimentos aparecem na sua conta InfinitePay (dentro do app). Pix cai instantaneamente e com taxa zero. Cartão pode cair na hora ou em 1 dia útil, dependendo do plano contratado dentro do app.

Webhook / redirect: preciso configurar algo no painel da InfinitePay?

Não. O plugin já envia webhook_url e redirect_url em cada checkout criado. A InfinitePay os usa automaticamente.

Documentação oficial: https://www.infinitepay.io/checkout-documentacao

== Como funciona ==

1. Cliente escolhe Pix ou Cartão no checkout do WooCommerce.
2. O plugin envia POST https://api.checkout.infinitepay.io/links com os itens, o order_nsu gerado a partir do pedido e as URLs de retorno e webhook.
3. Cliente é redirecionado para o Checkout Integrado da InfinitePay.
4. Após o pagamento, a InfinitePay:
   • envia um webhook para https://sua-loja/wc-api/infinitepay_webhook
   • redireciona o cliente para https://sua-loja/wc-api/infinitepay_return
5. Em ambos os fluxos, o plugin chama POST https://api.checkout.infinitepay.io/payment_check para confirmar o pagamento real e só então marca o pedido como pago.

== Perguntas frequentes ==

= Preciso de uma API key? =

Não. O Checkout Integrado da InfinitePay usa apenas o handle (InfiniteTag) público. Nenhuma chave privada é necessária.

= Posso usar só Pix (ou só Cartão)? =

Sim. Habilite apenas o gateway desejado em WooCommerce → Pagamentos.

= O cliente pode escolher Pix e cair no cartão (ou vice-versa)? =

Sim. O Checkout Integrado da InfinitePay é um único checkout hospedado onde o cliente pode alternar entre Pix e Cartão. Manter os dois gateways ativados no WooCommerce é apenas uma questão de UX na finalização — o link gerado é o mesmo.

= Onde vejo o comprovante? =

Após a confirmação, o link do comprovante é gravado como metadado do pedido e visível na página do pedido no admin, no metabox "InfinitePay".

= E se o webhook nunca chegar? =

O plugin tem duas camadas de defesa: (1) quando o cliente é redirecionado de volta à sua loja, os parâmetros transaction_nsu e slug da URL são validados via API; (2) se mesmo assim algo falhar, o metabox do pedido no admin permite verificar manualmente informando os dois códigos, que você consegue no dashboard da InfinitePay.

= Preciso configurar cron do WordPress? =

Não obrigatoriamente. Em WooCommerce 3.5+ o plugin usa o Actions Scheduler que já vem embutido no WooCommerce — mais confiável que o wp-cron. Você pode ver os jobs em Ferramentas → Ações Agendadas, grupo woo-atomti-infinitepay. Se seu ambiente for muito antigo e não tiver Actions Scheduler, o plugin cai para wp-cron automaticamente; nesse caso considere apontar o wp-cron para o cron do sistema operacional.

= É compatível com WooCommerce 10 e 11 (HPOS obrigatório)? =

Sim. O plugin foi construído desde o início considerando HPOS (High-Performance Order Storage): declara custom_order_tables como compatível, não usa nenhuma função de post-meta em pedidos, roteia URLs administrativas conforme o modo ativo e registra o metabox tanto na tela wc-orders (HPOS) quanto no shop_order (legacy).

== Changelog ==

= 1.0.0 =

• Lançamento inicial: Pix, Cartão, webhook, retorno, blocks, HPOS.