tutorial-mercado-pago-receber-automaticamente

# 💳 Tutorial: Mercado Pago - Receber Automaticamente ## 📋 Índice 1. [O Que É Recebimento Automático](#o-que-é-recebimento-automático) 2. [Por Que Usar Mercado Pago](#por-que-usar-mercado-pago) 3. [Como Conectar Mercado Pago](#como-conectar-mercado-pago) 4. [Como Funciona o Recebimento Automático](#como-funciona-o-recebimento-automático) 5. [Configurar Webhook](#configurar-webhook) 6. [Gerar PIX para Clientes](#gerar-pix-para-clientes) 7. [Acompanhar Pagamentos](#acompanhar-pagamentos) 8. [Troubleshooting](#troubleshooting) 9. [Dicas Importantes](#dicas-importantes) --- ## 💳 O Que É Recebimento Automático ### **Definição** **Recebimento Automático** é quando o sistema **detecta automaticamente** que um cliente pagou via PIX e **dá baixa automaticamente** na parcela, sem necessidade de ação manual. ### **Como Funciona** 1. Cliente recebe PIX para pagar parcela 2. Cliente paga no app do banco 3. Mercado Pago detecta pagamento 4. Sistema recebe notificação (webhook) 5. Sistema dá baixa automaticamente 6. Cliente recebe comprovante via WhatsApp ### **Vantagens** - ✅ Sem trabalho manual - ✅ Baixa instantânea - ✅ Comprovante automático - ✅ Reduz erros - ✅ Economiza tempo --- ## 💡 Por Que Usar Mercado Pago ### **1. Automação Completa** - Recebimentos automáticos - Baixas instantâneas - Comprovantes automáticos - Zero trabalho manual ### **2. Segurança** - Pagamentos seguros - Confirmação automática - Rastreabilidade completa - Proteção contra fraudes ### **3. Conveniência** - Cliente paga quando quiser - QR Code fácil de usar - Sem necessidade de encontro presencial - Pagamento 24/7 ### **4. Eficiência** - Economiza tempo - Reduz erros - Aumenta produtividade - Melhora experiência --- ## 🔌 Como Conectar Mercado Pago ### **Passo 1: Acessar Configurações** 1. No menu, clique em **"Configurações"** 2. Vá em **"Integrações"** → **"Mercado Pago"** 3. Você verá a página de configuração ### **Passo 2: Iniciar Conexão** 1. Clique em **"Conectar Mercado Pago"** ou **"Ativar Integração"** 2. Sistema mostrará informações sobre a integração 3. Leia os termos e condições ### **Passo 3: Pagar Taxa de Ativação** 1. Sistema mostrará taxa de ativação (geralmente R$ 10,00) 2. Clique em **"Pagar Taxa"** 3. Será redirecionado para pagamento 4. Complete o pagamento ### **Passo 4: Autorizar OAuth** 1. Após pagar, você será redirecionado para Mercado Pago 2. Faça login na sua conta Mercado Pago 3. Autorize o acesso do EmDias 4. Aguarde confirmação ### **Passo 5: Confirmação** 1. Sistema confirmará conexão 2. Você verá status: **"Ativo"** ou **"Conectado"** 3. Integração estará pronta para uso --- ## ⚙️ Como Funciona o Recebimento Automático ### **Fluxo Completo** ``` 1. SISTEMA GERA PIX └─> Cliente precisa pagar parcela └─> Sistema gera PIX usando credenciais do Mercado Pago └─> QR Code é exibido para cliente 2. CLIENTE PAGA └─> Cliente escaneia QR Code └─> Paga no app do banco └─> Pagamento é processado 3. MERCADO PAGO DETECTA └─> Mercado Pago detecta pagamento └─> Envia webhook para sistema └─> Sistema recebe notificação 4. SISTEMA PROCESSA └─> Sistema identifica lançamento pelo pix_id └─> Verifica status do pagamento └─> Confirma que foi pago 5. BAIXA AUTOMÁTICA └─> Sistema dá baixa na parcela └─> Atualiza status para "Pago" └─> Movimenta caixa (entrada) └─> Registra no extrato 6. COMPROVANTE AUTOMÁTICO └─> Sistema envia comprovante via WhatsApp └─> Cliente recebe confirmação └─> Processo completo ``` --- ## 🔗 Configurar Webhook ### **O Que É Webhook** **Webhook** é uma URL que o Mercado Pago usa para **notificar** o sistema quando um pagamento é feito. ### **Configuração Automática** - ✅ Sistema configura automaticamente - ✅ URL única por assinante - ✅ Formato: `/webhook/mp/ass-{licenciado_id}` - ✅ Não precisa configurar manualmente ### **Verificar Webhook** 1. Acesse **"Configurações"** → **"Mercado Pago"** 2. Veja status do webhook 3. Deve estar como **"Ativo"** ou **"Configurado"** --- ## 💰 Gerar PIX para Clientes ### **Método 1: Ao Dar Baixa** #### **Passo 1: Acessar Parcela** 1. Acesse o contrato 2. Encontre a parcela a receber 3. Clique em **"Dar Baixa"** #### **Passo 2: Escolher PIX** 1. No modal de baixa, selecione **"Tipo de Pagamento: PIX"** 2. Sistema gerará PIX automaticamente 3. QR Code será exibido #### **Passo 3: Compartilhar com Cliente** 1. Cliente escaneia QR Code 2. Ou você envia link/código 3. Cliente paga no app do banco --- ### **Método 2: Ao Enviar Cobrança** #### **Passo 1: Enviar Cobrança** 1. Acesse página de cobrança 2. Selecione parcela 3. Clique em **"Enviar Cobrança"** #### **Passo 2: Sistema Gera PIX** 1. Sistema gera PIX automaticamente 2. Inclui QR Code na mensagem 3. Cliente recebe via WhatsApp #### **Passo 3: Cliente Paga** 1. Cliente escaneia QR Code 2. Paga no app do banco 3. Sistema detecta automaticamente --- ## 📊 Acompanhar Pagamentos ### **1. Status dos Pagamentos** #### **Status Disponíveis:** - **Pendente**: PIX gerado, aguardando pagamento - **Processando**: Pagamento em processamento - **Aprovado**: Pagamento confirmado, baixa automática - **Rejeitado**: Pagamento rejeitado - **Cancelado**: PIX cancelado --- ### **2. Histórico de Pagamentos** #### **Como Acessar:** 1. Acesse **"Financeiro"** → **"Extrato"** 2. Filtre por tipo: **"Recebimento PIX"** 3. Veja todos os pagamentos PIX --- ### **3. Notificações** #### **Notificações Recebidas:** - ✅ Pagamento recebido - ✅ Baixa automática realizada - ✅ Comprovante enviado - ⚠️ Pagamento pendente há muito tempo --- ## 🔧 Troubleshooting ### **Problemas Comuns** #### **1. Pagamento Não É Detectado** **Causa:** Webhook não está funcionando **Solução:** - ✅ Verifique se webhook está ativo - ✅ Teste conexão com Mercado Pago - ✅ Verifique logs do sistema - ✅ Entre em contato com suporte --- #### **2. Baixa Não É Automática** **Causa:** Problema no processamento **Solução:** - ✅ Verifique se pagamento foi aprovado - ✅ Verifique logs do sistema - ✅ Dê baixa manualmente se necessário - ✅ Entre em contato com suporte --- #### **3. PIX Não É Gerado** **Causa:** Mercado Pago não conectado **Solução:** - ✅ Verifique se Mercado Pago está conectado - ✅ Reconecte se necessário - ✅ Verifique credenciais - ✅ Entre em contato com suporte --- #### **4. Comprovante Não É Enviado** **Causa:** WhatsApp não conectado ou problema no envio **Solução:** - ✅ Verifique se WhatsApp está conectado - ✅ Verifique se cliente tem WhatsApp cadastrado - ✅ Envie manualmente se necessário --- ## 💡 Dicas Importantes ### **1. Mantenha Mercado Pago Conectado** - ✅ Verifique status regularmente - ✅ Reconecte se desconectar - ✅ Mantenha credenciais atualizadas ### **2. Monitore Pagamentos** - ✅ Verifique pagamentos pendentes - ✅ Acompanhe histórico - ✅ Identifique problemas rapidamente ### **3. Teste Regularmente** - ✅ Teste geração de PIX - ✅ Verifique recebimento automático - ✅ Confirme comprovantes ### **4. Mantenha WhatsApp Conectado** - ✅ Comprovantes são enviados via WhatsApp - ✅ Mantenha conexão ativa - ✅ Verifique regularmente ### **5. Documente Problemas** - ✅ Anote problemas encontrados - ✅ Compartilhe com suporte - ✅ Acompanhe resolução --- ## ❓ Dúvidas Frequentes **P: Preciso pagar para usar Mercado Pago?** R: Sim, há uma taxa única de ativação (geralmente R$ 10,00) e taxas por transação do Mercado Pago. **P: Quanto tempo leva para detectar pagamento?** R: Geralmente é instantâneo, mas pode levar alguns minutos dependendo do banco. **P: Posso usar minha própria conta Mercado Pago?** R: Sim, você conecta sua própria conta do Mercado Pago. **P: O que acontece se o webhook falhar?** R: O sistema tenta novamente, mas se persistir, você pode dar baixa manualmente. **P: Posso desativar recebimento automático?** R: Sim, mas você perderá a automação. Pagamentos precisarão ser confirmados manualmente. **P: Comprovante é enviado automaticamente?** R: Sim, desde que WhatsApp esteja conectado e cliente tenha WhatsApp cadastrado. --- ## ✅ Checklist de Configuração - [ ] Conectar conta Mercado Pago - [ ] Pagar taxa de ativação - [ ] Autorizar OAuth - [ ] Verificar webhook ativo - [ ] Testar geração de PIX - [ ] Testar recebimento automático - [ ] Verificar comprovantes - [ ] Configurar WhatsApp (para comprovantes) --- **Última atualização**: Dezembro 2025 **Versão do Sistema**: 0.0.1