AccountCreatedEvent

Published when a new MerchantAccount aggregate is successfully created in the accounting system.

Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "AccountCreatedEvent",
  "description": "Event emitted when a new merchant account aggregate is created",
  "properties": {
    "accountId": {
      "type": "object",
      "description": "Account identifier",
      "properties": {
        "value": {
          "type": "string",
          "format": "uuid",
          "description": "The unique account UUID"
        }
      },
      "required": ["value"]
    },
    "ownerId": {
      "type": "object",
      "description": "Owner identifier",
      "properties": {
        "value": {
          "type": "string",
          "format": "uuid",
          "description": "The unique owner UUID"
        }
      },
      "required": ["value"]
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "The currency in which the account operates (ISO 4217, 3 characters)",
      "example": "EUR"
    },
    "delay": {
      "type": "integer",
      "description": "Delay configuration for the account",
      "example": 2
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Country code where the account operates (ISO 3166, 3 characters)",
      "example": "NOR"
    },
    "iban": {
      "type": "string",
      "maxLength": 34,
      "description": "International Bank Account Number",
      "example": "NO9386011117947"
    },
    "bic": {
      "type": "string",
      "maxLength": 34,
      "description": "Bank Identifier Code",
      "example": "DNBANOKKXXX"
    },
    "bookkeepingConfigId": {
      "type": "integer",
      "description": "Bookkeeping configuration identifier",
      "example": 15656
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the account was created"
    }
  },
  "required": ["accountId", "ownerId", "currency", "delay", "country", "iban", "bic", "bookkeepingConfigId", "timestamp"],
  "additionalProperties": false
}

Purpose

This event indicates that a new merchant account has been established with the necessary configuration for financial transaction processing. It serves as the foundation for all subsequent accounting operations for the merchant.

Key Attributes

Account ID: Unique identifier for the newly created merchant account (UUID)
Owner ID: Reference to the account owner (merchant)
Currency: The currency in which the account operates (ISO 4217)
Country: Country code where the account is registered (ISO 3166)
IBAN: International Bank Account Number for the account
BIC: Bank Identifier Code for the financial institution
Delay Configuration: Settlement delay settings for the account

Business Impact

Account Activation: Merchant account is now ready for transaction processing
Transaction Enablement: Enables booking of payments, refunds, and fees
Balance Tracking: Initializes balance tracking for various account types
Compliance Setup: Establishes regulatory and operational parameters

Integration Points

This event is consumed by:

Balance Views: For account balance reporting and monitoring
Transaction Processing: To validate account existence before processing
Settlement Services: For settlement configuration and processing
Reporting Systems: For merchant account analytics and reporting

Account Initialization

Upon account creation, the following capabilities are established:

Double-Entry Bookkeeping: Account supports proper accounting principles
Multi-Currency Support: If configured for multiple currencies
Balance Categories: Support for different balance types (MerchantDebt, ClientFunds, etc.)
Transaction Types: Ready to process various transaction categories

AccountCreatedEvent (v1.0.0)

Event emitted when a new merchant account aggregate is created