Pular para o conteúdo principal
Para criar um novo Pacote de Tarifas no Módulo Midaz:
1
Acesse a página Fee Packages e clique no botão Novo Pacote.
2
O formulário Novo Pacote de Taxas será aberto com múltiplas seções para configurar.
1

Preencha a seção **Informações Básicas**

  • Rótulo do Grupo de Tarifas (obrigatório) - Um nome descritivo para este pacote de tarifas
  • Descrição (obrigatório) - Explicação de quando e por que este pacote se aplica
  • Ledger (obrigatório) - Selecione o ledger ao qual este pacote se aplica
  • Rota de Transação (opcional) - Associe a uma rota de transação específica
  • Segmento (opcional) - Vincule a um segmento específico para aplicação direcionada
2

Configure a seção **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
Transações fora deste intervalo não terão taxas aplicadas deste package.
3
Clique no botão Próximo.
4

Adicione a primeira Fee Rule

Selecione uma das opções na seção Adicionar Taxa:
  • Flat Fee - Valor fixo independente do valor da transação.
  • Percentage - Porcentagem do valor da transação.
  • Max Between Types - Maior valor entre taxa fixa e porcentagem.
5

Adicione as informações da Taxa

  • Prioridade (obrigatório) - Ordem de aplicação da taxa (1 = primeiro)
  • Valor do Cálculo (obrigatório) - O valor da taxa ou percentual.
  • Nome da Taxa (obrigatório) - Nome que identifica esta taxa específica.
  • Configurações da Taxa - Especifique os valores para a taxa:
    • Valor de Referência (obrigatório) - Base para cálculos de porcentagem:
      • Valor Original - Calcula sobre o valor original da transação
      • Valor Após Taxas - Calcula após outras taxas serem aplicadas
    • ID da Conta de Crédito (obrigatório) - Alias da conta que recebe o valor da taxa
    • Rota De (opcional) - Filtro de conta de origem para esta taxa
    • Rota Para (opcional) - Filtro de conta de destino para esta taxa
    • Dedutível da transação? - Alterne se esta taxa deve ser deduzida da transação
6
Clique no botão Próximo.
7
(Opcional) Configure a seção Contas Isentas:
  • Adicione aliases de contas que devem ser isentas de taxas neste pacote
  • Clique em Adicionar para adicionar cada conta isenta
8
Clique no botão Próximo.
9

Revise seu package

Revise as informações e confirme que tudo está correto.
10
Clique no botão Criar Pacote.
3
Se bem-sucedido, você verá uma mensagem de confirmação e será redirecionado para a lista de Fee Packages.

Exemplos rápidos


Caso de uso: Taxa de $2,00 em todas as transações entre $10 e $500
CampoValor
Fee Group LabelStandard Transfer Fee
DescriptionFixed fee for standard transfers
Minimum Amount10.00
Maximum Amount500.00
Fee LabelTransfer Fee
Application RuleFlat Fee
Calculation Value2.00
Priority1
Credit Account@fees/transfers
Caso de uso: Taxa de 1,5% em transações acima de $100
CampoValor
Fee Group LabelPercentage Transaction Fee
DescriptionPercentage-based fee for larger transactions
Minimum Amount100.00
Maximum Amount999999.99
Fee LabelProcessing Fee
Application RulePercentage
Calculation Value1.5
Reference AmountOriginal Amount
Priority1
Credit Account@fees/processing
Caso de uso: Mínimo de $1,00 ou 2% (o que for maior)
CampoValor
Fee Group LabelMinimum Guarantee Fee
DescriptionEnsures minimum fee collection
Minimum Amount0.01
Maximum Amount999999.99
Fee LabelGuarantee Fee
Application RuleMax Between Types
Flat Value1.00
Percentage Value2.0
Reference AmountOriginal Amount
Priority1
Credit Account@fees/guarantee

Notas importantes


Quando um package contém múltiplas taxas, elas são aplicadas em ordem de prioridade (menor número primeiro). Isso é importante ao usar After Fees Amount como referência, já que taxas anteriores afetam a base de cálculo para taxas posteriores.Exemplo:
  • Taxa A (Prioridade 1): 1% sobre o valor original
  • Taxa B (Prioridade 2): 0,5% sobre o valor após taxas
Em uma transação de $100:
  • Taxa A = $1,00 (1% de $100)
  • Taxa B = $0,495 (0,5% de $99)
  • Faixas não devem se sobrepor entre packages para a mesma rota de transação
  • Use 0.01 como mínimo para packages que devem se aplicar a todas as transações
  • Use um máximo alto (ex.: 999999999.99) para não ter limite superior
  • Transações exatamente nos valores mínimo ou máximo estão incluídas na faixa
  • Contas isentas ignoram todas as taxas do package, não apenas taxas específicas
  • Use aliases de conta (não IDs) ao adicionar contas isentas
  • Isenções se aplicam quando a conta isenta é a origem da transação