Antes de começar
- Habilite o Fees Engine em Configurações do Módulo Midaz.
- Você precisa de pelo menos um Pacote de Tarifas salvo.
- Você precisa dos aliases de Conta de origem e destino que quer usar no teste.
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 Tarifas para executar a estimativa.
4
Revise os resultados exibidos abaixo do formulário.
Guia de campos
A Calculadora de Tarifas é 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 Tarifas mostra um detalhamento completo do cálculo:
Totais
- Tarifa Total - a soma de todas as tarifas da transação
- Valor Líquido - o valor que o destino receberia depois das tarifas dedutíveis
Detalhamento de tarifas
Para cada regra de tarifa aplicada, você verá:Exemplos de estimativa
Estimativa de tarifa fixa simples
Estimativa de tarifa fixa simples
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
- Tarifa Total: $2,00
- Valor Líquido: $98,00 (se dedutível) ou $100,00 (se não dedutível)
Estimativa de tarifa percentual
Estimativa de tarifa percentual
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
- Tarifa Total: $7,50 (1,5% de $500)
- Cálculo: 500 × 0,015 = 7,50
Estimativa de tarifa combinada
Estimativa de tarifa combinada
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)
- Fixa: $1,00
- Percentual: 2% = $4,00
- Resultado: $4,00 (a percentual é maior)
Estimativa de múltiplas tarifas
Estimativa de múltiplas tarifas
Cenário: pacote com duas tarifas aplicadas em ordem de prioridadeTarifa A (Prioridade 1): 1% sobre o valor original
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: $4,95 (0,5% de $990)
- Tarifa Total: $14,95
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 Tarifas 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.