@wix/ecom 1.0.713 → 1.0.715

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

@@ -3783,6 +3783,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$3;
     /**
      * Whether to save the payment method on the order.
      *
@@ -4038,17 +4045,17 @@ interface SelectedMembership$4 {
     appId?: string;
 }
 interface CatalogOverrideFields$3 {
-    /** Item product name */
+    /** Item name. */
     productName?: ProductName$5;
     /** Item price **after** discounts. */
     price?: string | null;
-    /** Item price **before** discount. */
+    /** Item price **before** discounts. */
     fullPrice?: string | null;
-    /** Line item description lines. Used for displaying the cart, checkout and order. */
+    /** Item description lines. Used when displaying the line item to customers. */
     descriptionLines?: DescriptionLine$5[];
-    /** Physical properties of the item. When relevant, contains information such as SKU, item weight, and shippability. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$6;
-    /** Line item image details. */
+    /** Item image. */
     image?: string;
 }
 /** Buyer Info */
@@ -4223,7 +4230,12 @@ interface UpdateCartRequest$1 {
     merchantDiscounts?: MerchantDiscountInput$3[];
     /** 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$4[];
 }
 interface MerchantDiscountInput$3 {
@@ -4258,31 +4270,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$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?: 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.
@@ -4290,21 +4301,23 @@ interface CustomLineItem$4 {
      */
     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$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. */
@@ -4317,7 +4330,12 @@ interface UpdateCartResponse$1 {
 interface AddToCurrentCartRequest$1 {
     /** 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$4[];
 }
 interface AddToCartResponse$1 {
@@ -4327,7 +4345,12 @@ interface AddToCartResponse$1 {
 interface AddToCurrentCartAndEstimateTotalsRequest$1 {
     /** 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$4[];
     /** Selected shipping option. */
     selectedShippingOption?: SelectedShippingOption$2;
@@ -5234,7 +5257,12 @@ interface CreateCartRequest$1 {
     merchantDiscounts?: MerchantDiscountInput$3[];
     /** 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$4[];
 }
 interface CreateCartResponse$1 {
@@ -5262,7 +5290,12 @@ interface AddToCartRequest$1 {
     _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$4[];
 }
 interface RemoveLineItemsRequest$2 {
@@ -5823,7 +5856,12 @@ interface CreateCartOptions {
     merchantDiscounts?: MerchantDiscountInput$3[];
     /** 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$4[];
 }
 interface UpdateCartOptions {
@@ -5914,13 +5952,23 @@ interface UpdateCartOptions {
     merchantDiscounts?: MerchantDiscountInput$3[];
     /** 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$4[];
 }
 interface AddToCartOptions {
     /** 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$4[];
 }
 interface CreateCheckoutOptions$1 {
@@ -6342,6 +6390,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$2;
     /**
      * Whether to save the payment method on the order.
      *
@@ -6597,17 +6652,17 @@ interface SelectedMembership$3 {
     appId?: string;
 }
 interface CatalogOverrideFields$2 {
-    /** Item product name */
+    /** Item name. */
     productName?: ProductName$4;
     /** Item price **after** discounts. */
     price?: string | null;
-    /** Item price **before** discount. */
+    /** Item price **before** discounts. */
     fullPrice?: string | null;
-    /** Line item description lines. Used for displaying the cart, checkout and order. */
+    /** Item description lines. Used when displaying the line item to customers. */
     descriptionLines?: DescriptionLine$4[];
-    /** Physical properties of the item. When relevant, contains information such as SKU, item weight, and shippability. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$5;
-    /** Line item image details. */
+    /** Item image. */
     image?: string;
 }
 /** Buyer Info */
@@ -6782,7 +6837,12 @@ interface UpdateCartRequest {
     merchantDiscounts?: MerchantDiscountInput$2[];
     /** 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$3[];
 }
 interface MerchantDiscountInput$2 {
@@ -6817,31 +6877,30 @@ interface CustomLineItem$3 {
     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$5;
-    /** 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$5;
     /**
-     * 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.
@@ -6849,21 +6908,23 @@ interface CustomLineItem$3 {
      */
     paymentOption?: PaymentOptionType$5;
     /**
-     * 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. */
@@ -6876,7 +6937,12 @@ interface UpdateCartResponse {
 interface AddToCurrentCartRequest {
     /** 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$3[];
 }
 interface AddToCartResponse {
@@ -6886,7 +6952,12 @@ interface AddToCartResponse {
 interface AddToCurrentCartAndEstimateTotalsRequest {
     /** 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$3[];
     /** Selected shipping option. */
     selectedShippingOption?: SelectedShippingOption$1;
@@ -7793,7 +7864,12 @@ interface CreateCartRequest {
     merchantDiscounts?: MerchantDiscountInput$2[];
     /** 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$3[];
 }
 interface CreateCartResponse {
@@ -7821,7 +7897,12 @@ interface AddToCartRequest {
     _id: string;
     /** 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$3[];
 }
 interface RemoveLineItemsRequest$1 {
@@ -8382,13 +8463,23 @@ interface UpdateCurrentCartOptions {
     merchantDiscounts?: MerchantDiscountInput$2[];
     /** 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$3[];
 }
 interface AddToCurrentCartOptions {
     /** 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$3[];
 }
 interface CreateCheckoutFromCurrentCartOptions {
@@ -8937,11 +9028,23 @@ interface LineItem$4 {
      * @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$1;
     /**
      * Whether to save the payment method on the order.
      *
@@ -9269,17 +9372,17 @@ interface PriceDescription$3 {
     translated?: string | null;
 }
 interface CatalogOverrideFields$1 {
-    /** Item product name */
+    /** Item name. */
     productName?: ProductName$3;
     /** Item price **after** discounts. */
     price?: string | null;
-    /** Item price **before** discount. */
+    /** Item price **before** discounts. */
     fullPrice?: string | null;
-    /** Line item description lines. Used for displaying the cart, checkout and order. */
+    /** Item description lines. Used when displaying the line item to customers. */
     descriptionLines?: DescriptionLine$3[];
-    /** Physical properties of the item. When relevant, contains information such as SKU, item weight, and shippability. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$4;
-    /** Line item image details. */
+    /** Item image. */
     image?: string;
 }
 /** Billing Info and shipping details */
@@ -10102,9 +10205,14 @@ interface CreateCheckoutRequest {
     checkoutInfo?: Checkout$1;
     /** 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$4[];
-    /** 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$2[];
     /**
      * **Required**
@@ -10148,31 +10256,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$3;
-    /**
-     * 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$4;
-    /** 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$4;
     /**
-     * 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.
@@ -10180,21 +10287,23 @@ interface CustomLineItem$2 {
      */
     paymentOption?: PaymentOptionType$4;
     /**
-     * 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. */
@@ -10272,7 +10381,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$4[];
+    /**
+     * 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$2[];
 }
 interface UpdateCheckoutResponse {
@@ -10308,7 +10424,12 @@ interface AddToCheckoutRequest {
     _id: string;
     /** 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$2[];
 }
 interface AddToCheckoutResponse {
@@ -11447,9 +11568,14 @@ interface CreateCheckoutOptions {
     checkoutInfo?: Checkout$1;
     /** 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$4[];
-    /** 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$2[];
     /**
      * **Required**
@@ -11649,13 +11775,25 @@ interface UpdateCheckoutOptions {
      * 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$4[];
+    /**
+     * 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$2[];
 }
 interface AddToCheckoutOptions {
     /** 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$2[];
 }
 
@@ -12559,6 +12697,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$3;
+    /**
+     * 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$3 {
@@ -12583,17 +12728,17 @@ interface CatalogReference$3 {
     options?: Record<string, any> | null;
 }
 interface CatalogOverrideFields {
-    /** Item product name */
+    /** Item name. */
     productName?: ProductName$2;
     /** Item price **after** discounts. */
     price?: string | null;
-    /** Item price **before** discount. */
+    /** Item price **before** discounts. */
     fullPrice?: string | null;
-    /** Line item description lines. Used for displaying the cart, checkout and order. */
+    /** Item description lines. Used when displaying the line item to customers. */
     descriptionLines?: DescriptionLine$2[];
-    /** Physical properties of the item. When relevant, contains information such as SKU, item weight, and shippability. */
+    /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties$3;
-    /** Line item image details. */
+    /** Item image. */
     image?: string;
 }
 interface ProductName$2 {
@@ -12698,31 +12843,30 @@ interface CustomLineItem$1 {
     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$2;
-    /**
-     * 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$3;
-    /** 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$3;
     /**
-     * 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.
@@ -12730,21 +12874,23 @@ interface CustomLineItem$1 {
      */
     paymentOption?: PaymentOptionType$3;
     /**
-     * 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. */
@@ -13307,11 +13453,23 @@ interface LineItem$3 {
      * @readonly
      */
     depositAmount?: MultiCurrencyPrice$1;
+    /**
+     * 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;
     /**
      * Whether to save the payment method on the order.
      *