@wix/ecom 1.0.713 → 1.0.715

package/type-bundles/meta.bundle.d.ts

@@ -3060,6 +3060,13 @@ interface LineItem$7 {
      * @readonly
      */
     consentRequiredPaymentPolicy?: string | null;
+    /**
+     * Overriding values for catalog item properties.
+     *
+     * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
+    catalogOverrideFields?: CatalogOverrideFields$7;
     /**
      * Whether to save the payment method on the order.
      *
@@ -3312,6 +3319,20 @@ interface SelectedMembership$7 {
     /** ID of the app providing this payment option. */
     appId?: string;
 }
+interface CatalogOverrideFields$7 {
+    /** Item name. */
+    productName?: ProductName$b;
+    /** Item price **after** discounts. */
+    price?: string | null;
+    /** Item price **before** discounts. */
+    fullPrice?: string | null;
+    /** Item description lines. Used when displaying the line item to customers. */
+    descriptionLines?: DescriptionLine$b[];
+    /** Physical properties of the item. */
+    physicalProperties?: PhysicalProperties$d;
+    /** Item image. */
+    image?: Image$6;
+}
 interface Image$6 {
     /** WixMedia image ID. */
     id?: string;
@@ -3483,7 +3504,12 @@ interface UpdateCartRequest$3 {
     merchantDiscounts?: MerchantDiscountInput$5[];
     /** Catalog line items. */
     lineItems?: LineItem$7[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$9[];
 }
 interface MerchantDiscountInput$5 {
@@ -3514,31 +3540,30 @@ interface CustomLineItem$9 {
     media?: Image$6;
     /**
      * Custom line item ID. If passed, `id` must be unique.
-     * Default: auto-generated ID.
+     *
+     * Default: auto-generated ID
      */
     id?: string | null;
     /** Tax group ID for this custom line item. */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName$b;
-    /**
-     * Optional - URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
-     * The URL is optional and if not provided, the site URL will be used.
-     */
+    /** URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work. */
     url?: PageUrlV2$4;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType$d;
-    /** Optional - Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
     fullPrice?: string | null;
     /**
-     * Optional - Item quantity available for purchase. Only return this if inventory is managed.
+     * Item quantity available for purchase. Only return this if inventory is managed.
      * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
      */
     quantityAvailable?: number | null;
-    /** Optional - Physical properties of the item. When relevant, contains information such as SKU and item weight. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$d;
     /**
-     * Optional - Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     *
      * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
      * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
      * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
@@ -3546,21 +3571,23 @@ interface CustomLineItem$9 {
      */
     paymentOption?: PaymentOptionType$d;
     /**
-     * Optional - Service properties. When relevant, this contains information such as date and number of participants.
+     * Service properties. When relevant, this contains information such as date and number of participants.
      * Used, among other things, when checking for valid memberships.
      */
     serviceProperties?: ServiceProperties$9;
     /**
-     * Optional - In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     *
      * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
-     * + in most cases, this field is the name as `catalogReference.catalogItemId`.
+     * + In most cases, this field is the same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
      */
     rootCatalogItemId?: string | null;
     /**
-     * Optional - partial payment for the given item to be paid upfront during the checkout.
+     * Partial payment for the given item to be paid upfront during the checkout.
+     *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
-     * If omitted - item's price will not be split and is expected to be paid in single installment
+     * When omitted, the item's price will not be split and is expected to be paid in a single installment.
      */
     depositAmount?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. */
@@ -4262,7 +4289,12 @@ interface CreateCartRequest$1 {
     merchantDiscounts?: MerchantDiscountInput$5[];
     /** Catalog line items. */
     lineItems?: LineItem$7[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$9[];
 }
 interface CreateCartResponse$1 {
@@ -4282,7 +4314,12 @@ interface AddToCartRequest$1 {
     id: string;
     /** Catalog line items. */
     lineItems?: LineItem$7[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$9[];
 }
 interface RemoveLineItemsRequest$3 {
@@ -4973,6 +5010,13 @@ interface LineItem$6 {
      * @readonly
      */
     consentRequiredPaymentPolicy?: string | null;
+    /**
+     * Overriding values for catalog item properties.
+     *
+     * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
+    catalogOverrideFields?: CatalogOverrideFields$6;
     /**
      * Whether to save the payment method on the order.
      *
@@ -5175,6 +5219,20 @@ interface SelectedMembership$6 {
     /** ID of the app providing this payment option. */
     appId?: string;
 }
+interface CatalogOverrideFields$6 {
+    /** Item name. */
+    productName?: ProductName$a;
+    /** Item price **after** discounts. */
+    price?: string | null;
+    /** Item price **before** discounts. */
+    fullPrice?: string | null;
+    /** Item description lines. Used when displaying the line item to customers. */
+    descriptionLines?: DescriptionLine$a[];
+    /** Physical properties of the item. */
+    physicalProperties?: PhysicalProperties$c;
+    /** Item image. */
+    image?: string;
+}
 /** Buyer Info */
 interface BuyerInfo$8 extends BuyerInfoIdOneOf$8 {
     /**
@@ -5324,7 +5382,12 @@ interface UpdateCartRequest$2 {
     merchantDiscounts?: MerchantDiscountInput$4[];
     /** Catalog line items. */
     lineItems?: LineItem$6[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$8[];
 }
 interface MerchantDiscountInput$4 {
@@ -5359,31 +5422,30 @@ interface CustomLineItem$8 {
     media?: string;
     /**
      * Custom line item ID. If passed, `id` must be unique.
-     * Default: auto-generated ID.
+     *
+     * Default: auto-generated ID
      */
     _id?: string | null;
     /** Tax group ID for this custom line item. */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName$a;
-    /**
-     * Optional - URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
-     * The URL is optional and if not provided, the site URL will be used.
-     */
+    /** URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work. */
     url?: string;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType$c;
-    /** Optional - Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
     fullPrice?: string | null;
     /**
-     * Optional - Item quantity available for purchase. Only return this if inventory is managed.
+     * Item quantity available for purchase. Only return this if inventory is managed.
      * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
      */
     quantityAvailable?: number | null;
-    /** Optional - Physical properties of the item. When relevant, contains information such as SKU and item weight. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$c;
     /**
-     * Optional - Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     *
      * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
      * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
      * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
@@ -5391,21 +5453,23 @@ interface CustomLineItem$8 {
      */
     paymentOption?: PaymentOptionType$c;
     /**
-     * Optional - Service properties. When relevant, this contains information such as date and number of participants.
+     * Service properties. When relevant, this contains information such as date and number of participants.
      * Used, among other things, when checking for valid memberships.
      */
     serviceProperties?: ServiceProperties$8;
     /**
-     * Optional - In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     *
      * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
-     * + in most cases, this field is the name as `catalogReference.catalogItemId`.
+     * + In most cases, this field is the same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
      */
     rootCatalogItemId?: string | null;
     /**
-     * Optional - partial payment for the given item to be paid upfront during the checkout.
+     * Partial payment for the given item to be paid upfront during the checkout.
+     *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
-     * If omitted - item's price will not be split and is expected to be paid in single installment
+     * When omitted, the item's price will not be split and is expected to be paid in a single installment.
      */
     depositAmount?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. */
@@ -6116,7 +6180,12 @@ interface CreateCartRequest {
     merchantDiscounts?: MerchantDiscountInput$4[];
     /** Catalog line items. */
     lineItems?: LineItem$6[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$8[];
 }
 interface CreateCartResponse {
@@ -6136,7 +6205,12 @@ interface AddToCartRequest {
     _id: string;
     /** Catalog line items. */
     lineItems?: LineItem$6[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$8[];
 }
 interface RemoveLineItemsRequest$2 {
@@ -6866,6 +6940,13 @@ interface LineItem$5 {
      * @readonly
      */
     consentRequiredPaymentPolicy?: string | null;
+    /**
+     * Overriding values for catalog item properties.
+     *
+     * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
+    catalogOverrideFields?: CatalogOverrideFields$5;
     /**
      * Whether to save the payment method on the order.
      *
@@ -7118,6 +7199,20 @@ interface SelectedMembership$5 {
     /** ID of the app providing this payment option. */
     appId?: string;
 }
+interface CatalogOverrideFields$5 {
+    /** Item name. */
+    productName?: ProductName$9;
+    /** Item price **after** discounts. */
+    price?: string | null;
+    /** Item price **before** discounts. */
+    fullPrice?: string | null;
+    /** Item description lines. Used when displaying the line item to customers. */
+    descriptionLines?: DescriptionLine$9[];
+    /** Physical properties of the item. */
+    physicalProperties?: PhysicalProperties$b;
+    /** Item image. */
+    image?: Image$5;
+}
 interface Image$5 {
     /** WixMedia image ID. */
     id?: string;
@@ -7295,7 +7390,12 @@ interface UpdateCartRequest$1 {
     merchantDiscounts?: MerchantDiscountInput$3[];
     /** Catalog line items. */
     lineItems?: LineItem$5[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$7[];
 }
 interface MerchantDiscountInput$3 {
@@ -7326,31 +7426,30 @@ interface CustomLineItem$7 {
     media?: Image$5;
     /**
      * Custom line item ID. If passed, `id` must be unique.
-     * Default: auto-generated ID.
+     *
+     * Default: auto-generated ID
      */
     id?: string | null;
     /** Tax group ID for this custom line item. */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName$9;
-    /**
-     * Optional - URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
-     * The URL is optional and if not provided, the site URL will be used.
-     */
+    /** URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work. */
     url?: PageUrlV2$3;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType$b;
-    /** Optional - Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
     fullPrice?: string | null;
     /**
-     * Optional - Item quantity available for purchase. Only return this if inventory is managed.
+     * Item quantity available for purchase. Only return this if inventory is managed.
      * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
      */
     quantityAvailable?: number | null;
-    /** Optional - Physical properties of the item. When relevant, contains information such as SKU and item weight. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$b;
     /**
-     * Optional - Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     *
      * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
      * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
      * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
@@ -7358,21 +7457,23 @@ interface CustomLineItem$7 {
      */
     paymentOption?: PaymentOptionType$b;
     /**
-     * Optional - Service properties. When relevant, this contains information such as date and number of participants.
+     * Service properties. When relevant, this contains information such as date and number of participants.
      * Used, among other things, when checking for valid memberships.
      */
     serviceProperties?: ServiceProperties$7;
     /**
-     * Optional - In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     *
      * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
-     * + in most cases, this field is the name as `catalogReference.catalogItemId`.
+     * + In most cases, this field is the same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
      */
     rootCatalogItemId?: string | null;
     /**
-     * Optional - partial payment for the given item to be paid upfront during the checkout.
+     * Partial payment for the given item to be paid upfront during the checkout.
+     *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
-     * If omitted - item's price will not be split and is expected to be paid in single installment
+     * When omitted, the item's price will not be split and is expected to be paid in a single installment.
      */
     depositAmount?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. */
@@ -7385,7 +7486,12 @@ interface UpdateCartResponse$1 {
 interface AddToCurrentCartRequest$1 {
     /** Catalog line items. */
     lineItems?: LineItem$5[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$7[];
 }
 interface AddToCartResponse$1 {
@@ -8744,6 +8850,13 @@ interface LineItem$4 {
      * @readonly
      */
     consentRequiredPaymentPolicy?: string | null;
+    /**
+     * Overriding values for catalog item properties.
+     *
+     * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
+    catalogOverrideFields?: CatalogOverrideFields$4;
     /**
      * Whether to save the payment method on the order.
      *
@@ -8946,6 +9059,20 @@ interface SelectedMembership$4 {
     /** ID of the app providing this payment option. */
     appId?: string;
 }
+interface CatalogOverrideFields$4 {
+    /** Item name. */
+    productName?: ProductName$8;
+    /** Item price **after** discounts. */
+    price?: string | null;
+    /** Item price **before** discounts. */
+    fullPrice?: string | null;
+    /** Item description lines. Used when displaying the line item to customers. */
+    descriptionLines?: DescriptionLine$8[];
+    /** Physical properties of the item. */
+    physicalProperties?: PhysicalProperties$a;
+    /** Item image. */
+    image?: string;
+}
 /** Buyer Info */
 interface BuyerInfo$6 extends BuyerInfoIdOneOf$6 {
     /**
@@ -9101,7 +9228,12 @@ interface UpdateCartRequest {
     merchantDiscounts?: MerchantDiscountInput$2[];
     /** Catalog line items. */
     lineItems?: LineItem$4[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$6[];
 }
 interface MerchantDiscountInput$2 {
@@ -9136,31 +9268,30 @@ interface CustomLineItem$6 {
     media?: string;
     /**
      * Custom line item ID. If passed, `id` must be unique.
-     * Default: auto-generated ID.
+     *
+     * Default: auto-generated ID
      */
     _id?: string | null;
     /** Tax group ID for this custom line item. */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName$8;
-    /**
-     * Optional - URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
-     * The URL is optional and if not provided, the site URL will be used.
-     */
+    /** URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work. */
     url?: string;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType$a;
-    /** Optional - Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
     fullPrice?: string | null;
     /**
-     * Optional - Item quantity available for purchase. Only return this if inventory is managed.
+     * Item quantity available for purchase. Only return this if inventory is managed.
      * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
      */
     quantityAvailable?: number | null;
-    /** Optional - Physical properties of the item. When relevant, contains information such as SKU and item weight. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$a;
     /**
-     * Optional - Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     *
      * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
      * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
      * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
@@ -9168,21 +9299,23 @@ interface CustomLineItem$6 {
      */
     paymentOption?: PaymentOptionType$a;
     /**
-     * Optional - Service properties. When relevant, this contains information such as date and number of participants.
+     * Service properties. When relevant, this contains information such as date and number of participants.
      * Used, among other things, when checking for valid memberships.
      */
     serviceProperties?: ServiceProperties$6;
     /**
-     * Optional - In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     *
      * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
-     * + in most cases, this field is the name as `catalogReference.catalogItemId`.
+     * + In most cases, this field is the same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
      */
     rootCatalogItemId?: string | null;
     /**
-     * Optional - partial payment for the given item to be paid upfront during the checkout.
+     * Partial payment for the given item to be paid upfront during the checkout.
+     *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
-     * If omitted - item's price will not be split and is expected to be paid in single installment
+     * When omitted, the item's price will not be split and is expected to be paid in a single installment.
      */
     depositAmount?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. */
@@ -9195,7 +9328,12 @@ interface UpdateCartResponse {
 interface AddToCurrentCartRequest {
     /** Catalog line items. */
     lineItems?: LineItem$4[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$6[];
 }
 interface AddToCartResponse {
@@ -10689,11 +10827,23 @@ interface LineItem$3 {
      * @readonly
      */
     depositAmount?: MultiCurrencyPrice$3;
+    /**
+     * Whether the line item is custom or from catalog.
+     * @readonly
+     */
+    customLineItem?: boolean;
     /**
      * Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
      * @readonly
      */
     consentRequiredPaymentPolicy?: string | null;
+    /**
+     * Overriding values for catalog item properties.
+     *
+     * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
+    catalogOverrideFields?: CatalogOverrideFields$3;
     /**
      * Whether to save the payment method on the order.
      *
@@ -10970,6 +11120,20 @@ interface PriceDescription$7 {
      */
     translated?: string | null;
 }
+interface CatalogOverrideFields$3 {
+    /** Item name. */
+    productName?: ProductName$7;
+    /** Item price **after** discounts. */
+    price?: string | null;
+    /** Item price **before** discounts. */
+    fullPrice?: string | null;
+    /** Item description lines. Used when displaying the line item to customers. */
+    descriptionLines?: DescriptionLine$7[];
+    /** Physical properties of the item. */
+    physicalProperties?: PhysicalProperties$9;
+    /** Item image. */
+    image?: Image$4;
+}
 interface Image$4 {
     /** WixMedia image ID. */
     id?: string;
@@ -11758,9 +11922,14 @@ interface CreateCheckoutRequest$1 {
     checkoutInfo?: Checkout$1;
     /** Coupon code. */
     couponCode?: string | null;
-    /** Line items to be added to checkout. */
+    /** Line items to add to the checkout. */
     lineItems?: LineItem$3[];
-    /** Custom line items to be added to checkout. */
+    /**
+     * Custom line items to add to the checkout.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$5[];
     /**
      * Sales channel that submitted the order.
@@ -11815,31 +11984,30 @@ interface CustomLineItem$5 {
     media?: Image$4;
     /**
      * Custom line item ID. If passed, `id` must be unique.
-     * Default: auto-generated ID.
+     *
+     * Default: auto-generated ID
      */
     id?: string | null;
     /** Tax group ID for this custom line item. */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName$7;
-    /**
-     * Optional - URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
-     * The URL is optional and if not provided, the site URL will be used.
-     */
+    /** URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work. */
     url?: PageUrlV2$2;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType$9;
-    /** Optional - Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
     fullPrice?: string | null;
     /**
-     * Optional - Item quantity available for purchase. Only return this if inventory is managed.
+     * Item quantity available for purchase. Only return this if inventory is managed.
      * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
      */
     quantityAvailable?: number | null;
-    /** Optional - Physical properties of the item. When relevant, contains information such as SKU and item weight. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$9;
     /**
-     * Optional - Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     *
      * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
      * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
      * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
@@ -11847,21 +12015,23 @@ interface CustomLineItem$5 {
      */
     paymentOption?: PaymentOptionType$9;
     /**
-     * Optional - Service properties. When relevant, this contains information such as date and number of participants.
+     * Service properties. When relevant, this contains information such as date and number of participants.
      * Used, among other things, when checking for valid memberships.
      */
     serviceProperties?: ServiceProperties$5;
     /**
-     * Optional - In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     *
      * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
-     * + in most cases, this field is the name as `catalogReference.catalogItemId`.
+     * + In most cases, this field is the same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
      */
     rootCatalogItemId?: string | null;
     /**
-     * Optional - partial payment for the given item to be paid upfront during the checkout.
+     * Partial payment for the given item to be paid upfront during the checkout.
+     *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
-     * If omitted - item's price will not be split and is expected to be paid in single installment
+     * When omitted, the item's price will not be split and is expected to be paid in a single installment.
      */
     depositAmount?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. */
@@ -11914,7 +12084,14 @@ interface UpdateCheckoutRequest$1 {
      * standard Wix checkout page. When `overrideCheckoutUrl` has a value, it will replace and set the value of `checkoutUrl`.
      */
     overrideCheckoutUrl?: string | null;
-    /** Custom line items to be saved on checkout. */
+    /** Line items. */
+    lineItems?: LineItem$3[];
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$5[];
 }
 interface UpdateCheckoutResponse$1 {
@@ -11950,7 +12127,12 @@ interface AddToCheckoutRequest$1 {
     id: string;
     /** Catalog line items. */
     lineItems?: LineItem$3[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$5[];
 }
 interface AddToCheckoutResponse$1 {
@@ -12790,11 +12972,23 @@ interface LineItem$2 {
      * @readonly
      */
     depositAmount?: MultiCurrencyPrice$2;
+    /**
+     * Whether the line item is custom or from catalog.
+     * @readonly
+     */
+    customLineItem?: boolean;
     /**
      * Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
      * @readonly
      */
     consentRequiredPaymentPolicy?: string | null;
+    /**
+     * Overriding values for catalog item properties.
+     *
+     * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
+    catalogOverrideFields?: CatalogOverrideFields$2;
     /**
      * Whether to save the payment method on the order.
      *
@@ -13044,6 +13238,20 @@ interface PriceDescription$6 {
      */
     translated?: string | null;
 }
+interface CatalogOverrideFields$2 {
+    /** Item name. */
+    productName?: ProductName$6;
+    /** Item price **after** discounts. */
+    price?: string | null;
+    /** Item price **before** discounts. */
+    fullPrice?: string | null;
+    /** Item description lines. Used when displaying the line item to customers. */
+    descriptionLines?: DescriptionLine$6[];
+    /** Physical properties of the item. */
+    physicalProperties?: PhysicalProperties$8;
+    /** Item image. */
+    image?: string;
+}
 /** Billing Info and shipping details */
 interface AddressWithContact$4 {
     /** Address. */
@@ -13810,9 +14018,14 @@ interface CreateCheckoutRequest {
     checkoutInfo?: Checkout;
     /** The code of an existing coupon to apply to checkout. For more information, see the [Coupons API](https://www.wix.com/velo/reference/wix-marketing-backend/coupons). */
     couponCode?: string | null;
-    /** Line items to be added to checkout. */
+    /** Line items to add to the checkout. */
     lineItems?: LineItem$2[];
-    /** Custom line items to be added to checkout. */
+    /**
+     * Custom line items to add to the checkout.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$4[];
     /**
      * **Required**
@@ -13856,31 +14069,30 @@ interface CustomLineItem$4 {
     media?: string;
     /**
      * Custom line item ID. If passed, `id` must be unique.
-     * Default: auto-generated ID.
+     *
+     * Default: auto-generated ID
      */
     _id?: string | null;
     /** Tax group ID for this custom line item. */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName$6;
-    /**
-     * Optional - URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
-     * The URL is optional and if not provided, the site URL will be used.
-     */
+    /** URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work. */
     url?: string;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType$8;
-    /** Optional - Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
     fullPrice?: string | null;
     /**
-     * Optional - Item quantity available for purchase. Only return this if inventory is managed.
+     * Item quantity available for purchase. Only return this if inventory is managed.
      * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
      */
     quantityAvailable?: number | null;
-    /** Optional - Physical properties of the item. When relevant, contains information such as SKU and item weight. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$8;
     /**
-     * Optional - Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     *
      * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
      * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
      * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
@@ -13888,21 +14100,23 @@ interface CustomLineItem$4 {
      */
     paymentOption?: PaymentOptionType$8;
     /**
-     * Optional - Service properties. When relevant, this contains information such as date and number of participants.
+     * Service properties. When relevant, this contains information such as date and number of participants.
      * Used, among other things, when checking for valid memberships.
      */
     serviceProperties?: ServiceProperties$4;
     /**
-     * Optional - In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     *
      * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
-     * + in most cases, this field is the name as `catalogReference.catalogItemId`.
+     * + In most cases, this field is the same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
      */
     rootCatalogItemId?: string | null;
     /**
-     * Optional - partial payment for the given item to be paid upfront during the checkout.
+     * Partial payment for the given item to be paid upfront during the checkout.
+     *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
-     * If omitted - item's price will not be split and is expected to be paid in single installment
+     * When omitted, the item's price will not be split and is expected to be paid in a single installment.
      */
     depositAmount?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. */
@@ -13949,7 +14163,14 @@ interface UpdateCheckoutRequest {
      * This field overrides the `checkoutUrl` in a cart or checkout. `checkoutUrl` is used to send customers back to their checkouts. By default, a `checkoutUrl` generates for a checkout and directs to a standard Wix checkout page. When `overrideCheckoutUrl` has a value, it will replace and set the value of `checkoutUrl`.
      */
     overrideCheckoutUrl?: string | null;
-    /** Custom line items to be saved on checkout. */
+    /** Line items. */
+    lineItems?: LineItem$2[];
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$4[];
 }
 interface UpdateCheckoutResponse {
@@ -13985,7 +14206,12 @@ interface AddToCheckoutRequest {
     _id: string;
     /** Catalog line items. */
     lineItems?: LineItem$2[];
-    /** Custom line items. */
+    /**
+     * Custom line items.
+     *
+     * To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
     customLineItems?: CustomLineItem$4[];
 }
 interface AddToCheckoutResponse {
@@ -15052,6 +15278,13 @@ interface V1LineItem$1 {
      * > **Note:** For more information on what to pass to `lineItems.catalogReference`, see [eCommerce Integration in the Wix Stores Catalog API](https://dev.wix.com/api/rest/wix-stores/catalog/ecommerce-integration).
      */
     catalogReference?: CatalogReference$7;
+    /**
+     * Overriding values for catalog item properties.
+     *
+     * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
+    catalogOverrideFields?: CatalogOverrideFields$1;
 }
 /** Used for grouping line items. Sent when an item is added to a cart, checkout, or order. */
 interface CatalogReference$7 {
@@ -15075,6 +15308,20 @@ interface CatalogReference$7 {
      */
     options?: Record<string, any> | null;
 }
+interface CatalogOverrideFields$1 {
+    /** Item name. */
+    productName?: ProductName$5;
+    /** Item price **after** discounts. */
+    price?: string | null;
+    /** Item price **before** discounts. */
+    fullPrice?: string | null;
+    /** Item description lines. Used when displaying the line item to customers. */
+    descriptionLines?: DescriptionLine$5[];
+    /** Physical properties of the item. */
+    physicalProperties?: PhysicalProperties$7;
+    /** Item image. */
+    image?: Image$3;
+}
 interface ProductName$5 {
     /**
      * __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
@@ -15189,31 +15436,30 @@ interface CustomLineItem$3 {
     media?: Image$3;
     /**
      * Custom line item ID. If passed, `id` must be unique.
-     * Default: auto-generated ID.
+     *
+     * Default: auto-generated ID
      */
     id?: string | null;
     /** Tax group ID for this custom line item. */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName$5;
-    /**
-     * Optional - URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
-     * The URL is optional and if not provided, the site URL will be used.
-     */
+    /** URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work. */
     url?: PageUrlV2$1;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType$7;
-    /** Optional - Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
     fullPrice?: string | null;
     /**
-     * Optional - Item quantity available for purchase. Only return this if inventory is managed.
+     * Item quantity available for purchase. Only return this if inventory is managed.
      * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
      */
     quantityAvailable?: number | null;
-    /** Optional - Physical properties of the item. When relevant, contains information such as SKU and item weight. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$7;
     /**
-     * Optional - Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     *
      * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
      * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
      * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
@@ -15221,21 +15467,23 @@ interface CustomLineItem$3 {
      */
     paymentOption?: PaymentOptionType$7;
     /**
-     * Optional - Service properties. When relevant, this contains information such as date and number of participants.
+     * Service properties. When relevant, this contains information such as date and number of participants.
      * Used, among other things, when checking for valid memberships.
      */
     serviceProperties?: ServiceProperties$3;
     /**
-     * Optional - In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     *
      * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
-     * + in most cases, this field is the name as `catalogReference.catalogItemId`.
+     * + In most cases, this field is the same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
      */
     rootCatalogItemId?: string | null;
     /**
-     * Optional - partial payment for the given item to be paid upfront during the checkout.
+     * Partial payment for the given item to be paid upfront during the checkout.
+     *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
-     * If omitted - item's price will not be split and is expected to be paid in single installment
+     * When omitted, the item's price will not be split and is expected to be paid in a single installment.
      */
     depositAmount?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. */
@@ -15712,6 +15960,13 @@ interface V1LineItem {
      * > **Note:** For more information on what to pass to `lineItems.catalogReference`, see [eCommerce Integration in the Wix Stores Catalog API](https://dev.wix.com/api/rest/wix-stores/catalog/ecommerce-integration).
      */
     catalogReference?: CatalogReference$6;
+    /**
+     * Overriding values for catalog item properties.
+     *
+     * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
+     * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
+     */
+    catalogOverrideFields?: CatalogOverrideFields;
 }
 /** Used for grouping line items. Sent when an item is added to a cart, checkout, or order. */
 interface CatalogReference$6 {
@@ -15735,6 +15990,20 @@ interface CatalogReference$6 {
      */
     options?: Record<string, any> | null;
 }
+interface CatalogOverrideFields {
+    /** Item name. */
+    productName?: ProductName$4;
+    /** Item price **after** discounts. */
+    price?: string | null;
+    /** Item price **before** discounts. */
+    fullPrice?: string | null;
+    /** Item description lines. Used when displaying the line item to customers. */
+    descriptionLines?: DescriptionLine$4[];
+    /** Physical properties of the item. */
+    physicalProperties?: PhysicalProperties$6;
+    /** Item image. */
+    image?: string;
+}
 interface ProductName$4 {
     /**
      * __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
@@ -15837,31 +16106,30 @@ interface CustomLineItem$2 {
     media?: string;
     /**
      * Custom line item ID. If passed, `id` must be unique.
-     * Default: auto-generated ID.
+     *
+     * Default: auto-generated ID
      */
     _id?: string | null;
     /** Tax group ID for this custom line item. */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName$4;
-    /**
-     * Optional - URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
-     * The URL is optional and if not provided, the site URL will be used.
-     */
+    /** URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work. */
     url?: string;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType$6;
-    /** Optional - Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
     fullPrice?: string | null;
     /**
-     * Optional - Item quantity available for purchase. Only return this if inventory is managed.
+     * Item quantity available for purchase. Only return this if inventory is managed.
      * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
      */
     quantityAvailable?: number | null;
-    /** Optional - Physical properties of the item. When relevant, contains information such as SKU and item weight. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$6;
     /**
-     * Optional - Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
+     *
      * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
      * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
      * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
@@ -15869,21 +16137,23 @@ interface CustomLineItem$2 {
      */
     paymentOption?: PaymentOptionType$6;
     /**
-     * Optional - Service properties. When relevant, this contains information such as date and number of participants.
+     * Service properties. When relevant, this contains information such as date and number of participants.
      * Used, among other things, when checking for valid memberships.
      */
     serviceProperties?: ServiceProperties$2;
     /**
-     * Optional - In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
+     *
      * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
-     * + in most cases, this field is the name as `catalogReference.catalogItemId`.
+     * + In most cases, this field is the same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
      */
     rootCatalogItemId?: string | null;
     /**
-     * Optional - partial payment for the given item to be paid upfront during the checkout.
+     * Partial payment for the given item to be paid upfront during the checkout.
+     *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
-     * If omitted - item's price will not be split and is expected to be paid in single installment
+     * When omitted, the item's price will not be split and is expected to be paid in a single installment.
      */
     depositAmount?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. */