n8n-nodes-mercadopago-v2

Nó n8n para integração completa com a API do Mercado Pago. Suporte a pagamentos, clientes, PIX, QR Code, assinaturas e muito mais.

Apoie este projeto!

Se este projeto foi útil para você, considere fazer uma doação para apoiar e ajudar na continuidade e atualização do projeto.

Doe via PayPal

Sobre o Projeto

Um nó da comunidade n8n para interagir com a API do Mercado Pago. Este nó permite automatizar pagamentos, gerenciar clientes e muito mais diretamente do seu fluxo de trabalho n8n.

🚀 Funcionalidades

✅ Recursos Implementados

• Pagamentos: Criar, consultar, atualizar, buscar, estornar e cancelar
• Clientes: Criar, consultar, atualizar, deletar e buscar
• Cartões: Salvar, consultar, listar, atualizar e deletar
• Preferências: Criar, consultar e atualizar
• Assinaturas: Criar, consultar, atualizar, cancelar e buscar
• Webhooks: Criar, consultar, listar, atualizar e deletar
• QR Code: Criar, consultar, atualizar e deletar
• Pontos de Venda: Criar, consultar, listar, atualizar e deletar
• Pedidos: Criar, consultar, atualizar e buscar
• Pagamentos Avançados: Criar, consultar, capturar, cancelar e estornar
• Métodos de Pagamento: Listar e consultar
• Tipos de Identificação: Listar
• Usuário: Consultar dados do usuário
• Saldo da Conta: Consultar saldo
• Solicitações de Dinheiro: Criar, consultar e atualizar
• Contestações: Listar e consultar
• OAuth: Obter e renovar tokens
• Tokens de Cartão: Criar e consultar
• Usuários de Teste: Criar e buscar

🔧 Melhorias Implementadas

Arquitetura

• Código modularizado: Separação em tipos, utilitários e nó principal
• TypeScript: Tipagem completa para melhor desenvolvimento
• Validação: Validação automática de parâmetros obrigatórios
• Tratamento de erros: Tratamento robusto de erros com fallback

Interface

• Interface organizada: Campos condicionais baseados no recurso e operação
• Validação de entrada: Validação de JSON e parâmetros obrigatórios
• Descrições detalhadas: Documentação inline para cada campo
• Suporte a busca: Parâmetros de busca para operações de listagem

Funcionalidades

• API completa: Suporte a todos os recursos da API do Mercado Pago v1
• PIX integrado: Suporte completo para pagamentos PIX
• QR Code: Geração e gerenciamento de QR Codes
• Assinaturas: Gerenciamento completo de assinaturas recorrentes

📦 Instalação

npm install n8n-nodes-mercadopago-v2

🔑 Configuração

1. Obtenha seu Access Token no Mercado Pago Developers
2. No n8n, vá em Credentials > Add Credential > Mercado Pago API
3. Insira seu Access Token
4. Teste a conexão

🎯 Uso

Exemplo: Criar um Pagamento PIX

1. Adicione o nó Mercado Pago ao seu workflow
2. Configure:
   • Recurso: Pagamento
   • Operação: Criar Pagamento
   • Dados (JSON):

   {
     "transaction_amount": 100.00,
     "payment_method_id": "pix",
     "payer": {
       "email": "[email protected]"
     },
     "description": "Pagamento via PIX"
   }

Exemplo: Criar Cliente

1. Configure:
   • Recurso: Cliente
   • Operação: Criar Cliente
   • Dados (JSON):

   {
     "email": "[email protected]",
     "first_name": "João",
     "last_name": "Silva",
     "identification": {
       "type": "CPF",
       "number": "12345678901"
     }
   }

Exemplo: Buscar Pagamentos

1. Configure:
   • Recurso: Pagamento
   • Operação: Buscar Pagamentos
   • Parâmetros de Busca (JSON):

   {
     "status": "approved",
     "limit": 10,
     "offset": 0
   }

🔧 Estrutura do Projeto

n8n-mercadopago-node/
├── nodes/
│   └── MercadoPago.node.ts          # Nó principal
├── credentials/
│   └── MercadoPagoApi.credentials.ts # Configuração de credenciais
├── types/
│   └── MercadoPago.types.ts         # Definições de tipos
├── utils/
│   └── MercadoPago.utils.ts         # Funções utilitárias
├── icons/
│   └── mercadopago.svg              # Ícones do nó
├── dist/                            # Arquivos compilados
├── package.json
├── tsconfig.json
└── README.md

🐛 Solução de Problemas

Ícone não aparece

Consulte o arquivo ICON_TROUBLESHOOTING.md para soluções detalhadas.

Erro de validação

• Verifique se todos os campos obrigatórios estão preenchidos
• Valide o formato JSON dos dados de entrada
• Confirme se o Access Token está correto

Erro de API

• Verifique a documentação oficial do Mercado Pago
• Confirme se os dados enviados estão no formato correto
• Verifique se o endpoint suporta a operação desejada

📚 Documentação da API

Para informações detalhadas sobre os parâmetros de cada endpoint, consulte:

• Documentação oficial do Mercado Pago
• Coleção Postman

🤝 Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🔄 Changelog

v2.1.0

• ✅ Refatoração completa da arquitetura
• ✅ Suporte a todos os recursos da API do Mercado Pago
• ✅ Código modularizado e tipado
• ✅ Validação automática de parâmetros
• ✅ Tratamento robusto de erros
• ✅ Interface melhorada com campos condicionais
• ✅ Correção do problema do ícone
• ✅ Documentação completa

📞 Suporte

Para suporte, abra uma issue no GitHub ou entre em contato via email.

Siga no Instagram

• @degois.mauricio
• @analixbi

Desenvolvido com ❤️ para a comunidade n8n