Primeiro commit
This commit is contained in:
252
MERCADOPAGO-PRODUCAO-GUIDE.md
Normal file
252
MERCADOPAGO-PRODUCAO-GUIDE.md
Normal file
@@ -0,0 +1,252 @@
|
||||
# 🏦 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!** 🎉
|
||||
Reference in New Issue
Block a user