Intra Pay Pix para WooCommerce

Plugin de pagamento Pix via Intra Pay para WooCommerce.
Receba pagamentos instantâneos com QR Code estático, dinâmico imediato e dinâmico com vencimento.

Recursos • Requisitos • Instalação • Configuração • Uso • Webhook • FAQ

---

🚀 Recursos

• ✅ 3 tipos de cobrança Pix
  • QR Code Estático
  • QR Code Dinâmico Imediato (expira em 60 min)
  • QR Code Dinâmico com Vencimento
• ✅ QR Code gerado automaticamente na tela de pagamento
• ✅ Botão "Copiar código Pix" (copia e cola)
• ✅ Webhook para atualização automática do status do pedido
• ✅ Verificação automática a cada 5 minutos via WP-Cron
• ✅ Verificação manual no admin do pedido
• ✅ Busca automática de chaves PIX cadastradas na conta
• ✅ Desconto, juros e multa para cobranças com vencimento
• ✅ Compatível com HPOS (High-Performance Order Storage)
• ✅ Logs detalhados para debug

---

📋 Requisitos

Requisito	Versão Mínima
WordPress	6.0+
WooCommerce	8.0+
PHP	8.0+
Conta Intra Pay	Criar conta

---

📥 Instalação

Método 1: Upload pelo WordPress (Recomendado)

1. Baixe o arquivo intrapay-pix-woocommerce.zip da página de releases
2. No WordPress, vá em Plugins → Adicionar novo
3. Clique em Fazer upload do plugin
4. Selecione o arquivo ZIP e clique em Instalar agora
5. Clique em Ativar

Método 2: Via FTP/SFTP

1. Baixe e extraia o arquivo intrapay-pix-woocommerce.zip
2. Faça upload da pasta intrapay-pix-woocommerce para /wp-content/plugins/
3. No WordPress, vá em Plugins e ative o Intra Pay Pix para WooCommerce

Método 3: Via Composer (para desenvolvedores)

composer require intrapay/intrapay-pix-woocommerce

---

⚙️ Configuração

Passo 1: Acessar Configurações

1. No WordPress, vá em WooCommerce → Configurações
2. Clique na aba Pagamentos
3. Encontre Pix via Intra Pay e clique em Gerenciar

Passo 2: Configurar Credenciais

Campo	Descrição
Ativar/Desativar	Marque para ativar o método de pagamento
Título	Nome exibido no checkout (ex: "Pix")
Descrição	Texto exibido ao cliente
Ambiente	Sandbox para testes ou Produção para uso real
Base URL	URL da API (padrão: https://api.intrapay.io)
Client Key	Sua chave de cliente (obtida no painel Intra Pay)
Client Secret	Seu segredo de cliente (obtido no painel Intra Pay)

Passo 3: Selecionar Chave PIX

1. Após preencher as credenciais, clique em Salvar alterações
2. Clique no botão Buscar Chaves Disponíveis
3. Selecione a chave PIX desejada no dropdown
4. Clique em Usar Esta Chave
5. Clique em Salvar alterações novamente

Passo 4: Configurar Tipo de Cobrança

Tipo	Descrição
QR Code Estático	QR fixo, sem expiração definida
QR Code Dinâmico Imediato	Expira em 60 minutos
QR Code Dinâmico com Vencimento	Com data de vencimento, permite desconto/juros/multa

Passo 5: Configurar Webhook

1. Copie a URL do Webhook exibida nas configurações:

   https://seusite.com/wp-json/intrapay/v1/webhook
   

2. Acesse o painel da Intra Pay
3. Cadastre a URL do webhook nas configurações da sua conta
4. (Opcional) Configure um Webhook Secret para maior segurança

---

🛒 Uso

Fluxo do Cliente

1. Cliente adiciona produtos ao carrinho
2. No checkout, seleciona Pix via Intra Pay
3. Finaliza o pedido
4. Visualiza o QR Code e o código Pix (copia e cola)
5. Realiza o pagamento no app do banco
6. Pedido é atualizado automaticamente para Processando

Fluxo do Admin

1. Pedido é criado com status Aguardando
2. Quando o pagamento é confirmado via webhook, status muda para Processando
3. Você pode verificar manualmente clicando em Verificar Status no pedido

---

🔗 Webhook

Status Mapeados

Status Intra Pay	Status WooCommerce
CONFIRMED	Processando (ou Concluído)
PAID	Processando (ou Concluído)
EXPIRED	Cancelado

Verificação Automática

O plugin verifica automaticamente pedidos pendentes a cada 5 minutos via WP-Cron, garantindo que nenhum pagamento seja perdido caso o webhook falhe.

---

💰 Cobrança com Vencimento

Para cobranças com vencimento, você pode configurar:

Opção	Descrição
Dias para vencimento	Quantos dias até o vencimento
Desconto antecipado	Percentual de desconto para pagamento antecipado
Juros por atraso	Percentual de juros ao mês
Multa por atraso	Percentual de multa

---

❓ FAQ

O plugin funciona com qual moeda?

Apenas BRL (Real Brasileiro).

Preciso ter conta na Intra Pay?

Sim, você precisa criar uma conta em intrapay.io para obter as credenciais.

O webhook não está funcionando. O que fazer?

1. Verifique se a URL está cadastrada corretamente no painel Intra Pay
2. Verifique se seu servidor aceita requisições POST externas
3. Verifique os logs em wp-content/uploads/wc-logs/intrapay-pix-*
4. Use a verificação manual no admin do pedido como fallback

Como testar em ambiente de desenvolvimento?

1. Configure o Ambiente como Sandbox
2. Use as credenciais de teste fornecidas pela Intra Pay
3. Faça pedidos de teste

O QR Code não aparece. O que fazer?

1. Verifique se JavaScript está habilitado no navegador
2. Verifique o console do navegador (F12) para erros
3. Confirme que a API retornou o payload do QR Code

Erro "IP não liberado". O que fazer?

Acesse o painel da Intra Pay e adicione o IP do seu servidor na lista de IPs permitidos.

---

🔧 Hooks e Filtros

Alterar endpoints da API

// Endpoint de chaves PIX
add_filter('intrapay_pix_endpoint_keys', function($path) {
    return '/api/financial/v1/pix-keys';
});

// Endpoint de cobrança estática
add_filter('intrapay_pix_endpoint_static', function($path) {
    return '/api/financial/v1/pix-cash-in/static';
});

// Endpoint de cobrança dinâmica
add_filter('intrapay_pix_endpoint_immediate', function($path) {
    return '/api/financial/v1/pix-cash-in/dynamic';
});

// Endpoint de consulta de status
add_filter('intrapay_pix_endpoint_status', function($path) {
    return '/api/financial/v1/pix-cash-in/status/' . $txid;
});

---

📁 Estrutura do Plugin

intrapay-pix-woocommerce/
├── intrapay-pix-woocommerce.php   # Arquivo principal
├── uninstall.php                   # Limpeza ao desinstalar
├── README.md                       # Documentação
├── assets/
│   ├── css/
│   │   └── frontend.css            # Estilos do checkout
│   └── js/
│       └── frontend.js             # QR Code e polling
├── includes/
│   ├── class-intrapay-pix-api-client.php      # Cliente da API
│   ├── class-intrapay-pix-gateway.php         # Gateway WooCommerce
│   ├── class-intrapay-pix-logger.php          # Sistema de logs
│   ├── class-intrapay-pix-settings.php        # Configurações
│   └── class-intrapay-pix-webhook-handler.php # Handler do webhook
└── languages/
    └── intrapay-pix-woocommerce.pot            # Traduções

---

📝 Changelog

1.0.0 (2024)

• 🎉 Versão inicial
• ✅ Suporte a QR Code estático, dinâmico imediato e com vencimento
• ✅ Webhook para atualização automática
• ✅ Verificação manual e automática de status
• ✅ Busca automática de chaves PIX
• ✅ Desconto, juros e multa para cobranças com vencimento
• ✅ Compatibilidade com HPOS

---

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Faça um fork do repositório
2. Crie uma branch para sua feature (git checkout -b feature/nova-feature)
3. Commit suas mudanças (git commit -m 'Adiciona nova feature')
4. Push para a branch (git push origin feature/nova-feature)
5. Abra um Pull Request

---

📄 Licença

Este projeto está licenciado sob a GPL v2 ou posterior.

---

📞 Suporte

• Documentação Intra Pay: docs.intrapay.io
• Suporte Intra Pay: intrapay.io/contato
• Issues: GitHub Issues

---

Desenvolvido com ❤️ para a comunidade WooCommerce