Pular para o conteúdo principal
O Fees Engine roda como seu próprio serviço, e funciona por cálculo: a sua aplicação pede que ele calcule as taxas de uma transação, e o plugin devolve o resultado. A sua aplicação então submete a transação — já com as taxas — ao Midaz. O Fees Engine lê do Midaz para fazer seu trabalho, mas nunca grava no ledger; registrar a transação é um passo da sua aplicação. Para ver onde isso se encaixa no quadro geral, veja Montando um core banking completo.

​
O que o Fees Engine usa do Midaz

O plugin lê do Midaz para duas coisas — ele não posta nada de volta:
  • Resolver as contas — busca as contas envolvidas, por alias, pela Onboarding API do Midaz, para que a taxa atinja contas reais.
  • Billing por volume — conta as transações por rota pela Transaction API do Midaz, o que alimenta o billing por período e por volume.
A taxa em si é calculada e devolvida ao chamador. A sua aplicação a registra no ledger quando submete a transação — o Fees Engine não grava no Midaz.

​
Configuração da conexão

A conexão é definida por variáveis de ambiente quando o plugin é implantado (no ConfigMap dele) — não pela sua aplicação. A sua app só chama a API do próprio Fees Engine.
VariávelDefault / ObrigatóriaDescrição
MIDAZ_ONBOARDING_URLObrigatóriaURL base da Onboarding API do Midaz, usada para resolver contas por alias. Em setups locais: http://midaz-ledger:3002/v1/.
MIDAZ_TRANSACTION_URLObrigatóriaURL base da Transaction API do Midaz, usada para contar transações por rota no billing por volume. Em setups locais: http://midaz-ledger:3002/v1/.
CLIENT_IDUsada na authClient ID que o plugin usa para autenticar no Midaz (machine-to-machine).
CLIENT_SECRETUsada na authClient secret pareado com CLIENT_ID.
PLUGIN_AUTH_ENABLEDfalseHabilita autenticação via Access Manager. Use true em produção.
PLUGIN_AUTH_ADDRESShttp://plugin-auth:4000URL do serviço Access Manager (plugin-auth) que emite os tokens.
As duas variáveis MIDAZ_ONBOARDING_URL e MIDAZ_TRANSACTION_URL são obrigatórias — o plugin não sobe sem elas. Em setups locais, ambas apontam para o mesmo host do Midaz (midaz-ledger:3002); em produção, apontam para as suas APIs do Midaz implantadas.

​
Autenticação

O Fees Engine autentica no Midaz através do Access Manager. Ele troca o seu CLIENT_ID / CLIENT_SECRET por um application token e chama o Midaz com esse token — o mesmo padrão machine-to-machine que os outros plugins usam. Em deployments multi-tenant, as credenciais por tenant vêm do AWS Secrets Manager em vez do CLIENT_ID / CLIENT_SECRET estáticos; o Access Manager então emite o token a partir dessas credenciais, para que as chamadas de cada tenant cheguem ao ledger certo. O modo multi-tenant exige a autenticação habilitada. → Access Manager

​
Veja na Lerian