App-Estoque-LiberiKids/MERCADOPAGO-PRODUCAO-GUIDE.md

🏦 Guia Completo: PIX Produção com Mercado Pago

📋 REQUISITOS OBRIGATÓRIOS

1. Conta Mercado Pago Empresarial

• ❌ NÃO use conta pessoal
• ✅ Conta empresarial com CNPJ
• ✅ Verificação de identidade completa
• ✅ Dados bancários confirmados

2. Documentação Necessária

• CNPJ da empresa
• Comprovante de endereço da empresa
• Documento do representante legal
• Conta bancária em nome da empresa

---

🚀 PASSO A PASSO COMPLETO

ETAPA 1: Criar Conta Empresarial

1. Acesse: https://www.mercadopago.com.br/developers
2. Clique em: "Criar conta"
3. Selecione: "Conta empresarial"
4. Preencha:
   • CNPJ da empresa
   • Razão social
   • Email empresarial
   • Telefone da empresa

ETAPA 2: Verificação de Identidade

1. Upload de documentos:

   • Cartão CNPJ
   • Comprovante de endereço (máx 3 meses)
   • RG/CNH do representante legal

2. Aguardar aprovação:

   • Processo: 1-3 dias úteis
   • Email de confirmação

ETAPA 3: Configurar Conta Bancária

1. No painel Mercado Pago:

   • Vá em "Conta" → "Dados bancários"
   • Adicione conta em nome da empresa
   • Confirme com micro depósitos

2. Ativar PIX:

   • Vá em "Conta" → "PIX"
   • Ative PIX para recebimentos
   • Configure chaves PIX

ETAPA 4: Criar Aplicação

1. No painel de desenvolvedores:

   • Clique em "Criar aplicação"
   • Nome: Liberi Kids - Sistema de Vendas
   • Produto: Checkout Pro + Pagamentos online

2. Configurar URLs:

   URL de sucesso: https://seudominio.com/sucesso
   URL de falha: https://seudominio.com/falha
   URL de webhook: https://seudominio.com/api/pix/webhook
   

3. Obter credenciais:

   • Vá em "Credenciais"
   • Copie Access Token e Public Key

---

🔑 TIPOS DE CREDENCIAIS

Desenvolvimento (Sandbox):

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

Produção (Vendas Reais):

MERCADOPAGO_ACCESS_TOKEN=APP-1234567890-abcdef...
MERCADOPAGO_PUBLIC_KEY=pk_live_1234567890abcdef...
BASE_URL=https://seudominio.com

---

⚙️ CONFIGURAÇÃO NO SISTEMA

Opção 1: Script Automático (Recomendado)

# Execute o script de configuração:
./configurar-producao-pix.sh

Opção 2: Manual

# Editar .env:
nano .env

# Configurar:
MERCADOPAGO_ACCESS_TOKEN=APP-sua_access_token_real
MERCADOPAGO_PUBLIC_KEY=pk_live_sua_public_key_real
BASE_URL=https://seudominio.com
NODE_ENV=production

# Ativar versão de produção:
sed -i "s|mercadopago-demo|mercadopago|g" server-supabase.js

# Reiniciar servidor:
pm2 restart liberi-kids

---

🌐 CONFIGURAR WEBHOOK

1. No Painel Mercado Pago:

• Acesse sua aplicação
• Vá em "Webhooks"
• Clique em "Configurar webhook"

2. Configurações:

URL: https://seudominio.com/api/pix/webhook
Eventos: payment
Versão: v1

3. Testar Webhook:

• Use a ferramenta de teste do Mercado Pago
• Verifique logs do servidor
• Confirme recebimento das notificações

---

🧪 TESTES OBRIGATÓRIOS

1. Teste de Valor Baixo:

# Gerar PIX de R$ 0,01:
curl -X POST https://seudominio.com/api/pix/gerar \
  -H "Content-Type: application/json" \
  -d '{"venda_id": "teste001", "valor": 0.01}'

2. Verificações:

• ✅ QR Code gerado corretamente
• ✅ Pagamento processado
• ✅ Webhook recebido
• ✅ Valor creditado na conta
• ✅ Status atualizado no sistema

---

💰 CUSTOS E TARIFAS

PIX:

• Taxa: 0,99% por transação
• Sem mensalidade
• Recebimento: D+1 (1 dia útil)
• Limite: Até R$ 1.000 por transação (padrão)

Outros Métodos:

• Cartão de Crédito: 2,99% + R$ 0,39
• Cartão de Débito: 1,99% + R$ 0,39
• Boleto: R$ 3,49 por boleto

---

🔒 SEGURANÇA E BOAS PRÁTICAS

1. Proteção de Credenciais:

# Nunca commite .env no Git:
echo ".env" >> .gitignore

# Use variáveis de ambiente no servidor:
export MERCADOPAGO_ACCESS_TOKEN="APP-..."
export MERCADOPAGO_PUBLIC_KEY="pk_live_..."

2. HTTPS Obrigatório:

• Use certificado SSL válido
• Configure redirect HTTP → HTTPS
• Webhook só funciona com HTTPS

3. Monitoramento:

• Configure logs de transações
• Monitore webhooks perdidos
• Alerte para falhas de pagamento

4. Backup:

• Backup regular do banco de dados
• Logs de todas as transações
• Histórico de webhooks recebidos

---

🚨 PROBLEMAS COMUNS

Erro: "Unauthorized"

• ✅ Verificar se credenciais são de produção (APP-...)
• ✅ Confirmar se conta está verificada
• ✅ Verificar se PIX está ativado

Erro: "Invalid webhook URL"

• ✅ URL deve usar HTTPS
• ✅ Servidor deve estar acessível publicamente
• ✅ Endpoint /api/pix/webhook deve existir

PIX não aparece:

• ✅ Aplicar SQL no Supabase
• ✅ Reiniciar servidor
• ✅ Limpar cache do navegador

---

📞 SUPORTE

Mercado Pago:

• Documentação: https://www.mercadopago.com.br/developers/pt/docs
• Suporte: https://www.mercadopago.com.br/ajuda
• Status: https://status.mercadopago.com/

Liberi Kids:

• Verifique logs do servidor
• Teste APIs individualmente
• Confirme configurações do .env

---

✅ CHECKLIST FINAL

• Conta Mercado Pago empresarial criada
• Verificação de identidade aprovada
• Conta bancária configurada
• PIX ativado na conta
• Aplicação criada no painel
• Credenciais de produção obtidas
• Sistema configurado com credenciais reais
• Webhook configurado e testado
• Teste de pagamento realizado
• HTTPS configurado
• Monitoramento ativo

Após completar todos os itens, seu PIX de produção estará funcionando! 🎉