Fundamentos — Arquitetura da plataforma
Fundamentos
Arquitetura da plataforma
A plataforma é um sistema de camadas independentes que conversam por API. Cada módulo tem responsabilidade única — processar, decidir, liquidar, orquestrar —, e você integra apenas com os que precisa.
Módulos da plataforma
| Módulo | Responsabilidade | Máscara de acesso |
|---|---|---|
| Bank Manager | Processamento de cobranças e pagamentos | /api/v1/bank/... |
| BFF Manager | Operação interna: staff, console, APIs de gestão | /api/v1/bff/... |
| BFF Merchant | Portal do lojista: self-service e consultas | /api/v1/bff/merchant/... |
| Risk Manager | Motor de decisão de risco (shadow-first) | /api/v1/bff/risk/... |
| Settlement Manager | Liquidação, saldos, fees e rolling reserve | /api/v1/settlement/... |
| Orchestration | Roteamento de transações e fallback | /api/v1/bff/orchestration/... |
Como as camadas conversam
- Uma cobrança chega pelas APIs públicas do Bank Manager — checkout, payment link, wallet ou portal.
- Antes do processamento, o Risk Manager avalia a transação e devolve uma decisão: permitir, revisar, exigir step-up ou rejeitar.
- A Orquestração escolhe o provedor mais adequado para o meio e o modelo de negócio, com fallback automático em caso de falha.
- O Bank Manager executa a cobrança no provedor e captura o resultado.
- O Settlement Manager consome o evento e move os saldos: valor, fee, split, escrowing e rolling reserve.
- Console e portais exibem tudo por cima do BFF — sem consulta direta a banco de dados.
Segurança e identidade
A autenticação é centralizada com Keycloak e OpenID Connect. O operador entra com credenciais próprias; o lojista, com usuário do portal. As chamadas de servidor para servidor usam credenciais de API emitidas por conta.