O que são Contas Alias?
Uma Conta Alias conecta um Titular (pessoa física ou empresa) a uma conta específica do ledger do Midaz. No Midaz Module, cada conta alias armazena:
- Identificação da conta - ID do banco, agência, conta e tipo
- Referência do titular - Vínculo com o titular associado (Pessoa Física ou Jurídica)
- Vínculo com a 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 Documento do Participante, em Regulatório
- Metadados personalizados - Campos adicionais para necessidades de integração e específicas de negócio
Acessando a página de Contas Alias
Para abrir a página Contas Alias, selecione a opção Alias na seção Contas do menu lateral esquerdo. A página Contas Alias exibe uma tabela com todas as Contas Alias do seu sistema, incluindo:
- Nome do Titular - O nome do titular associado
- ID do Titular - O identificador do titular associado
- ID da Conta - O identificador da conta do ledger vinculada
- Ledger - O ledger ao qual a conta vinculada pertence
- Tipo - Classificação da conta (checking, savings etc.)
- Ações - As ações disponíveis para cada conta alias
Se você não tiver nenhuma Conta Alias, a lista aparece vazia, com uma sugestão para criar a sua primeira conta alias.
Ações disponíveis
Na página Contas Alias, você pode:Criar uma Conta Alias
Vincule um titular a uma conta do ledger do Midaz com detalhes bancários
Editar uma Conta Alias
Atualize as informações da conta e os detalhes financeiros
Excluir uma Conta Alias
Remova o vínculo 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 as informações do cliente (Pessoa Física ou Jurídica)
- Crie uma Conta Alias vinculando o titular a uma conta do ledger do Midaz
- Adicione os detalhes bancários (ID do banco, agência, conta, tipo)
- O cliente já pode transacionar usando o número de conta bancária familiar a ele
Cenários multibanco
Cenários multibanco
Quando os clientes têm contas em várias instituições:
- Crie várias Contas Alias para o mesmo Titular
- Cada conta alias referencia uma conta diferente do ledger do Midaz
- Rastreie números de conta e relacionamentos bancários diferentes
- Mantenha uma separação clara entre os 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 Documento do Participante
- Mantenha metadados para campos específicos de integração
- Sincronize as mudanças de status entre os sistemas
Boas práticas
1
Crie os titulares antes das contas alias
Sempre crie o registro do Titular primeiro e só depois crie as Contas Alias para vinculá-los às contas do ledger.
2
Use uma 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 os detalhes da instituição financeira precisos
Confirme que os IDs do banco e os outros detalhes bancários estão corretos, para o roteamento correto de pagamentos e a compliance regulatória.
4
Documente os relacionamentos entre contas
Use metadados para armazenar contexto adicional sobre os relacionamentos entre contas, especialmente em cenários multibanco ou de integração.
5
Gerencie o status adequadamente
Atualize o status da conta alias para refletir mudanças no relacionamento da conta (ativo, inativo, encerrado).

