Checkout Page

update_checkout_page

Destructive

Update an existing checkout page's content and settings. Supports a subset of create's fields; read current values with get_checkout_page before a partial update. Prices, variants, stock and other product settings are not on the page: use update_product with the page's data.product.id. Custom fields are managed with create_field, update_field and delete_field. The change applies to the live page at once: customers see it right away. There is no undo, because the previous values are not kept. For the page's design and customer-facing labels (including translations), set themeOverrides and hostedLayoutType; list_theme_properties lists what can be set. Set themeId (from list_themes) to use a theme; changing it replaces the page's own theme settings.

Input Schema

Name	Required	Description
`tax`	No	Tax configuration for this page. Defaults to Stripe Tax when omitted.
`fees`	No
`name`	No	Internal page name used in your dashboard and API responses.
`slug`	No	Page URL slug. For events and forms the slug defaults to the slugified version of your `title`. For checkouts the slug defaults to the slugified version of your `productData.title`.
`locale`	No
`pageId`	Yes	The ID of the checkout page to update.
`status`	No
`themeId`	No	The theme the page uses: one of your themes or a built-in one (see List themes). Changing it replaces all of the page's own theme settings, including order bump styling set in the dashboard, so the page looks like the theme. That drops the page's labels too, translations included: send the ones to keep in `themeOverrides` in the same request, which apply on top. The page's locale is kept.
`imageIds`	No	Array of images for the page gallery. All referenced file IDs must exist and belong to your account. Pass null to clear the gallery.
`redirect`	No	If enabled, redirects the customer to the specified URL before the page loads.
`testmode`	No	Puts the page in test mode. While it is on, every purchase on this page is a test purchase: no money is taken, the buyer still receives everything the page delivers, and the records are created with `livemode: false`. Turn it off to take real payments again.
`formLayout`	No	Replaces how the page's form is arranged, top to bottom. Reference fields by `fieldId`, the ids in the page's `fields`; an id that is not on the page is rejected. Send the whole layout: read the current one from `formLayout` on the page, change it and send it back. Each item is one of: `field` (`fieldId`), `heading` (`id`, `text`, `level` `heading` or `subheading`), `divider` (`id`), `discount-code` (no other properties) and `group` (`id`, optional `name`, `columns` 1 to 4, and `items` holding fields, headings, dividers or the discount code; groups never nest). You choose the `id` of each heading, divider and group: 1 to 64 characters, unique in the layout. Fields the layout leaves out are added after it, in their current order. `formLayout` on the page decides the form's order. Each field's `order` is its position among the page's fields and follows the layout: saving a layout (in the dashboard or through the API) rewrites every field's `order`. On a page that has never saved a layout, setting `order` moves the field; once a layout is saved, move fields with `formLayout` instead. A `discount-code` item only places the discount code box: the box shows while `showCouponCodeField` is on, and the item does not switch it on. Forms have no discount code, so a form layout must leave it out. More item types may be added later. When reading a layout, skip any item type you do not recognise. When updating, send every item back as you received it, including those.
`funnelSteps`	No	Ordered funnel configuration for this page. Supports intermediate checkout steps, one-click upsells, and confirmation behavior. Field references inside upsell/confirmation redirect steps resolve by `fieldId` (get current field IDs from the page detail response) — the create-time `fieldKey` string is rejected.
`googleIndex`	No	Allow Google to index this page for search results. Defaults to `true`.
`notifyEmail`	No	Email addresses to send notifications to. Supports comma separated emails.
`redirectUrl`	No	URL to redirect to after payment. Applies if `afterPaymentAction` is `redirect`.
`trackingCodes`	No	Custom tracking scripts to include on the page. Supports HTML `<script>` tags.
`paymentMethods`	No
`paymentOptions`	No
`redirectPageId`	No	ID of the page (checkout, event or form) to redirect to after payment. Applies when `afterPaymentAction` is `checkout`.
`themeOverrides`	No	The page's design and labels, set on top of its theme and nested by theme property path: `tokens.colorPrimary` is sent as `{ "tokens": { "colorPrimary": { "light": "#1A73E8" } } }`. Keys you leave out keep their current value, and `null` resets a property, or everything under a key, to the theme default. Call `list_theme_properties` for the supported properties, their value formats and, where a property has a fixed one, its default.
`invoiceSettings`	No
`redirectUrlPath`	No	Additional path parameters appended to the `redirectUrl`. Applies if `afterPaymentAction` is `redirect` and `redirectUrl` is set. To reference a field value, use `fieldId` (the persisted field ID, from the page detail response) instead of the create-time `fieldKey`. [Learn more](https://checkoutpage.com/docs/articles/add-field-and-variant-data-to-redirect-url)
`hostedLayoutType`	No
`redirectUrlQuery`	No	Query parameters for the `redirectUrl`. Applies if `afterPaymentAction` is `redirect` and `redirectUrl` is set. To reference a field value, use `fieldId` instead of the create-time `fieldKey`. [Learn more](https://checkoutpage.com/docs/articles/add-field-and-variant-data-to-redirect-url)
`allowDynamicLabel`	No
`allowDynamicPrice`	No
`allowDynamicTitle`	No	Allow page title to be overridden via URL query parameters.
`savePaymentMethod`	No
`afterPaymentAction`	No	Behavior after checkout. `confirmation` shows the confirmation page. `checkout` redirects to `redirectPageId`. `redirect` sends the customer to `redirectUrl`. Defaults to `confirmation`.
`limitSubscriptions`	No	Deprecated — superseded by `productData.limitSubscriptions.enabled`. Accepted and applied to the page's product.
`checkoutAbandonment`	No
`coverProcessingFees`	No	Options that let customers choose to cover the processing fee. The list holds at most one option for now. Sending it replaces the whole list.
`showCouponCodeField`	No
`sendEmailConfirmation`	No	Send an email confirmation to the customer. Defaults to `true`.
`redirectUrlInsideEmbed`	No	If the page is embedded, redirect the customer within the embed instead of redirecting the main browser window. Defaults to `false`.
`allowDynamicDescription`	No	Allow page description to be overridden via URL query parameters.
`allowDynamicRedirectUrl`	No
`sendPaymentNotification`	No	Send payment/submission notification emails to the store owner.
`showCouponCodeFieldType`	No
`closePopupOnClickOutside`	No	Whether a popup embed closes when clicking outside the container. Defaults to `false`.
`confirmationEmailMessage`	No	Custom confirmation email message. Accepts HTML or plain text. Write `{{id}}` where a customer's own details go, and it is filled in for each customer: `{{field_<field id>}}` for their answer to one of the page's fields, `{{variant_<variant id>}}` and `{{variant_<variant id>_sku}}` for their variant choice, or one of `price` (Amount), `amountDue` (Payment amount due), `amountPaid` (Payment amount paid), `currentPeriodEnd` (Next payment date), `planIterations` (No. of payments), `createdAt` (Created date), `status` (Status), `payment_method` (Payment method), `orderId` (Order ID), `product_title` (Product title), `order_summary` (Order summary), `variant_breakdown` (Variant selection), `license_key` (License key), `sku` (SKU), `form_title` (Form title), `event_name` (Event name), `event_date` (Event date/time), `event_location` (Event location), `event_tickets` (Tickets purchased), `booking_fee` (Booking fee), `event_meeting_link` (Virtual meeting link), `customer_portal_link` (Customer portal link), `coupon_code` (Coupon code), `coupon_discount` (Coupon discount). Product, variant, license key and billing variables apply to checkout pages, event variables to events, `form_title` to forms; a variable that does not apply is left blank. To show paragraphs only to some customers, wrap them in `<if variable="<id>" operator="<operator>" value="<value>">...</if>`, with operator one of equals, not_equals, contains, not_contains, starts_with, ends_with, greater_than, less_than, greater_than_or_equal, less_than_or_equal.
`confirmationEmailSubject`	No	Custom confirmation email subject.
`limitSubscriptionsStripe`	No	Deprecated — superseded by `productData.limitSubscriptions.limitSubscriptionsStripe.enabled`. Accepted and applied to the page's product.
`confirmationCheckoutTitle`	No	Confirmation title.
`confirmationEmailShowLogo`	No	Show store logo in confirmation email.
`allowDynamicPlanIterations`	No	Allow subscription plan iterations to be overridden via URL query parameters.
`customizeEmailConfirmation`	No	Use a custom email confirmation template. If enabled, provide `confirmationEmailSubject` and `confirmationEmailMessage`.
`confirmationCheckoutMessage`	No	Confirmation message. Accepts HTML or plain text. Write `{{id}}` where a customer's own details go, and it is filled in for each customer: `{{field_<field id>}}` for their answer to one of the page's fields, `{{variant_<variant id>}}` and `{{variant_<variant id>_sku}}` for their variant choice, or one of `price` (Amount), `amountDue` (Payment amount due), `amountPaid` (Payment amount paid), `currentPeriodEnd` (Next payment date), `planIterations` (No. of payments), `createdAt` (Created date), `status` (Status), `payment_method` (Payment method), `orderId` (Order ID), `product_title` (Product title), `order_summary` (Order summary), `variant_breakdown` (Variant selection), `license_key` (License key), `sku` (SKU), `form_title` (Form title), `event_name` (Event name), `event_date` (Event date/time), `event_location` (Event location), `event_tickets` (Tickets purchased), `booking_fee` (Booking fee), `event_meeting_link` (Virtual meeting link), `customer_portal_link` (Customer portal link), `coupon_code` (Coupon code), `coupon_discount` (Coupon discount). Product, variant, license key and billing variables apply to checkout pages, event variables to events, `form_title` to forms; a variable that does not apply is left blank. To show paragraphs only to some customers, wrap them in `<if variable="<id>" operator="<operator>" value="<value>">...</if>`, with operator one of equals, not_equals, contains, not_contains, starts_with, ends_with, greater_than, less_than, greater_than_or_equal, less_than_or_equal.
`allowDynamicPreselectedPrice`	No
`customizeCheckoutConfirmation`	No	If set to true `confirmationCheckoutMessage` and `confirmationCheckoutTitle` will be displayed on the confirmation page. Defaults to `false`.
`confirmationEmailShowStoreName`	No	Show store name in confirmation email.
`allowDynamicDiscountedFromPrice`	No
`sendCanceledSubscriptionNotifications`	No	Send notifications when subscriptions are canceled.
`sendRecurringPaymentFailedNotifications`	No	Send notifications when recurring payments fail.
`enableFileAccessForInactiveSubscriptions`	No	Deprecated — superseded by `productData.enableFileAccessForInactiveSubscriptions`. Accepted and applied to the page's product.
`sendRecurringPaymentSucceededNotifications`	No	Send notifications when recurring payments succeed.

Output Schema

Name	Required	Description	Default
`data`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedOct 28, 2026

addedInput schema / $defs / FormLayoutDivider / properties / disabled

Added value: +{
+  "description": "`true` keeps the divider in the layout but hides it from customers. Defaults to `false`.",
+  "type": "boolean"
+}

addedInput schema / $defs / FormLayoutHeading / properties / disabled

Added value: +{
+  "description": "`true` keeps the heading in the layout but hides it from customers. Defaults to `false`.",
+  "type": "boolean"
+}

addedOutput schema / $defs / FormLayoutDivider / properties / disabled

Added value: +{
+  "description": "`true` keeps the divider in the layout but hides it from customers. Defaults to `false`.",
+  "type": "boolean"
+}

addedOutput schema / $defs / FormLayoutHeading / properties / disabled

Added value: +{
+  "description": "`true` keeps the heading in the layout but hides it from customers. Defaults to `false`.",
+  "type": "boolean"
+}

Changed5 schema fields changedOct 28, 2026

changedInput schema / $defs / PageCheckoutAbandonmentSettingsInput / properties / emailReminders / anyOf

Previous value: -[
-  {
-    "properties": {
-      "reminder1": {
-        "anyOf": [
-          {
-            "properties": {
-              "body": {
-                "description": "Email body. Accepts HTML or plain text.",
-                "example": "<p>You left something behind!</p>",
-                "type": "string"
-              },
-              "buttonText": {
-                "description": "Email call-to-action button label.",
-                "example": "Complete order",
-                "type": "string"
-              },
-              "customizeEmail": {
-                "description": "Enable a custom email for this reminder.",
-                "example": true,
-                "type": "boolean"
-              },
-              "subject": {
-                "description": "Email subject line.",
-                "example": "Complete your purchase",
-                "type": "string"
-              }
-            },
-            "required": [
-              "customizeEmail"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "reminder2": {
-        "anyOf": [
-          {
-            "properties": {
-              "body": {
-                "description": "Email body. Accepts HTML or plain text.",
-                "example": "<p>You left something behind!</p>",
-                "type": "string"
-              },
-              "buttonText": {
-                "description": "Email call-to-action button label.",
-                "example": "Complete order",
-                "type": "string"
-              },
-              "customizeEmail": {
-                "description": "Enable a custom email for this reminder.",
-                "example": true,
-                "type": "boolean"
-              },
-              "subject": {
-                "description": "Email subject line.",
-                "example": "Complete your purchase",
-                "type": "string"
-              }
-            },
-            "required": [
-              "customizeEmail"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "reminder3": {
-        "anyOf": [
-          {
-            "properties": {
-              "body": {
-                "description": "Email body. Accepts HTML or plain text.",
-                "example": "<p>You left something behind!</p>",
-                "type": "string"
-              },
-              "buttonText": {
-                "description": "Email call-to-action button label.",
-                "example": "Complete order",
-                "type": "string"
-              },
-              "customizeEmail": {
-                "description": "Enable a custom email for this reminder.",
-                "example": true,
-                "type": "boolean"
-              },
-              "subject": {
-                "description": "Email subject line.",
-                "example": "Complete your purchase",
-                "type": "string"
-              }
-            },
-            "required": [
-              "customizeEmail"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "reminder1": {
+        "anyOf": [
+          {
+            "properties": {
+              "body": {
+                "description": "Email body. Accepts HTML or plain text. Takes the same `{{id}}` variables as `confirmationEmailMessage`, except `amountDue`, `amountPaid`, `currentPeriodEnd`, `status`, `payment_method` and `customer_portal_link`: the customer has not paid yet.",
+                "example": "<p>You left something behind!</p>",
+                "type": "string"
+              },
+              "buttonText": {
+                "description": "Email call-to-action button label.",
+                "example": "Complete order",
+                "type": "string"
+              },
+              "customizeEmail": {
+                "description": "Enable a custom email for this reminder.",
+                "example": true,
+                "type": "boolean"
+              },
+              "subject": {
+                "description": "Email subject line.",
+                "example": "Complete your purchase",
+                "type": "string"
+              }
+            },
+            "required": [
+              "customizeEmail"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "reminder2": {
+        "anyOf": [
+          {
+            "properties": {
+              "body": {
+                "description": "Email body. Accepts HTML or plain text. Takes the same `{{id}}` variables as `confirmationEmailMessage`, except `amountDue`, `amountPaid`, `currentPeriodEnd`, `status`, `payment_method` and `customer_portal_link`: the customer has not paid yet.",
+                "example": "<p>You left something behind!</p>",
+                "type": "string"
+              },
+              "buttonText": {
+                "description": "Email call-to-action button label.",
+                "example": "Complete order",
+                "type": "string"
+              },
+              "customizeEmail": {
+                "description": "Enable a custom email for this reminder.",
+                "example": true,
+                "type": "boolean"
+              },
+              "subject": {
+                "description": "Email subject line.",
+                "example": "Complete your purchase",
+                "type": "string"
+              }
+            },
+            "required": [
+              "customizeEmail"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "reminder3": {
+        "anyOf": [
+          {
+            "properties": {
+              "body": {
+                "description": "Email body. Accepts HTML or plain text. Takes the same `{{id}}` variables as `confirmationEmailMessage`, except `amountDue`, `amountPaid`, `currentPeriodEnd`, `status`, `payment_method` and `customer_portal_link`: the customer has not paid yet.",
+                "example": "<p>You left something behind!</p>",
+                "type": "string"
+              },
+              "buttonText": {
+                "description": "Email call-to-action button label.",
+                "example": "Complete order",
+                "type": "string"
+              },
+              "customizeEmail": {
+                "description": "Enable a custom email for this reminder.",
+                "example": true,
+                "type": "boolean"
+              },
+              "subject": {
+                "description": "Email subject line.",
+                "example": "Complete your purchase",
+                "type": "string"
+              }
+            },
+            "required": [
+              "customizeEmail"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / confirmationCheckoutMessage / description

Previous value: -"Confirmation message. Accepts HTML or plaintext."New value: +"Confirmation message. Accepts HTML or plain text. Write `{{id}}` where a customer's own details go, and it is filled in for each customer: `{{field_<field id>}}` for their answer to one of the page's fields, `{{variant_<variant id>}}` and `{{variant_<variant id>_sku}}` for their variant choice, or one of `price` (Amount), `amountDue` (Payment amount due), `amountPaid` (Payment amount paid), `currentPeriodEnd` (Next payment date), `planIterations` (No. of payments), `createdAt` (Created date), `status` (Status), `payment_method` (Payment method), `orderId` (Order ID), `product_title` (Product title), `order_summary` (Order summary), `variant_breakdown` (Variant selection), `license_key` (License key), `sku` (SKU), `form_title` (Form title), `event_name` (Event name), `event_date` (Event date/time), `event_location` (Event location), `event_tickets` (Tickets purchased), `booking_fee` (Booking fee), `event_meeting_link` (Virtual meeting link), `customer_portal_link` (Customer portal link), `coupon_code` (Coupon code), `coupon_discount` (Coupon discount). Product, variant, license key and billing variables apply to checkout pages, event variables to events, `form_title` to forms; a variable that does not apply is left blank. To show paragraphs only to some customers, wrap them in `<if variable=\"<id>\" operator=\"<operator>\" value=\"<value>\">...</if>`, with operator one of equals, not_equals, contains, not_contains, starts_with, ends_with, greater_than, less_than, greater_than_or_equal, less_than_or_equal."

changedInput schema / properties / confirmationEmailMessage / description

Previous value: -"Custom confirmation email message. Accepts HTML or plain text."New value: +"Custom confirmation email message. Accepts HTML or plain text. Write `{{id}}` where a customer's own details go, and it is filled in for each customer: `{{field_<field id>}}` for their answer to one of the page's fields, `{{variant_<variant id>}}` and `{{variant_<variant id>_sku}}` for their variant choice, or one of `price` (Amount), `amountDue` (Payment amount due), `amountPaid` (Payment amount paid), `currentPeriodEnd` (Next payment date), `planIterations` (No. of payments), `createdAt` (Created date), `status` (Status), `payment_method` (Payment method), `orderId` (Order ID), `product_title` (Product title), `order_summary` (Order summary), `variant_breakdown` (Variant selection), `license_key` (License key), `sku` (SKU), `form_title` (Form title), `event_name` (Event name), `event_date` (Event date/time), `event_location` (Event location), `event_tickets` (Tickets purchased), `booking_fee` (Booking fee), `event_meeting_link` (Virtual meeting link), `customer_portal_link` (Customer portal link), `coupon_code` (Coupon code), `coupon_discount` (Coupon discount). Product, variant, license key and billing variables apply to checkout pages, event variables to events, `form_title` to forms; a variable that does not apply is left blank. To show paragraphs only to some customers, wrap them in `<if variable=\"<id>\" operator=\"<operator>\" value=\"<value>\">...</if>`, with operator one of equals, not_equals, contains, not_contains, starts_with, ends_with, greater_than, less_than, greater_than_or_equal, less_than_or_equal."

changedOutput schema / properties / data / properties / confirmationCheckoutMessage / description

Previous value: -"Confirmation page message."New value: +"Confirmation page message. Variables read as `{{id}}` and conditional paragraphs as `<if variable=\"...\" operator=\"...\" value=\"...\">` blocks; send them back unchanged to keep them."

changedOutput schema / properties / data / properties / confirmationEmailMessage / description

Previous value: -"Custom confirmation email message."New value: +"Custom confirmation email message. Variables read as `{{id}}` and conditional paragraphs as `<if variable=\"...\" operator=\"...\" value=\"...\">` blocks; send them back unchanged to keep them."

Changed2 schema fields changedOct 27, 2026

changedOutput schema / $defs / Field / properties / reference / description

Previous value: -"External reference ID for mapping this field in downstream systems."New value: +"Stable key that exports, Zapier, Google Sheets and webhooks use for this field's answers. Not updated when the label changes."

changedOutput schema / properties / data / properties / product / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "callToActionText": {
-        "description": "Accept copy shown on an order-bump card, e.g. \"Yes! Add gift wrapping\".",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "calloutIcon": {
-        "anyOf": [
-          {
-            "description": "Icon shown before the badge text.",
-            "enum": [
-              "star",
-              "sparkles",
-              "fire",
-              "bolt",
-              "rocket",
-              "trophy",
-              "check",
-              "x-mark",
-              "plus",
-              "arrow-right",
-              "check-badge",
-              "check-circle",
-              "shield-check",
-              "thumbs-up",
-              "heart",
-              "smile",
-              "light-bulb",
-              "sun",
-              "moon",
-              "gift",
-              "tag",
-              "percent",
-              "dollar",
-              "banknotes",
-              "credit-card",
-              "shopping-bag",
-              "shopping-cart",
-              "truck",
-              "clock",
-              "calendar",
-              "bell",
-              "megaphone",
-              "trending-up",
-              "chart",
-              "refresh",
-              "lock",
-              "key",
-              "ticket",
-              "users",
-              "academic-cap",
-              "book",
-              "music",
-              "video",
-              "document",
-              "download",
-              "mobile",
-              "camera",
-              "paint-brush",
-              "puzzle",
-              "cube",
-              "globe",
-              "map-pin",
-              "storefront",
-              "tools",
-              "beaker",
-              "lifebuoy",
-              "chat",
-              "envelope",
-              "phone",
-              "cake",
-              "scale",
-              "eye"
-            ],
-            "example": "star",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Icon leading the call out box."
-      },
-      "calloutText": {
-        "description": "Call out box shown on an order-bump card under the description. Sanitised HTML: links and inline emphasis only.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "createdAt": {
-        "description": "ISO 8601 timestamp when the product was created.",
-        "type": "string"
-      },
-      "defaultPriceId": {
-        "description": "The price pre-selected at checkout: the saved default while it is enabled, or the only enabled price. Null when the product has several prices and no default, so the buyer chooses one.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "description": {
-        "description": "Product description as HTML.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "discounts": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "amountOff": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "maxQuantity": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "minQuantity": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "percentOff": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "quantityCondition": {
-                  "enum": [
-                    "checkout_quantity",
-                    "variant_option_quantity"
-                  ],
-                  "type": "string"
-                },
-                "variantOptionIds": {
-                  "anyOf": [
-                    {
-                      "items": {
-                        "pattern": "^[0-9a-fA-F]{24}$",
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "quantityCondition"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Bulk discount tiers."
-      },
-      "enableFileAccessForInactiveSubscriptions": {
-        "description": "Whether customers with inactive subscriptions can still access file downloads.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "features": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "icon": {
-                  "anyOf": [
-                    {
-                      "description": "Icon leading a feature line, or `none` for no icon.",
-                      "enum": [
-                        "star",
-                        "sparkles",
-                        "fire",
-                        "bolt",
-                        "rocket",
-                        "trophy",
-                        "check",
-                        "x-mark",
-                        "plus",
-                        "arrow-right",
-                        "check-badge",
-                        "check-circle",
-                        "shield-check",
-                        "thumbs-up",
-                        "heart",
-                        "smile",
-                        "light-bulb",
-                        "sun",
-                        "moon",
-                        "gift",
-                        "tag",
-                        "percent",
-                        "dollar",
-                        "banknotes",
-                        "credit-card",
-                        "shopping-bag",
-                        "shopping-cart",
-                        "truck",
-                        "clock",
-                        "calendar",
-                        "bell",
-                        "megaphone",
-                        "trending-up",
-                        "chart",
-                        "refresh",
-                        "lock",
-                        "key",
-                        "ticket",
-                        "users",
-                        "academic-cap",
-                        "book",
-                        "music",
-                        "video",
-                        "document",
-                        "download",
-                        "mobile",
-                        "camera",
-                        "paint-brush",
-                        "puzzle",
-                        "cube",
-                        "globe",
-                        "map-pin",
-                        "storefront",
-                        "tools",
-                        "beaker",
-                        "lifebuoy",
-                        "chat",
-                        "envelope",
-                        "phone",
-                        "cake",
-                        "scale",
-                        "eye",
-                        "none"
-                      ],
-                      "example": "check-circle",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Icon leading the line. Unset, the line leads with a check; `none` draws no icon."
-                },
-                "text": {
-                  "description": "One line of the list.",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "text"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Short list of what the customer gets, shown on an order-bump card above the description."
-      },
-      "fileIds": {
-        "anyOf": [
-          {
-            "items": {
-              "pattern": "^[0-9a-fA-F]{24}$",
-              "type": "string"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "fixedTaxRateIds": {
-        "anyOf": [
-          {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 1,
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Applied Tax Rate IDs for this product."
-      },
-      "generateLicenseKeys": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "hasUnlimitedStock": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "headingText": {
-        "description": "Heading shown above an order-bump card, e.g. \"Special one time offer\".",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "id": {
-        "description": "Unique identifier for the product.",
-        "type": "string"
-      },
-      "limitPayments": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "enabled": {
-                "type": [
-                  "boolean",
-                  "null"
-                ]
-              },
-              "enabledAt": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Duplicate-payment prevention settings for this product. Applies to one-time payments only."
-      },
-      "limitSubscriptions": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "enabled": {
-                "type": [
-                  "boolean",
-                  "null"
-                ]
-              },
-              "limitSubscriptionsStripe": {
-                "anyOf": [
-                  {
-                    "additionalProperties": false,
-                    "properties": {
-                      "enabled": {
-                        "type": [
-                          "boolean",
-                          "null"
-                        ]
-                      }
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Duplicate-subscription prevention settings for this product."
-      },
-      "media": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "fileId": {
-                  "description": "File ID of the media asset.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "height": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "size": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "url": {
-                  "description": "CDN URL of the media asset.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "width": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Product images."
-      },
-      "price": {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "description": "Price in smallest currency unit (cents).",
-            "example": 4900,
-            "type": "number"
-          },
-          "currency": {
-            "description": "Lowercase ISO 4217 currency code.",
-            "example": "usd",
-            "type": "string"
-          },
-          "discountedFromPrice": {
-            "description": "Original price before discount, in cents.",
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "payWhatYouWant": {
-            "description": "Whether pay-what-you-want pricing is enabled.",
-            "type": [
-              "boolean",
-              "null"
-            ]
-          },
-          "paymentPlan": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "billingCycleAnchorConfig": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "dayOfMonth": {
-                            "anyOf": [
-                              {
-                                "maximum": 31,
-                                "minimum": 1,
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ],
-                            "description": "Day of month the billing cycle is anchored to."
-                          },
-                          "enabled": {
-                            "type": [
-                              "boolean",
-                              "null"
-                            ]
-                          },
-                          "month": {
-                            "anyOf": [
-                              {
-                                "maximum": 12,
-                                "minimum": 1,
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "interval": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "day",
-                          "week",
-                          "month",
-                          "year"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ],
-                    "description": "Billing interval (day, week, month, year).",
-                    "example": "month"
-                  },
-                  "intervalCount": {
-                    "description": "Number of intervals between billings.",
-                    "example": 1,
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "planIterations": {
-                    "description": "Number of billing cycles after which the plan completes.",
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "startDate": {
-                    "anyOf": [
-                      {
-                        "format": "date-time",
-                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ],
-                    "description": "The date on which the subscription begins."
-                  },
-                  "trialPeriodDays": {
-                    "description": "Trial period in days.",
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Payment plan configuration — recurring billing that completes after `planIterations` cycles. Never present together with recurring."
-          },
-          "pricingType": {
-            "anyOf": [
-              {
-                "description": "Pricing type for this product - single price or multiple prices using variants.",
-                "enum": [
-                  "single",
-                  "multiple"
-                ],
-                "example": "single",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "deprecated": true,
-            "description": "Deprecated — superseded by `prices[]`. Retained for backward compatibility.",
-            "example": "single"
-          },
-          "recurring": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "billingCycleAnchorConfig": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "dayOfMonth": {
-                            "anyOf": [
-                              {
-                                "maximum": 31,
-                                "minimum": 1,
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ],
-                            "description": "Day of month the billing cycle is anchored to."
-                          },
-                          "enabled": {
-                            "type": [
-                              "boolean",
-                              "null"
-                            ]
-                          },
-                          "month": {
-                            "anyOf": [
-                              {
-                                "maximum": 12,
-                                "minimum": 1,
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "interval": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "day",
-                          "week",
-                          "month",
-                          "year"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ],
-                    "description": "Billing interval (day, week, month, year).",
-                    "example": "month"
-                  },
-                  "intervalCount": {
-                    "description": "Number of intervals between billings.",
-                    "example": 1,
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "startDate": {
-                    "anyOf": [
-                      {
-                        "format": "date-time",
-                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ],
-                    "description": "The date on which the subscription begins."
-                  },
-                  "trialPeriodDays": {
-                    "description": "Trial period in days.",
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Recurring billing configuration. Never present together with paymentPlan."
-          },
-          "setupFee": {
-            "description": "One-time setup fee in cents.",
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "setupFeeMultipliesWithQuantity": {
-            "type": [
-              "boolean",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "amount",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "pricePicker": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "description": {
-                "description": "Text shown above the price options.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "priceDisplayDefaults": {
-                "anyOf": [
-                  {
-                    "additionalProperties": {
-                      "type": "string"
-                    },
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "priceDisplayLabels": {
-                "anyOf": [
-                  {
-                    "additionalProperties": {
-                      "additionalProperties": {
-                        "type": "string"
-                      },
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "type": "object"
-                    },
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "priceDisplayTabOrder": {
-                "anyOf": [
-                  {
-                    "additionalProperties": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "shortenDescription": {
-                "description": "Whether long price descriptions are cut behind a Show more link.",
-                "type": [
-                  "boolean",
-                  "null"
-                ]
-              },
-              "title": {
-                "description": "Heading shown above the price options.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Price picker settings: the heading and description above the options, Show more / less, and tab labels, defaults and order."
-      },
-      "prices": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "description": "A single price entry on a multi-price product.",
-              "properties": {
-                "amount": {
-                  "description": "Price in smallest currency unit (cents).",
-                  "example": 4900,
-                  "type": "number"
-                },
-                "badge": {
-                  "description": "Optional short label shown over the price card.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "badgeIcon": {
-                  "anyOf": [
-                    {
-                      "description": "Icon shown before the badge text.",
-                      "enum": [
-                        "star",
-                        "sparkles",
-                        "fire",
-                        "bolt",
-                        "rocket",
-                        "trophy",
-                        "check",
-                        "x-mark",
-                        "plus",
-                        "arrow-right",
-                        "check-badge",
-                        "check-circle",
-                        "shield-check",
-                        "thumbs-up",
-                        "heart",
-                        "smile",
-                        "light-bulb",
-                        "sun",
-                        "moon",
-                        "gift",
-                        "tag",
-                        "percent",
-                        "dollar",
-                        "banknotes",
-                        "credit-card",
-                        "shopping-bag",
-                        "shopping-cart",
-                        "truck",
-                        "clock",
-                        "calendar",
-                        "bell",
-                        "megaphone",
-                        "trending-up",
-                        "chart",
-                        "refresh",
-                        "lock",
-                        "key",
-                        "ticket",
-                        "users",
-                        "academic-cap",
-                        "book",
-                        "music",
-                        "video",
-                        "document",
-                        "download",
-                        "mobile",
-                        "camera",
-                        "paint-brush",
-                        "puzzle",
-                        "cube",
-                        "globe",
-                        "map-pin",
-                        "storefront",
-                        "tools",
-                        "beaker",
-                        "lifebuoy",
-                        "chat",
-                        "envelope",
-                        "phone",
-                        "cake",
-                        "scale",
-                        "eye"
-                      ],
-                      "example": "star",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Optional icon shown before the badge text."
-                },
-                "billingType": {
-                  "description": "Billing type. Immutable once the price exists (see the pricing-type identity lock).",
-                  "enum": [
-                    "one_time",
-                    "recurring"
-                  ],
-                  "example": "one_time",
-                  "type": "string"
-                },
-                "currency": {
-                  "description": "Lowercase ISO 4217 currency code.",
-                  "example": "usd",
-                  "type": "string"
-                },
-                "discountedFromPrice": {
-                  "description": "Original price before discount, in cents.",
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "enabled": {
-                  "description": "Whether this price is selectable by customers.",
-                  "type": "boolean"
-                },
-                "hidden": {
-                  "description": "Hide this price. Hidden prices can still be shown using query parameters.",
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "id": {
-                  "description": "Unique price identifier.",
-                  "example": "507f1f77bcf86cd799439011",
-                  "type": "string"
-                },
-                "isDefault": {
-                  "description": "Whether checkout pre-selects this price: the entry `defaultPriceId` names. False on every price when the product has several prices and no default.",
-                  "type": "boolean"
-                },
-                "label": {
-                  "description": "Optional seller-facing label (e.g. \"Monthly\", \"Annual\").",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "order": {
-                  "description": "Dashboard display order.",
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "payWhatYouWant": {
-                  "description": "Whether pay-what-you-want pricing is enabled.",
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "paymentPlan": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "billingCycleAnchorConfig": {
-                          "anyOf": [
-                            {
-                              "additionalProperties": false,
-                              "properties": {
-                                "dayOfMonth": {
-                                  "anyOf": [
-                                    {
-                                      "maximum": 31,
-                                      "minimum": 1,
-                                      "type": "number"
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ],
-                                  "description": "Day of month the billing cycle is anchored to."
-                                },
-                                "enabled": {
-                                  "type": [
-                                    "boolean",
-                                    "null"
-                                  ]
-                                },
-                                "month": {
-                                  "anyOf": [
-                                    {
-                                      "maximum": 12,
-                                      "minimum": 1,
-                                      "type": "number"
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ]
-                                }
-                              },
-                              "type": "object"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "interval": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "day",
-                                "week",
-                                "month",
-                                "year"
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Billing interval (day, week, month, year).",
-                          "example": "month"
-                        },
-                        "intervalCount": {
-                          "description": "Number of intervals between billings.",
-                          "example": 1,
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        },
-                        "planIterations": {
-                          "description": "Number of billing cycles after which the plan completes.",
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        },
-                        "startDate": {
-                          "anyOf": [
-                            {
-                              "format": "date-time",
-                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "The date on which the subscription begins."
-                        },
-                        "trialPeriodDays": {
-                          "description": "Trial period in days.",
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Payment plan configuration — recurring billing that completes after `planIterations` cycles. Never present together with recurring."
-                },
-                "pwywSuggestedPrice": {
-                  "description": "Suggested price in cents for PWYW prices.",
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "recurring": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "billingCycleAnchorConfig": {
-                          "anyOf": [
-                            {
-                              "additionalProperties": false,
-                              "properties": {
-                                "dayOfMonth": {
-                                  "anyOf": [
-                                    {
-                                      "maximum": 31,
-                                      "minimum": 1,
-                                      "type": "number"
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ],
-                                  "description": "Day of month the billing cycle is anchored to."
-                                },
-                                "enabled": {
-                                  "type": [
-                                    "boolean",
-                                    "null"
-                                  ]
-                                },
-                                "month": {
-                                  "anyOf": [
-                                    {
-                                      "maximum": 12,
-                                      "minimum": 1,
-                                      "type": "number"
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ]
-                                }
-                              },
-                              "type": "object"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "interval": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "day",
-                                "week",
-                                "month",
-                                "year"
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Billing interval (day, week, month, year).",
-                          "example": "month"
-                        },
-                        "intervalCount": {
-                          "description": "Number of intervals between billings.",
-                          "example": 1,
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        },
-                        "startDate": {
-                          "anyOf": [
-                            {
-                              "format": "date-time",
-                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "The date on which the subscription begins."
-                        },
-                        "trialPeriodDays": {
-                          "description": "Trial period in days.",
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Recurring billing configuration. Never present together with paymentPlan."
-                },
-                "reference": {
-                  "description": "Merchant-facing internal id used in exports and reports (e.g. `price_one_time_fixed_5000`).",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "setupFee": {
-                  "description": "One-time setup fee in cents.",
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "setupFeeMultipliesWithQuantity": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                }
-              },
-              "required": [
-                "amount",
-                "currency",
-                "id",
-                "enabled",
-                "isDefault",
-                "billingType"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Explicit price list for this product. Populated when the product was created with `prices[]`. Each entry includes an `isDefault` flag. Use `defaultPriceId` to find the pre-selected price. Disabled prices are filtered from customer-facing reads but appear in seller API responses."
-      },
-      "role": {
-        "anyOf": [
-          {
-            "description": "What the product is for. `orderbump` products are the simplified add-ons a checkout page offers as order bumps and an event page offers as add-ons; they can never be sold as a page product, and a product cannot be converted between roles.",
-            "enum": [
-              "product",
-              "orderbump"
-            ],
-            "example": "product",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "shortDescription": {
-        "description": "Plain-text one-liner, shown where the full description is too long.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "sku": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "stock": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "taxBehavior": {
-        "anyOf": [
-          {
-            "description": "Tax behavior for this product. Determines how taxes are calculated and displayed. Options include inclusive (tax included in price), exclusive (tax added on top of price), automatic (tax behavior determined by Stripe based on tax settings), or default (use default tax behavior).",
-            "enum": [
-              "inclusive",
-              "exclusive",
-              "automatic",
-              ""
-            ],
-            "example": "exclusive",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "taxCode": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "title": {
-        "description": "Product title.",
-        "example": "Premium Course",
-        "type": "string"
-      },
-      "type": {
-        "description": "Product type.",
-        "enum": [
-          "charge",
-          "subscription"
-        ],
-        "example": "charge",
-        "type": "string"
-      },
-      "updatedAt": {
-        "description": "ISO 8601 timestamp when the product was last updated.",
-        "type": "string"
-      },
-      "variants": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "hidden": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "increasesWithQuantity": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "layout": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "collapseVariantOptions": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "imageSize": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "small",
-                                "medium",
-                                "large",
-                                ""
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "showPwywPlaceholder": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "showVariantName": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "showVariantOptionNames": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "showVariantOptionPriceSign": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "showVariantOptionPrices": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "spacing": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "comfortable",
-                                "compact",
-                                ""
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "textAlign": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "left",
-                                "center",
-                                "stack",
-                                ""
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "variantOptionColumns": {
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        },
-                        "variantOptionLayout": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "list",
-                                "grid"
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "manageVariantOptionStock": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": "string"
-                },
-                "options": {
-                  "anyOf": [
-                    {
-                      "items": {
-                        "additionalProperties": false,
-                        "properties": {
-                          "additionalChargeAmount": {
-                            "type": [
-                              "number",
-                              "null"
-                            ]
-                          },
-                          "description": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "fileIds": {
-                            "anyOf": [
-                              {
-                                "items": {
-                                  "pattern": "^[0-9a-fA-F]{24}$",
-                                  "type": "string"
-                                },
-                                "type": "array"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "image": {
-                            "anyOf": [
-                              {
-                                "additionalProperties": false,
-                                "properties": {
-                                  "fileId": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "height": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "name": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "size": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "url": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "width": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  }
-                                },
-                                "type": "object"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "name": {
-                            "type": "string"
-                          },
-                          "payWhatYouWant": {
-                            "type": [
-                              "boolean",
-                              "null"
-                            ]
-                          },
-                          "pwywSuggestedPrice": {
-                            "type": [
-                              "number",
-                              "null"
-                            ]
-                          },
-                          "sku": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "status": {
-                            "anyOf": [
-                              {
-                                "description": "Status of a product variant, indicating whether it is enabled, disabled, or deleted.",
-                                "enum": [
-                                  "enabled",
-                                  "disabled",
-                                  "deleted"
-                                ],
-                                "example": "enabled",
-                                "type": "string"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "stock": {
-                            "type": [
-                              "number",
-                              "null"
-                            ]
-                          },
-                          "type": {
-                            "anyOf": [
-                              {
-                                "enum": [
-                                  "one_time",
-                                  "recurring",
-                                  "pay_what_you_want"
-                                ],
-                                "type": "string"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name"
-                        ],
-                        "type": "object"
-                      },
-                      "type": "array"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "order": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "preselect": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "enabled": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "optionId": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "quantity": {
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "priceIds": {
-                  "anyOf": [
-                    {
-                      "items": {
-                        "pattern": "^[0-9a-fA-F]{24}$",
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Price IDs this variant group is scoped to. Present only when the product has multiple prices. Customers see this variant group only when the corresponding price is selected."
-                },
-                "reference": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "required": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "selectionType": {
-                  "anyOf": [
-                    {
-                      "description": "Selection type for product variants, indicating how customers can select variant options in a variant. Options include single (only one option can be selected), multiple (multiple options can be selected), or quantity (customer can specify quantity for each option).",
-                      "enum": [
-                        "single",
-                        "multiple",
-                        "quantity"
-                      ],
-                      "example": "single",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "showHideLogic": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "comparison": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "is",
-                                "is_not",
-                                "is_empty",
-                                "is_not_empty",
-                                "contains"
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "element": {
-                          "anyOf": [
-                            {
-                              "additionalProperties": false,
-                              "properties": {
-                                "elementId": {
-                                  "type": [
-                                    "string",
-                                    "null"
-                                  ]
-                                }
-                              },
-                              "type": "object"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "enabled": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "value": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "status": {
-                  "anyOf": [
-                    {
-                      "description": "Status of a product variant, indicating whether it is enabled, disabled, or deleted.",
-                      "enum": [
-                        "enabled",
-                        "disabled",
-                        "deleted"
-                      ],
-                      "example": "enabled",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "useVariantOptionSkus": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                }
-              },
-              "required": [
-                "name"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Product variants."
-      },
-      "variantsRequired": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "id",
-      "type",
-      "title",
-      "price",
-      "createdAt",
-      "updatedAt"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "callToActionText": {
+        "description": "Accept copy shown on an order-bump card, e.g. \"Yes! Add gift wrapping\".",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "calloutIcon": {
+        "anyOf": [
+          {
+            "description": "Icon shown before the badge text.",
+            "enum": [
+              "star",
+              "sparkles",
+              "fire",
+              "bolt",
+              "rocket",
+              "trophy",
+              "check",
+              "x-mark",
+              "plus",
+              "arrow-right",
+              "check-badge",
+              "check-circle",
+              "shield-check",
+              "thumbs-up",
+              "heart",
+              "smile",
+              "light-bulb",
+              "sun",
+              "moon",
+              "gift",
+              "tag",
+              "percent",
+              "dollar",
+              "banknotes",
+              "credit-card",
+              "shopping-bag",
+              "shopping-cart",
+              "truck",
+              "clock",
+              "calendar",
+              "bell",
+              "megaphone",
+              "trending-up",
+              "chart",
+              "refresh",
+              "lock",
+              "key",
+              "ticket",
+              "users",
+              "academic-cap",
+              "book",
+              "music",
+              "video",
+              "document",
+              "download",
+              "mobile",
+              "camera",
+              "paint-brush",
+              "puzzle",
+              "cube",
+              "globe",
+              "map-pin",
+              "storefront",
+              "tools",
+              "beaker",
+              "lifebuoy",
+              "chat",
+              "envelope",
+              "phone",
+              "cake",
+              "scale",
+              "eye"
+            ],
+            "example": "star",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Icon leading the call out box."
+      },
+      "calloutText": {
+        "description": "Call out box shown on an order-bump card under the description. Sanitised HTML: links and inline emphasis only.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "createdAt": {
+        "description": "ISO 8601 timestamp when the product was created.",
+        "type": "string"
+      },
+      "defaultPriceId": {
+        "description": "The price pre-selected at checkout: the saved default while it is enabled, or the only enabled price. Null when the product has several prices and no default, so the buyer chooses one.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "description": {
+        "description": "Product description as HTML.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "discounts": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "amountOff": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "maxQuantity": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "minQuantity": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "percentOff": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "quantityCondition": {
+                  "enum": [
+                    "checkout_quantity",
+                    "variant_option_quantity"
+                  ],
+                  "type": "string"
+                },
+                "variantOptionIds": {
+                  "anyOf": [
+                    {
+                      "items": {
+                        "pattern": "^[0-9a-fA-F]{24}$",
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "quantityCondition"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Bulk discount tiers."
+      },
+      "enableFileAccessForInactiveSubscriptions": {
+        "description": "Whether customers with inactive subscriptions can still access file downloads.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "features": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "icon": {
+                  "anyOf": [
+                    {
+                      "description": "Icon leading a feature line, or `none` for no icon.",
+                      "enum": [
+                        "star",
+                        "sparkles",
+                        "fire",
+                        "bolt",
+                        "rocket",
+                        "trophy",
+                        "check",
+                        "x-mark",
+                        "plus",
+                        "arrow-right",
+                        "check-badge",
+                        "check-circle",
+                        "shield-check",
+                        "thumbs-up",
+                        "heart",
+                        "smile",
+                        "light-bulb",
+                        "sun",
+                        "moon",
+                        "gift",
+                        "tag",
+                        "percent",
+                        "dollar",
+                        "banknotes",
+                        "credit-card",
+                        "shopping-bag",
+                        "shopping-cart",
+                        "truck",
+                        "clock",
+                        "calendar",
+                        "bell",
+                        "megaphone",
+                        "trending-up",
+                        "chart",
+                        "refresh",
+                        "lock",
+                        "key",
+                        "ticket",
+                        "users",
+                        "academic-cap",
+                        "book",
+                        "music",
+                        "video",
+                        "document",
+                        "download",
+                        "mobile",
+                        "camera",
+                        "paint-brush",
+                        "puzzle",
+                        "cube",
+                        "globe",
+                        "map-pin",
+                        "storefront",
+                        "tools",
+                        "beaker",
+                        "lifebuoy",
+                        "chat",
+                        "envelope",
+                        "phone",
+                        "cake",
+                        "scale",
+                        "eye",
+                        "none"
+                      ],
+                      "example": "check-circle",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Icon leading the line. Unset, the line leads with a check; `none` draws no icon."
+                },
+                "text": {
+                  "description": "One line of the list.",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "text"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Short list of what the customer gets, shown on an order-bump card above the description."
+      },
+      "fileIds": {
+        "anyOf": [
+          {
+            "items": {
+              "pattern": "^[0-9a-fA-F]{24}$",
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "fixedTaxRateIds": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 1,
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Applied Tax Rate IDs for this product."
+      },
+      "generateLicenseKeys": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "hasUnlimitedStock": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "headingText": {
+        "description": "Heading shown above an order-bump card, e.g. \"Special one time offer\".",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "id": {
+        "description": "Unique identifier for the product.",
+        "type": "string"
+      },
+      "limitPayments": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "enabled": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "enabledAt": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Duplicate-payment prevention settings for this product. Applies to one-time payments only."
+      },
+      "limitSubscriptions": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "enabled": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "limitSubscriptionsStripe": {
+                "anyOf": [
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Duplicate-subscription prevention settings for this product."
+      },
+      "media": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "fileId": {
+                  "description": "File ID of the media asset.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "height": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "size": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "url": {
+                  "description": "CDN URL of the media asset.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "width": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Product images."
+      },
+      "price": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "description": "Price in smallest currency unit (cents).",
+            "example": 4900,
+            "type": "number"
+          },
+          "currency": {
+            "description": "Lowercase ISO 4217 currency code.",
+            "example": "usd",
+            "type": "string"
+          },
+          "discountedFromPrice": {
+            "description": "Original price before discount, in cents.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "payWhatYouWant": {
+            "description": "Whether pay-what-you-want pricing is enabled.",
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "paymentPlan": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "billingCycleAnchorConfig": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": false,
+                        "properties": {
+                          "dayOfMonth": {
+                            "anyOf": [
+                              {
+                                "maximum": 31,
+                                "minimum": 1,
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Day of month the billing cycle is anchored to."
+                          },
+                          "enabled": {
+                            "type": [
+                              "boolean",
+                              "null"
+                            ]
+                          },
+                          "month": {
+                            "anyOf": [
+                              {
+                                "maximum": 12,
+                                "minimum": 1,
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "interval": {
+                    "anyOf": [
+                      {
+                        "enum": [
+                          "day",
+                          "week",
+                          "month",
+                          "year"
+                        ],
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Billing interval (day, week, month, year).",
+                    "example": "month"
+                  },
+                  "intervalCount": {
+                    "description": "Number of intervals between billings.",
+                    "example": 1,
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "planIterations": {
+                    "description": "Number of billing cycles after which the plan completes.",
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "startDate": {
+                    "anyOf": [
+                      {
+                        "format": "date-time",
+                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "The date on which the subscription begins."
+                  },
+                  "trialPeriodDays": {
+                    "description": "Trial period in days.",
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Payment plan configuration — recurring billing that completes after `planIterations` cycles. Never present together with recurring."
+          },
+          "pricingType": {
+            "anyOf": [
+              {
+                "description": "Pricing type for this product - single price or multiple prices using variants.",
+                "enum": [
+                  "single",
+                  "multiple"
+                ],
+                "example": "single",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "deprecated": true,
+            "description": "Deprecated — superseded by `prices[]`. Retained for backward compatibility.",
+            "example": "single"
+          },
+          "recurring": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "billingCycleAnchorConfig": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": false,
+                        "properties": {
+                          "dayOfMonth": {
+                            "anyOf": [
+                              {
+                                "maximum": 31,
+                                "minimum": 1,
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Day of month the billing cycle is anchored to."
+                          },
+                          "enabled": {
+                            "type": [
+                              "boolean",
+                              "null"
+                            ]
+                          },
+                          "month": {
+                            "anyOf": [
+                              {
+                                "maximum": 12,
+                                "minimum": 1,
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "interval": {
+                    "anyOf": [
+                      {
+                        "enum": [
+                          "day",
+                          "week",
+                          "month",
+                          "year"
+                        ],
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Billing interval (day, week, month, year).",
+                    "example": "month"
+                  },
+                  "intervalCount": {
+                    "description": "Number of intervals between billings.",
+                    "example": 1,
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "startDate": {
+                    "anyOf": [
+                      {
+                        "format": "date-time",
+                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "The date on which the subscription begins."
+                  },
+                  "trialPeriodDays": {
+                    "description": "Trial period in days.",
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Recurring billing configuration. Never present together with paymentPlan."
+          },
+          "setupFee": {
+            "description": "One-time setup fee in cents.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "setupFeeMultipliesWithQuantity": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "amount",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "pricePicker": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "description": {
+                "description": "Text shown above the price options.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "priceDisplayDefaults": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "type": "string"
+                    },
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "priceDisplayLabels": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "additionalProperties": {
+                        "type": "string"
+                      },
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "type": "object"
+                    },
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "priceDisplayTabOrder": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "shortenDescription": {
+                "description": "Whether long price descriptions are cut behind a Show more link.",
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "title": {
+                "description": "Heading shown above the price options.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Price picker settings: the heading and description above the options, Show more / less, and tab labels, defaults and order."
+      },
+      "prices": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "description": "A single price entry on a multi-price product.",
+              "properties": {
+                "amount": {
+                  "description": "Price in smallest currency unit (cents).",
+                  "example": 4900,
+                  "type": "number"
+                },
+                "badge": {
+                  "description": "Optional short label shown over the price card.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "badgeIcon": {
+                  "anyOf": [
+                    {
+                      "description": "Icon shown before the badge text.",
+                      "enum": [
+                        "star",
+                        "sparkles",
+                        "fire",
+                        "bolt",
+                        "rocket",
+                        "trophy",
+                        "check",
+                        "x-mark",
+                        "plus",
+                        "arrow-right",
+                        "check-badge",
+                        "check-circle",
+                        "shield-check",
+                        "thumbs-up",
+                        "heart",
+                        "smile",
+                        "light-bulb",
+                        "sun",
+                        "moon",
+                        "gift",
+                        "tag",
+                        "percent",
+                        "dollar",
+                        "banknotes",
+                        "credit-card",
+                        "shopping-bag",
+                        "shopping-cart",
+                        "truck",
+                        "clock",
+                        "calendar",
+                        "bell",
+                        "megaphone",
+                        "trending-up",
+                        "chart",
+                        "refresh",
+                        "lock",
+                        "key",
+                        "ticket",
+                        "users",
+                        "academic-cap",
+                        "book",
+                        "music",
+                        "video",
+                        "document",
+                        "download",
+                        "mobile",
+                        "camera",
+                        "paint-brush",
+                        "puzzle",
+                        "cube",
+                        "globe",
+                        "map-pin",
+                        "storefront",
+                        "tools",
+                        "beaker",
+                        "lifebuoy",
+                        "chat",
+                        "envelope",
+                        "phone",
+                        "cake",
+                        "scale",
+                        "eye"
+                      ],
+                      "example": "star",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Optional icon shown before the badge text."
+                },
+                "billingType": {
+                  "description": "Billing type. Immutable once the price exists (see the pricing-type identity lock).",
+                  "enum": [
+                    "one_time",
+                    "recurring"
+                  ],
+                  "example": "one_time",
+                  "type": "string"
+                },
+                "currency": {
+                  "description": "Lowercase ISO 4217 currency code.",
+                  "example": "usd",
+                  "type": "string"
+                },
+                "discountedFromPrice": {
+                  "description": "Original price before discount, in cents.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "enabled": {
+                  "description": "Whether this price is selectable by customers.",
+                  "type": "boolean"
+                },
+                "hidden": {
+                  "description": "Hide this price. Hidden prices can still be shown using query parameters.",
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "id": {
+                  "description": "Unique price identifier.",
+                  "example": "507f1f77bcf86cd799439011",
+                  "type": "string"
+                },
+                "isDefault": {
+                  "description": "Whether checkout pre-selects this price: the entry `defaultPriceId` names. False on every price when the product has several prices and no default.",
+                  "type": "boolean"
+                },
+                "label": {
+                  "description": "Optional seller-facing label (e.g. \"Monthly\", \"Annual\").",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "order": {
+                  "description": "Dashboard display order.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "payWhatYouWant": {
+                  "description": "Whether pay-what-you-want pricing is enabled.",
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "paymentPlan": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "billingCycleAnchorConfig": {
+                          "anyOf": [
+                            {
+                              "additionalProperties": false,
+                              "properties": {
+                                "dayOfMonth": {
+                                  "anyOf": [
+                                    {
+                                      "maximum": 31,
+                                      "minimum": 1,
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "description": "Day of month the billing cycle is anchored to."
+                                },
+                                "enabled": {
+                                  "type": [
+                                    "boolean",
+                                    "null"
+                                  ]
+                                },
+                                "month": {
+                                  "anyOf": [
+                                    {
+                                      "maximum": 12,
+                                      "minimum": 1,
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                }
+                              },
+                              "type": "object"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "interval": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "day",
+                                "week",
+                                "month",
+                                "year"
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Billing interval (day, week, month, year).",
+                          "example": "month"
+                        },
+                        "intervalCount": {
+                          "description": "Number of intervals between billings.",
+                          "example": 1,
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        },
+                        "planIterations": {
+                          "description": "Number of billing cycles after which the plan completes.",
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        },
+                        "startDate": {
+                          "anyOf": [
+                            {
+                              "format": "date-time",
+                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "The date on which the subscription begins."
+                        },
+                        "trialPeriodDays": {
+                          "description": "Trial period in days.",
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Payment plan configuration — recurring billing that completes after `planIterations` cycles. Never present together with recurring."
+                },
+                "pwywSuggestedPrice": {
+                  "description": "Suggested price in cents for PWYW prices.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "recurring": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "billingCycleAnchorConfig": {
+                          "anyOf": [
+                            {
+                              "additionalProperties": false,
+                              "properties": {
+                                "dayOfMonth": {
+                                  "anyOf": [
+                                    {
+                                      "maximum": 31,
+                                      "minimum": 1,
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "description": "Day of month the billing cycle is anchored to."
+                                },
+                                "enabled": {
+                                  "type": [
+                                    "boolean",
+                                    "null"
+                                  ]
+                                },
+                                "month": {
+                                  "anyOf": [
+                                    {
+                                      "maximum": 12,
+                                      "minimum": 1,
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                }
+                              },
+                              "type": "object"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "interval": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "day",
+                                "week",
+                                "month",
+                                "year"
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Billing interval (day, week, month, year).",
+                          "example": "month"
+                        },
+                        "intervalCount": {
+                          "description": "Number of intervals between billings.",
+                          "example": 1,
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        },
+                        "startDate": {
+                          "anyOf": [
+                            {
+                              "format": "date-time",
+                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "The date on which the subscription begins."
+                        },
+                        "trialPeriodDays": {
+                          "description": "Trial period in days.",
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Recurring billing configuration. Never present together with paymentPlan."
+                },
+                "reference": {
+                  "description": "Stable label for this price, sent to exports, Zapier, Google Sheets and webhooks as `priceReference`. A generated reference can contain the amount the price was created with, such as `price_one_time_fixed_5000`. It is not updated when the amount changes, and does not need to be.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "setupFee": {
+                  "description": "One-time setup fee in cents.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "setupFeeMultipliesWithQuantity": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "amount",
+                "currency",
+                "id",
+                "enabled",
+                "isDefault",
+                "billingType"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Explicit price list for this product. Populated when the product was created with `prices[]`. Each entry includes an `isDefault` flag. Use `defaultPriceId` to find the pre-selected price. Disabled prices are filtered from customer-facing reads but appear in seller API responses."
+      },
+      "role": {
+        "anyOf": [
+          {
+            "description": "What the product is for. `orderbump` products are the simplified add-ons a checkout page offers as order bumps and an event page offers as add-ons; they can never be sold as a page product, and a product cannot be converted between roles.",
+            "enum": [
+              "product",
+              "orderbump"
+            ],
+            "example": "product",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "shortDescription": {
+        "description": "Plain-text one-liner, shown where the full description is too long.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sku": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "stock": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "taxBehavior": {
+        "anyOf": [
+          {
+            "description": "Tax behavior for this product. Determines how taxes are calculated and displayed. Options include inclusive (tax included in price), exclusive (tax added on top of price), automatic (tax behavior determined by Stripe based on tax settings), or default (use default tax behavior).",
+            "enum": [
+              "inclusive",
+              "exclusive",
+              "automatic",
+              ""
+            ],
+            "example": "exclusive",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "taxCode": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "description": "Product title.",
+        "example": "Premium Course",
+        "type": "string"
+      },
+      "type": {
+        "description": "Product type.",
+        "enum": [
+          "charge",
+          "subscription"
+        ],
+        "example": "charge",
+        "type": "string"
+      },
+      "updatedAt": {
+        "description": "ISO 8601 timestamp when the product was last updated.",
+        "type": "string"
+      },
+      "variants": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "hidden": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "increasesWithQuantity": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "layout": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "collapseVariantOptions": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "imageSize": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "small",
+                                "medium",
+                                "large",
+                                ""
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "showPwywPlaceholder": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "showVariantName": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "showVariantOptionNames": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "showVariantOptionPriceSign": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "showVariantOptionPrices": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "spacing": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "comfortable",
+                                "compact",
+                                ""
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "textAlign": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "left",
+                                "center",
+                                "stack",
+                                ""
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "variantOptionColumns": {
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        },
+                        "variantOptionLayout": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "list",
+                                "grid"
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "manageVariantOptionStock": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": "string"
+                },
+                "options": {
+                  "anyOf": [
+                    {
+                      "items": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "additionalChargeAmount": {
+                            "type": [
+                              "number",
+                              "null"
+                            ]
+                          },
+                          "description": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "fileIds": {
+                            "anyOf": [
+                              {
+                                "items": {
+                                  "pattern": "^[0-9a-fA-F]{24}$",
+                                  "type": "string"
+                                },
+                                "type": "array"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "image": {
+                            "anyOf": [
+                              {
+                                "additionalProperties": false,
+                                "properties": {
+                                  "fileId": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "height": {
+                                    "type": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "name": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "size": {
+                                    "type": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "url": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "width": {
+                                    "type": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "payWhatYouWant": {
+                            "type": [
+                              "boolean",
+                              "null"
+                            ]
+                          },
+                          "pwywSuggestedPrice": {
+                            "type": [
+                              "number",
+                              "null"
+                            ]
+                          },
+                          "sku": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "status": {
+                            "anyOf": [
+                              {
+                                "description": "Status of a product variant, indicating whether it is enabled, disabled, or deleted.",
+                                "enum": [
+                                  "enabled",
+                                  "disabled",
+                                  "deleted"
+                                ],
+                                "example": "enabled",
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "stock": {
+                            "type": [
+                              "number",
+                              "null"
+                            ]
+                          },
+                          "type": {
+                            "anyOf": [
+                              {
+                                "enum": [
+                                  "one_time",
+                                  "recurring",
+                                  "pay_what_you_want"
+                                ],
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        },
+                        "required": [
+                          "name"
+                        ],
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "order": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "preselect": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "optionId": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "quantity": {
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "priceIds": {
+                  "anyOf": [
+                    {
+                      "items": {
+                        "pattern": "^[0-9a-fA-F]{24}$",
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Price IDs this variant group is scoped to. Present only when the product has multiple prices. Customers see this variant group only when the corresponding price is selected."
+                },
+                "reference": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "required": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "selectionType": {
+                  "anyOf": [
+                    {
+                      "description": "Selection type for product variants, indicating how customers can select variant options in a variant. Options include single (only one option can be selected), multiple (multiple options can be selected), or quantity (customer can specify quantity for each option).",
+                      "enum": [
+                        "single",
+                        "multiple",
+                        "quantity"
+                      ],
+                      "example": "single",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "showHideLogic": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "comparison": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "is",
+                                "is_not",
+                                "is_empty",
+                                "is_not_empty",
+                                "contains"
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "element": {
+                          "anyOf": [
+                            {
+                              "additionalProperties": false,
+                              "properties": {
+                                "elementId": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                }
+                              },
+                              "type": "object"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "value": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "status": {
+                  "anyOf": [
+                    {
+                      "description": "Status of a product variant, indicating whether it is enabled, disabled, or deleted.",
+                      "enum": [
+                        "enabled",
+                        "disabled",
+                        "deleted"
+                      ],
+                      "example": "enabled",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "useVariantOptionSkus": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "name"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Product variants."
+      },
+      "variantsRequired": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "id",
+      "type",
+      "title",
+      "price",
+      "createdAt",
+      "updatedAt"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed15 schema fields changedOct 23, 2026

addedInput schema / $defs / FormLayoutDiscountCode

Added value: +{
+  "description": "Where the discount code box sits. This item only places the box: the box shows while the page has `showCouponCodeField` on. Checkout pages and events only.",
+  "properties": {
+    "type": {
+      "const": "discount-code",
+      "description": "Always `discount-code`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / FormLayoutDivider

Added value: +{
+  "description": "A line that separates parts of the form.",
+  "properties": {
+    "id": {
+      "description": "The divider's id, chosen by you: 1 to 64 characters, unique in the layout.",
+      "maxLength": 64,
+      "minLength": 1,
+      "type": "string"
+    },
+    "type": {
+      "const": "divider",
+      "description": "Always `divider`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "id"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / FormLayoutField

Added value: +{
+  "description": "A field on the page, shown where it sits in the layout.",
+  "properties": {
+    "fieldId": {
+      "description": "The `id` of a field in the page's `fields`.",
+      "pattern": "^[0-9a-fA-F]{24}$",
+      "type": "string"
+    },
+    "type": {
+      "const": "field",
+      "description": "Always `field`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "fieldId"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / FormLayoutGroup

Added value: +{
+  "description": "Items shown side by side in columns.",
+  "properties": {
+    "columns": {
+      "description": "How many items sit side by side, 1 to 4. On phones the group stacks by default.",
+      "maximum": 4,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "id": {
+      "description": "The group's id, chosen by you: 1 to 64 characters, unique in the layout.",
+      "maxLength": 64,
+      "minLength": 1,
+      "type": "string"
+    },
+    "items": {
+      "description": "What the group holds, filled row by row: fields, headings, dividers and the discount code. Groups never nest.",
+      "items": {
+        "oneOf": [
+          {
+            "$ref": "#/$defs/FormLayoutField"
+          },
+          {
+            "$ref": "#/$defs/FormLayoutHeading"
+          },
+          {
+            "$ref": "#/$defs/FormLayoutDivider"
+          },
+          {
+            "$ref": "#/$defs/FormLayoutDiscountCode"
+          }
+        ]
+      },
+      "maxItems": 200,
+      "type": "array"
+    },
+    "name": {
+      "description": "A name for the group, seen only in the dashboard. Up to 100 characters.",
+      "maxLength": 100,
+      "type": "string"
+    },
+    "type": {
+      "const": "group",
+      "description": "Always `group`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "id",
+    "columns",
+    "items"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / FormLayoutHeading

Added value: +{
+  "description": "A heading or subheading shown above the items after it.",
+  "properties": {
+    "id": {
+      "description": "The heading's id, chosen by you: 1 to 64 characters, unique in the layout.",
+      "maxLength": 64,
+      "minLength": 1,
+      "type": "string"
+    },
+    "level": {
+      "description": "`heading` for a section title, `subheading` for a smaller one.",
+      "enum": [
+        "heading",
+        "subheading"
+      ],
+      "type": "string"
+    },
+    "text": {
+      "description": "The text shown, up to 200 characters.",
+      "maxLength": 200,
+      "minLength": 1,
+      "type": "string"
+    },
+    "type": {
+      "const": "heading",
+      "description": "Always `heading`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "id",
+    "text",
+    "level"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / FormLayoutItem

Added value: +{
+  "description": "More item types may be added later. When reading a layout, skip any item type you do not recognise. When updating, send every item back as you received it, including those.",
+  "oneOf": [
+    {
+      "$ref": "#/$defs/FormLayoutField"
+    },
+    {
+      "$ref": "#/$defs/FormLayoutHeading"
+    },
+    {
+      "$ref": "#/$defs/FormLayoutDivider"
+    },
+    {
+      "$ref": "#/$defs/FormLayoutDiscountCode"
+    },
+    {
+      "$ref": "#/$defs/FormLayoutGroup"
+    }
+  ]
+}

addedInput schema / properties / formLayout

Added value: +{
+  "description": "Replaces how the page's form is arranged, top to bottom. Reference fields by `fieldId`, the ids in the page's `fields`; an id that is not on the page is rejected. Send the whole layout: read the current one from `formLayout` on the page, change it and send it back. Each item is one of: `field` (`fieldId`), `heading` (`id`, `text`, `level` `heading` or `subheading`), `divider` (`id`), `discount-code` (no other properties) and `group` (`id`, optional `name`, `columns` 1 to 4, and `items` holding fields, headings, dividers or the discount code; groups never nest). You choose the `id` of each heading, divider and group: 1 to 64 characters, unique in the layout. Fields the layout leaves out are added after it, in their current order. `formLayout` on the page decides the form's order. Each field's `order` is its position among the page's fields and follows the layout: saving a layout (in the dashboard or through the API) rewrites every field's `order`. On a page that has never saved a layout, setting `order` moves the field; once a layout is saved, move fields with `formLayout` instead. A `discount-code` item only places the discount code box: the box shows while `showCouponCodeField` is on, and the item does not switch it on. Forms have no discount code, so a form layout must leave it out. More item types may be added later. When reading a layout, skip any item type you do not recognise. When updating, send every item back as you received it, including those.",
+  "items": {
+    "$ref": "#/$defs/FormLayoutItem"
+  },
+  "maxItems": 500,
+  "type": "array"
+}

changedOutput schema / $defs / Field / properties / order / description

Previous value: -"Display order of the field within the form."New value: +"Position of the field among the page's fields, from 0. `formLayout` on the page decides the form's order. Each field's `order` is its position among the page's fields and follows the layout: saving a layout (in the dashboard or through the API) rewrites every field's `order`. On a page that has never saved a layout, setting `order` moves the field; once a layout is saved, move fields with `formLayout` instead."

addedOutput schema / $defs / FormLayoutDiscountCode

Added value: +{
+  "additionalProperties": false,
+  "description": "Where the discount code box sits. This item only places the box: the box shows while the page has `showCouponCodeField` on. Checkout pages and events only.",
+  "properties": {
+    "type": {
+      "const": "discount-code",
+      "description": "Always `discount-code`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type"
+  ],
+  "type": "object"
+}

addedOutput schema / $defs / FormLayoutDivider

Added value: +{
+  "additionalProperties": false,
+  "description": "A line that separates parts of the form.",
+  "properties": {
+    "id": {
+      "description": "The divider's id, chosen by you: 1 to 64 characters, unique in the layout.",
+      "maxLength": 64,
+      "minLength": 1,
+      "type": "string"
+    },
+    "type": {
+      "const": "divider",
+      "description": "Always `divider`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "id"
+  ],
+  "type": "object"
+}

addedOutput schema / $defs / FormLayoutField

Added value: +{
+  "additionalProperties": false,
+  "description": "A field on the page, shown where it sits in the layout.",
+  "properties": {
+    "fieldId": {
+      "description": "The `id` of a field in the page's `fields`.",
+      "pattern": "^[0-9a-fA-F]{24}$",
+      "type": "string"
+    },
+    "type": {
+      "const": "field",
+      "description": "Always `field`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "fieldId"
+  ],
+  "type": "object"
+}

addedOutput schema / $defs / FormLayoutGroup

Added value: +{
+  "additionalProperties": false,
+  "description": "Items shown side by side in columns.",
+  "properties": {
+    "columns": {
+      "description": "How many items sit side by side, 1 to 4. On phones the group stacks by default.",
+      "maximum": 4,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "id": {
+      "description": "The group's id, chosen by you: 1 to 64 characters, unique in the layout.",
+      "maxLength": 64,
+      "minLength": 1,
+      "type": "string"
+    },
+    "items": {
+      "description": "What the group holds, filled row by row: fields, headings, dividers and the discount code. Groups never nest.",
+      "items": {
+        "oneOf": [
+          {
+            "$ref": "#/$defs/FormLayoutField"
+          },
+          {
+            "$ref": "#/$defs/FormLayoutHeading"
+          },
+          {
+            "$ref": "#/$defs/FormLayoutDivider"
+          },
+          {
+            "$ref": "#/$defs/FormLayoutDiscountCode"
+          }
+        ]
+      },
+      "maxItems": 200,
+      "type": "array"
+    },
+    "name": {
+      "description": "A name for the group, seen only in the dashboard. Up to 100 characters.",
+      "maxLength": 100,
+      "type": "string"
+    },
+    "type": {
+      "const": "group",
+      "description": "Always `group`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "id",
+    "columns",
+    "items"
+  ],
+  "type": "object"
+}

addedOutput schema / $defs / FormLayoutHeading

Added value: +{
+  "additionalProperties": false,
+  "description": "A heading or subheading shown above the items after it.",
+  "properties": {
+    "id": {
+      "description": "The heading's id, chosen by you: 1 to 64 characters, unique in the layout.",
+      "maxLength": 64,
+      "minLength": 1,
+      "type": "string"
+    },
+    "level": {
+      "description": "`heading` for a section title, `subheading` for a smaller one.",
+      "enum": [
+        "heading",
+        "subheading"
+      ],
+      "type": "string"
+    },
+    "text": {
+      "description": "The text shown, up to 200 characters.",
+      "maxLength": 200,
+      "minLength": 1,
+      "type": "string"
+    },
+    "type": {
+      "const": "heading",
+      "description": "Always `heading`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "id",
+    "text",
+    "level"
+  ],
+  "type": "object"
+}

addedOutput schema / $defs / FormLayoutItem

Added value: +{
+  "description": "More item types may be added later. When reading a layout, skip any item type you do not recognise. When updating, send every item back as you received it, including those.",
+  "oneOf": [
+    {
+      "$ref": "#/$defs/FormLayoutField"
+    },
+    {
+      "$ref": "#/$defs/FormLayoutHeading"
+    },
+    {
+      "$ref": "#/$defs/FormLayoutDivider"
+    },
+    {
+      "$ref": "#/$defs/FormLayoutDiscountCode"
+    },
+    {
+      "$ref": "#/$defs/FormLayoutGroup"
+    }
+  ]
+}

addedOutput schema / properties / data / properties / formLayout

Added value: +{
+  "description": "How the page's form is arranged, top to bottom: fields, headings, dividers, groups of fields shown side by side in columns, and where the discount code box sits. Always returned, even for a page that was never arranged: every field on the page is listed, and `fieldId` matches the `id` of an entry in `fields`. A `discount-code` item only places the box, which shows while `showCouponCodeField` is on. A placement you saved is returned whether the box is on or off; when none was saved and the box is on, the item is at the end, where the box shows. Forms never have one. Each item is one of: `field` (`fieldId`), `heading` (`id`, `text`, `level` `heading` or `subheading`), `divider` (`id`), `discount-code` (no other properties) and `group` (`id`, optional `name`, `columns` 1 to 4, and `items` holding fields, headings, dividers or the discount code; groups never nest). You choose the `id` of each heading, divider and group: 1 to 64 characters, unique in the layout. `formLayout` on the page decides the form's order. Each field's `order` is its position among the page's fields and follows the layout: saving a layout (in the dashboard or through the API) rewrites every field's `order`. On a page that has never saved a layout, setting `order` moves the field; once a layout is saved, move fields with `formLayout` instead. More item types may be added later. When reading a layout, skip any item type you do not recognise. When updating, send every item back as you received it, including those.",
+  "items": {
+    "$ref": "#/$defs/FormLayoutItem"
+  },
+  "type": "array"
+}

Changed1 schema field changedOct 21, 2026

addedOutput schema / $defs / Field / properties / disabled

Added value: +{
+  "description": "Whether this field is switched off. A disabled field keeps its settings but is removed from the page entirely.",
+  "example": false,
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Changed4 schema fields changedOct 20, 2026

addedInput schema / $defs / PageCoverProcessingFees

Added value: +{
+  "description": "An option that lets customers choose to cover the processing fee. The contribution is `percentage` of the total plus `amount`, and is not an Additional fee.",
+  "properties": {
+    "amount": {
+      "anyOf": [
+        {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "enabled": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "label": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "percentage": {
+      "anyOf": [
+        {
+          "maximum": 100,
+          "minimum": 0,
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "preselected": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "showAmount": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / coverProcessingFees

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "$ref": "#/$defs/PageCoverProcessingFees"
+      },
+      "maxItems": 1,
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Options that let customers choose to cover the processing fee. The list holds at most one option for now. Sending it replaces the whole list."
+}

addedOutput schema / $defs / PageCoverProcessingFees

Added value: +{
+  "additionalProperties": false,
+  "description": "An option that lets customers choose to cover the processing fee. The contribution is `percentage` of the total plus `amount`, and is not an Additional fee.",
+  "properties": {
+    "amount": {
+      "anyOf": [
+        {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "enabled": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "label": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "percentage": {
+      "anyOf": [
+        {
+          "maximum": 100,
+          "minimum": 0,
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "preselected": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "showAmount": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / data / properties / coverProcessingFees

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "$ref": "#/$defs/PageCoverProcessingFees"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Options that let customers choose to cover the processing fee. Empty when the page has none. The list holds at most one option for now."
+}

Changed1 schema field changedOct 19, 2026

changedOutput schema / properties / data / properties / product / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "callToActionText": {
-        "description": "Accept copy shown on an order-bump card, e.g. \"Yes! Add gift wrapping\".",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "calloutIcon": {
-        "anyOf": [
-          {
-            "description": "Icon shown before the badge text.",
-            "enum": [
-              "star",
-              "sparkles",
-              "fire",
-              "bolt",
-              "rocket",
-              "trophy",
-              "check",
-              "x-mark",
-              "plus",
-              "arrow-right",
-              "check-badge",
-              "check-circle",
-              "shield-check",
-              "thumbs-up",
-              "heart",
-              "smile",
-              "light-bulb",
-              "sun",
-              "moon",
-              "gift",
-              "tag",
-              "percent",
-              "dollar",
-              "banknotes",
-              "credit-card",
-              "shopping-bag",
-              "shopping-cart",
-              "truck",
-              "clock",
-              "calendar",
-              "bell",
-              "megaphone",
-              "trending-up",
-              "chart",
-              "refresh",
-              "lock",
-              "key",
-              "ticket",
-              "users",
-              "academic-cap",
-              "book",
-              "music",
-              "video",
-              "document",
-              "download",
-              "mobile",
-              "camera",
-              "paint-brush",
-              "puzzle",
-              "cube",
-              "globe",
-              "map-pin",
-              "storefront",
-              "tools",
-              "beaker",
-              "lifebuoy",
-              "chat",
-              "envelope",
-              "phone",
-              "cake",
-              "scale",
-              "eye"
-            ],
-            "example": "star",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Icon leading the call out box."
-      },
-      "calloutText": {
-        "description": "Call out box shown on an order-bump card under the description. Sanitised HTML: links and inline emphasis only.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "createdAt": {
-        "description": "ISO 8601 timestamp when the product was created.",
-        "type": "string"
-      },
-      "defaultPriceId": {
-        "description": "The price pre-selected at checkout: the saved default while it is enabled, or the only enabled price. Null when the product has several prices and no default, so the buyer chooses one.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "description": {
-        "description": "Product description as HTML.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "discounts": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "amountOff": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "maxQuantity": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "minQuantity": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "percentOff": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "quantityCondition": {
-                  "enum": [
-                    "checkout_quantity",
-                    "variant_option_quantity"
-                  ],
-                  "type": "string"
-                },
-                "variantOptionIds": {
-                  "anyOf": [
-                    {
-                      "items": {
-                        "pattern": "^[0-9a-fA-F]{24}$",
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "quantityCondition"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Bulk discount tiers."
-      },
-      "enableFileAccessForInactiveSubscriptions": {
-        "description": "Whether customers with inactive subscriptions can still access file downloads.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "features": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "icon": {
-                  "anyOf": [
-                    {
-                      "description": "Icon leading a feature line, or `none` for no icon.",
-                      "enum": [
-                        "star",
-                        "sparkles",
-                        "fire",
-                        "bolt",
-                        "rocket",
-                        "trophy",
-                        "check",
-                        "x-mark",
-                        "plus",
-                        "arrow-right",
-                        "check-badge",
-                        "check-circle",
-                        "shield-check",
-                        "thumbs-up",
-                        "heart",
-                        "smile",
-                        "light-bulb",
-                        "sun",
-                        "moon",
-                        "gift",
-                        "tag",
-                        "percent",
-                        "dollar",
-                        "banknotes",
-                        "credit-card",
-                        "shopping-bag",
-                        "shopping-cart",
-                        "truck",
-                        "clock",
-                        "calendar",
-                        "bell",
-                        "megaphone",
-                        "trending-up",
-                        "chart",
-                        "refresh",
-                        "lock",
-                        "key",
-                        "ticket",
-                        "users",
-                        "academic-cap",
-                        "book",
-                        "music",
-                        "video",
-                        "document",
-                        "download",
-                        "mobile",
-                        "camera",
-                        "paint-brush",
-                        "puzzle",
-                        "cube",
-                        "globe",
-                        "map-pin",
-                        "storefront",
-                        "tools",
-                        "beaker",
-                        "lifebuoy",
-                        "chat",
-                        "envelope",
-                        "phone",
-                        "cake",
-                        "scale",
-                        "eye",
-                        "none"
-                      ],
-                      "example": "check-circle",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Icon leading the line. Unset, the line leads with a check; `none` draws no icon."
-                },
-                "text": {
-                  "description": "One line of the list.",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "text"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Short list of what the customer gets, shown on an order-bump card above the description."
-      },
-      "fileIds": {
-        "anyOf": [
-          {
-            "items": {
-              "pattern": "^[0-9a-fA-F]{24}$",
-              "type": "string"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "fixedTaxRateIds": {
-        "anyOf": [
-          {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 1,
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Applied Tax Rate IDs for this product."
-      },
-      "generateLicenseKeys": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "hasUnlimitedStock": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "headingText": {
-        "description": "Heading shown above an order-bump card, e.g. \"Special one time offer\".",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "id": {
-        "description": "Unique identifier for the product.",
-        "type": "string"
-      },
-      "limitPayments": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "enabled": {
-                "type": [
-                  "boolean",
-                  "null"
-                ]
-              },
-              "enabledAt": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Duplicate-payment prevention settings for this product. Applies to one-time payments only."
-      },
-      "limitSubscriptions": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "enabled": {
-                "type": [
-                  "boolean",
-                  "null"
-                ]
-              },
-              "limitSubscriptionsStripe": {
-                "anyOf": [
-                  {
-                    "additionalProperties": false,
-                    "properties": {
-                      "enabled": {
-                        "type": [
-                          "boolean",
-                          "null"
-                        ]
-                      }
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Duplicate-subscription prevention settings for this product."
-      },
-      "media": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "fileId": {
-                  "description": "File ID of the media asset.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "height": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "size": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "url": {
-                  "description": "CDN URL of the media asset.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "width": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Product images."
-      },
-      "price": {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "description": "Price in smallest currency unit (cents).",
-            "example": 4900,
-            "type": "number"
-          },
-          "currency": {
-            "description": "Lowercase ISO 4217 currency code.",
-            "example": "usd",
-            "type": "string"
-          },
-          "discountedFromPrice": {
-            "description": "Original price before discount, in cents.",
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "payWhatYouWant": {
-            "description": "Whether pay-what-you-want pricing is enabled.",
-            "type": [
-              "boolean",
-              "null"
-            ]
-          },
-          "paymentPlan": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "billingCycleAnchorConfig": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "dayOfMonth": {
-                            "anyOf": [
-                              {
-                                "maximum": 31,
-                                "minimum": 1,
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ],
-                            "description": "Day of month the billing cycle is anchored to."
-                          },
-                          "enabled": {
-                            "type": [
-                              "boolean",
-                              "null"
-                            ]
-                          },
-                          "month": {
-                            "anyOf": [
-                              {
-                                "maximum": 12,
-                                "minimum": 1,
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "interval": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "day",
-                          "week",
-                          "month",
-                          "year"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ],
-                    "description": "Billing interval (day, week, month, year).",
-                    "example": "month"
-                  },
-                  "intervalCount": {
-                    "description": "Number of intervals between billings.",
-                    "example": 1,
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "planIterations": {
-                    "description": "Number of billing cycles after which the plan completes.",
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "startDate": {
-                    "anyOf": [
-                      {
-                        "format": "date-time",
-                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ],
-                    "description": "The date on which the subscription begins."
-                  },
-                  "trialPeriodDays": {
-                    "description": "Trial period in days.",
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Payment plan configuration — recurring billing that completes after `planIterations` cycles. Never present together with recurring."
-          },
-          "pricingType": {
-            "anyOf": [
-              {
-                "description": "Pricing type for this product - single price or multiple prices using variants.",
-                "enum": [
-                  "single",
-                  "multiple"
-                ],
-                "example": "single",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "deprecated": true,
-            "description": "Deprecated — superseded by `prices[]`. Retained for backward compatibility.",
-            "example": "single"
-          },
-          "recurring": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "billingCycleAnchorConfig": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "dayOfMonth": {
-                            "anyOf": [
-                              {
-                                "maximum": 31,
-                                "minimum": 1,
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ],
-                            "description": "Day of month the billing cycle is anchored to."
-                          },
-                          "enabled": {
-                            "type": [
-                              "boolean",
-                              "null"
-                            ]
-                          },
-                          "month": {
-                            "anyOf": [
-                              {
-                                "maximum": 12,
-                                "minimum": 1,
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "interval": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "day",
-                          "week",
-                          "month",
-                          "year"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ],
-                    "description": "Billing interval (day, week, month, year).",
-                    "example": "month"
-                  },
-                  "intervalCount": {
-                    "description": "Number of intervals between billings.",
-                    "example": 1,
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "startDate": {
-                    "anyOf": [
-                      {
-                        "format": "date-time",
-                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ],
-                    "description": "The date on which the subscription begins."
-                  },
-                  "trialPeriodDays": {
-                    "description": "Trial period in days.",
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Recurring billing configuration. Never present together with paymentPlan."
-          },
-          "setupFee": {
-            "description": "One-time setup fee in cents.",
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "setupFeeMultipliesWithQuantity": {
-            "type": [
-              "boolean",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "amount",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "pricePicker": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "description": {
-                "description": "Text shown above the price options.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "priceDisplayDefaults": {
-                "anyOf": [
-                  {
-                    "additionalProperties": {
-                      "type": "string"
-                    },
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "priceDisplayLabels": {
-                "anyOf": [
-                  {
-                    "additionalProperties": {
-                      "additionalProperties": {
-                        "type": "string"
-                      },
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "type": "object"
-                    },
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "priceDisplayTabOrder": {
-                "anyOf": [
-                  {
-                    "additionalProperties": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "shortenDescription": {
-                "description": "Whether long price descriptions are cut behind a Show more link.",
-                "type": [
-                  "boolean",
-                  "null"
-                ]
-              },
-              "title": {
-                "description": "Heading shown above the price options.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Price picker settings: the heading and description above the options, Show more / less, and tab labels, defaults and order."
-      },
-      "prices": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "description": "A single price entry on a multi-price product.",
-              "properties": {
-                "amount": {
-                  "description": "Price in smallest currency unit (cents).",
-                  "example": 4900,
-                  "type": "number"
-                },
-                "badge": {
-                  "description": "Optional short label shown over the price card.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "badgeIcon": {
-                  "anyOf": [
-                    {
-                      "description": "Icon shown before the badge text.",
-                      "enum": [
-                        "star",
-                        "sparkles",
-                        "fire",
-                        "bolt",
-                        "rocket",
-                        "trophy",
-                        "check",
-                        "x-mark",
-                        "plus",
-                        "arrow-right",
-                        "check-badge",
-                        "check-circle",
-                        "shield-check",
-                        "thumbs-up",
-                        "heart",
-                        "smile",
-                        "light-bulb",
-                        "sun",
-                        "moon",
-                        "gift",
-                        "tag",
-                        "percent",
-                        "dollar",
-                        "banknotes",
-                        "credit-card",
-                        "shopping-bag",
-                        "shopping-cart",
-                        "truck",
-                        "clock",
-                        "calendar",
-                        "bell",
-                        "megaphone",
-                        "trending-up",
-                        "chart",
-                        "refresh",
-                        "lock",
-                        "key",
-                        "ticket",
-                        "users",
-                        "academic-cap",
-                        "book",
-                        "music",
-                        "video",
-                        "document",
-                        "download",
-                        "mobile",
-                        "camera",
-                        "paint-brush",
-                        "puzzle",
-                        "cube",
-                        "globe",
-                        "map-pin",
-                        "storefront",
-                        "tools",
-                        "beaker",
-                        "lifebuoy",
-                        "chat",
-                        "envelope",
-                        "phone",
-                        "cake",
-                        "scale",
-                        "eye"
-                      ],
-                      "example": "star",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Optional icon shown before the badge text."
-                },
-                "billingType": {
-                  "description": "Billing type. Immutable once the price exists (see the pricing-type identity lock).",
-                  "enum": [
-                    "one_time",
-                    "recurring"
-                  ],
-                  "example": "one_time",
-                  "type": "string"
-                },
-                "currency": {
-                  "description": "Lowercase ISO 4217 currency code.",
-                  "example": "usd",
-                  "type": "string"
-                },
-                "discountedFromPrice": {
-                  "description": "Original price before discount, in cents.",
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "enabled": {
-                  "description": "Whether this price is selectable by customers.",
-                  "type": "boolean"
-                },
-                "hidden": {
-                  "description": "Hide this price. Hidden prices can still be shown using query parameters.",
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "id": {
-                  "description": "Unique price identifier.",
-                  "example": "507f1f77bcf86cd799439011",
-                  "type": "string"
-                },
-                "isDefault": {
-                  "description": "Whether checkout pre-selects this price: the entry `defaultPriceId` names. False on every price when the product has several prices and no default.",
-                  "type": "boolean"
-                },
-                "label": {
-                  "description": "Optional seller-facing label (e.g. \"Monthly\", \"Annual\").",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "order": {
-                  "description": "Dashboard display order.",
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "payWhatYouWant": {
-                  "description": "Whether pay-what-you-want pricing is enabled.",
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "paymentPlan": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "billingCycleAnchorConfig": {
-                          "anyOf": [
-                            {
-                              "additionalProperties": false,
-                              "properties": {
-                                "dayOfMonth": {
-                                  "anyOf": [
-                                    {
-                                      "maximum": 31,
-                                      "minimum": 1,
-                                      "type": "number"
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ],
-                                  "description": "Day of month the billing cycle is anchored to."
-                                },
-                                "enabled": {
-                                  "type": [
-                                    "boolean",
-                                    "null"
-                                  ]
-                                },
-                                "month": {
-                                  "anyOf": [
-                                    {
-                                      "maximum": 12,
-                                      "minimum": 1,
-                                      "type": "number"
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ]
-                                }
-                              },
-                              "type": "object"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "interval": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "day",
-                                "week",
-                                "month",
-                                "year"
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Billing interval (day, week, month, year).",
-                          "example": "month"
-                        },
-                        "intervalCount": {
-                          "description": "Number of intervals between billings.",
-                          "example": 1,
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        },
-                        "planIterations": {
-                          "description": "Number of billing cycles after which the plan completes.",
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        },
-                        "startDate": {
-                          "anyOf": [
-                            {
-                              "format": "date-time",
-                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "The date on which the subscription begins."
-                        },
-                        "trialPeriodDays": {
-                          "description": "Trial period in days.",
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Payment plan configuration — recurring billing that completes after `planIterations` cycles. Never present together with recurring."
-                },
-                "pwywSuggestedPrice": {
-                  "description": "Suggested price in cents for PWYW prices.",
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "recurring": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "billingCycleAnchorConfig": {
-                          "anyOf": [
-                            {
-                              "additionalProperties": false,
-                              "properties": {
-                                "dayOfMonth": {
-                                  "anyOf": [
-                                    {
-                                      "maximum": 31,
-                                      "minimum": 1,
-                                      "type": "number"
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ],
-                                  "description": "Day of month the billing cycle is anchored to."
-                                },
-                                "enabled": {
-                                  "type": [
-                                    "boolean",
-                                    "null"
-                                  ]
-                                },
-                                "month": {
-                                  "anyOf": [
-                                    {
-                                      "maximum": 12,
-                                      "minimum": 1,
-                                      "type": "number"
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ]
-                                }
-                              },
-                              "type": "object"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "interval": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "day",
-                                "week",
-                                "month",
-                                "year"
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Billing interval (day, week, month, year).",
-                          "example": "month"
-                        },
-                        "intervalCount": {
-                          "description": "Number of intervals between billings.",
-                          "example": 1,
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        },
-                        "startDate": {
-                          "anyOf": [
-                            {
-                              "format": "date-time",
-                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "The date on which the subscription begins."
-                        },
-                        "trialPeriodDays": {
-                          "description": "Trial period in days.",
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Recurring billing configuration. Never present together with paymentPlan."
-                },
-                "reference": {
-                  "description": "Merchant-facing internal id used in exports and reports (e.g. `price_one_time_fixed_5000`).",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "setupFee": {
-                  "description": "One-time setup fee in cents.",
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "setupFeeMultipliesWithQuantity": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                }
-              },
-              "required": [
-                "amount",
-                "currency",
-                "id",
-                "enabled",
-                "isDefault",
-                "billingType"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Explicit price list for this product. Populated when the product was created with `prices[]`. Each entry includes an `isDefault` flag. Use `defaultPriceId` to find the pre-selected price. Disabled prices are filtered from customer-facing reads but appear in seller API responses."
-      },
-      "role": {
-        "anyOf": [
-          {
-            "description": "What the product is for. `orderbump` products are the simplified add-ons a checkout page offers as order bumps and an event page offers as add-ons; they can never be sold as a page product, and a product cannot be converted between roles. `orderbump` products are only available for beta testing of the order bump feature.",
-            "enum": [
-              "product",
-              "orderbump"
-            ],
-            "example": "product",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "shortDescription": {
-        "description": "Plain-text one-liner, shown where the full description is too long.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "sku": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "stock": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "taxBehavior": {
-        "anyOf": [
-          {
-            "description": "Tax behavior for this product. Determines how taxes are calculated and displayed. Options include inclusive (tax included in price), exclusive (tax added on top of price), automatic (tax behavior determined by Stripe based on tax settings), or default (use default tax behavior).",
-            "enum": [
-              "inclusive",
-              "exclusive",
-              "automatic",
-              ""
-            ],
-            "example": "exclusive",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "taxCode": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "title": {
-        "description": "Product title.",
-        "example": "Premium Course",
-        "type": "string"
-      },
-      "type": {
-        "description": "Product type.",
-        "enum": [
-          "charge",
-          "subscription"
-        ],
-        "example": "charge",
-        "type": "string"
-      },
-      "updatedAt": {
-        "description": "ISO 8601 timestamp when the product was last updated.",
-        "type": "string"
-      },
-      "variants": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "hidden": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "increasesWithQuantity": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "layout": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "collapseVariantOptions": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "imageSize": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "small",
-                                "medium",
-                                "large",
-                                ""
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "showPwywPlaceholder": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "showVariantName": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "showVariantOptionNames": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "showVariantOptionPriceSign": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "showVariantOptionPrices": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "spacing": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "comfortable",
-                                "compact",
-                                ""
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "textAlign": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "left",
-                                "center",
-                                "stack",
-                                ""
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "variantOptionColumns": {
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        },
-                        "variantOptionLayout": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "list",
-                                "grid"
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "manageVariantOptionStock": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": "string"
-                },
-                "options": {
-                  "anyOf": [
-                    {
-                      "items": {
-                        "additionalProperties": false,
-                        "properties": {
-                          "additionalChargeAmount": {
-                            "type": [
-                              "number",
-                              "null"
-                            ]
-                          },
-                          "description": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "fileIds": {
-                            "anyOf": [
-                              {
-                                "items": {
-                                  "pattern": "^[0-9a-fA-F]{24}$",
-                                  "type": "string"
-                                },
-                                "type": "array"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "image": {
-                            "anyOf": [
-                              {
-                                "additionalProperties": false,
-                                "properties": {
-                                  "fileId": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "height": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "name": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "size": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "url": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "width": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  }
-                                },
-                                "type": "object"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "name": {
-                            "type": "string"
-                          },
-                          "payWhatYouWant": {
-                            "type": [
-                              "boolean",
-                              "null"
-                            ]
-                          },
-                          "pwywSuggestedPrice": {
-                            "type": [
-                              "number",
-                              "null"
-                            ]
-                          },
-                          "sku": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "status": {
-                            "anyOf": [
-                              {
-                                "description": "Status of a product variant, indicating whether it is enabled, disabled, or deleted.",
-                                "enum": [
-                                  "enabled",
-                                  "disabled",
-                                  "deleted"
-                                ],
-                                "example": "enabled",
-                                "type": "string"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "stock": {
-                            "type": [
-                              "number",
-                              "null"
-                            ]
-                          },
-                          "type": {
-                            "anyOf": [
-                              {
-                                "enum": [
-                                  "one_time",
-                                  "recurring",
-                                  "pay_what_you_want"
-                                ],
-                                "type": "string"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name"
-                        ],
-                        "type": "object"
-                      },
-                      "type": "array"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "order": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "preselect": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "enabled": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "optionId": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "quantity": {
-                          "type": [
-                            "number",
-                            "null"
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "priceIds": {
-                  "anyOf": [
-                    {
-                      "items": {
-                        "pattern": "^[0-9a-fA-F]{24}$",
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "Price IDs this variant group is scoped to. Present only when the product has multiple prices. Customers see this variant group only when the corresponding price is selected."
-                },
-                "reference": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "required": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                },
-                "selectionType": {
-                  "anyOf": [
-                    {
-                      "description": "Selection type for product variants, indicating how customers can select variant options in a variant. Options include single (only one option can be selected), multiple (multiple options can be selected), or quantity (customer can specify quantity for each option).",
-                      "enum": [
-                        "single",
-                        "multiple",
-                        "quantity"
-                      ],
-                      "example": "single",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "showHideLogic": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "comparison": {
-                          "anyOf": [
-                            {
-                              "enum": [
-                                "is",
-                                "is_not",
-                                "is_empty",
-                                "is_not_empty",
-                                "contains"
-                              ],
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "element": {
-                          "anyOf": [
-                            {
-                              "additionalProperties": false,
-                              "properties": {
-                                "elementId": {
-                                  "type": [
-                                    "string",
-                                    "null"
-                                  ]
-                                }
-                              },
-                              "type": "object"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "enabled": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "value": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "status": {
-                  "anyOf": [
-                    {
-                      "description": "Status of a product variant, indicating whether it is enabled, disabled, or deleted.",
-                      "enum": [
-                        "enabled",
-                        "disabled",
-                        "deleted"
-                      ],
-                      "example": "enabled",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "useVariantOptionSkus": {
-                  "type": [
-                    "boolean",
-                    "null"
-                  ]
-                }
-              },
-              "required": [
-                "name"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Product variants."
-      },
-      "variantsRequired": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "id",
-      "type",
-      "title",
-      "price",
-      "createdAt",
-      "updatedAt"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "callToActionText": {
+        "description": "Accept copy shown on an order-bump card, e.g. \"Yes! Add gift wrapping\".",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "calloutIcon": {
+        "anyOf": [
+          {
+            "description": "Icon shown before the badge text.",
+            "enum": [
+              "star",
+              "sparkles",
+              "fire",
+              "bolt",
+              "rocket",
+              "trophy",
+              "check",
+              "x-mark",
+              "plus",
+              "arrow-right",
+              "check-badge",
+              "check-circle",
+              "shield-check",
+              "thumbs-up",
+              "heart",
+              "smile",
+              "light-bulb",
+              "sun",
+              "moon",
+              "gift",
+              "tag",
+              "percent",
+              "dollar",
+              "banknotes",
+              "credit-card",
+              "shopping-bag",
+              "shopping-cart",
+              "truck",
+              "clock",
+              "calendar",
+              "bell",
+              "megaphone",
+              "trending-up",
+              "chart",
+              "refresh",
+              "lock",
+              "key",
+              "ticket",
+              "users",
+              "academic-cap",
+              "book",
+              "music",
+              "video",
+              "document",
+              "download",
+              "mobile",
+              "camera",
+              "paint-brush",
+              "puzzle",
+              "cube",
+              "globe",
+              "map-pin",
+              "storefront",
+              "tools",
+              "beaker",
+              "lifebuoy",
+              "chat",
+              "envelope",
+              "phone",
+              "cake",
+              "scale",
+              "eye"
+            ],
+            "example": "star",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Icon leading the call out box."
+      },
+      "calloutText": {
+        "description": "Call out box shown on an order-bump card under the description. Sanitised HTML: links and inline emphasis only.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "createdAt": {
+        "description": "ISO 8601 timestamp when the product was created.",
+        "type": "string"
+      },
+      "defaultPriceId": {
+        "description": "The price pre-selected at checkout: the saved default while it is enabled, or the only enabled price. Null when the product has several prices and no default, so the buyer chooses one.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "description": {
+        "description": "Product description as HTML.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "discounts": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "amountOff": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "maxQuantity": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "minQuantity": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "percentOff": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "quantityCondition": {
+                  "enum": [
+                    "checkout_quantity",
+                    "variant_option_quantity"
+                  ],
+                  "type": "string"
+                },
+                "variantOptionIds": {
+                  "anyOf": [
+                    {
+                      "items": {
+                        "pattern": "^[0-9a-fA-F]{24}$",
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "quantityCondition"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Bulk discount tiers."
+      },
+      "enableFileAccessForInactiveSubscriptions": {
+        "description": "Whether customers with inactive subscriptions can still access file downloads.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "features": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "icon": {
+                  "anyOf": [
+                    {
+                      "description": "Icon leading a feature line, or `none` for no icon.",
+                      "enum": [
+                        "star",
+                        "sparkles",
+                        "fire",
+                        "bolt",
+                        "rocket",
+                        "trophy",
+                        "check",
+                        "x-mark",
+                        "plus",
+                        "arrow-right",
+                        "check-badge",
+                        "check-circle",
+                        "shield-check",
+                        "thumbs-up",
+                        "heart",
+                        "smile",
+                        "light-bulb",
+                        "sun",
+                        "moon",
+                        "gift",
+                        "tag",
+                        "percent",
+                        "dollar",
+                        "banknotes",
+                        "credit-card",
+                        "shopping-bag",
+                        "shopping-cart",
+                        "truck",
+                        "clock",
+                        "calendar",
+                        "bell",
+                        "megaphone",
+                        "trending-up",
+                        "chart",
+                        "refresh",
+                        "lock",
+                        "key",
+                        "ticket",
+                        "users",
+                        "academic-cap",
+                        "book",
+                        "music",
+                        "video",
+                        "document",
+                        "download",
+                        "mobile",
+                        "camera",
+                        "paint-brush",
+                        "puzzle",
+                        "cube",
+                        "globe",
+                        "map-pin",
+                        "storefront",
+                        "tools",
+                        "beaker",
+                        "lifebuoy",
+                        "chat",
+                        "envelope",
+                        "phone",
+                        "cake",
+                        "scale",
+                        "eye",
+                        "none"
+                      ],
+                      "example": "check-circle",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Icon leading the line. Unset, the line leads with a check; `none` draws no icon."
+                },
+                "text": {
+                  "description": "One line of the list.",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "text"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Short list of what the customer gets, shown on an order-bump card above the description."
+      },
+      "fileIds": {
+        "anyOf": [
+          {
+            "items": {
+              "pattern": "^[0-9a-fA-F]{24}$",
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "fixedTaxRateIds": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 1,
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Applied Tax Rate IDs for this product."
+      },
+      "generateLicenseKeys": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "hasUnlimitedStock": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "headingText": {
+        "description": "Heading shown above an order-bump card, e.g. \"Special one time offer\".",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "id": {
+        "description": "Unique identifier for the product.",
+        "type": "string"
+      },
+      "limitPayments": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "enabled": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "enabledAt": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Duplicate-payment prevention settings for this product. Applies to one-time payments only."
+      },
+      "limitSubscriptions": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "enabled": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "limitSubscriptionsStripe": {
+                "anyOf": [
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Duplicate-subscription prevention settings for this product."
+      },
+      "media": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "fileId": {
+                  "description": "File ID of the media asset.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "height": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "size": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "url": {
+                  "description": "CDN URL of the media asset.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "width": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Product images."
+      },
+      "price": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "description": "Price in smallest currency unit (cents).",
+            "example": 4900,
+            "type": "number"
+          },
+          "currency": {
+            "description": "Lowercase ISO 4217 currency code.",
+            "example": "usd",
+            "type": "string"
+          },
+          "discountedFromPrice": {
+            "description": "Original price before discount, in cents.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "payWhatYouWant": {
+            "description": "Whether pay-what-you-want pricing is enabled.",
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "paymentPlan": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "billingCycleAnchorConfig": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": false,
+                        "properties": {
+                          "dayOfMonth": {
+                            "anyOf": [
+                              {
+                                "maximum": 31,
+                                "minimum": 1,
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Day of month the billing cycle is anchored to."
+                          },
+                          "enabled": {
+                            "type": [
+                              "boolean",
+                              "null"
+                            ]
+                          },
+                          "month": {
+                            "anyOf": [
+                              {
+                                "maximum": 12,
+                                "minimum": 1,
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "interval": {
+                    "anyOf": [
+                      {
+                        "enum": [
+                          "day",
+                          "week",
+                          "month",
+                          "year"
+                        ],
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Billing interval (day, week, month, year).",
+                    "example": "month"
+                  },
+                  "intervalCount": {
+                    "description": "Number of intervals between billings.",
+                    "example": 1,
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "planIterations": {
+                    "description": "Number of billing cycles after which the plan completes.",
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "startDate": {
+                    "anyOf": [
+                      {
+                        "format": "date-time",
+                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "The date on which the subscription begins."
+                  },
+                  "trialPeriodDays": {
+                    "description": "Trial period in days.",
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Payment plan configuration — recurring billing that completes after `planIterations` cycles. Never present together with recurring."
+          },
+          "pricingType": {
+            "anyOf": [
+              {
+                "description": "Pricing type for this product - single price or multiple prices using variants.",
+                "enum": [
+                  "single",
+                  "multiple"
+                ],
+                "example": "single",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "deprecated": true,
+            "description": "Deprecated — superseded by `prices[]`. Retained for backward compatibility.",
+            "example": "single"
+          },
+          "recurring": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "billingCycleAnchorConfig": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": false,
+                        "properties": {
+                          "dayOfMonth": {
+                            "anyOf": [
+                              {
+                                "maximum": 31,
+                                "minimum": 1,
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Day of month the billing cycle is anchored to."
+                          },
+                          "enabled": {
+                            "type": [
+                              "boolean",
+                              "null"
+                            ]
+                          },
+                          "month": {
+                            "anyOf": [
+                              {
+                                "maximum": 12,
+                                "minimum": 1,
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "interval": {
+                    "anyOf": [
+                      {
+                        "enum": [
+                          "day",
+                          "week",
+                          "month",
+                          "year"
+                        ],
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Billing interval (day, week, month, year).",
+                    "example": "month"
+                  },
+                  "intervalCount": {
+                    "description": "Number of intervals between billings.",
+                    "example": 1,
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "startDate": {
+                    "anyOf": [
+                      {
+                        "format": "date-time",
+                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "The date on which the subscription begins."
+                  },
+                  "trialPeriodDays": {
+                    "description": "Trial period in days.",
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Recurring billing configuration. Never present together with paymentPlan."
+          },
+          "setupFee": {
+            "description": "One-time setup fee in cents.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "setupFeeMultipliesWithQuantity": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "amount",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "pricePicker": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "description": {
+                "description": "Text shown above the price options.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "priceDisplayDefaults": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "type": "string"
+                    },
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "priceDisplayLabels": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "additionalProperties": {
+                        "type": "string"
+                      },
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "type": "object"
+                    },
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "priceDisplayTabOrder": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "shortenDescription": {
+                "description": "Whether long price descriptions are cut behind a Show more link.",
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "title": {
+                "description": "Heading shown above the price options.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Price picker settings: the heading and description above the options, Show more / less, and tab labels, defaults and order."
+      },
+      "prices": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "description": "A single price entry on a multi-price product.",
+              "properties": {
+                "amount": {
+                  "description": "Price in smallest currency unit (cents).",
+                  "example": 4900,
+                  "type": "number"
+                },
+                "badge": {
+                  "description": "Optional short label shown over the price card.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "badgeIcon": {
+                  "anyOf": [
+                    {
+                      "description": "Icon shown before the badge text.",
+                      "enum": [
+                        "star",
+                        "sparkles",
+                        "fire",
+                        "bolt",
+                        "rocket",
+                        "trophy",
+                        "check",
+                        "x-mark",
+                        "plus",
+                        "arrow-right",
+                        "check-badge",
+                        "check-circle",
+                        "shield-check",
+                        "thumbs-up",
+                        "heart",
+                        "smile",
+                        "light-bulb",
+                        "sun",
+                        "moon",
+                        "gift",
+                        "tag",
+                        "percent",
+                        "dollar",
+                        "banknotes",
+                        "credit-card",
+                        "shopping-bag",
+                        "shopping-cart",
+                        "truck",
+                        "clock",
+                        "calendar",
+                        "bell",
+                        "megaphone",
+                        "trending-up",
+                        "chart",
+                        "refresh",
+                        "lock",
+                        "key",
+                        "ticket",
+                        "users",
+                        "academic-cap",
+                        "book",
+                        "music",
+                        "video",
+                        "document",
+                        "download",
+                        "mobile",
+                        "camera",
+                        "paint-brush",
+                        "puzzle",
+                        "cube",
+                        "globe",
+                        "map-pin",
+                        "storefront",
+                        "tools",
+                        "beaker",
+                        "lifebuoy",
+                        "chat",
+                        "envelope",
+                        "phone",
+                        "cake",
+                        "scale",
+                        "eye"
+                      ],
+                      "example": "star",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Optional icon shown before the badge text."
+                },
+                "billingType": {
+                  "description": "Billing type. Immutable once the price exists (see the pricing-type identity lock).",
+                  "enum": [
+                    "one_time",
+                    "recurring"
+                  ],
+                  "example": "one_time",
+                  "type": "string"
+                },
+                "currency": {
+                  "description": "Lowercase ISO 4217 currency code.",
+                  "example": "usd",
+                  "type": "string"
+                },
+                "discountedFromPrice": {
+                  "description": "Original price before discount, in cents.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "enabled": {
+                  "description": "Whether this price is selectable by customers.",
+                  "type": "boolean"
+                },
+                "hidden": {
+                  "description": "Hide this price. Hidden prices can still be shown using query parameters.",
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "id": {
+                  "description": "Unique price identifier.",
+                  "example": "507f1f77bcf86cd799439011",
+                  "type": "string"
+                },
+                "isDefault": {
+                  "description": "Whether checkout pre-selects this price: the entry `defaultPriceId` names. False on every price when the product has several prices and no default.",
+                  "type": "boolean"
+                },
+                "label": {
+                  "description": "Optional seller-facing label (e.g. \"Monthly\", \"Annual\").",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "order": {
+                  "description": "Dashboard display order.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "payWhatYouWant": {
+                  "description": "Whether pay-what-you-want pricing is enabled.",
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "paymentPlan": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "billingCycleAnchorConfig": {
+                          "anyOf": [
+                            {
+                              "additionalProperties": false,
+                              "properties": {
+                                "dayOfMonth": {
+                                  "anyOf": [
+                                    {
+                                      "maximum": 31,
+                                      "minimum": 1,
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "description": "Day of month the billing cycle is anchored to."
+                                },
+                                "enabled": {
+                                  "type": [
+                                    "boolean",
+                                    "null"
+                                  ]
+                                },
+                                "month": {
+                                  "anyOf": [
+                                    {
+                                      "maximum": 12,
+                                      "minimum": 1,
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                }
+                              },
+                              "type": "object"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "interval": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "day",
+                                "week",
+                                "month",
+                                "year"
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Billing interval (day, week, month, year).",
+                          "example": "month"
+                        },
+                        "intervalCount": {
+                          "description": "Number of intervals between billings.",
+                          "example": 1,
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        },
+                        "planIterations": {
+                          "description": "Number of billing cycles after which the plan completes.",
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        },
+                        "startDate": {
+                          "anyOf": [
+                            {
+                              "format": "date-time",
+                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "The date on which the subscription begins."
+                        },
+                        "trialPeriodDays": {
+                          "description": "Trial period in days.",
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Payment plan configuration — recurring billing that completes after `planIterations` cycles. Never present together with recurring."
+                },
+                "pwywSuggestedPrice": {
+                  "description": "Suggested price in cents for PWYW prices.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "recurring": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "billingCycleAnchorConfig": {
+                          "anyOf": [
+                            {
+                              "additionalProperties": false,
+                              "properties": {
+                                "dayOfMonth": {
+                                  "anyOf": [
+                                    {
+                                      "maximum": 31,
+                                      "minimum": 1,
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "description": "Day of month the billing cycle is anchored to."
+                                },
+                                "enabled": {
+                                  "type": [
+                                    "boolean",
+                                    "null"
+                                  ]
+                                },
+                                "month": {
+                                  "anyOf": [
+                                    {
+                                      "maximum": 12,
+                                      "minimum": 1,
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                }
+                              },
+                              "type": "object"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "interval": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "day",
+                                "week",
+                                "month",
+                                "year"
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Billing interval (day, week, month, year).",
+                          "example": "month"
+                        },
+                        "intervalCount": {
+                          "description": "Number of intervals between billings.",
+                          "example": 1,
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        },
+                        "startDate": {
+                          "anyOf": [
+                            {
+                              "format": "date-time",
+                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "The date on which the subscription begins."
+                        },
+                        "trialPeriodDays": {
+                          "description": "Trial period in days.",
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Recurring billing configuration. Never present together with paymentPlan."
+                },
+                "reference": {
+                  "description": "Merchant-facing internal id used in exports and reports (e.g. `price_one_time_fixed_5000`).",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "setupFee": {
+                  "description": "One-time setup fee in cents.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "setupFeeMultipliesWithQuantity": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "amount",
+                "currency",
+                "id",
+                "enabled",
+                "isDefault",
+                "billingType"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Explicit price list for this product. Populated when the product was created with `prices[]`. Each entry includes an `isDefault` flag. Use `defaultPriceId` to find the pre-selected price. Disabled prices are filtered from customer-facing reads but appear in seller API responses."
+      },
+      "role": {
+        "anyOf": [
+          {
+            "description": "What the product is for. `orderbump` products are the simplified add-ons a checkout page offers as order bumps and an event page offers as add-ons; they can never be sold as a page product, and a product cannot be converted between roles.",
+            "enum": [
+              "product",
+              "orderbump"
+            ],
+            "example": "product",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "shortDescription": {
+        "description": "Plain-text one-liner, shown where the full description is too long.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sku": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "stock": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "taxBehavior": {
+        "anyOf": [
+          {
+            "description": "Tax behavior for this product. Determines how taxes are calculated and displayed. Options include inclusive (tax included in price), exclusive (tax added on top of price), automatic (tax behavior determined by Stripe based on tax settings), or default (use default tax behavior).",
+            "enum": [
+              "inclusive",
+              "exclusive",
+              "automatic",
+              ""
+            ],
+            "example": "exclusive",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "taxCode": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "description": "Product title.",
+        "example": "Premium Course",
+        "type": "string"
+      },
+      "type": {
+        "description": "Product type.",
+        "enum": [
+          "charge",
+          "subscription"
+        ],
+        "example": "charge",
+        "type": "string"
+      },
+      "updatedAt": {
+        "description": "ISO 8601 timestamp when the product was last updated.",
+        "type": "string"
+      },
+      "variants": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "hidden": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "increasesWithQuantity": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "layout": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "collapseVariantOptions": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "imageSize": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "small",
+                                "medium",
+                                "large",
+                                ""
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "showPwywPlaceholder": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "showVariantName": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "showVariantOptionNames": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "showVariantOptionPriceSign": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "showVariantOptionPrices": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "spacing": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "comfortable",
+                                "compact",
+                                ""
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "textAlign": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "left",
+                                "center",
+                                "stack",
+                                ""
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "variantOptionColumns": {
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        },
+                        "variantOptionLayout": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "list",
+                                "grid"
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "manageVariantOptionStock": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": "string"
+                },
+                "options": {
+                  "anyOf": [
+                    {
+                      "items": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "additionalChargeAmount": {
+                            "type": [
+                              "number",
+                              "null"
+                            ]
+                          },
+                          "description": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "fileIds": {
+                            "anyOf": [
+                              {
+                                "items": {
+                                  "pattern": "^[0-9a-fA-F]{24}$",
+                                  "type": "string"
+                                },
+                                "type": "array"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "image": {
+                            "anyOf": [
+                              {
+                                "additionalProperties": false,
+                                "properties": {
+                                  "fileId": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "height": {
+                                    "type": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "name": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "size": {
+                                    "type": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "url": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "width": {
+                                    "type": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "payWhatYouWant": {
+                            "type": [
+                              "boolean",
+                              "null"
+                            ]
+                          },
+                          "pwywSuggestedPrice": {
+                            "type": [
+                              "number",
+                              "null"
+                            ]
+                          },
+                          "sku": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "status": {
+                            "anyOf": [
+                              {
+                                "description": "Status of a product variant, indicating whether it is enabled, disabled, or deleted.",
+                                "enum": [
+                                  "enabled",
+                                  "disabled",
+                                  "deleted"
+                                ],
+                                "example": "enabled",
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "stock": {
+                            "type": [
+                              "number",
+                              "null"
+                            ]
+                          },
+                          "type": {
+                            "anyOf": [
+                              {
+                                "enum": [
+                                  "one_time",
+                                  "recurring",
+                                  "pay_what_you_want"
+                                ],
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        },
+                        "required": [
+                          "name"
+                        ],
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "order": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "preselect": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "optionId": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "quantity": {
+                          "type": [
+                            "number",
+                            "null"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "priceIds": {
+                  "anyOf": [
+                    {
+                      "items": {
+                        "pattern": "^[0-9a-fA-F]{24}$",
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Price IDs this variant group is scoped to. Present only when the product has multiple prices. Customers see this variant group only when the corresponding price is selected."
+                },
+                "reference": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "required": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "selectionType": {
+                  "anyOf": [
+                    {
+                      "description": "Selection type for product variants, indicating how customers can select variant options in a variant. Options include single (only one option can be selected), multiple (multiple options can be selected), or quantity (customer can specify quantity for each option).",
+                      "enum": [
+                        "single",
+                        "multiple",
+                        "quantity"
+                      ],
+                      "example": "single",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "showHideLogic": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "comparison": {
+                          "anyOf": [
+                            {
+                              "enum": [
+                                "is",
+                                "is_not",
+                                "is_empty",
+                                "is_not_empty",
+                                "contains"
+                              ],
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "element": {
+                          "anyOf": [
+                            {
+                              "additionalProperties": false,
+                              "properties": {
+                                "elementId": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                }
+                              },
+                              "type": "object"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "value": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "status": {
+                  "anyOf": [
+                    {
+                      "description": "Status of a product variant, indicating whether it is enabled, disabled, or deleted.",
+                      "enum": [
+                        "enabled",
+                        "disabled",
+                        "deleted"
+                      ],
+                      "example": "enabled",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "useVariantOptionSkus": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "name"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Product variants."
+      },
+      "variantsRequired": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "id",
+      "type",
+      "title",
+      "price",
+      "createdAt",
+      "updatedAt"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

First observedOct 15, 2026

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true and openWorldHint=true. The description reinforces this with 'customers see it right away' and 'there is no undo, because the previous values are not kept' — meaningful confirmation of the destructive profile beyond the annotation. It also discloses that changing themeId replaces the page's own theme settings. Minor gaps remain (auth/permissions), but the behavioral picture is strong and consistent with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose and the partial-update precondition, then scoping, then destructive warning, then theme guidance. Each sentence carries information, though it runs several compact clauses long. No filler, but dense.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 57-parameter mutation tool with an output schema (so return values need no explanation), the description covers the high-risk ambiguities: partial-update workflow, destructive immediacy, cross-resource routing, and theme replacement semantics. A few specialized sub-objects (fees, payment options, funnel steps) rely on their own schema descriptions, which is acceptable at 72% coverage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 72%, so the schema already documents most fields. The description adds genuine value on the trickiest params: it explains that themeOverrides carries design and labels including translations, that hostedLayoutType relates to layout, and that themeId replaces existing theme settings requiring themeOverrides to be resent. This is more than the schema alone conveys for these nested/opaque fields.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Update an existing checkout page's content and settings') and immediately scopes it against the sibling create tool ('Supports a subset of create's fields'). An agent can distinguish this from create_checkout_page, get_checkout_page, and update_product without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly directs the agent to read current values with get_checkout_page before a partial update, routes product settings to update_product, routes custom fields to create_field/update_field/delete_field, and routes theme work to list_theme_properties and list_themes. Coverage of when-to-use-each-alternative is unusually thorough.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Checkout Page tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?