O que são Contas Alias?
Uma Conta Alias conecta um Titular (pessoa física ou jurídica) a uma Conta específica do Ledger Midaz. No Módulo Midaz, cada Conta Alias armazena:
- Identificação da conta - ID do banco (Bank ID), agência, conta e tipo
- Referência do Titular - Ligação com o Titular associado (Pessoa Física ou Jurídica)
- Ligação com Conta do Ledger - Conexão com a Conta subjacente do Midaz
- Detalhes bancários - Data de abertura, IBAN, código do país e o Participant Document na seção Regulatory
- Metadados customizados - Campos adicionais para integração e necessidades específicas do negócio
Acessando a página de Contas Alias
Para abrir a página de Contas Alias, selecione a opção Alias na seção Contas do menu lateral esquerdo. A página de Contas Alias exibe uma tabela listando todas as Contas Alias no seu sistema, incluindo:
- Holder Name - O nome do Titular associado
- Holder ID - O identificador do Titular associado
- Account ID - O identificador da Conta do Ledger vinculada
- Ledger - O Ledger ao qual a Conta vinculada pertence
- Type - Classificação da conta (corrente, poupança, etc.)
- Actions - As ações disponíveis para cada Conta Alias
Se você não tiver nenhuma Conta Alias, a lista aparecerá vazia com um prompt para criar sua primeira Conta Alias.
Ações disponíveis
Na página de Contas Alias, você pode:Criar uma Conta Alias
Vincular um Titular a uma Conta do Ledger Midaz com detalhes bancários
Editar uma Conta Alias
Atualizar informações da conta e detalhes financeiros
Excluir uma Conta Alias
Remover a ligação entre um Titular e uma Conta do Ledger
Casos de uso comuns
Vinculando contas de clientes
Vinculando contas de clientes
Quando um cliente abre uma conta:
- Crie um Titular com informações do cliente (Pessoa Física ou Jurídica)
- Crie uma Conta Alias vinculando o Titular a uma Conta do Ledger Midaz
- Adicione detalhes bancários (ID do banco, agência, conta, tipo)
- O cliente agora pode transacionar usando seu número de conta bancária familiar
Cenários multi-banco
Cenários multi-banco
Quando clientes têm contas em múltiplas instituições:
- Crie múltiplas Contas Alias para o mesmo Titular
- Cada Conta Alias referencia uma Conta diferente do Ledger Midaz
- Rastreie diferentes números de conta e relacionamentos bancários
- Mantenha separação clara entre relacionamentos institucionais
Integração com sistemas externos
Integração com sistemas externos
Ao integrar com sistemas bancários externos:
- Use Contas Alias para mapear números de conta externos para Contas internas do Ledger
- Armazene identificadores regulatórios como o Participant Document
- Mantenha metadados para campos específicos de integração
- Sincronize mudanças de status entre sistemas
Melhores práticas
1
Crie Titulares antes das Contas Alias
Sempre crie o registro do Titular primeiro, depois crie Contas Alias para vinculá-los às Contas do Ledger. Isso garante relacionamentos de dados adequados.
2
Use numeração de conta consistente
Siga os padrões de numeração de conta da sua instituição ao criar Contas Alias para evitar confusão e problemas de integração.
3
Mantenha detalhes da instituição financeira precisos
Garanta que os Bank IDs e demais detalhes bancários estejam corretos para roteamento adequado de pagamentos e conformidade regulatória.
4
Documente relacionamentos de conta
Use metadados para armazenar contexto adicional sobre relacionamentos de conta, especialmente em cenários multi-banco ou de integração.
5
Gerencie status apropriadamente
Atualize o status da Conta Alias para refletir mudanças no relacionamento da conta (ativo, inativo, encerrado).

