Pular para o conteúdo principal

Liquidação Financeira e Pagamentos

Para o processamento de transações financeiras e custódia de saldos, a AltherGo utiliza um microsserviço dedicado e isolado em NestJS, totalmente integrado com o gateway Pagar.me V5.

Esta arquitetura garante que os dados sensíveis de pagamento (como cartões de crédito e tokens de Wallets da Apple/Google) sejam manipulados com o mais alto nível de segurança e conformidade normativa (PCI-DSS), sem nunca expor o núcleo principal da aplicação.


Autenticação e Segurança

Como este microsserviço lida com fluxos monetários reais, todas as rotas exigem autenticação rigorosa.

O serviço utiliza um mecanismo de validação cruzada: os tokens JWT são validados em tempo real no Core System, garantindo que permissões revogadas tenham efeito imediato nas tentativas de pagamento.

Cabeçalho Obrigatório: Authorization: Bearer <TOKEN_JWT>


Domínios de Pagamento

A infraestrutura financeira está dividida nos seguintes grupos operacionais:

  • Integração Pagar.me: Gestão de tokens de cartões, criação de clientes e rotinas de Void e Refund.
  • Carteira Digital (Wallet): Gestão em Closed-Loop do saldo digital do utilizador e top-ups.
  • Orquestração de Recarga (Charge): Fluxo de autorização financeira com Auth and Capture acoplado ao arranque do hardware OCPP.
  • Utilizadores (Financeiro): Perfil financeiro e provisionamento de clientes.
  • Fidelização (Cashback): Motor de regras de recompensa e retenção de utilizadores.