Pular para o conteúdo principal
Use a Calculadora de Taxas no Módulo Midaz para estimar tarifas antes de processar uma Transação real. A Calculadora de Taxas é somente leitura. Ela não cria uma Transação nem altera nenhum saldo do Ledger.

Antes de começar


Executando uma estimativa


1
Na barra lateral do Módulo Midaz, expanda Fees Engine e clique em Calculadora.
2
Preencha a transação estimada. Veja o Guia de campos abaixo para cada campo.
3
Clique em Calcular Taxas para executar a estimativa.
4
Revise os resultados mostrados abaixo do formulário.

Guia de campos


A Calculadora de Taxas é uma ferramenta somente leitura. Ela não afeta o ledger nem cria transações. Você pode executar quantas estimativas forem necessárias com segurança.

Entendendo os resultados


Depois de executar uma estimativa, a Calculadora de Taxas mostra um detalhamento completo do cálculo:

Totais

  • Pagador pagou - o valor que a origem envia, incluindo as tarifas somadas por cima
  • Total de taxas - a soma de todas as tarifas da transação
  • Destinatário recebeu - Pagador pagou menos Total de taxas

Detalhamento de tarifas

Para cada regra de tarifa aplicada, você verá:

Exemplos de estimativa


Cenário: teste uma tarifa fixa de $2,00 em uma transferência de $100Entrada:
  • Pacote de Tarifas: Standard Transfer Fee
  • Ativo: USD
  • Valor: 100.00
  • Origem: @customer/checking
  • Destino: @merchant/revenue
Resultado Esperado:
  • Total de taxas: $2,00
  • Destinatário recebeu: $98,00 se a tarifa for dedutível. Se ela não for dedutível, Pagador pagou é $102,00 e Destinatário recebeu é $100,00.
Cenário: teste uma tarifa de 1,5% em uma transferência de $500Entrada:
  • Pacote de Tarifas: Percentage Transaction Fee
  • Ativo: USD
  • Valor: 500.00
  • Origem: @customer/savings
  • Destino: @vendor/payments
Resultado Esperado:
  • Total de taxas: $7,50 (1,5% de $500)
  • Cálculo: 500 × 0,015 = 7,50
Cenário: teste a tarifa de máximo entre fixa e percentual em valores diferentesTeste 1 - transação pequena ($30):
  • Fixa: $1,00
  • Percentual: 2% = $0,60
  • Resultado: $1,00 (a fixa é maior)
Teste 2 - transação grande ($200):
  • Fixa: $1,00
  • Percentual: 2% = $4,00
  • Resultado: $4,00 (a percentual é maior)
Cenário: pacote com duas tarifas aplicadas em ordem de prioridadeTarifa A (Prioridade 1): 1% sobre o valor original, não dedutível Tarifa B (Prioridade 2): 0,5% sobre o valor após tarifasEntrada: transação de $1000Resultado Esperado:
  • Tarifa A: $10,00 (1% de $1000)
  • Tarifa B: $5,05 (0,5% de $1010)
  • Total de taxas: $15,05

Casos de uso para estimativa de tarifa


Validar novos pacotes de tarifas

Antes de habilitar um novo pacote de tarifas, execute estimativas em vários valores de transação. Confirme que as tarifas estão corretas em toda a faixa de valores.

Testar casos extremos

Estime transações nos limites mínimo e máximo de valor para verificar o comportamento da tarifa nos extremos das faixas configuradas.

Comparar estruturas de tarifa

Rode a mesma transação em pacotes de tarifas diferentes para comparar os resultados e escolher a melhor estrutura para o seu caso de uso.

Documentar as tarifas esperadas

Use os resultados da estimativa para criar documentação para a equipe financeira ou os clientes sobre os valores de tarifa esperados.

Depurar problemas de tarifa

Se uma transação mostrar tarifas inesperadas, use a Calculadora de Taxas para reproduzir o cenário e entender o detalhamento do cálculo.

Boas práticas


  • Teste toda a faixa de valores - não teste apenas um valor. Estime transações no mínimo, no máximo e em vários pontos intermediários.
  • Verifique a ordem de prioridade - quando os pacotes têm múltiplas tarifas, confirme que elas se aplicam na ordem esperada.
  • Verifique as contas isentas - teste com contas que o pacote de tarifas isenta. Confirme que os resultados as excluem das tarifas.
  • Documente seus testes - mantenha um registro dos resultados das estimativas para fins de auditoria e compliance.
  • Compartilhe com as partes interessadas - use os detalhamentos das estimativas para alinhar com as equipes financeiras os resultados de tarifa esperados antes de entrar em produção.

O que fazer a seguir


Depois de validar o resultado da tarifa, ajuste o Pacote de Tarifas se necessário em Editando um Pacote de Tarifas, ou crie uma Transação real em Criando uma Transação.