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: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#
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:
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