Antes de começar
- Habilite o Fees Engine nas configurações do Módulo Midaz.
- Você precisa de pelo menos um Pacote de Taxa salvo.
- Você precisa dos aliases das Contas de origem e destino que deseja testar.
Executando uma estimativa
1
Na barra lateral do Módulo Midaz, expanda Fees Engine e clique em Calculadora.
2
Preencha a transação estimada. Consulte o Guia de campos abaixo para cada entrada.
3
Clique em Calcular Taxas para executar a estimativa.
4
Revise os resultados exibidos abaixo do formulário.
Guia de campos
A Calculadora de Taxa é uma ferramenta somente leitura. Ela não afeta o Ledger nem cria nenhuma transação. Você pode executar quantas estimativas precisar com segurança.
Entendendo os resultados
Após executar uma estimativa, a Calculadora de Taxa mostra um detalhamento do cálculo:
Resumo
- Taxa Total - A soma de todas as taxas da transação
- Valor Líquido - O valor que o destino receberia após as taxas dedutíveis
Detalhamento de taxas
Para cada Regra de Taxa aplicada, você verá:Exemplos de estimativa
Estimativa de taxa fixa simples
Estimativa de taxa fixa simples
Cenário: Testar uma taxa fixa de $2.00 em uma transferência de $100Entrada:
- Pacote de Taxa:
Standard Transfer Fee - Ativo:
USD - Valor:
100.00 - Origem:
@customer/checking - Destino:
@merchant/revenue
- Taxa Total: $2.00
- Valor Líquido: $98.00 (se dedutível) ou $100.00 (se não dedutível)
Estimativa de taxa por porcentagem
Estimativa de taxa por porcentagem
Cenário: Testar uma taxa de 1.5% em uma transferência de $500Entrada:
- Pacote de Taxa:
Percentage Transaction Fee - Ativo:
USD - Valor:
500.00 - Origem:
@customer/savings - Destino:
@vendor/payments
- Taxa Total: $7.50 (1.5% de $500)
- Cálculo: 500 × 0.015 = 7.50
Estimativa de taxa combinada
Estimativa de taxa combinada
Cenário: Testar a taxa max(flat, percentage) em valores diferentesTeste 1 - Transação pequena ($30):
- Flat: $1.00
- Percentage: 2% = $0.60
- Resultado: $1.00 (a fixa é maior)
- Flat: $1.00
- Percentage: 2% = $4.00
- Resultado: $4.00 (a porcentagem é maior)
Estimativa de múltiplas taxas
Estimativa de múltiplas taxas
Cenário: Pacote 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)
- Taxa Total: $14.95
Casos de uso para estimativa de taxas
Validar novos Pacotes de Taxa
Antes de habilitar um novo pacote de taxa, execute estimativas com vários valores de transação. Garanta que as taxas estejam corretas em toda a faixa de valores.Testar casos extremos
Estime transações nos limites mínimo e máximo dos valores para verificar o comportamento das taxas nos limites das faixas configuradas.Comparar estruturas de taxas
Execute a mesma transação por diferentes pacotes de taxa para comparar resultados e escolher a melhor estrutura para o seu caso de uso.Documentar taxas esperadas
Use os resultados das estimativas para criar documentação para a sua equipe financeira ou clientes sobre os valores de taxas esperados.Depurar problemas de taxas
Se uma transação mostrar taxas inesperadas, use a Calculadora de Taxa para reproduzir o cenário e entender o detalhamento do cálculo.Boas práticas
- Teste faixas completas de valor - 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 várias taxas, confirme se elas são aplicadas na ordem esperada.
- Verifique as Contas Isentas - Teste com contas que o pacote de taxa isenta. Confirme que os resultados as excluem das taxas.
- Documente seus testes - Mantenha um registro dos resultados das estimativas para fins de auditoria e conformidade.
- Compartilhe com stakeholders - Use os detalhamentos das estimativas para alinhar com as equipes financeiras sobre os resultados de taxas esperados antes de ir para produção.
O que fazer em seguida
Após validar o resultado da taxa, ajuste o Pacote de Taxa se necessário em Editando um Pacote de Taxa, ou crie uma Transação real em Criando uma Transação.