253 lines
5.8 KiB
Markdown
253 lines
5.8 KiB
Markdown
# 🏦 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!** 🎉
|