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 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
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
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.
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
Para transações complexas, a soma de todos os valores de origem deve ser igual à soma de todos os valores de destino.
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.
4
Quando todas as informações estiverem corretas, clique no botão Continuar 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 a transação
  • Clique em Enviar e Criar outra para enviar e iniciar imediatamente uma nova transação
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 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 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.

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.