Skip to main content
Uma operação é a menor unidade de uma transação. Cada transação contém duas ou mais operações (Figura 1). Cada operação registra uma alteração no saldo de uma conta:
  • Uma operação de Débito registra valor que sai de uma conta — a origem.
  • Uma operação de Crédito registra valor que entra em uma conta — o destino.
O efeito sobre o saldo armazenado depende da direction do saldo. Uma conta normal (o caso comum) diminui com um débito e aumenta com um crédito. Uma transação é um conjunto de operações que deve ter saldo zero da perspectiva do ledger. Por exemplo, um pagamento P2P com taxa inclui:
  • um débito de $100 da conta do remetente.
  • um crédito de $98 na conta do destinatário.
  • um crédito de $2 na conta de taxas da plataforma.
O Midaz garante que uma transação esteja balanceada antes de confirmá-la. As operações também carregam metadados como timestamps e referências à transação à qual pertencem. Você cria uma transação através da API JSON do Midaz. Para cada transação, você especifica um conjunto de operações. Cada operação tem um valor, um ativo e uma conta de origem ou destino. O Midaz então verifica que as operações estejam balanceadas antes de confirmá-las.

​
Características principais

  • Cada operação pertence a uma transação e referencia uma conta e ativo específicos.
  • As operações incluem metadados como valor, direção (débito/crédito), tipo, timestamps, referências e mais.
  • O Midaz cria as operações quando você inicia uma transação e as preenche com os dados que você fornece.
  • O Midaz valida todas as operações contra as regras configuradas antes de confirmá-las no ledger.
Toda operação tem uma direction (debit ou credit) e um type. A direction é a base das partidas dobradas descrita acima. O type classifica a movimentação. Além dos padrão CREDIT e DEBIT, o type marca movimentações especiais:
  • ON_HOLD e RELEASE — reservas de fundos em duas fases.
  • OVERDRAFT — operações acompanhantes geradas pelo sistema no saldo interno de overdraft.
  • BLOCK e UNBLOCK — o rótulo aplicado a todas as operações de uma transação criada pelos endpoints dedicados de bloqueio e desbloqueio. O rótulo sobrescreve apenas o type da operação, nunca a direção nem o valor.
A direction sempre mantém seu significado de débito ou crédito, independentemente do type.

​
Rotas de Operação

Com as Rotas Contábeis, cada operação se conecta à lógica de validação estruturada. Essa lógica vive nas Rotas de Operação.

​
O que é uma Rota de Operação?

Uma Rota de Operação é uma regra de validação. Ela define quais tipos de conta ou contas específicas um componente de transação pode usar. Ela também define a direção contábil (origem ou destino) e uma anotação descritiva. Ela funciona como uma camada de validação entre a entrada da transação e a estrutura do ledger. Cada operação que você envia deve atender aos requisitos de conta e às regras de negócio.
Resumindo: as transações contêm múltiplas operações. As Rotas de Operação validam cada operação contra as regras de validação configuradas.

​
Relacionamento Operação > Rota de Operação

Quando você envia uma transação ao Midaz, ela contém múltiplas Operações. Com os Tipos de Conta e as Rotas Contábeis habilitados, o Midaz valida cada operação contra as regras das Rotas de Operação. Isso garante que:
  • A conta especificada corresponde ao tipo de conta esperado ou ao requisito de conta específica.
  • A direção da operação (débito/crédito) está alinhada com a definição da rota.
Isso adiciona uma camada de validação, consistência e integridade ao processamento de transações. Importa principalmente para requisitos financeiros estruturados.
Se as operações que você envia não corresponderem aos requisitos da Rota de Operação configurada, o Midaz falha a validação e rejeita a transação.

​
Gerenciando Operações

O Midaz gera as operações automaticamente como parte do fluxo de uma transação. Você não pode criar uma operação diretamente. Você pode consultar uma operação conforme necessário.