Pricing and Discount Messages
Messages that represent a change or an action performed on a Cart Discount, Discount Code, or Standalone Price.
Messages are available in a variety of Message Types specific to a resource. Common fields across all Message Types are represented by a base resource, Message.
You can access Messages either by querying the Messages API, or by subscribing to them with a Subscription. To query Messages using the API, you must enable the feature first.
For Embedded Price related Messages, see the Product Catalog Messages page.
Cart Discount Messages
Messages that represent a change or an action performed on a Cart Discount.
Cart Discount Created
Generated after a successful Create CartDiscount request.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "CartDiscountCreated"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
cartDiscount | The Cart Discount that was created. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Cart Discount Deleted
Generated after a successful Delete CartDiscount request.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "CartDiscountDeleted"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Cart Discount Store Added
Generated after a successful Add Store update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "CartDiscountStoreAdded"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
store | The Store that was added to the Cart Discount. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Cart Discount Store Removed
Generated after a successful Remove Store update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "CartDiscountStoreRemoved"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
store | The Store that was removed from the Cart Discount. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Cart Discount Stores Set
Generated after a successful Set Stores update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "CartDiscountStoresSet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
storesArray of StoreKeyReference | Stores of the Cart Discount after the Set Stores update action. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Discount Code Messages
Messages that represent a change or an action performed on a Discount Code.
Discount Code Created
Generated after a successful Create DiscountCode request.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "DiscountCodeCreated"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
discountCode | The Discount Code that was created. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Discount Code Deleted
Generated after a successful Delete DiscountCode request.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "DiscountCodeDeleted"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Discount Code Key Set
Generated after a successful Set Key update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
keyString |
2MaxLength: 256Pattern: ^[A-Za-z0-9_-]+$ |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "DiscountCodeKeySet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
oldKeyString |
2MaxLength: 256Pattern: ^[A-Za-z0-9_-]+$ |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Messages
Messages that represent a change or an action performed on a StandalonePrice.
Standalone Price Created
Generated after a successful Create StandalonePrice request.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceCreated"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
standalonePrice | Standalone Price that was created. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Deleted
Generated after a successful Delete StandalonePrice request.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceDeleted"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
skuString | SKU of the ProductVariant to which the deleted Standalone Price was associated. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Value Changed
Generated after a successful Change Value update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceValueChanged"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
value | The new value of the updated StandalonePrice. |
stagedBoolean | Whether the new value was applied to the current or the staged representation of the StandalonePrice. Staged changes are stored on the StagedStandalonePrice. Default:false |
oldValue | The old value of the updated StandalonePrice. Present on Messages created after 3 February 2023. Optional for backwards compatibility. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Key Set
Generated after a successful Set Key update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
keyString |
2MaxLength: 256Pattern: ^[A-Za-z0-9_-]+$ |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceKeySet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
oldKeyString |
2MaxLength: 256Pattern: ^[A-Za-z0-9_-]+$ |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Discount Set
Generated after a Product Discount is successfully applied to a StandalonePrice.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceDiscountSet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
discounted | The new |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price External Discount Set
Generated after a successful Set Discounted Price update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceExternalDiscountSet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
discounted | The |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Staged Changes Applied
Generated after a successful Apply Staged Changes update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceStagedChangesApplied"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
stagedChanges | Applied changes of the StandalonePrice after the Apply Staged Changes update action. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Staged Changes Removed
Generated after a successful Remove Staged Changes update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceStagedChangesRemoved"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
stagedChanges | Removed changes of the StandalonePrice after the Remove Staged Changes update action. |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Active Changed
Generated after a successful Change Active update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceActiveChanged"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
activeBoolean | Value of the |
oldActiveBoolean | Value of the |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Valid From Set
Generated after a successful Set Valid From update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceValidFromSet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
validFrom | Value of StandalonePrice |
previousValidFrom | Value of StandalonePrice |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Valid Until Set
Generated after a successful Set Valid Until update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceValidUntilSet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
validUntil | Value of StandalonePrice |
previousValidUntil | Value of StandalonePrice |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Valid From and Until Set
Generated after a successful Set Valid From and Until update action.
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceValidFromAndUntilSet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
validFrom | Value of StandalonePrice |
previousValidFrom | Value of StandalonePrice |
validUntil | Value of StandalonePrice |
previousValidUntil | Value of StandalonePrice |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Tier Added
Generated after a successful Add Price Tier update action
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceTierAdded"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
tier | The Price Tier that has been added to the array field |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Tier Removed
Generated after a successful Remove Price Tier update action
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceTierRemoved"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
removedTier | The Price Tier that has been removed from the array field |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |
Standalone Price Tiers Set
Generated after a successful Set Price Tier update action
idString | Unique identifier of the Message. Can be used to track which Messages have been processed. |
versionInt | Version of a resource. In case of Messages, this is always |
sequenceNumberInt | Message number in relation to other Messages for a given resource. The |
resource | Reference to the resource on which the change or action was performed. |
resourceVersionInt | Version of the resource on which the change or action was performed. |
typeString | "StandalonePriceTiersSet"Message Type of the Message. |
resourceUserProvidedIdentifiers | User-provided identifiers of the resource, such as |
tiersArray of PriceTier | The updated content of the field |
previousTiersArray of PriceTier | The previous content of the field |
createdAt | Date and time (UTC) the Message was generated. |
createdByBETA | IDs and references that created the Message. |
lastModifiedAt | Value of |
lastModifiedByBETA | IDs and references that last modified the Message. |