Skip to main content
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

1
Na página Transações, clique no botão Nova Transação.
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
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 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
2
Clique em Próximo para avançar para a etapa de seleção de contas.
3

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
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.
4
Clique em Próximo 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 descrições e metadados opcionais
Para transações complexas, a soma de todos os valores de origem deve ser igual à soma de todos os valores de destino.
4
Quando todas as informações estiverem corretas, clique no botão Ir para Revisão.
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)
6
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
7
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.

​
Guia de campos

Dados da Transação Origem/Destino Operações

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

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

Criar uma Transação usando JSON

Crie uma Transação de forma programática com o endpoint JSON.

Recuperar uma Transação

Inspecione o status e as operações da Transação via API.