# 🏦 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):**
```env
MERCADOPAGO_ACCESS_TOKEN=TEST-1234567890-abcdef...
MERCADOPAGO_PUBLIC_KEY=pk_test_1234567890abcdef...
BASE_URL=http://localhost:5000
```

### **Produção (Vendas Reais):**
```env
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)**
```bash
# Execute o script de configuração:
./configurar-producao-pix.sh
```

### **Opção 2: Manual**
```bash
# 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:**
```bash
# 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:**
```bash
# 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!** 🎉
