InfinitePay para WooCommerce

Plugin WordPress que adiciona um gateway de pagamento ao WooCommerce usando o Checkout Integrado InfinitePay. Sua loja gera o pedido; o cliente paga com PIX ou cartão no checkout hospedado da InfinitePay; o WooCommerce recebe a confirmação automaticamente.

Recursos

• Redirect para checkout InfinitePay (modelo oficial da API)
• Confirmação de pagamento via webhook + validação payment_check
• Fallback na página de pedido recebido (thank you)
• Compatível com WooCommerce Blocks e checkout clássico
• Compatível com HPOS (High-Performance Order Storage)
• Pré-preenchimento de dados do comprador e endereço
• URLs de webhook e redirect exibidas no painel
• Log de depuração integrado ao WooCommerce (source: infinitepay)

Requisitos

Testado até WooCommerce 9.0.

Você também precisa de uma conta InfinitePay e da sua InfiniteTag (handle), configurada no app InfinitePay.

Instalação

1. Baixe o ZIP da última release — Clique aqui (versão publicada automaticamente a partir do campo Version em infinitepay.php a cada push na main).
2. No WordPress, acesse Plugins → Adicionar novo → Enviar plugin.
3. Selecione o arquivo .zip baixado e clique em Instalar agora.
4. Após a instalação, clique em Ativar plugin.
5. Confirme que o WooCommerce está instalado e ativo antes de configurar o pagamento.

Atualizações

A partir da 1.0.1, o plugin consulta as releases do GitHub e exibe o botão Atualizar no painel do WordPress quando houver versão nova.

Para publicar uma atualização:

1. Suba o número em Version / INFINITEPAY_VERSION (infinitepay.php) e em Stable tag (readme.txt).
2. Descreva a mudança no Changelog do readme.txt.
3. Faça push na main — a Action cria a release vX.Y.Z com o ZIP.

Lojas que ainda estão na 1.0.0 (sem o checker) precisam instalar o ZIP 1.0.1 uma vez; depois disso as próximas versões atualizam pelo painel.

Configuração

Acesse WooCommerce → Ajustes → Pagamentos → InfinitePay.

Checklist pós-instalação

1. Ativar o gateway e salvar o handle correto.
2. Fazer um pedido de teste com valor baixo.
3. Confirmar que o pedido fica pending e redireciona para a InfinitePay.
4. Após pagar, verificar se o pedido vai para processing ou completed.
5. Em ambiente local, use túnel (ngrok, Local Connect, etc.) se precisar testar o webhook.

Como funciona

sequenceDiagram
    participant Cliente
    participant WooCommerce
    participant Plugin
    participant API as InfinitePay_API
    participant Checkout as Checkout_InfinitePay

    Cliente->>WooCommerce: Finalizar pedido
    WooCommerce->>Plugin: process_payment
    Plugin->>API: POST /links
    API-->>Plugin: link de pagamento
    Plugin-->>Cliente: Redirect
    Cliente->>Checkout: Paga PIX ou cartão
    Checkout->>Plugin: Webhook
    Plugin->>API: POST /payment_check
    API-->>Plugin: paid true
    Plugin->>WooCommerce: payment_complete
    Checkout-->>Cliente: Retorno à loja

1. O pedido WooCommerce é criado como aguardando pagamento.
2. O plugin chama https://api.checkout.infinitepay.io/links com handle, itens (centavos), order_nsu, webhook e redirect.
3. O cliente paga no ambiente InfinitePay.
4. O webhook dispara; o plugin confirma com payment_check antes de marcar o pedido como pago.

Estrutura do projeto

infinitepay/
├── infinitepay.php              # Bootstrap do plugin
├── readme.txt                   # Formato WordPress.org
├── AGENTS.md                    # Guia técnico para desenvolvimento
├── includes/
│   ├── class-infinitepay-gateway.php
│   ├── class-infinitepay-api.php
│   ├── class-infinitepay-order.php
│   ├── class-infinitepay-webhook.php
│   └── class-infinitepay-blocks-support.php
├── assets/js/
│   └── infinitepay-blocks.js    # Checkout em blocos
└── languages/                   # Traduções (text domain: infinitepay)

Desenvolvimento

Documentação técnica, decisões de arquitetura e endpoints da API estão em AGENTS.md.

# Exemplo: clonar e ativar no ambiente local
cd wp-content/plugins/infinitepay

FAQ

O pagamento acontece dentro do meu site?
Não. O cliente é redirecionado para o checkout InfinitePay. Isso segue o Checkout Integrado documentado oficialmente.

Funciona com checkout em blocos?
Sim. O plugin registra integração com WooCommerce Blocks.

Preciso de API key?
No fluxo documentado do Checkout Integrado, a loja se identifica pelo handle (InfiniteTag). Não há secret no payload público usado por este plugin.

E se o webhook não chegar?
O retorno na página de pedido recebido (com parâmetros da InfinitePay) tenta confirmar o pagamento pelo mesmo fluxo de payment_check.

Links úteis

• Documentação InfinitePay — Checkout Integrado
• WooCommerce — Payment Gateway API

Licença

Este projeto está licenciado sob GPL-2.0-or-later.
Veja GNU GPL v2.

Autor

Léo Felipe
Contato: WhatsApp

Desenvolvido para integrar WooCommerce ao ecossistema InfinitePay de forma simples e alinhada à documentação oficial.