Account roles: Holders, Accounts, Aliases & Instruments

Midaz keeps the balance record, the party context, and the identifiers used to find an account separate. That separation makes each concern explicit.

​

Accounts hold balances and movements

An Account is the Ledger record that holds balances and receives movements. It is the transactional record.

​

Holders represent people or companies

A Holder is the CRM record for a person or company. A Holder supplies the party context that can be associated with Ledger Accounts.

​

Aliases identify Accounts

An alias is a friendly identifier for an Account. It helps people and systems refer to an Account without using its full identifier.

​

Instruments associate CRM context with Accounts

An Instrument is the CRM record that associates a Holder with a Ledger Account. It carries the ledgerId and accountId for that association and can hold banking details, regulatory fields, metadata, and related parties. An Instrument is not an alias. An alias identifies an Account. An Instrument associates Holder and CRM context with a Ledger Account.

​

Next steps