Antes de começar
- Habilite o Fees Engine nas configurações do Módulo Midaz.
- Você precisa de um Ledger existente e ao menos uma Conta que possa receber valores de tarifa.
- Se o Pacote deve se aplicar apenas a uma Rota ou Segmento específico, crie esses registros primeiro.
Criar o Pacote de Taxa
1
Acesse a página Pacotes de Taxa e clique no botão Novo Pacote.
2
O formulário Novo Pacote de Taxa será aberto com várias seções para configurar.
1
Preencha a seção Basic Information.
2
Configure a seção Amount Range.
Transações fora dessa faixa não terão tarifas aplicadas por este Pacote.
3
Clique no botão Avançar.
4
Selecione uma das opções na seção Add Fee:
Flat Fee- Valor fixo independente do valor da transação.Percentage- Percentual sobre o valor da transação.Max Between Types- O maior valor entre a tarifa fixa e a percentual.
5
Adicione as informações da tarifa.
6
(Opcional) Você pode adicionar outra Regra de Taxa se necessário. Para isso, selecione um novo tipo de tarifa e preencha as informações.
7
Clique no botão Avançar.
8
(Opcional) Configure a seção Account Waivers:
- Adicione os aliases das contas que devem ficar isentas das tarifas deste Pacote.
- Clique em Adicionar para incluir cada conta isenta.
9
Clique no botão Avançar.
10
Revise as informações e confirme se está tudo correto.
11
Clique no botão Criar Pacote.
Guia de campos
Basic Information
Regras de Taxa
Cada tarifa dentro de um Pacote tem uma Prioridade (1 = aplicada primeiro). A tarifa com prioridade1 deve usar Original Amount como Valor de Referência.
Taxa Fixa
Um valor fixo aplicado à Transação independentemente do seu valor.Quando você ativa Dedutível da transação?, o formulário força Valor de Referência para
Valor Original e desabilita a opção Valor Após Taxas.Percentual
Um percentual do valor da Transação.Máximo Entre Tipos
Calcula um valor fixo e um percentual e aplica o maior resultado. O formulário exige os dois cálculos.O formulário Máximo Entre Tipos sempre exige exatamente dois cálculos: um do tipo
Taxa Fixa e outro do tipo Percentual. O Console calcula os dois e aplica o maior.Contas Isentas
Observações importantes
Ordem de prioridade das tarifas
Quando um Pacote contém várias tarifas, o Console as aplica em ordem de prioridade (menor número primeiro). Isso importa ao usarAfter Fees Amount como referência, já que tarifas anteriores afetam a base de cálculo das seguintes.
Exemplo:
- Tarifa A (Prioridade 1): 1% sobre o valor original
- Tarifa B (Prioridade 2): 0.5% sobre o valor após tarifas
- Tarifa A = $1.00 (1% de $100)
- Tarifa B = $0.495 (0.5% de $99)
Considerações sobre a faixa de valor
- As faixas não devem se sobrepor entre Pacotes para a mesma Rota de Transação.
- Use
0.01como mínimo para Pacotes que devam se aplicar a todas as transações. - Use um máximo alto (por exemplo,
999999999.99) para não ter limite superior. - A faixa inclui as Transações exatamente nos valores mínimo ou máximo.
Comportamento das contas isentas
- Contas isentas pulam todas as tarifas do Pacote, não apenas tarifas específicas.
- Use aliases de conta (não IDs) ao adicionar contas isentas.
- As isenções valem quando a conta isenta é a origem da transação.
O que fazer em seguida
Após criar o Pacote de Taxa, rode um cálculo de teste em Executando uma Estimativa de Tarifas antes de usá-lo com Transações reais.