Home
SiteDashboardInternet Bank
Home
SiteDashboardInternet Bank
  1. Modelo de dados
  • Home
  • Embedded Bank
    • Guias
    • Autenticação
    • Paginação
    • Idempotência
    • Erros
    • Data e Hora
    • Eventos e Webhooks
    • Modelo de dados
      • Entidades
      • Contas
      • Plataforma
      • Número de conta
      • Transferências
      • Pix Internacional
      • Cross-Border (Pagamentos Internacionais)
    • Conta
      • Detalhes de uma empresa
      • Criar uma Empresa
      • /entities/person
  • Gateway (Obsoleto)
    • Autenticação
      • Recebendo um token de acesso
    • Conta
      • Dados da conta
      • Visualizar saldo na conta
    • PIX
      • Pagamento
        • Iniciando e Confirmando o PIX
        • Listando Pagamentos de PIX
        • Detalhe de um Pagamento PIX
      • Recebimento
        • Criando QRCode PIX
        • Listando QRCodes
        • Detalhe de um QRCode
        • Devolvendo PIX Recebido
        • Encontrando pix pelo EndToEndId
        • Inativando um QRCode
    • Transferências
      • Consulta conta disponível transferências
      • Transferências entre contas P2P
      • Transferências entre contas P2P por Lote
      • Transferências entre contas TED
    • Boletos
      • Retornando lista de boleto emitidos
      • Emitindo um boleto
      • Cancelando um boleto
    • Pagamentos de Títulos
      • Consulta código de barras
      • Pagamento código de barras
    • Webhook
      • Criando um webhook
      • Listando webhooks
      • Removendo webhook
    • HealthCheck
      GET
  • Core
  • Esquemas
    • bussines_entity
    • Address
  1. Modelo de dados

Contas

Uma conta na Valut é um objeto financeiro capaz de armazenar, enviar e receber recursos, funcionando como um ledger em tempo real com capacidades bancárias completas.
As contas são o núcleo da infraestrutura da Valut e permitem modelar diferentes estruturas financeiras de forma flexível e escalável.

Características principais#

Ledger em tempo real (double-entry)
Suporte a múltiplas moedas (fiat e digital)
Integração com trilhos globais (ACH, Wire, SWIFT, Pix)
Alta granularidade para rastreamento de transações
Estrutura desacoplada da forma legal da conta bancária

Estrutura de Contas#

O modelo da Valut separa o conceito de conta lógica (ledger) da estrutura bancária legal, permitindo diferentes configurações:

1. Conta Bancária (DDA)#

Conta legal independente
Pode possuir um ou mais números de conta
Utilizada para movimentações reais no sistema bancário
Pode incluir cobertura regulatória (dependendo da jurisdição)

2. Conta Virtual#

Não é uma conta bancária legal
Utilizada para controle contábil interno
Ideal para:
Subcontas de clientes
Wallets
Estruturas multi-tenant

3. Conta FBO (For Benefit Of)#

Estrutura onde múltiplas entidades operam sob uma conta principal
Muito utilizada para fintechs e plataformas
Permite segregação lógica mantendo eficiência operacional

Contas da Entidade Raiz#

As contas da Entidade Raiz representam a base financeira da plataforma.
Essas contas armazenam recursos próprios da empresa e suportam toda a operação.

Contas padrão da plataforma#

Ao iniciar sua operação, algumas contas são criadas automaticamente:

Conta de Reserva de Overdraft#

Utilizada para cobrir saldos negativos de contas habilitadas
Garante liquidez operacional
Controla o limite total de exposição da plataforma

Conta de Reserva do Programa#

Utilizada para manter garantias operacionais
Percentual definido conforme volume e risco
Necessária para operações de pagamento e liquidação

Saldos da Conta#

Cada conta possui três tipos de saldo:

available_balance#

Valor disponível para uso imediato
Considera apenas fundos liquidados

pending_balance#

Valores em processamento
Inclui transferências ainda não liquidadas

locked_balance#

Fundos bloqueados
Não disponíveis para saque ou transferência
Usado para:
Garantias
Reservas
Cobertura de risco

Overdraft (Cheque Especial)#

A Valut permite habilitar contas para operar com saldo negativo (overdraft).

Regras:#

O limite depende do saldo disponível na conta de reserva da entidade raiz
O total utilizado é refletido no locked_balance da conta de reserva
Controlado centralmente pela plataforma

Boas práticas#

Utilize contas virtuais para estruturação de clientes
Separe contas por finalidade (operacional, liquidez, reserva)
Nunca misture fundos de clientes com contas da entidade raiz
Monitore saldos em tempo real para evitar inconsistências
Utilize overdraft com controle rigoroso de risco

Considerações#

A modelagem de contas na Valut é altamente flexível e será definida em conjunto com sua operação, considerando:
Estrutura legal
Requisitos regulatórios
Volume de transações
Modelo de negócio

A arquitetura de contas da Valut permite construir soluções financeiras robustas com controle total, transparência e escalabilidade global.
Modificado em 2026-04-26 00:17:52
Página anterior
Entidades
Próxima página
Plataforma
Built with