Pular para o conteúdo principal
As regras de tarifas definem como o Matcher calcula e aplica tarifas durante o processo de conciliação. Use regras de tarifas para modelar taxas de transação, cobranças de serviço e deduções esperadas que afetam os resultados da conciliação.

​
O que as regras de tarifas resolvem

A conciliação falha quando um lado de uma transação inclui tarifas ou cobranças que o outro lado não registra. Um gateway de pagamento deduz uma taxa de processamento antes de liquidar. Um banco cobra uma tarifa de transferência bancária. Um adquirente desconta taxas dos pagamentos. Sem regras de tarifas, o Matcher trata essas diferenças como discrepâncias de valor e gera exceções — mesmo quando a diferença é esperada e documentada. As regras de tarifas informam ao Matcher quais tarifas esperar, para que ele possa conciliar corretamente apesar da diferença de valor.

​
Como as regras de tarifas funcionam

As regras de tarifas são associadas a um contexto de conciliação. Quando o Matcher é executado, ele avalia as regras de tarifas aplicáveis e ajusta os valores esperados antes de comparar transações entre fontes. Esse ajuste acontece antes da avaliação das regras de conciliação. Uma transação que de outra forma ficaria fora da tolerância pode conciliar corretamente uma vez que a tarifa conhecida é considerada. As regras de tarifas reduzem exceções falsas causadas por cobranças previsíveis e recorrentes. Em vez de resolver manualmente centenas de diferenças esperadas de tarifas por dia, sua equipe se concentra em discrepâncias reais.

​
Estrutura de uma regra de tarifa

CampoDescrição
NomeRótulo descritivo para a regra de tarifa. Use nomes que identifiquem a origem da tarifa (ex., “Taxa de processamento do gateway”).
TipoA categoria da tarifa: processing, service_charge, wire_fee, acquirer_fee ou custom.
Método de cálculoComo a tarifa é calculada: flat (valor fixo) ou percentage (porcentagem do valor da transação).
Valor / TaxaO valor da tarifa. Para tarifas fixas, o valor fixo. Para tarifas percentuais, a taxa (ex., 2.5 para 2.5%).
Aplicado aQual lado do match ajustar: a transação de origem, a transação de destino, ou ambas.
CondiçõesFiltros opcionais que restringem quando a regra se aplica — por fonte, faixa de valor, moeda ou tipo de transação.
AtivaSe a regra está atualmente em uso. Regras inativas são mantidas mas não avaliadas.

​
Criação de uma regra de tarifa

Este exemplo cria uma regra de tarifa para um gateway de pagamento que deduz uma taxa de processamento de 2.5% das liquidações antes de creditar a conta do lojista. 
curl -X POST "https://api.matcher.example.com/v1/config/contexts/{contextId}/fee-rules" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Taxa de processamento do gateway — 2.5%",
    "type": "processing",
    "calculationMethod": "percentage",
    "rate": 2.5,
    "appliedTo": "target",
    "conditions": {
      "sourceId": "src_gateway_001",
      "currencyCode": "BRL"
    },
    "active": true
  }'
Referência API: Criar regra de tarifa

​
Gerenciamento de regras de tarifas

OperaçãoDescrição
Listar regras de tarifasObter todas as regras de tarifas de um contexto, com filtros opcionais.
Consultar uma regra de tarifaObter a configuração completa de uma regra de tarifa específica por ID.
Atualizar uma regra de tarifaModificar taxa, condições ou status sem recriar a regra.
Excluir uma regra de tarifaRemover uma regra de tarifa permanentemente. Considere desativar em vez de excluir para preservar o histórico de auditoria.
Referência API: Listar regras de tarifas · Consultar regra de tarifa · Atualizar regra de tarifa · Excluir regra de tarifa

​
Melhores práticas

Identifique os tipos de tarifas que geram mais exceções hoje. Modele esses primeiro. Uma única regra de tarifa bem configurada cobrindo uma cobrança comum elimina mais trabalho manual do que cinco regras cobrindo casos extremos.
Nomes como “Taxa de processamento do gateway — 2.5%” são mais úteis do que “Regra de tarifa 1”. Ao revisar exceções ou auditar conciliações, um nome claro conta a história sem precisar abrir a configuração.
As taxas mudam quando contratos de pagamento são renegociados. Uma regra de tarifa com uma taxa desatualizada gera exceções em vez de preveni-las. Programe uma revisão trimestral — ou acione uma cada vez que um contrato com um provedor de pagamentos for renovado.
Uma regra de tarifa sem condições se aplica a todas as transações do contexto. Regras específicas com filtros de fonte, códigos de moeda ou faixas de valor previnem ajustes indesejados. Regras amplas são mais difíceis de auditar.
Antes de ativar uma nova regra de tarifa em produção, execute-a contra uma amostra de transações recentes. Confirme que ela resolve as exceções esperadas sem criar novas. Desative em vez de excluir regras sobre as quais você não tem certeza — você pode reativar sem reconfigurar.

​
Próximos passos

Regras de conciliação

A pontuação de confiança considera os ajustes de tarifas ao avaliar a qualidade da conciliação.

Roteamento de exceções

Encaminhe as exceções que as regras de tarifas não cobrem para as equipes corretas.

Referência API de regras de tarifas

Referência completa da API para os endpoints de regras de tarifas.