AccountDefinitionAddedEvent (v1.0.0)
Event emitted when a new account definition is added to a merchant account
AccountDefinitionAddedEvent
Published when a new account definition is successfully added to an existing merchant account’s ledger structure.
Schema
{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "title": "AccountDefinitionAddedEvent", "description": "Event emitted when a new account definition is added to a merchant account", "properties": { "accountId": { "type": "object", "description": "Account identifier", "properties": { "value": { "type": "string", "format": "uuid", "description": "The unique account UUID" } }, "required": ["value"] }, "accountDefinitionId": { "type": "integer", "description": "Account definition identifier", "example": 15652 }, "accountDefinitionName": { "type": "string", "description": "Name of the account definition", "example": "MerchantDebt" }, "timestamp": { "type": "string", "format": "date-time", "description": "Timestamp when the account definition was added" } }, "required": ["accountId", "accountDefinitionId", "accountDefinitionName", "timestamp"], "additionalProperties": false}Purpose
This event indicates that a merchant account now supports a new type of account, enabling new financial products or account categories.
Key Attributes
- Aggregate ID: Merchant account aggregate identifier
- Hierarchy: Ledger hierarchy level
- Sub Hierarchy: Sub-ledger hierarchy level
- Account Holder ID: Identifier of the merchant
- Currency: Account currency
- Definition: The new account definition (ID, type, name)
Business Impact
- Enables dynamic expansion of account types for existing merchants
- Supports introduction of new financial products
- Maintains ledger flexibility and extensibility