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

***

<Steps>
  <Step>
    Na página **Transações**, clique no botão **Nova Transação**.
  </Step>

  <Step>
    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>

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

    <Steps>
      <Step title="Dados da Transação">
        Preencha as informações básicas da transação:

        * (Opcional) Adicione uma **Descrição** para a transação
        * (Opcional) Especifique um **Grupo de rota contábil** para classificação
        * Digite o **Valor** (quantia) a transferir
        * Selecione o **Ativo** para a transação
      </Step>

      <Step>
        Clique em **Próximo** para avançar para a etapa de seleção de contas.
      </Step>

      <Step title="Origem e 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 realizar 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](/pt/products/midaz/console/editing-account-information).
        </Warning>
      </Step>

      <Step>
        Clique em **Próximo** para avançar para a etapa de operações.
      </Step>

      <Step title="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 descrições e metadados opcionais

        <Note>
          Para transações complexas, a soma de todos os valores de origem deve ser igual à soma de todos os valores de destino.
        </Note>
      </Step>
    </Steps>
  </Step>

  <Step>
    Quando todas as informações estiverem corretas, clique no botão **Ir para Revisão**.
  </Step>

  <Step>
    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>

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

    * Clique em **Enviar Transação** para enviar e ver os detalhes da transação
    * Clique em **Enviar e Criar outra** para enviar e iniciar imediatamente uma nova transação
  </Step>

  <Step>
    Se der certo, o Console abre a página de detalhes da transação com o resumo, os dados e o status da transação.
  </Step>
</Steps>

## 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` |
| Grupo de rota contábil | Classificação de rota opcional quando sua configuração usa validação ou agrupamento de rotas.                 | `Pix Transfer Group`           |
| Rota de Transação      | Selecione a Rota de Transação associada à transação.                                                          | `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`                       |

**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`        |
| Plano de Contas       | Nome opcional do Plano de Contas ao qual a operação pertence. | `Pix debit - source`                  |
| Rota de Operação      | Rota de operação opcional para este trecho da transação.      | `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 aba Metadados 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.
</Tip>

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

<CardGroup cols={2}>
  <Card title="Criar uma Transação usando JSON" icon="code" href="/pt/reference/products/midaz/v1/create-transaction-json">
    Crie uma Transação de forma programática com o endpoint JSON.
  </Card>

  <Card title="Recuperar uma Transação" icon="file-search" href="/pt/reference/products/midaz/v2/get-transaction">
    Inspecione o status e as operações da Transação via API.
  </Card>
</CardGroup>