Pular para o conteúdo principal
O Fees Engine é um plugin disponível no Módulo Midaz que permite configurar e gerenciar taxas de transação através de uma interface visual. Defina regras de taxas, teste cálculos e aplique cobranças às transações sem escrever código.

​
O que é o Fees Engine?

O Fees Engine oferece um sistema completo de gerenciamento de taxas que se integra à sua infraestrutura Midaz Core. Ele permite que você:
  • Defina regras de taxas flexíveis: Crie taxas baseadas em valores fixos, porcentagens ou uma combinação de ambos
  • Direcione transações específicas: Aplique taxas a rotas de transação, segmentos ou ledgers específicos
  • Defina limites de valores: Configure valores mínimos e máximos de transação para aplicação de taxas
  • Isente taxas seletivamente: Exclua contas específicas de taxas quando necessário
  • Teste antes de implantar: Use a calculadora de taxas para simular cobranças antes de habilitá-las

​
Acessando o Fees Engine

Para acessar o Fees Engine no Lerian Console:
1

Abra o Módulo Midaz

Na página inicial do Lerian Console, selecione o card do produto Midaz.
2

Navegue até Plugins

Na barra lateral esquerda, localize a seção Plugins.
3

Selecione Fees Engine

Clique em Fees Engine para acessar a interface de gerenciamento de taxas.

​
Conceitos principais

Antes de trabalhar com o Fees Engine, entenda estes elementos fundamentais:
  • Fee Package: Um container que agrupa regras de taxas e define quando elas se aplicam (rota de transação, segmento, faixa de valores)
  • Fee Rule: Uma configuração individual de taxa dentro de um package que especifica como a taxa é calculada
  • Application Rule: O método de cálculo utilizado — taxa fixa, porcentagem ou máximo entre ambos
  • Reference Amount: Se as taxas percentuais são calculadas sobre o valor original da transação ou após outras taxas
  • Priority: A ordem em que múltiplas taxas são aplicadas dentro de um package

​
Funcionalidades disponíveis

Gerenciar Fee Packages

Crie, edite e organize configurações de taxas para suas transações.

Criar um Fee Package

Guia passo a passo para configurar um novo fee package.

Editar um Fee Package

Atualize configurações e regras de taxas existentes.

Excluir um Fee Package

Remova fee packages da sua configuração.

Executar Simulações de Taxas

Teste cálculos de taxas antes de aplicá-los a transações reais.

​
Como as taxas são calculadas

Quando uma transação é processada, o Fees Engine:
  1. Associa a transação aos fee packages aplicáveis com base em rota, segmento e ledger
  2. Valida se o valor está dentro da faixa mínima e máxima do package
  3. Verifica isenções para saber se a conta de origem está isenta
  4. Aplica as regras de taxas em ordem de prioridade
  5. Calcula cada taxa usando a regra de aplicação e valor de referência especificados
  6. Credita as contas de taxas com os valores calculados

​
Tipos de cálculo de taxas

O Fees Engine suporta três métodos de cálculo:
Um valor fixo cobrado independentemente do valor da transação.Exemplo: $2,50 por transação
Uma porcentagem do valor da transação.Exemplo: 1,5% de 100=taxade100 = taxa de 1,50
Aplica o que for maior entre um valor fixo e uma porcentagem.Exemplo: Máximo de $1,00 ou 2%
  • Em 30:max(30: max(1,00, 0,60)=0,60) = 1,00
  • Em 100:max(100: max(1,00, 2,00)=2,00) = 2,00

​
Integração com o Midaz Core

O Fees Engine funciona com sua infraestrutura Midaz existente:
  • Ledgers: Defina o escopo dos pacotes de tarifas para ledgers específicos
  • Segmentos: Aplique diferentes estruturas de taxas a segmentos de clientes
  • Rotas de Transação: Defina quais taxas se aplicam a quais fluxos de transação
  • Contas: Designe contas para receber créditos de taxas e especifique contas isentas

​
Próximos passos

Crie seu primeiro Fee Package

Comece configurando regras de taxas para suas transações.

Teste com Simulação de Taxas

Valide seus cálculos de taxas antes de entrar em produção.