> ## 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.

# Criando uma Transação

> Crie uma nova Transação no Console usando o assistente 1:1 ou N:N para mover saldos de Ativos entre Contas de origem e destino por alias.

Uma Transação move valor entre Contas em um Ledger. Crie uma apenas depois que o Ativo, a conta de origem, a conta de destino e qualquer Rota Contábil necessária estiverem prontos.

## Antes de começar

***

Confirme que:

* As Contas de origem e destino existem no Ledger selecionado.
* As duas Contas usam o Ativo selecionado para a Transação.
* Você sabe o alias de cada Conta. Um `@` no início é uma convenção comum, não uma exigência.
* Contas de origem permitem envio, e contas de destino permitem recebimento.
* Se **Validar Rotas** estiver ativado, a Transação deve corresponder a uma Rota Contábil existente.

## Criar a Transação

***

**Step 1**

Na página **Transações**, clique no botão **Nova Transação**.

**Step 2**

O modal **Nova Transação** vai abrir. Selecione o tipo de transação que você quer criar:

* **Simples 1-1** - Transações usando uma origem e um destino
* **Complexa n:n** - Transações usando mais de uma origem ou destino

**Step 3**

Depois de selecionar o tipo de transação, a página **Nova Transação** abre com um formulário passo a passo:

**1. Dados da Transação**

Preencha as informações básicas da transação:

* (Opcional) Adicione uma **Descrição da Transação**
* Se **Validar Rotas** estiver ativo, selecione a **Rota de Transação**
* Digite o **Valor** (quantia) a transferir
* Selecione o **Ativo** para a transação
* (Opcional) Ative **Ignorar taxas** para registrar a transação sem executar o Fees Engine. A opção aparece somente quando o Ledger permite ignorar taxas

**Step 2**

Clique em **Continuar para a próxima etapa** para avançar para a etapa de seleção de contas.

**3. Origem / Destino**

Especifique as contas envolvidas:

* Pesquise a **conta de origem** por alias e selecione-a
* Pesquise a **conta de destino** por alias e selecione-a
* Para transações complexas, você pode adicionar várias origens e/ou destinos

> [!WARNING]
>
> Você **deve** usar o alias da conta para fazer transações. Não deixe de salvá-lo quando criar sua conta.
>
> Se você esquecer seu alias, pode encontrá-lo [editando informações da conta](https://docs.lerian.studio/pt/products/midaz/console/editing-account-information.md).

**Step 4**

Clique em **Continuar para a próxima etapa** para avançar para a etapa de operações.

**5. Operações**

Revise e ajuste os detalhes da operação:

* Para transações simples (1:1), o Console preenche os valores automaticamente
* Para transações complexas (N:N), especifique o valor de cada origem (débito) e destino (crédito)
* Expanda cada operação para adicionar uma **Descrição da Operação** opcional. Se **Validar Rotas** estiver ativo, selecione a **Rota de Operação** dela. O seletor marca as rotas de operação opcionais com um selo **Opcional**
* Adicione metadados na seção **Metadados da Transação**

> [!NOTE]
>
> Para transações complexas, a soma de todos os valores de origem deve ser igual à soma de todos os valores de destino.

> [!NOTE]
>
> Se **Validar Rotas** estiver ativo, o Console verifica a Rota de Transação em **Continuar para Revisão**. Ele verifica a rota de novo ao enviar. Selecione cada rota de operação obrigatória com lançamentos de Transação Direta em pelo menos uma operação do seu lado. Uma rota Bidirecional pode estar em qualquer lado.

**Step 4**

Quando todas as informações estiverem corretas, clique no botão **Continuar para Revisão**.

**Step 5**

O Console mostra uma página de revisão com um resumo de todas as informações da transação:

* Valor da transação e ativo
* Contas de origem e destino
* Operações individuais de débito e crédito
* Registros de metadados (se houver)

**Step 6**

Revise as informações com cuidado. Se tudo estiver correto:

* Clique em **Enviar Transação** para enviar a transação
* Clique em **Enviar e Criar outra** para enviar e iniciar imediatamente uma nova transação

**Step 7**

Se der certo, o Console mostra **Transação criada** com as operações que o Ledger registrou. Clique em **Ver Transação** para abrir a página de detalhes da transação.

## Guia de campos

***

**Dados da Transação**

| Campo | O que digitar | Exemplo |
| - | - | - |
| Descrição da Transação | Descrição comercial opcional do movimento. | `Customer payment to merchant` |
| Rota de Transação | Aparece quando **Validar Rotas** está ativo. Selecione a Rota de Transação à qual a Transação deve corresponder. | `Pix Transfer Route` |
| Ativo | Ativo usado pela Transação. Deve corresponder às Contas selecionadas. | `BRL` |
| Valor | Quantia total a mover. Para transações complexas, os totais de origem devem ser iguais aos totais de destino. | `100.00` |
| Ignorar taxas | Aparece quando o Ledger permite ignorar taxas. Ative para registrar a Transação sem executar o Fees Engine. | `Disabled` |

**Origem / Destino**

| Campo | O que digitar | Exemplo |
| - | - | - |
| Origem | Alias da conta que será debitada. | `@customer_123` |
| Destino | Alias da conta que será creditada. | `@merchant_456` |

**Operações**

| Campo | O que digitar | Exemplo |
| - | - | - |
| Descrição da Operação | Descrição opcional para a operação. | `Debit for the source account` |
| Rota de Operação | Aparece quando **Validar Rotas** está ativo. Selecione a Rota de Operação à qual este trecho da transação deve corresponder. | `Checking account validation for Pix` |
| Chave de Metadados | Nome de campo de classificação ou integração, opcional. | `externalReference` |
| Valor de Metadados | Valor da chave de metadados. | `order_98765` |

## Tipos de transação explicados

***

### Transação Simples (1:1)

Use para transferências simples entre duas contas:

* Uma conta de origem (débito)
* Uma conta de destino (crédito)
* O mesmo valor debitado e creditado

**Exemplo**: transferir US\$ 100 do Cliente A para o Comerciante B.

### Transação Complexa (N:N)

Use para transações envolvendo várias partes:

* Várias contas de origem (débitos) e/ou várias contas de destino (créditos)
* Você pode distribuir valores entre as contas
* O total de débitos deve ser igual ao total de créditos

**Exemplos**:

* Pagamento com tarifas:
  * Cliente paga US\$ 103
  * Comerciante recebe US\$ 100
  * Conta de tarifa recebe US\$ 3
* Pagamento consolidado: vários clientes financiam o pagamento de um único fornecedor

> [!TIP]
>
> Os campos na seção **Metadados da Transação** são abertos. Não há chaves ou valores padrão. Use nomes de chave consistentes em toda a sua Organização, como `externalReference`, `orderId` ou `channel`, para vincular as Transações de volta aos sistemas de origem para conciliação e auditoria.

## O que fazer a seguir

***

Depois de enviar a Transação, revise a página de detalhes e confirme o status, a operação de origem, a operação de destino e os saldos das contas.

> [card] [Criar uma Transação usando JSON](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-json.md)
>
> Crie uma Transação de forma programática com o endpoint JSON.

> [card] [Recuperar uma Transação](https://docs.lerian.studio/pt/reference/products/midaz/v2/get-transaction.md)
>
> Inspecione o status e as operações da Transação via API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.