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.json
{
"$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