LedgerIdUpdatedEvent (v1.0.0)

Event emitted when the ledger ID reference for a merchant account is updated

LedgerIdUpdatedEvent

Published when account definition IDs are successfully updated in a merchant account ledger structure.

Schema

schema.json
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"title": "LedgerIdUpdatedEvent",
"description": "Event emitted when the ledger ID reference for a merchant account is updated",
"properties": {
"accountId": {
"type": "object",
"description": "Account identifier",
"properties": {
"value": {
"type": "string",
"format": "uuid",
"description": "The unique account UUID"
}
},
"required": ["value"]
},
"ledgerId": {
"type": "object",
"description": "Ledger identifier",
"properties": {
"value": {
"type": "string",
"format": "uuid",
"description": "The unique ledger UUID"
}
},
"required": ["value"]
},
"previousLedgerId": {
"type": "object",
"description": "Previous ledger identifier",
"properties": {
"value": {
"type": "string",
"format": "uuid",
"description": "The previous ledger UUID"
}
}
},
"timestamp": {
"type": "string",
"format": "date-time",
"description": "Timestamp when the ledger ID was updated"
}
},
"required": ["accountId", "ledgerId", "timestamp"],
"additionalProperties": false
}

Purpose

This event indicates that account definitions have been migrated from old IDs to new IDs while preserving balances and transaction history.

Key Attributes

  • Aggregate ID: Merchant account aggregate identifier
  • Old And New Account Definition Ids Map: Mapping of old account IDs to new account IDs

Business Impact

  • Enables migration of account structures
  • Supports system upgrades and configuration changes
  • Maintains data integrity during ID migrations