mercadopago-v2

n8n community node for Mercado Pago API. Automate payments, manage customers, and more.

Package Information

Released: 7/10/2025
Downloads: 15 weekly / 1,458 monthly
Latest Version: 2.1.2
Author: mauricio góis

Available Nodes

Mercado Pago
No description available

Documentation

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": "cliente@email.com"
  },
  "description": "Pagamento via PIX"
}

Exemplo: Criar Cliente

  1. Configure:
    • Recurso: Cliente
    • Operação: Criar Cliente
    • Dados (JSON):
    {
  "email": "cliente@email.com",
  "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:

🤝 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

Desenvolvido com ❤️ para a comunidade n8n

Discussion