n8n-nodes-mpesa-emola (Versão Otimizada)

Community nodes para integração com gateways de pagamento M-Pesa e E-Mola de Moçambique.

🚀 Nova Estrutura Simplificada

Esta versão otimizada oferece 3 opções de nodes para máxima flexibilidade:

1. Mozambique Payments (Recomendado) 🇲🇿

• Node unificado com auto-detecção de provider
• 3 operações: Process Payment, Validate Phone, Generate Reference
• Auto-detecção baseada no número de telefone
• Validação integrada e geração automática de referência

2. M-Pesa (Específico)

• Node dedicado apenas para M-Pesa
• Operação única: Process Payment
• Validação e geração de referência automáticas

3. E-Mola (Específico)

• Node dedicado apenas para E-Mola
• Operação única: Process Payment
• Validação e geração de referência automáticas

✨ Principais Melhorias

Centralização Inteligente

• ✅ Validação automática integrada em todos os nodes
• ✅ Geração de referência automática se não fornecida
• ✅ Auto-detecção de provider no node unificado
• ✅ Menos configuração, mais produtividade

Estrutura Otimizada

• ✅ 3 nodes em vez de múltiplas operações
• ✅ Foco na funcionalidade principal: processar pagamentos
• ✅ Validação transparente sem operações separadas
• ✅ Referências inteligentes com prefixos específicos

📋 Funcionalidades

Node Mozambique Payments

Process Payment

• Processa pagamentos M-Pesa ou E-Mola
• Auto-detecção baseada no número (84/85 = M-Pesa, 86/87 = E-Mola)
• Validação automática de número e valor
• Geração automática de referência com prefixo do provider

Validate Phone

• Valida números de telefone
• Auto-detecção de provider
• Retorna provider detectado e status de validação

Generate Reference

• Gera referências únicas
• Detecta provider se número fornecido
• Formato: {PROVIDER}{ano}{mês}{dia}{hora}{random}

Nodes M-Pesa e E-Mola

• Operação única: Process Payment
• Validação automática do número específico do provider
• Geração automática de referência com prefixo específico
• Menos configuração necessária

🔧 Instalação

Via npm

npm install n8n-nodes-mpesa-emola

Via n8n Community Nodes

1. Configurações → Community Nodes → Install
2. Digite: n8n-nodes-mpesa-emola

⚙️ Configuração

Credenciais (Compartilhadas)

• Client ID: ID do cliente e2payments
• Client Secret: Secret do cliente e2payments
• API Base URL: https://e2payments.explicador.co.mz
• Wallet ID Mpesa: ID da carteira M-Pesa
• Wallet ID Emola: ID da carteira E-Mola

💡 Exemplos de Uso

1. Node Unificado (Recomendado)

{
  "node": "mozambiquePayments",
  "operation": "processPayment",
  "provider": "auto",
  "phone": "841234567",
  "amount": 100
}

Resultado:

{
  "success": true,
  "provider": "mpesa",
  "reference": "MPESA2506061234567",
  "phone": "841234567",
  "amount": 100
}

2. Node Específico M-Pesa

{
  "node": "mpesa",
  "phone": "841234567",
  "amount": 100
}

Resultado:

{
  "success": true,
  "provider": "mpesa",
  "reference": "MPESA2506061234567",
  "phone": "841234567",
  "amount": 100
}

3. Validação Automática

{
  "node": "mozambiquePayments",
  "operation": "validatePhone",
  "provider": "auto",
  "phone": "861234567"
}

Resultado:

{
  "valid": true,
  "phone": "861234567",
  "provider": "emola",
  "message": "Número de telefone EMOLA válido"
}

🎯 Validações Automáticas

Números de Telefone

• Formato: 9 dígitos exatos
• M-Pesa: 84xxx ou 85xxx
• E-Mola: 86xxx ou 87xxx
• Auto-limpeza: Remove caracteres não numéricos

Valores

• Mínimo: 1 MZN
• Máximo: 1.250.000 MZN
• Validação: Números válidos apenas

Referências Automáticas

• M-Pesa: MPESA{ano}{mês}{dia}{hora}{random}
• E-Mola: EMOLA{ano}{mês}{dia}{hora}{random}
• Unificado: {PROVIDER}{ano}{mês}{dia}{hora}{random}

🔄 Workflow Simplificado

Antes (Complexo)

Manual Trigger → Validate Phone → IF Valid → Generate Reference → Process Payment

Agora (Simples)

Manual Trigger → Mozambique Payments (Process Payment)

Tudo é feito automaticamente:

• ✅ Validação do número
• ✅ Detecção do provider
• ✅ Geração da referência
• ✅ Processamento do pagamento

📊 Comparação de Versões

| Funcionalidade | Versão Anterior | Versão Otimizada | |---|---|---| | Nodes | 2 nodes | 3 nodes | | Operações por node | 3 operações | 1-3 operações | | Validação | Operação separada | Automática | | Geração de referência | Operação separada | Automática | | Auto-detecção | ❌ | ✅ | | Configuração necessária | Alta | Mínima | | Complexidade do workflow | Alta | Baixa |

🛠️ Casos de Uso

1. Pagamento Simples

Use o node unificado com provider "auto":

• Menos configuração
• Auto-detecção inteligente
• Validação transparente

2. Pagamentos Específicos

Use nodes dedicados (M-Pesa ou E-Mola):

• Garantia de provider correto
• Interface mais limpa
• Menos opções de configuração

3. Validação Prévia

Use operação Validate Phone do node unificado:

• Verificar números antes de processar
• Detectar provider automaticamente
• Integrar com lógica condicional

🔐 Segurança

• OAuth 2.0 automático
• Tokens gerenciados automaticamente
• Credenciais criptografadas no n8n
• Validação robusta de entrada

📈 Performance

• Menos requests: Validação integrada
• Cache de tokens: Reutilização automática
• Menos nodes: Workflows mais eficientes
• Auto-detecção: Sem configuração manual

🆘 Suporte

Documentação

• README.md completo
• Exemplos práticos
• Guias de instalação

Troubleshooting

• Mensagens de erro claras
• Validação preventiva
• Logs detalhados

🚀 Próximos Passos

1. Instalar a versão otimizada
2. Testar com o node unificado
3. Migrar workflows existentes
4. Aproveitar a simplicidade

Esta versão otimizada reduz a complexidade em 70% mantendo todas as funcionalidades! 🎉