Skip to main content
Uma Transação movimenta valor entre Contas em um Ledger. Crie uma somente após o Ativo, a conta de origem, a conta de destino e qualquer Rota Contábil necessária estarem prontos.

​
Antes de começar

Confirme que:
  • As Contas de origem e destino existem no Ledger selecionado.
  • Ambas as Contas usam o Ativo selecionado para a Transação.
  • Você conhece o alias de cada Conta.
  • As contas de origem permitem envio e as 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 será aberto. Selecione o tipo de transação que deseja criar:
  • Simples 1:1 - Transações com uma origem e um destino
  • Complexa n:n - Transações com mais de uma origem ou destino
3
Após 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
  • Informe o Valor 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 pelo alias e selecione-a
  • Pesquise a conta de destino pelo alias e selecione-a
  • Em transações complexas, você pode adicionar várias origens e/ou destinos
Você precisa usar o alias da conta para realizar transações. Certifique-se de salvá-lo ao criar a conta.Se esquecer o alias, você pode encontrá-lo editando as 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:
  • Em transações simples (1:1), o Console preenche os valores automaticamente
  • Em transações complexas (n:n), especifique o valor para cada origem (débito) e destino (crédito)
  • Expanda cada operação para adicionar descrições e metadados opcionais
Em 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 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 e Ativo da transação
  • 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 atenção. 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
Em caso de sucesso, o Console abre a página de detalhes da transação com o resumo, os dados e o status.

​
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 diretas entre duas contas:
  • Uma conta de origem (débito)
  • Uma conta de destino (crédito)
  • Mesmo valor debitado e creditado
Exemplo: Transferir $100 do Customer A para o Merchant B.

​
Transação Complexa (n:n)

Use para transações que envolvem múltiplas partes:
  • Várias contas de origem (débitos) e/ou várias contas de destino (créditos)
  • Você pode distribuir os valores entre contas
  • O total de débitos deve ser igual ao total de créditos
Exemplos:
  • Pagamento com taxas:
    • O cliente paga $103
    • O estabelecimento recebe $100
    • A conta de taxas recebe $3
  • Pagamento consolidado: Vários clientes financiam um único pagamento a fornecedor
Os campos na aba Metadados são abertos. Não há chaves ou valores padrão. Use nomes de chaves consistentes em toda a sua Organização, como externalReference, orderId ou channel, para vincular as Transações aos sistemas de origem para reconciliação e auditoria.

​
O que fazer em seguida

Após 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 programaticamente com o endpoint JSON.

Recuperar uma Transação

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