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

Entidades

Uma entidade na Valut representa uma pessoa física ou jurídica com identidade legal própria dentro da plataforma.
As entidades são a base para:
Abertura de contas
Execução de transações
Gestão de ativos financeiros
Operações de pagamento e liquidação

Uso das Entidades#

Dependendo do seu modelo de negócio, você deverá criar entidades para:
Clientes finais (PF ou PJ)
Empresas da sua plataforma
Estruturas internas (tesouraria, liquidez, etc.)
Na maioria dos casos, as entidades devem passar por processos de:
KYC (Know Your Customer) – Pessoa Física
KYB (Know Your Business) – Pessoa Jurídica
⚠️ A Valut exige que sua plataforma implemente processos próprios de KYC/KYB ou utilize provedores especializados.
Nossos parceiros e equipe de compliance irão revisar e aprovar sua estrutura.

Entidade Raiz (Root Entity)#

A Entidade Raiz é uma entidade especial que representa sua empresa dentro da Valut.
Ela possui privilégios exclusivos e é utilizada como base para toda a operação financeira.

Capacidades da Entidade Raiz#

A entidade raiz pode:
Ser titular de contas principais (master accounts)
Controlar fluxos de liquidez da plataforma
Operar contas operacionais e de liquidação
Gerenciar reservas e garantias

Tipos de contas associadas#

As contas vinculadas à entidade raiz podem incluir:
Contas operacionais (movimentação principal)
Contas de liquidez / tesouraria
Contas de reserva (risk / antifraude)
Contas de cobertura (overdraft / fallback)
Contas de programas (ex: fidelidade, crédito, etc.)

Limitações#

É permitida apenas uma entidade raiz por ambiente:
Sandbox (teste)
Produção (live)

Criação da Entidade Raiz#

Criada automaticamente durante o onboarding da sua empresa
Disponível após aprovação de compliance e ativação do ambiente de produção

Boas práticas#

Separe entidades por cliente ou unidade de negócio
Não utilize a entidade raiz para operações de clientes finais
Estruture corretamente KYC/KYB antes de iniciar operações
Utilize entidades para segmentar risco, compliance e contabilidade

A modelagem correta de entidades é fundamental para garantir escala, compliance e rastreabilidade dentro da Valut.
Modificado em 2026-04-26 00:18:00
Página anterior
Eventos e Webhooks
Próxima página
Contas
Built with