Skip to main content
Usa Midaz Module para gestionar las Cuentas alias. Las Cuentas alias crean el vínculo entre los Titulares y las cuentas del ledger de Midaz. Agregan contexto de negocio, como números de cuenta bancaria y datos de la institución financiera.

​
¿Qué son las Cuentas alias?

Una Cuenta alias conecta a un Titular (persona natural o jurídica) con una cuenta específica del ledger de Midaz. En Midaz Module, cada cuenta alias almacena:
  • Identificación de la cuenta: ID del banco, sucursal, cuenta y tipo
  • Referencia al Titular: vínculo con el titular asociado (persona natural o jurídica)
  • Vínculo con la cuenta del ledger: conexión con la cuenta subyacente de Midaz
  • Datos bancarios: fecha de apertura, IBAN, código de país y el Documento de Participante bajo Regulatory
  • Metadatos personalizados: campos adicionales para necesidades de integración y de negocio
Las Cuentas alias permiten mantener separada la información de cuenta orientada al cliente del ledger transaccional. Esto da soporte a escenarios multibanco y a la integración con sistemas externos. Para más detalles técnicos sobre las capacidades subyacentes del CRM, consulta la página Resumen de CRM.

​
Acceder a la página de Cuentas alias

Para abrir la página Alias Accounts, selecciona la opción Alias en la sección Accounts del menú lateral izquierdo. La página Alias Accounts muestra una tabla con todas las Cuentas alias de tu sistema, entre ellas:
  • Holder Name: el nombre del titular asociado
  • Holder ID: el identificador del titular asociado
  • Account ID: el identificador de la cuenta del ledger vinculada
  • Ledger: el ledger al que pertenece la cuenta vinculada
  • Type: clasificación de la cuenta (checking, savings, etc.)
  • Actions: las acciones disponibles para cada cuenta alias
Si no tienes ninguna Cuenta alias, la lista aparecerá vacía con una indicación para crear tu primera cuenta alias.

​
Acciones disponibles

Desde la página Alias Accounts, puedes:

Crear una Cuenta alias

Vincula un titular con una cuenta del ledger de Midaz junto con sus datos bancarios

Editar una Cuenta alias

Actualiza la información de la cuenta y sus datos financieros

Eliminar una Cuenta alias

Elimina el vínculo entre un titular y una cuenta del ledger

​
Casos de uso comunes

Cuando un cliente abre una cuenta:
  1. Crea un Titular con la información del cliente (persona natural o jurídica)
  2. Crea una Cuenta alias que vincule al titular con una cuenta del ledger de Midaz
  3. Agrega los datos bancarios (ID del banco, sucursal, cuenta, tipo)
  4. El cliente ya puede operar usando el número de cuenta bancaria que conoce
Cuando los clientes tienen cuentas en varias instituciones:
  • Crea varias Cuentas alias para el mismo Titular
  • Cada cuenta alias referencia una cuenta distinta del ledger de Midaz
  • Da seguimiento a los distintos números de cuenta y relaciones bancarias
  • Mantén una separación clara entre las relaciones institucionales
Al integrarte con sistemas bancarios externos:
  • Usa las Cuentas alias para mapear números de cuenta externos a cuentas internas del ledger
  • Guarda identificadores regulatorios, como el Documento de Participante
  • Mantén metadatos para campos específicos de la integración
  • Sincroniza los cambios de estado entre sistemas

​
Mejores prácticas

1

Crea los Titulares antes que las Cuentas alias

Crea siempre primero el registro del Titular y luego las Cuentas alias que lo vinculen con las cuentas del ledger.
2

Usa una numeración de cuenta consistente

Sigue los estándares de numeración de cuentas de tu institución al crear Cuentas alias, para evitar confusiones y problemas de integración.
3

Mantén exactos los datos de la institución financiera

Confirma que los IDs de banco y demás datos bancarios sean correctos para un enrutamiento de pagos adecuado y el cumplimiento regulatorio.
4

Documenta las relaciones de cuenta

Usa metadatos para guardar contexto adicional sobre las relaciones de cuenta, sobre todo en escenarios multibanco o de integración.
5

Gestiona el estado correctamente

Actualiza el estado de la Cuenta alias para reflejar los cambios en la relación de cuenta (active, inactive, closed).