Módulo 6 — Integrações de produto (Angola) 🟢🔴

Objectivo: ligar pagamentos, facturação, SMS e email — o que torna uma solução vendável no mercado angolano. O momento aha: ver um pagamento real confirmado → factura emitida → SMS enviado, tudo orquestrado pelo teu código. Resultado: um pagamento de teste confirmado, com factura e notificação.

1. Pagamentos — MCX Express (AKI / 5Linhas)

O cliente paga por Multicaixa Express. O fluxo seguro:

1. O teu sistema inicia o pagamento.
2. Recebe um callback (webhook) do provider.
3. Confirma sempre na origem (GET .../Payment/{id}) antes de dar como pago — evita fraude.

🔴 Onboarding (contrato, credenciais de produção, autorizar o URL de callback) é feito com o fornecedor.

2. Facturação — FactPlus

Emitir factura legal por API. Regra prática angolana:

• IVA 14% por defeito; recargas isentas (tax: 0, código de isenção).
• O nome do cliente tem de coincidir com o NIF.

3. SMS / OTP — TelcoSMS

Enviar avisos e códigos. Cuidados:

• O sender (nome do remetente) é configurado a nível de conta.
• Confirma o saldo antes de enviar em quantidade — a zero, os SMS são rejeitados.

4. Email — SMTP2GO

Email transaccional (confirmações, alertas) por API REST.

5. O padrão que liga tudo

pagar → confirmar na origem → entregar serviço → emitir factura → notificar (SMS/email)

Cada passo é uma chamada de API; o teu código é o maestro.

🔴 Fora do VSCode

Contratos, credenciais de produção, autorizar callbacks, saldo/sender e séries de factura nos painéis.

✅ Exercícios

1. Fluxo no papel — desenha o caminho completo de um pagamento até ao SMS de confirmação.
2. Segurança — explica porque é que confiar só no callback (sem confirmar na origem) é perigoso.
3. Factura — define os campos de uma factura de recarga (isenta) vs um serviço normal (IVA 14%).

Resultado esperado: um diagrama do fluxo + a regra de confirmação anti-fraude explicada.

⚠️ Erros comuns

• Dar o pagamento como concluído só pelo callback — confirma SEMPRE na origem.
• Enviar SMS sem confirmar saldo — a zero, os envios são rejeitados.
• Factura com nome ≠ NIF — é rejeitada na facturação.
• Misturar contas nossas vs cliente — nunca usar a conta de um no produto do outro.

📋 Checklist do módulo

• Pagamento confirmado na origem antes de processar
• Saldo de SMS confirmado antes de enviar
• Factura com nome/NIF correctos
• Chaves do titular certo (nosso vs cliente)