- Quais Contas são permitidas no lado de origem?
- Quais Contas são permitidas no lado de destino?
- Quais lançamentos de débito e crédito devem ser registrados quando a Transação é executada?
Pix transfer pode exigir que a origem seja uma Conta do tipo customer e o destino uma Conta do tipo merchant e, em seguida, registrar um lançamento direto de débito e crédito entre as duas. Quando alguém cria uma transação Pix no Midaz, é a rota que valida as Contas e grava os lançamentos.
Configure as Rotas Contábeis depois de ter as Contas principais e os Tipos de Conta já definidos — 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
| Peça | O que controla | Exemplo |
|---|---|---|
| Rota Contábil | A Rota em nível de Transação que agrupa as Rotas de Operação. | Pix transfer route |
| Rota de Operação | O lado da Conta e a regra de validação. | Source deve ser customer, Destination deve ser merchant |
| Regra de validação | Como o Midaz decide se uma Conta pode ser usada. | Tipo de Conta customer ou alias @treasury_main |
| Cenário contábil | Quais lançamentos de débito e crédito são registrados durante o ciclo de vida da Transação. | Direct, Two-Step, Reversal, Overdraft |
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 precisa ter pelo menos uma Rota de Operação Source e uma Destination, ou uma Rota de Operação Bidirectional.
Escolhendo a regra de validação
| Tipo de validação | Quando usar | Exemplo |
|---|---|---|
| Tipo de Conta | Qualquer Conta de uma classe deve ser válida. | Qualquer Conta customer pode enviar. |
| Alias | Apenas uma Conta exata deve ser válida. | Somente @treasury_main pode enviar. |
| Sem validação | Você quer, propositalmente, não validar a Conta nesse nível da Rota. | Raro; use com cuidado. |
Padrões comuns de Rota
Cliente para comerciante
Use Rotas Source e Destination separadas quando cada lado tem um papel diferente.| Rota de Operação | Validação |
|---|---|
| Source | Tipo de Conta customer |
| Destination | Tipo de Conta merchant |
Transferência peer-to-peer
Use uma Rota Bidirectional quando o mesmo Tipo de Conta pode ser origem e destino.| Rota de Operação | Validação |
|---|---|
| Bidirectional | Tipo de Conta customer |
Cobrança de taxas
Use uma Rota Destination com validação por alias quando as taxas precisam sempre cair em uma única Conta operacional.| Rota de Operação | Validação |
|---|---|
| Source | Tipo de Conta customer |
| Destination | Alias @fee_revenue |
Cenários contábeis
| Cenário | Quando usar | O que o usuário configura |
|---|---|---|
| Direct Transaction | O movimento é executado em uma única etapa. | Lançamentos de débito e crédito para registro imediato. |
| Two-Step Transaction | O movimento tem fases de hold, commit e cancel. | Lançamentos para reserva, confirmação e cancelamento. |
| Reversal | Uma Transação concluída pode precisar ser estornada. | Lançamentos de débito e crédito para o evento de estorno. |
| Overdraft | Um débito pode exceder os fundos disponíveis da Conta, usando uma linha de cheque especial. | Lançamentos de débito e crédito para o uso do overdraft e a posterior quitação. |
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.