Notification Handling (hidden)

Overview

The Checkout API supports a flexible notification system across all state endpoints (e.g., orderState, orderOptions, etc.). These notifications serve as a mechanism to inform the frontend—and ultimately the customer—about important contextual feedback during the checkout process.

Where Notifications Appear

Notifications are returned at the top-level of the response JSON object under the property:

json

Copy

{
    "notifications": []
}

This array may contain zero or more notification objects, each of which conveys a specific message relevant to the current request or customer state.

Notification Structure

Each notification contains:

Example:

json

Copy

{
  "id": "e5aee158b584b930c6ec89db69a1560e01ebcf69f76761e5ca330435204cc0aa",
  "textTranslationKey": "payment.voucher.notifications.notFound",
  "type": "error"
}

Notification Types

• notification – Informational; no action required.
• warning – Indicates a possible issue, but not blocking.
• error – Indicates a critical issue that may block progress or require immediate attention.

Available notifications