Skip to main content
Pacotes de Tarifas são a unidade base do Fees Engine. Cada pacote define um conjunto de regras de tarifa e as condições sob as quais elas se aplicam a Transações.
Habilite o Fees Engine nas configurações do Módulo Midaz antes de usar esta página.

​
O que um Pacote de Tarifas contém

Um Pacote de Tarifas permite:
  • Definir regras de cálculo de tarifa: tarifas fixas, tarifas percentuais ou cálculos combinados.
  • Definir faixas de valores: aplicar tarifas apenas a transações dentro de uma faixa mínima/máxima.
  • Vincular a rotas de transação: direcionar fluxos de transação específicos.
  • Isentar contas específicas de tarifas: isentar contas de origem selecionadas.
  • Priorizar a aplicação de tarifas: controlar a ordem em que o Fees Engine aplica múltiplas tarifas.
Pacotes de Tarifas se combinam com Rotas Contábeis e Segmentos para um controle granular.

​
Acessando a página Pacotes de Tarifas

Na barra lateral do Módulo Midaz, expanda Fees Engine. Selecione Pacotes de Tarifas. A página lista todos os pacotes configurados.
Se você não tiver Pacotes de Tarifas, a lista fica vazia e mostra um aviso para criar seu primeiro pacote.

​
Ações disponíveis

Na página Pacotes de Tarifas, você pode:

Criar um Pacote de Tarifas

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

Editar um Pacote de Tarifas

Atualize configurações e regras de tarifa

Excluir um Pacote de Tarifas

Exclua um pacote de tarifas da sua configuração
Selecione um pacote na lista para abrir sua visualização de detalhes. Lá você pode revisar a configuração do pacote (tipo, escopo e regras) antes de editá-lo. Para pré-visualizar as tarifas que um período gera entre pacotes, use Execuções de Faturamento.

​
Entendendo a estrutura de um Pacote de Tarifas

Ao criar ou editar um pacote de tarifas no Módulo Midaz, você trabalha com estes campos:

​
Informações básicas

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

​
Faixa de valores

  • Valor Mínimo (obrigatório) - Menor valor de transação para aplicação da tarifa
  • Valor Máximo (obrigatório) - Maior valor de transação para aplicação da tarifa
  • Contas Isentas (opcional) - Lista de aliases de conta isentos dessas tarifas

​
Regras de tarifa

Cada pacote de tarifas pode conter múltiplas regras de tarifa com:
  • Rótulo da Tarifa - Nome que identifica esta tarifa
  • Regra de Aplicação - Como o Fees Engine calcula a tarifa:
    • flatFee - Valor fixo, independente do valor da transação
    • percentual - Percentual do valor da transação
    • maxBetweenTypes - Maior valor entre os cálculos fixo e percentual
  • Tipo de Cálculo - flat ou percentage
  • Valor do Cálculo - O valor da tarifa ou o percentual
  • Valor de Referência - Base para o cálculo do percentual:
    • originalAmount - Calcula sobre o valor original da transação
    • afterFeesAmount - Calcula depois que o Fees Engine aplica outras tarifas
  • Prioridade - Ordem de aplicação da tarifa (números menores se aplicam primeiro)
  • É Dedutível De - Se o Fees Engine deduz esta tarifa da transação
  • Conta de Crédito - Conta que recebe o valor da tarifa

​
Casos de uso comuns

Aplique uma tarifa fixa a todas as transações dentro de uma faixa de valores:
  • Regra de Aplicação: flatFee
  • Cálculo: flat com valor 2.50
  • Exemplo: tarifa de 2,50emtodatransac\ca~oentre2,50 em toda transação entre 10 e $1000
Cobre um percentual do valor da transação:
  • Regra de Aplicação: percentual
  • Cálculo: percentage com valor 1.5
  • Exemplo: tarifa de 1,5% em transferências, em que uma transferência de 100geratarifade100 gera tarifa de 1,50
Crie múltiplos pacotes com faixas de valores diferentes:
  • Pacote 1: 0−0-100 → tarifa de 2%
  • Pacote 2: 100−100-1000 → tarifa de 1,5%
  • Pacote 3: $1000+ → tarifa de 1%
  • Tarifas menores para transações de maior valor
Aplique o que for maior entre o valor fixo e o percentual:
  • Regra de Aplicação: maxBetweenTypes
  • Cálculos: flat: 1.00 e percentage: 2.0
  • Exemplo: em transação de 30:max(30: max(1,00, 0,60)=tarifade0,60) = tarifa de 1,00
  • Exemplo: em transação de 100:max(100: max(1,00, 2,00)=tarifade2,00) = tarifa de 2,00
Isente contas específicas de tarifas:
  • Crie o pacote com as regras de tarifa padrão
  • Adicione os aliases das contas premium à lista Contas Isentas
  • Essas contas transacionam sem as tarifas configuradas

​
Boas práticas

1

Planeje sua estrutura de tarifas

Projete seus pacotes de tarifas antes da implementação. Considere os tipos de transação, as faixas de valores e os segmentos de clientes que exigem tratamentos de tarifa diferentes.
2

Use rótulos descritivos

Escolha rótulos de grupo de tarifa e descrições claras que expliquem quando e por que as tarifas se aplicam. Isso ajuda na auditoria e na comunicação com o cliente.
3

Defina faixas de valores adequadas

Defina os valores mínimo e máximo com cuidado para evitar lacunas ou sobreposições na sua estrutura de tarifas.
4

Teste os cálculos de tarifa

Use o recurso de Estimativa de Tarifa para pré-visualizar os cálculos antes de habilitar pacotes em produção.
5

Gerencie a prioridade com cuidado

Ao usar múltiplas tarifas em um pacote, defina prioridades para que as tarifas se apliquem na ordem correta.
6

Documente as contas isentas

Registre por que você isenta certas contas de tarifas. Isso apoia a auditoria e a conformidade.

​
Fluxo de cálculo de tarifa

Quando o Fees Engine processa uma transação, ele:
  1. Identifica os pacotes de tarifas aplicáveis com base na rota de transação e no segmento
  2. Filtra os pacotes pela faixa de valores (a transação deve estar dentro do mínimo/máximo)
  3. Verifica se a conta está na lista de contas isentas
  4. Aplica as regras de tarifa em ordem de prioridade
  5. Calcula cada tarifa com base na regra de aplicação e no valor de referência
  6. Credita os valores de tarifa nas contas designadas
Habilite um pacote de tarifas para que ele se aplique às transações. Para pausar um pacote, desabilite-o. Um pacote desabilitado permanece na sua configuração.