# Simulate a rail notification

Simulates receipt of a rail notification message.

Endpoint: POST /rail/notifications/simulate
Version: 1.0.0

## Request fields (application/json):

  - `event` (string, required)
    Event name.
    Example: "transfer.completed"

  - `data` (object, required)
    Rail notification data payload.

  - `data.amount` (object, required)
    Monetary amount payload.

  - `data.amount.amount` (integer, required)
    Amount in minor units.
    Example: 12500

  - `data.amount.currency` (string, required)
    ISO currency code.
    Example: "ZAR"

  - `data.timestamp` (string, required)
    Event timestamp.
    Example: "2026-03-06T08:00:00Z"

  - `data.notification_type` (string, required)
    Notification type received from the rail.
    Example: "PAYMENT"

  - `data.transaction_id` (string, required)
    Rail transaction identifier.
    Example: "rail-tx-123"

  - `data.transaction_type` (string, required)
    Rail transaction type.
    Example: "TRANSFER"

  - `data.account_id` (string, required)
    Related account identifier.
    Example: "6c9083ce-b9d6-4415-8ad1-e32050fc8f93"

## Response 200 fields (application/json):

  - `success` (boolean, required)
    Indicates whether the simulation succeeded.
    Example: true

  - `message` (string, required)
    Simulation result message.
    Example: "Notification processed successfully."

  - `transactionId` (string, required)
    Transaction identifier linked to the simulation.
    Example: "rail-tx-123"