> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Como o dinheiro se move

> Entenda o que conta como uma movimentação de dinheiro, como suas partes são chamadas e onde o dinheiro fica antes de ser finalmente liquidado.

Você já sabe que o dinheiro nunca aparece nem desaparece — ele se move de uma origem para um destino, e ambos os lados são registrados. Esta página é sobre a *movimentação* em si: o que é uma movimentação completa, como suas peças são chamadas e a parte que a maioria das pessoas acha confusa — onde o dinheiro fica enquanto uma movimentação ainda está em andamento.

Imagine entregar dinheiro em espécie sobre um balcão. No momento em que o dinheiro sai da sua mão e cai na da outra pessoa, toda a troca aconteceu como um único evento. Um sistema bancário trata a movimentação da mesma forma: uma entrega completa, registrada integralmente, tudo de uma só vez.

## Uma movimentação, registrada integralmente

***

Uma **transação** é uma movimentação completa de valor — o evento inteiro, do início ao fim. Quando um cliente envia R\$100 para um comerciante, essa única transação *é* os R\$100 trocando de mãos.

Mas você já viu que toda movimentação tem dois lados. Então uma transação é construída a partir de peças menores:

* Uma **operação** é uma parte da movimentação — um único débito ou um único crédito.
* Uma transação é feita de operações que **se balanceiam**: tudo o que é debitado é igual a tudo o que é creditado.

A transferência de R\$100 é uma transação feita de duas operações — um débito de R\$100 saindo do cliente, e um crédito de R\$100 chegando ao comerciante. Mesmo valor, direções opostas, registrados juntos.

<Tip>
  Mantenha esta palavra à mão: uma **operação é uma parte de uma movimentação**. A transação é a movimentação inteira; as operações são suas partes. Você encontrará essa palavra em todo lugar no core banking.
</Tip>

## As formas que uma movimentação pode assumir

***

A movimentação mais simples tem uma origem e um destino, mas uma única transação pode se espalhar por mais contas — e por mais partes que tenha, ela sempre se balanceia. As formas comuns:

* **Um-para-um** — uma origem, um destino. Uma transferência simples: sai do cliente, entra no comerciante.
* **Um-para-muitos** — uma origem, vários destinos. O cliente paga R\$103: R\$100 vão para o comerciante e R\$3 para uma conta de taxas. Três operações, ainda balanceadas (R\$103 de saída = R\$100 + R\$3 de entrada).
* **Muitos-para-um** — várias origens, um destino. Algumas contas reunindo dinheiro em um único fundo.
* **Muitos-para-muitos** — várias origens e vários destinos de uma vez, como um marketplace dividindo pagamentos recebidos entre vendedores e taxas.

A regra nunca muda, não importa quantas partes haja: **tudo o que sai deve ser igual a tudo o que chega.**

<Note>
  Nem todo ledger suporta as quatro formas. Sistemas mais simples podem permitir apenas movimentações um-para-um (ou um-para-muitos), enquanto outros lidam com o caso completo muitos-para-muitos em uma única transação — então o que é possível depende do ledger que você usa.
</Note>

<Note>
  Uma transação é **tudo ou nada**. Ou todas as operações têm sucesso juntas, ou nenhuma delas acontece. Os livros nunca podem ficar pela metade — essa propriedade é chamada de **atomicidade**.
</Note>

## Dinheiro em trânsito: retenções e movimentações em duas fases

***

Aqui está a parte que confunde quase todo mundo: onde o dinheiro fica *antes* de uma transação ser finalizada?

Muitas movimentações não são liquidadas no instante em que começam. O sistema primeiro **reserva** o valor — ele é separado, ainda na conta, mas não mais livre para gastar. Então a transação ou **confirma** (liquida de vez) ou **cancela** (libera a reserva). Esta é uma movimentação em **duas fases**: reservar primeiro, depois confirmar ou cancelar.

Para fazer sentido disso, o dinheiro de uma conta é descrito em duas partes:

* **Saldo disponível** — o que você pode de fato gastar agora.
* **Saldo retido** — o que está reservado para uma movimentação que ainda não terminou. Ainda é seu, apenas congelado no lugar até ser liquidado ou liberado.

<Note>
  Pense em uma pré-autorização de hotel no seu cartão. No check-in, o hotel **reserva** um valor — ele não sumiu, mas você não pode gastá-lo. No check-out a cobrança **confirma**, ou a retenção é **cancelada** e o dinheiro é liberado. Mesmo dinheiro, duas fases.
</Note>

```mermaid mermaid theme={null}
flowchart LR
  R["Reservar<br/>valor retido"] -->|"liquida"| C["Confirmar<br/>move para o destino"]
  R -->|"liberada"| X["Cancelar<br/>retorna ao disponível"]
  classDef bal fill:#fff8e1,stroke:#f4b400,color:#333;
  class R,C,X bal;
```

## Controle de gastos

***

Assim que você consegue ver o dinheiro como *disponível* versus *retido*, controlar gastos se torna natural. A qualquer momento, o dinheiro de uma conta está em um de três estados:

* **Disponível** — livre para gastar.
* **Retido** — reservado para uma movimentação em andamento (em trânsito).
* **Bloqueado** — congelado de propósito, separado para que não possa se mover de jeito nenhum.

Além disso, a movimentação pode ser limitada por **limites** — um teto de quanto pode fluir. Juntos, eles explicam a pergunta que as pessoas sempre fazem: *por que esta conta não consegue gastar?* Geralmente é porque o dinheiro está retido, bloqueado ou acima de um limite — não porque está faltando.

## Em resumo

***

* Uma **transação** é uma movimentação completa de valor — o evento inteiro.
* Uma **operação** é uma parte dela: um único débito ou crédito. Uma transação são operações que se balanceiam.
* Uma movimentação pode variar de **um-para-um** a **muitos-para-muitos**; qualquer que seja sua forma, ela é **tudo ou nada** e sempre se balanceia.
* Dinheiro em trânsito está **retido**, não sumido: uma movimentação em duas fases **reserva**, depois **confirma** ou **cancela**.
* O dinheiro de uma conta está **disponível**, **retido** ou **bloqueado**, e pode ser limitado por **limites** — isso é controle de gastos.

<Note>
  **Veja na Lerian**

  Veja essas ideias na prática: [Transações](/pt/midaz/transactions), [Operações](/pt/midaz/operations) e [Saldos](/pt/midaz/balances).
</Note>