Files
App-Estoque-LiberiKids/TESTAR-PIX-COMPLETO.md
2025-10-14 14:04:17 -03:00

5.8 KiB

🧪 Como Testar PIX - Guia Completo

📋 Pré-requisitos para Teste

Antes de testar, certifique-se que:

  • Deploy foi feito para o servidor
  • SQL foi aplicado no Supabase
  • Credenciais Mercado Pago configuradas no .env
  • Servidor reiniciado com PM2

🔧 1. Verificar Configuração no Servidor

Conectar no servidor:

ssh tiago@192.168.195.145
cd ~/app_estoque

Verificar se .env está configurado:

cat .env | grep MERCADOPAGO

Deve mostrar algo como:

MERCADOPAGO_ACCESS_TOKEN=TEST-1234567890-abcdef...
MERCADOPAGO_PUBLIC_KEY=pk_test_1234567890abcdef...
BASE_URL=http://192.168.195.145:5000

Verificar se servidor está rodando:

pm2 status
pm2 logs liberi-kids --lines 20

🗄️ 2. Verificar Banco de Dados

No painel do Supabase:

  1. Acesse: https://supabase.com/dashboard
  2. Vá em SQL Editor
  3. Execute para verificar se colunas foram criadas:
SELECT column_name, data_type, column_default 
FROM information_schema.columns 
WHERE table_name = 'vendas' 
AND column_name IN ('status_pagamento', 'data_pagamento', 'pix_payment_id', 'pix_qr_code', 'metodo_pagamento')
ORDER BY column_name;

Deve retornar 5 linhas com as colunas PIX.


🌐 3. Teste da Interface Web

Acesse o sistema:

http://192.168.195.145:5000

Navegue para Vendas:

  1. Menu lateralVendas
  2. Procure uma venda na lista
  3. Verifique se aparece o botão PIX (ícone 💳)

💳 4. Teste do Modal PIX

Clique no botão PIX de uma venda:

O que deve acontecer:

  • Modal PIX abre instantaneamente
  • Título: "Pagamento PIX - Venda #123"
  • QR Code aparece (imagem quadrada)
  • Código PIX aparece (texto longo para copiar)
  • Timer mostra 30:00 (30 minutos)
  • Status: "Aguardando pagamento..."

Se der erro, verifique:

  • Console do navegador (F12)
  • Logs do servidor: pm2 logs liberi-kids
  • Se credenciais estão corretas no .env

🔍 5. Teste das APIs Diretamente

No servidor, teste as APIs:

# Teste 1: Gerar PIX para venda ID 1
curl -X POST http://localhost:5000/api/pix/gerar \
  -H "Content-Type: application/json" \
  -d '{"vendaId": 1}'

# Deve retornar: payment_id, qr_code, qr_code_base64
# Teste 2: Consultar status (use o payment_id do teste anterior)
curl http://localhost:5000/api/pix/status/SEU_PAYMENT_ID

# Deve retornar: status, payment_id, etc.

📱 6. Teste de Pagamento Real (Sandbox)

Com credenciais TEST do Mercado Pago:

  1. Gere um PIX no sistema
  2. Use o app de teste do Mercado Pago
  3. Escaneie o QR Code ou copie o código PIX
  4. Simule o pagamento no ambiente de teste

Cartões de teste Mercado Pago:

Cartão aprovado: 4111 1111 1111 1111
CVV: 123
Vencimento: 12/25
Nome: APRO
CPF: 12345678909

🔄 7. Teste do Webhook (Confirmação Automática)

Configurar webhook no Mercado Pago:

  1. Acesse: https://www.mercadopago.com.br/developers
  2. Sua aplicaçãoWebhooks
  3. URL: http://192.168.195.145:5000/api/pix/webhook
  4. Eventos: payment

Teste a confirmação:

  1. Faça um pagamento de teste
  2. Aguarde alguns segundos
  3. Verifique se status mudou para "Pago" no sistema

📊 8. Verificar Logs e Monitoramento

Logs do servidor:

# Ver logs em tempo real:
pm2 logs liberi-kids --lines 50

# Ver apenas erros:
pm2 logs liberi-kids --err

# Ver logs específicos do PIX:
pm2 logs liberi-kids | grep -i pix

Console do navegador:

  • F12Console
  • Procure por erros em vermelho
  • Verifique chamadas de API na aba Network

Checklist de Teste Completo

Configuração:

  • Credenciais Mercado Pago no .env
  • SQL aplicado no Supabase
  • Servidor rodando (pm2 status)
  • Build do frontend atualizado

Interface:

  • Botão PIX aparece nas vendas
  • Modal PIX abre sem erro
  • QR Code é exibido
  • Código PIX aparece para copiar
  • Timer funciona (30 minutos)

APIs:

  • POST /api/pix/gerar retorna payment_id
  • GET /api/pix/status retorna dados corretos
  • Webhook recebe confirmações

Pagamento:

  • QR Code pode ser escaneado
  • Código PIX pode ser colado no banco
  • Status atualiza automaticamente
  • Venda fica marcada como "Paga"

🚨 Problemas Comuns e Soluções

Erro: "Access token inválido"

# Verifique se token está correto:
cat .env | grep MERCADOPAGO_ACCESS_TOKEN
# Deve começar com TEST- ou APP-

Erro: "QR Code não aparece"

# Verifique logs:
pm2 logs liberi-kids | grep -i error
# Reinstale dependência:
npm install mercadopago

Erro: "Webhook não funciona"

  • Verifique se URL está correta no Mercado Pago
  • Teste se servidor está acessível externamente
  • Configure firewall se necessário

Erro: "Modal não abre"

  • Verifique console do navegador (F12)
  • Limpe cache do navegador (Ctrl+F5)
  • Verifique se build foi feito corretamente

🎯 Teste Rápido (2 minutos)

# 1. Conectar no servidor
ssh tiago@192.168.195.145

# 2. Verificar status
cd ~/app_estoque && pm2 status

# 3. Testar API
curl -X POST http://localhost:5000/api/pix/gerar -H "Content-Type: application/json" -d '{"vendaId": 1}'

# 4. Acessar sistema
# http://192.168.195.145:5000 → Vendas → Botão PIX

Se tudo funcionar, seu PIX está 100% operacional! 🎉


📞 Suporte

Se encontrar problemas:

  1. Verifique os logs primeiro
  2. Teste as APIs diretamente
  3. Confirme as credenciais do Mercado Pago
  4. Reinicie o servidor se necessário

Seu sistema PIX está pronto para processar pagamentos reais! 💳🏦