- Quais Contas podem atuar no lado de origem?
- Quais Contas podem atuar no lado de destino?
- Quais lançamentos de débito e crédito a rota registra quando a Transação é executada?
Pix transfer pode exigir uma Conta customer no lado de origem e uma Conta merchant no lado de destino. Em seguida, a rota define lançamentos diretos de débito e crédito entre as duas. Quando a validação de rotas está habilitada, uma transação Pix que referencia a rota valida as Contas e aplica as regras configuradas.
As Rotas Contábeis fornecem validação opcional de rotas. O Midaz só a aplica quando a configuração do Ledger accounting.validateRoutes está habilitada (padrão: false). Quando habilitada, as Transações devem referenciar rotas válidas e as Operações devem cumprir as regras configuradas. As rotas são mais fáceis de modelar quando você já sabe quais Contas representam clientes, treasury, fees, settlement, revenues e expenses.
Como as peças se encaixam
Escolhendo o tipo de operação
Use Source quando a regra se aplica apenas ao lado de envio
Use Source quando a regra se aplica apenas ao lado de envio
Use Source para Contas onde o valor se origina.Exemplo: uma Conta de cliente pode enviar fundos em um fluxo de pagamento.
Use Destination quando a regra se aplica apenas ao lado de recebimento
Use Destination quando a regra se aplica apenas ao lado de recebimento
Use Destination para Contas onde o valor chega.Exemplo: uma Conta de merchant pode receber fundos em um fluxo de pagamento.
Use Bidirectional quando a mesma regra vale para os dois lados
Use Bidirectional quando a mesma regra vale para os dois lados
Use Bidirectional quando a mesma classe de Conta pode enviar e receber.Exemplo: Contas checking podem transferir valor para outras Contas checking.
Uma Rota deve incluir uma Rota de Operação Source e uma Destination, ou ao menos uma Rota de Operação Bidirectional.
Escolhendo a regra de validação
Uma Rota de Operação pode incluir opcionalmente uma regra de conta: Tipos de Conta registrados ou um
@Alias. O Midaz aplica uma regra presente quando a validação de rotas está habilitada. Use validação por Tipo de Conta para fluxos escaláveis. Use validação por alias para Contas operacionais fixas, como treasury, fee, settlement ou suspense.
Padrões comuns de Rota
Cliente para comerciante
Use Rotas Source e Destination separadas quando cada lado tem um papel diferente.Transferência peer-to-peer
Use uma Rota Bidirectional quando o mesmo Tipo de Conta pode ser origem e destino.Cobrança de taxas
Use uma Rota Destination com validação por alias quando as taxas precisam sempre cair em uma única Conta operacional.Cenários contábeis
Páginas disponíveis
Configurando a contabilidade na Console
Um guia passo a passo, centrado na Console, para construir seu modelo contábil — do plano de contas até um pagamento Pix funcionando, sem chamadas de API.
Gerenciar Rotas Contábeis
Configure Rotas de Transação com Rotas de Operação e cenários contábeis em um assistente unificado.

