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

Número de conta

Na Valut, o conceito de conta é separado do número de conta, permitindo maior flexibilidade na estrutura financeira.
Enquanto sistemas bancários tradicionais vinculam diretamente um número a uma conta, na Valut:
👉 Um número de conta funciona como um identificador (ponteiro) para uma conta.

Como funciona#

Uma conta pode ter um ou vários números de conta
Cada número de conta aponta para a mesma conta (ledger)
Um número de conta é criado automaticamente ao criar uma conta
Você pode criar novos números conforme necessário

Importante#

As transações são registradas no nível da conta, não no número
Saldos e movimentações são sempre consolidados por conta

Exemplo#

Se uma conta possui 5 números diferentes:
Todos os depósitos e saques são agregados
O saldo exibido será único (não separado por número)

Casos de uso#

A utilização de múltiplos números de conta permite:
Identificação de origem de pagamentos
Diferentes canais de entrada (clientes, produtos, regiões)
Organização operacional sem criar múltiplas contas
Integrações específicas por parceiro ou fluxo

Regras de Reatribuição#

Um número de conta, uma vez criado, não pode ser reutilizado
Não é possível mover um número de conta entre contas diferentes
O vínculo entre número e conta é permanente

Futuro (Roadmap)#

A Valut evoluirá o uso de números de conta com suporte a regras avançadas, como:
Restrição de uso:
Apenas envio
Apenas recebimento
Limites:
Valor por transação
Volume total
Regras de validação:
Nome do remetente
Destinatário autorizado
Origem da transação

Boas práticas#

Utilize múltiplos números para rastreamento e organização
Não crie contas desnecessárias — use números de conta para segmentação
Planeje a estrutura considerando escala e conciliação

A separação entre conta e número de conta permite construir arquiteturas financeiras mais flexíveis, rastreáveis e escaláveis dentro da Valut.
Modificado em 2026-04-26 01:08:45
Página anterior
Plataforma
Próxima página
Transferências
Built with