Pular para o conteúdo principal
Use a Fee Calculator no Módulo Midaz para simular cálculos de taxas antes de processar transações reais. Isso ajuda você a validar fee packages e entender como as taxas serão aplicadas.
Você deve ter pelo menos um Fee Package criado antes de usar a Fee Calculator. O simulador requer a seleção de um fee package para testar.

Executando uma simulação


1
Acesse a página Calculadora na seção Fees Engine.
2
3
Configure a transação simulada:
  • Valor da Transação - O valor total a transferir.
  • Moeda - O código do ativo para a transação (ex.: USD, BRL)
  • Pacote de Tarifas - Selecione um dos Pacotes de Tarifas criados no dropdown.
  • Conta de Origem - O alias da conta que será debitada
  • Conta de Destino - O alias da conta que será creditada
  • Descrição (opcional) - Uma descrição para a transação simulada
4
Clique em Calcular Taxas para executar a simulação.
5
Revise os resultados exibidos abaixo do formulário.
A Fee Calculator é uma ferramenta somente leitura. Ela não afeta o ledger nem cria transações. Você pode executar quantas simulações precisar com segurança.

Entendendo os resultados


Após executar uma simulação, você verá um detalhamento de como as taxas são calculadas:

Resumo

  • Total de Taxas - O valor combinado de todas as taxas que seriam cobradas
  • Valor Líquido - O valor que o destino receberia após as taxas dedutíveis

Detalhamento das taxas

Para cada regra de taxa aplicada, você verá:
CampoDescrição
Rótulo da TaxaNome que identifica a taxa
PrioridadeOrdem em que a taxa foi aplicada
Tipo de Cálculoflat ou percentage
Valor de ReferênciaO valor base usado para o cálculo
Valor CalculadoO valor real da taxa
Conta de CréditoConta que receberia a taxa
É DedutívelSe a taxa é deduzida da transação

Exemplos de simulação


Cenário: Testar uma taxa fixa de $2,00 em uma transferência de $100Entrada:
  • Fee Package: Standard Transfer Fee
  • Asset: USD
  • Amount: 100.00
  • Source: @customer/checking
  • Destination: @merchant/revenue
Resultado esperado:
  • Total Fee: $2,00
  • Net Amount: $98,00 (se dedutível) ou $100,00 (se não dedutível)
Cenário: Testar uma taxa de 1,5% em uma transferência de $500Entrada:
  • Fee Package: Percentage Transaction Fee
  • Asset: USD
  • Amount: 500.00
  • Source: @customer/savings
  • Destination: @vendor/payments
Resultado esperado:
  • Total Fee: $7,50 (1,5% de $500)
  • Cálculo: 500 x 0,015 = 7,50
Cenário: Testar taxa max(fixa, percentual) em diferentes valoresTeste 1 - Transação pequena ($30):
  • Fixa: $1,00
  • Percentual: 2% = $0,60
  • Resultado: $1,00 (fixa é maior)
Teste 2 - Transação grande ($200):
  • Fixa: $1,00
  • Percentual: 2% = $4,00
  • Resultado: $4,00 (percentual é maior)
Cenário: Package com duas taxas aplicadas em ordem de prioridadeTaxa A (Prioridade 1): 1% sobre o valor original Taxa B (Prioridade 2): 0,5% sobre o valor após taxasEntrada: Transação de $1000Resultado esperado:
  • Taxa A: $10,00 (1% de $1000)
  • Taxa B: $4,95 (0,5% de $990)
  • Total Fee: $14,95

Casos de uso para simulação de taxas


Validar novos fee packages

Antes de habilitar um novo fee package, execute simulações com vários valores de transação para garantir que as taxas sejam calculadas corretamente em toda a faixa de valores.

Testar casos extremos

Simule transações nos limites mínimo e máximo de valores para verificar o comportamento das taxas nos extremos das suas faixas configuradas.

Comparar estruturas de taxas

Execute a mesma transação através de diferentes fee packages para comparar resultados e escolher a melhor estrutura para seu caso de uso.

Documentar taxas esperadas

Use os resultados da simulação para criar documentação para sua equipe financeira ou clientes sobre os valores de taxas esperados.

Depurar problemas com taxas

Se as transações estão mostrando taxas inesperadas, use o simulador para reproduzir o cenário e entender o detalhamento do cálculo.

Boas práticas


  • Teste faixas de valores completas - Não teste apenas um valor; simule transações no mínimo, máximo e vários pontos intermediários.
  • Verifique a ordenação por prioridade - Quando os packages têm múltiplas taxas, confirme que elas são aplicadas na ordem esperada.
  • Verifique contas isentas - Teste com contas que deveriam ser isentas para confirmar que estão excluídas das taxas.
  • Documente seus testes - Mantenha um registro dos resultados de simulação para fins de auditoria e conformidade.
  • Compartilhe com stakeholders - Use os detalhamentos da simulação para alinhar com as equipes financeiras sobre os resultados esperados de taxas antes de entrar em produção.