Update the openapi spec for the product.update webhook

Author: wjdp

features/product-catalog.mdx

@@ -223,7 +223,7 @@ The response will include a `pagination` object with the following fields. You c
 
 ## Keeping your catalog in sync
 
-If you need to maintain a copy of your product catalog in your system you can use the [product update webhook](/reference/2024-02-05/webhook/product.update) to keep it synchronized with Runa's system.
+If you maintain a copy of the product catalog in your system you can use the [product update webhook](/reference/2024-02-05/webhook/product.update) to keep it synchronized and avoid order failures.
 
 <Card
   title="How to implement real-time product updates"

features/realtime-product-updates.mdx

@@ -4,11 +4,13 @@ description: "Using webhooks to get real-time updates on product catalog changes
 icon: "webhook"
 ---
 
-Instead of polling the product catalog for changes, you can use the `product.update` webhook to get real-time update pushed to your system when a product is added, updated or removed from your catalog. If multiple products are updated at once, an event is triggered for each product.
+Instead of polling the product catalog for changes, you can use the `product.update` webhook to get real-time update pushed to your system when a product is added, updated or removed from your catalog.
 
 ## How to use the `product.update` webhook
 
-If you maintain a copy of the product catalog in your system, you can use the `product.update` webhook to keep it synchronized with Runa's system and minimize order failures. Attempts to order a product that is no longer available or for a denomination that is no longer available will be rejected. If you subscribe to the webhook, you will receive an event for each product that is updated and can take action to avoid these rejections.
+An event is triggered when there is an update to a product in the catalog. If multiple products are updated at once, an event is triggered for each product. This can be a product being added, updated or removed from the catalog.
+
+Attempts to order a product that is no longer available or for a denomination that is no longer available will be rejected. If you subscribe to the webhook, you will receive an event for each product that is updated and can take action to avoid these rejections.
 
 We won't cover the generic details of how to set up a webhook subscription, but you can read about that in the [webhook reference](/reference/webhooks).
 

reference/2024-02-05/openapi.json

@@ -1587,10 +1587,12 @@
         "required": ["price_multiplier", "is_orderable"],
         "properties": {
           "price_multiplier": {
-            "type": "string",
-            "example": "0.8"
+            "$ref": "#/components/schemas/ProductDiscountMultiplier"
           },
-          "is_orderable": { "$ref": "#/components/schemas/ProductIsOrderable" }
+          "is_orderable": { "$ref": "#/components/schemas/ProductIsOrderable" },
+          "denominations": {
+            "$ref": "#/components/schemas/ProductDenominations"
+          }
         }
       },
       "PayoutStatus": {
@@ -1955,7 +1957,8 @@
           "type": {
             "type": "string",
             "enum": ["open", "fixed"],
-            "description": "The type of denomination. Can be `open` or `fixed`. `open` is any amount between minimum and maximum value. Fixed is limited to those returned in the `available_list`."
+            "description": "The type of denomination. Can be `open` or `fixed`. `open` is any amount between minimum and maximum value. Fixed is limited to those returned in the `available_list`.",
+            "example": "fixed"
           },
           "minimum_value": {
             "$ref": "#/components/schemas/ProductMinimumValue"