Pular para o conteúdo principal
Use o Módulo Midaz para gerenciar Pacotes de Tarifas que definem como as taxas são calculadas para transações. Pacotes de Tarifas são o núcleo da funcionalidade do Fees Engine, permitindo configurar estruturas de taxas complexas baseadas em rotas de transação, valores e tipos de conta.

​
O que são Fee Packages?

Um Fee Package é uma configuração que define regras de taxas aplicadas a transações que correspondem a critérios específicos. No Módulo Midaz, fee packages permitem que você:
  • Defina regras de cálculo de taxas - Configure taxas fixas, taxas baseadas em porcentagem ou cálculos combinados
  • Defina faixas de valores - Aplique taxas apenas a transações dentro de valores mínimos e máximos especificados
  • Vincule a rotas de transação - Associe packages a rotas de transação específicas para aplicação direcionada de taxas
  • Isente taxas para contas específicas - Exclua certas contas dos cálculos de taxas
  • Priorize a aplicação de taxas - Controle a ordem em que múltiplas taxas são aplicadas
Fee Packages funcionam em conjunto com Transaction Routes e Segments para fornecer controle granular sobre sua estrutura de taxas.

​
Acessando a página de Fee Packages

Para abrir a página Fee Packages, selecione a opção Fee Packages na seção Fees Engine do menu lateral esquerdo. A página Fee Packages exibe uma lista de todos os fee packages configurados.
Se você não tiver nenhum Fee Package, a lista aparecerá vazia com um prompt para criar seu primeiro package.

​
Ações disponíveis

A partir da página Fee Packages, você pode:

Criar um Fee Package

Defina novas regras de cálculo de taxas para transações

Editar um Fee Package

Atualize configurações e regras de taxas

Excluir um Fee Package

Remova um fee package da sua configuração

​
Entendendo a estrutura do Fee Package

Ao criar ou editar um fee package no Módulo Midaz, você trabalhará com:

​
Informações Básicas

  • Rótulo do Grupo de Tarifas (obrigatório) - Um nome descritivo para o pacote de tarifas
  • Descrição (obrigatório) - Explicação do propósito do pacote e quando ele se aplica
  • Rota de Transação (opcional) - Vínculo a uma rota de transação específica
  • Segmento (opcional) - Associação a um segmento específico
  • Ledger (obrigatório) - O ledger ao qual este pacote se aplica

​
Faixa de Valores

  • Valor Mínimo (obrigatório) - Valor mínimo da transação para aplicação da taxa
  • Valor Máximo (obrigatório) - Valor máximo da transação para aplicação da taxa
  • Contas Isentas (opcional) - Lista de aliases de conta isentos destas taxas

​
Regras de Taxas

Cada pacote de tarifas pode conter múltiplas regras de taxas com:
  • Rótulo da Taxa - Nome que identifica esta taxa específica
  • Regra de Aplicação - Como a taxa é calculada:
    • flatFee - Valor fixo independente do valor da transação
    • percentual - Porcentagem do valor da transação
    • maxBetweenTypes - Maior valor entre cálculos de taxa fixa e porcentagem
  • Tipo de Cálculo - flat ou percentage
  • Valor do Cálculo - O valor da taxa ou porcentagem
  • Valor de Referência - Base para cálculo de porcentagem:
    • originalAmount - Calcular sobre o valor original da transação
    • afterFeesAmount - Calcular após outras taxas serem aplicadas
  • Prioridade - Ordem de aplicação da taxa (números menores são aplicados primeiro)
  • É Dedutível De - Se esta taxa é deduzida da transação
  • Conta de Crédito - Conta que recebe o valor da taxa

​
Casos de Uso Comuns

Aplique uma taxa fixa a todas as transações dentro de uma faixa de valores:
  • Application Rule: flatFee
  • Calculation: flat com valor 2.50
  • Exemplo: Taxa de 2,50emcadatransac\ca~oentre2,50 em cada transação entre 10 e $1000
Cobre uma porcentagem do valor da transação:
  • Application Rule: percentual
  • Calculation: percentage com valor 1.5
  • Exemplo: Taxa de 1,5% em transferências, onde transferência de 100=taxade100 = taxa de 1,50
Crie múltiplos packages com diferentes faixas de valores:
  • Package 1: 0−0-100 → taxa de 2%
  • Package 2: 100−100-1000 → taxa de 1,5%
  • Package 3: $1000+ → taxa de 1%
  • Taxas menores para transações de maior valor
Aplique o que for maior entre taxa fixa e porcentagem:
  • Application Rule: maxBetweenTypes
  • Calculations: flat: 1.00 e percentage: 2.0
  • Exemplo: Em transação de 30:max(30: max(1,00, 0,60)=taxade0,60) = taxa de 1,00
  • Exemplo: Em transação de 100:max(100: max(1,00, 2,00)=taxade2,00) = taxa de 2,00
Isente contas específicas de taxas:
  • Crie package com regras de taxas padrão
  • Adicione aliases de contas premium à lista Waived Accounts
  • Essas contas transacionam sem incorrer nas taxas configuradas

​
Boas Práticas

1

Planeje sua estrutura de taxas

Projete seus fee packages antes da implementação. Considere tipos de transação, faixas de valores e segmentos de clientes que requerem tratamentos de taxas diferentes.
2

Use labels descritivos

Escolha labels de grupo de taxas e descrições claras que expliquem quando e por que as taxas se aplicam. Isso ajuda na auditoria e comunicação com o cliente.
3

Defina faixas de valores apropriadas

Defina valores mínimos e máximos cuidadosamente para evitar lacunas ou sobreposições em sua estrutura de taxas.
4

Teste cálculos de taxas

Use a funcionalidade Simulação de Taxas para verificar os cálculos de taxas antes de habilitar packages em produção.
5

Gerencie prioridades com cuidado

Ao usar múltiplas taxas em um package, defina prioridades para garantir que as taxas sejam aplicadas na ordem correta.
6

Documente contas isentas

Mantenha registro de por que certas contas estão isentas de taxas para fins de auditoria e conformidade.

​
Fluxo de Cálculo de Taxas

Quando uma transação é processada, o Fees Engine:
  1. Identifica fee packages aplicáveis com base na rota de transação e segmento
  2. Filtra packages por faixa de valores (transação deve estar dentro do min/max)
  3. Verifica se a conta de origem está na lista de contas isentas
  4. Aplica regras de taxas em ordem de prioridade
  5. Calcula cada taxa com base na regra de aplicação e valor de referência
  6. Credita valores de taxas nas contas designadas
Fee packages devem estar habilitados para serem aplicados a transações. Você pode desabilitar packages temporariamente sem excluí-los.