@wix/auto_sdk_ecom_checkout 1.0.3 → 1.0.4

package/build/internal/cjs/src/ecom-v1-checkout-checkout.universal.d.ts

@@ -1,6 +1,7 @@
 export interface Checkout {
     /**
      * Checkout ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
@@ -8,6 +9,8 @@ export interface Checkout {
      * Line items.
      *
      * Max: 300 items
+     * @minSize 1
+     * @maxSize 300
      * @readonly
      */
     lineItems?: LineItem[];
@@ -15,13 +18,17 @@ export interface Checkout {
     billingInfo?: AddressWithContact;
     /** Shipping information. */
     shippingInfo?: ShippingInfo;
-    /** [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer. */
+    /**
+     * [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer.
+     * @maxLength 1000
+     */
     buyerNote?: string | null;
     /** Buyer information. */
     buyerInfo?: BuyerInfo;
     /**
      * All converted prices are displayed in this currency in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
      * @readonly
+     * @format CURRENCY
      */
     conversionCurrency?: string;
     /**
@@ -60,6 +67,7 @@ export interface Checkout {
     taxSummary?: TaxSummary;
     /**
      * The currency used when submitting the order.
+     * @format CURRENCY
      * @readonly
      */
     currency?: string;
@@ -117,9 +125,15 @@ export interface Checkout {
     payLater?: PriceSummary;
     /** Memberships to apply when creating the order. */
     membershipOptions?: MembershipOptions;
-    /** Additional Fees. */
+    /**
+     * Additional Fees.
+     * @maxSize 100
+     */
     additionalFees?: AdditionalFee[];
-    /** Cart ID that this checkout was created from. Empty if this checkout wasn't created from a cart. */
+    /**
+     * Cart ID that this checkout was created from. Empty if this checkout wasn't created from a cart.
+     * @format GUID
+     */
     cartId?: string | null;
     /**
      * List of validation violations raised by the [Validations Custom Extension SPI](https://www.wix.com/velo/reference/spis/wix-ecom/ecom-validations/introduction).
@@ -134,6 +148,7 @@ export interface Checkout {
     extendedFields?: ExtendedFields;
     /**
      * Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
+     * @format GUID
      * @readonly
      */
     purchaseFlowId?: string | null;
@@ -141,6 +156,7 @@ export interface Checkout {
      * Additional settings for customization of the checkout process.
      *
      * Custom settings can only be defined when [creating a checkout](https://www.wix.com/velo/reference/wix-ecom-backend/checkout/createcheckout).
+     * @immutable
      */
     customSettings?: CustomSettings;
     /**
@@ -155,6 +171,7 @@ export interface Checkout {
      *
      * This field is empty until the checkout completes and becomes an order.
      * @internal
+     * @format GUID
      * @readonly
      */
     orderId?: string | null;
@@ -167,6 +184,7 @@ export interface Checkout {
     /**
      * The business location ID associated with the checkout.
      * Learn more about the [Locations API](https://dev.wix.com/docs/rest/business-management/locations/introduction).
+     * @format GUID
      */
     businessLocationId?: string | null;
     /**
@@ -179,10 +197,18 @@ export interface Checkout {
      * @readonly
      */
     paymentRequired?: boolean;
+    /**
+     * Charges information for each subscription in the Checkout.
+     * @internal
+     * @readonly
+     * @maxSize 100
+     */
+    subscriptionCharges?: SubscriptionCharges[];
 }
 export interface LineItem {
     /**
      * Line item ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
@@ -191,6 +217,8 @@ export interface LineItem {
      *
      * Min: `"1"`
      * Max: `"100000"`
+     * @min 1
+     * @max 100000
      */
     quantity?: number;
     /** Catalog and item reference. Holds IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. */
@@ -297,6 +325,8 @@ export interface LineItem {
      * + 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 has the same value as `catalogReference.catalogItemId`.
      * + Used in membership validation.
+     * @minLength 1
+     * @maxLength 36
      * @readonly
      */
     rootCatalogItemId?: string | null;
@@ -311,8 +341,8 @@ export interface LineItem {
      */
     depositAmount?: MultiCurrencyPrice;
     /**
-     * Delivery Profile Id for the product
-     * @internal
+     * Delivery profile ID.
+     * @format GUID
      * @readonly
      */
     deliveryProfileId?: string | null;
@@ -323,6 +353,8 @@ export interface LineItem {
     customLineItem?: boolean;
     /**
      * Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
+     * @minLength 1
+     * @maxLength 2500
      * @readonly
      */
     consentRequiredPaymentPolicy?: string | null;
@@ -353,7 +385,7 @@ export interface LineItem {
      */
     savePaymentMethod?: boolean;
     /**
-     * Address to be used for tax calculation.
+     * Address to use for tax calculation purposes.
      * @internal
      */
     taxableAddress?: TaxableAddress;
@@ -368,11 +400,13 @@ export interface LineItem {
      * Policies to be displayed to the customer on the checkout page.
      * @internal
      * @readonly
+     * @maxSize 5
      */
     policies?: Policy[];
     /**
      * ID of the app managing the inventory.
      * @internal
+     * @format GUID
      */
     inventoryAppId?: string | null;
     /**
@@ -386,7 +420,11 @@ export interface LineItem {
 }
 /** Used for grouping line items. Sent when an item is added to a cart, checkout, or order. */
 export interface CatalogReference {
-    /** ID of the item within the catalog it belongs to. */
+    /**
+     * ID of the item within the catalog it belongs to.
+     * @minLength 1
+     * @maxLength 36
+     */
     catalogItemId?: string;
     /**
      * ID of the app providing the catalog.
@@ -397,6 +435,7 @@ export interface CatalogReference {
      * + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"`
      * + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"`
      * + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
+     * @minLength 1
      */
     appId?: string;
     /**
@@ -414,6 +453,8 @@ export interface ProductName {
      *
      * Min: 1 character.
      * Max: 200 characters.
+     * @minLength 1
+     * @maxLength 200
      */
     original?: string;
     /**
@@ -422,15 +463,21 @@ export interface ProductName {
      * Min: 1 character.
      * Max: 400 characters.
      * Default: Same as `original`.
+     * @minLength 1
+     * @maxLength 400
      */
     translated?: string | null;
 }
 export interface MultiCurrencyPrice {
-    /** Amount. */
+    /**
+     * Amount.
+     * @decimalValue options { gte:0, lte:1000000000000000 }
+     */
     amount?: string;
     /**
      * Converted amount.
      * @readonly
+     * @decimalValue options { gte:0, lte:1000000000000000 }
      */
     convertedAmount?: string;
     /**
@@ -447,7 +494,10 @@ export interface MultiCurrencyPrice {
 export interface ItemTaxFullDetails {
     /** Amount for which tax is calculated. */
     taxableAmount?: MultiCurrencyPrice;
-    /** Tax rate %, as a decimal point between 0 and 1. */
+    /**
+     * Tax rate %, as a decimal point between 0 and 1.
+     * @decimalValue options { gte:0, lte:1, maxScale:6 }
+     */
     taxRate?: string;
     /** Calculated tax, based on `taxable_amount` and `tax_rate`. */
     totalTax?: MultiCurrencyPrice;
@@ -459,9 +509,15 @@ export interface ItemTaxFullDetails {
     rateBreakdown?: TaxRateBreakdown[];
 }
 export interface TaxRateBreakdown {
-    /** Name of tax against which the calculation was performed. */
+    /**
+     * Name of tax against which the calculation was performed.
+     * @maxLength 100
+     */
     name?: string;
-    /** Rate at which this tax detail was calculated. */
+    /**
+     * Rate at which this tax detail was calculated.
+     * @decimalValue options { gte:0, lte:1, maxScale:6 }
+     */
     rate?: string;
     /** Amount of tax for this tax detail. */
     tax?: MultiCurrencyPrice;
@@ -471,21 +527,31 @@ export interface TaxRateBreakdown {
  * It holds the tax amount and the tax rate for each tax authority that apply on the line item.
  */
 export interface TaxBreakdown {
-    /** The name of the jurisdiction to which this tax detail applies. For example, "New York" or "Quebec". */
+    /**
+     * The name of the jurisdiction to which this tax detail applies. For example, "New York" or "Quebec".
+     * @maxLength 200
+     */
     jurisdiction?: string | null;
     /** The amount of this line item price that was considered nontaxable. (Decimal value) */
     nonTaxableAmount?: MultiCurrencyPrice;
-    /** The rate at which this tax detail was calculated, e.g 0.1000 signifies 10% tax and 2.0000 signifies 200% tax. (Decimal value) */
+    /**
+     * The rate at which this tax detail was calculated, e.g 0.1000 signifies 10% tax and 2.0000 signifies 200% tax. (Decimal value)
+     * @decimalValue options { gte:0, maxScale:6 }
+     */
     rate?: string | null;
     /** The amount of tax estimated for this line item. (Decimal value) */
     taxAmount?: MultiCurrencyPrice;
     /** The taxable amount of this line item. */
     taxableAmount?: MultiCurrencyPrice;
-    /** The type of tax that was calculated. Depends on the jurisdiction's tax laws. For example, "Sales Tax", "Income Tax", "Value Added Tax", etc. */
+    /**
+     * The type of tax that was calculated. Depends on the jurisdiction's tax laws. For example, "Sales Tax", "Income Tax", "Value Added Tax", etc.
+     * @maxLength 200
+     */
     taxType?: string | null;
     /**
      * The name of the tax against which this tax amount was calculated. For example, "NY State Sales Tax", "Quebec GST", etc.
      * This name should be explicit enough to allow the merchant to understand what tax was calculated.
+     * @maxLength 200
      */
     taxName?: string | null;
     /** The type of the jurisdiction in which this tax detail applies. */
@@ -519,32 +585,44 @@ export interface DescriptionLineValueOneOf {
 export interface DescriptionLineDescriptionLineValueOneOf {
 }
 export interface DescriptionLineName {
-    /** Description line 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). */
+    /**
+     * Description line 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).
+     * @maxLength 100
+     */
     original?: string;
     /**
      * Description line name translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @maxLength 200
      */
     translated?: string | null;
 }
 export interface PlainTextValue {
-    /** Description line plain text value 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). */
+    /**
+     * Description line plain text value 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).
+     * @maxLength 600
+     */
     original?: string;
     /**
      * Description line plain text value translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @maxLength 600
      */
     translated?: string | null;
 }
 export interface Color {
-    /** Description line color 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). */
+    /**
+     * Description line color 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).
+     * @maxLength 500
+     */
     original?: string;
     /**
      * Description line color name translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @maxLength 500
      */
     translated?: string | null;
     /** HEX or RGB color code for display. */
@@ -586,7 +664,10 @@ export declare enum ItemAvailabilityStatus {
 export interface PhysicalProperties {
     /** Line item weight. Measurement unit (`"KG"` or `"LB"`) is taken from `order.weightUnit`. */
     weight?: number | null;
-    /** Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku). */
+    /**
+     * Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
+     * @maxLength 40
+     */
     sku?: string | null;
     /** Whether this line item is shippable. */
     shippable?: boolean;
@@ -639,11 +720,16 @@ export interface SubscriptionSettings {
      *
      * Default: `1`.
      * If SubscriptionFrequency is Day the minimum interval is 7
+     * @min 1
+     * @max 50
      */
     interval?: number | null;
     /** Whether subscription is renewed automatically at the end of each period. */
     autoRenewal?: boolean;
-    /** Number of billing cycles before subscription ends. Ignored if `autoRenewal` is `true`. */
+    /**
+     * Number of billing cycles before subscription ends. Ignored if `autoRenewal` is `true`.
+     * @min 1
+     */
     billingCycles?: number | null;
     /**
      * Whether to allow the customer to cancel the subscription..
@@ -673,29 +759,53 @@ export declare enum SubscriptionFrequency {
 export interface FreeTrialPeriod {
     /** Frequency of priod. Values: DAY, WEEK, MONTH, YEAR */
     frequency?: SubscriptionFrequency;
-    /** interval of period */
+    /**
+     * interval of period
+     * @min 1
+     * @max 50
+     */
     interval?: number;
 }
 export interface Title {
-    /** Subscription option 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). */
+    /**
+     * Subscription option 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).
+     * @minLength 1
+     * @maxLength 150
+     */
     original?: string;
     /**
      * Subscription option name translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @minLength 1
+     * @maxLength 150
      */
     translated?: string | null;
 }
 export interface Description {
-    /** Subscription option description. */
+    /**
+     * Subscription option description.
+     * @maxLength 500
+     */
     original?: string;
-    /** Translated subscription option description. */
+    /**
+     * Translated subscription option description.
+     * @maxLength 500
+     */
     translated?: string | null;
 }
 export interface SecuredMedia {
-    /** Media ID in Wix Media Manager. */
+    /**
+     * Media ID in Wix Media Manager.
+     * @minLength 1
+     * @maxLength 100
+     */
     _id?: string;
-    /** Original filename. */
+    /**
+     * Original filename.
+     * @minLength 1
+     * @maxLength 1000
+     */
     fileName?: string;
     /** File type. */
     fileType?: FileType;
@@ -727,27 +837,46 @@ export interface ServiceProperties {
      * For example, the start time of a class.
      */
     scheduledDate?: Date | null;
-    /** The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room. */
+    /**
+     * The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room.
+     * @min 1
+     * @max 10000
+     */
     numberOfParticipants?: number | null;
 }
 export interface PriceDescription {
-    /** __Required.__ Price description 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). */
+    /**
+     * __Required.__ Price description 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).
+     * @minLength 1
+     * @maxLength 100
+     */
     original?: string;
     /**
      * Price description translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @minLength 1
+     * @maxLength 100
      */
     translated?: string | null;
 }
 export interface CatalogOverrideFields {
     /** Item name. */
     productName?: ProductName;
-    /** Item price **after** discounts. */
+    /**
+     * Item price **after** discounts.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     */
     price?: string | null;
-    /** Item price **before** discounts. */
+    /**
+     * Item price **before** discounts.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     */
     fullPrice?: string | null;
-    /** Item description lines. Used when displaying the line item to customers. */
+    /**
+     * Item description lines. Used when displaying the line item to customers.
+     * @maxSize 20
+     */
     descriptionLines?: DescriptionLine[];
     /** Physical properties of the item. */
     physicalProperties?: PhysicalProperties;
@@ -755,7 +884,11 @@ export interface CatalogOverrideFields {
     image?: string;
     /** Payment method selected for the item. */
     paymentOption?: PaymentOption;
-    /** Only eligible for catalog items with `lineItem.paymentOption.value` type of `DEPOSIT_ONLINE`. */
+    /**
+     * Only eligible for catalog items with `lineItem.paymentOption.value` type of `DEPOSIT_ONLINE`.
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gt:0, lte:999999999, maxScale:3 }
+     */
     depositAmount?: string | null;
     /**
      * Whether to save the payment method on the order.
@@ -766,11 +899,9 @@ export interface CatalogOverrideFields {
 }
 export interface PaymentOption {
     /**
-     * + `FULL_PAYMENT_ONLINE`: The entire payment for this item happens as part of the checkout.
-     * + `FULL_PAYMENT_OFFLINE`: The 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 selected, `price` is `0`.
-     * + `DEPOSIT_ONLINE`: Partial payment to be paid upfront during the checkout. Initial amount to be paid for each line item is specified in `depositAmount`.
-     * + `MEMBERSHIP_OFFLINE`: Payment for this item can only be done by charging a membership and must be manually redeemed in the dashboard by the site admin. When selected, `price` is `0`.
+     * Type of selected payment option for current item.
+     *
+     * Default: `FULL_PAYMENT_ONLINE`
      */
     value?: PaymentOptionType;
 }
@@ -801,9 +932,17 @@ export interface ExtendedFields {
     namespaces?: Record<string, Record<string, any>>;
 }
 export interface Policy {
-    /** Policy title - should be translated */
+    /**
+     * Policy title - should be translated
+     * @minLength 1
+     * @maxLength 29
+     */
     title?: string | null;
-    /** Policy content - should be translated */
+    /**
+     * Policy content - should be translated
+     * @minLength 1
+     * @maxLength 3000
+     */
     content?: string;
 }
 /** Billing Info and shipping details */
@@ -815,19 +954,37 @@ export interface AddressWithContact {
 }
 /** Physical address */
 export interface ApiAddress {
-    /** Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format. */
+    /**
+     * Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
+     * @format COUNTRY
+     */
     country?: string | null;
-    /** Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format. */
+    /**
+     * Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
+     * @maxLength 50
+     */
     subdivision?: string | null;
-    /** City name. */
+    /**
+     * City name.
+     * @maxLength 50
+     */
     city?: string | null;
-    /** Postal or zip code. */
+    /**
+     * Postal or zip code.
+     * @maxLength 50
+     */
     postalCode?: string | null;
     /** Street address. */
     streetAddress?: StreetAddress;
-    /** Main address line (usually street name and number). */
+    /**
+     * Main address line (usually street name and number).
+     * @maxLength 150
+     */
     addressLine1?: string | null;
-    /** Free text providing more detailed address info. Usually contains apt, suite, floor. */
+    /**
+     * Free text providing more detailed address info. Usually contains apt, suite, floor.
+     * @maxLength 100
+     */
     addressLine2?: string | null;
     /**
      * Country's full name.
@@ -854,13 +1011,25 @@ export interface AddressLocation {
 }
 /** Full contact details for an address */
 export interface FullAddressContactDetails {
-    /** First name. */
+    /**
+     * First name.
+     * @maxLength 100
+     */
     firstName?: string | null;
-    /** Last name. */
+    /**
+     * Last name.
+     * @maxLength 100
+     */
     lastName?: string | null;
-    /** Phone number. */
+    /**
+     * Phone number.
+     * @format PHONE
+     */
     phone?: string | null;
-    /** Company name. */
+    /**
+     * Company name.
+     * @maxLength 1000
+     */
     company?: string | null;
     /** Tax information (for Brazil only). If ID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed. */
     vatId?: CommonVatId;
@@ -902,11 +1071,15 @@ export interface ShippingInfo {
     carrierServiceOptions?: CarrierServiceOption[];
 }
 export interface SelectedCarrierServiceOption {
-    /** Unique identifier of selected option. For example, "usps_std_overnight". */
+    /**
+     * Unique identifier of selected option. For example, "usps_std_overnight".
+     * @maxLength 100
+     */
     code?: string;
     /**
      * Title of the option, such as USPS Standard Overnight Delivery (in the requested locale).
      * For example, "Standard" or "First-Class Package International".
+     * @maxLength 250
      * @readonly
      */
     title?: string;
@@ -927,17 +1100,29 @@ export interface SelectedCarrierServiceOption {
     requestedShippingOption?: boolean;
     /** Other charges */
     otherCharges?: SelectedCarrierServiceOptionOtherCharge[];
-    /** This carrier's unique ID */
+    /**
+     * This carrier's unique ID
+     * @format GUID
+     */
     carrierId?: string | null;
-    /** Delivery solution allocations to different delivery carriers and delivery regions */
+    /**
+     * Delivery solution allocations to different delivery carriers and delivery regions
+     * @maxSize 300
+     */
     deliveryAllocations?: DeliveryAllocation[];
     /** If the delivery solution is a partial and doesn't apply to all items. */
     partial?: boolean | null;
 }
 export interface DeliveryLogistics {
-    /** Expected delivery time, in free text. For example, "3-5 business days". */
+    /**
+     * Expected delivery time, in free text. For example, "3-5 business days".
+     * @maxLength 500
+     */
     deliveryTime?: string | null;
-    /** Instructions for caller, e.g for pickup: "Please deliver during opening hours, and please don't park in disabled parking spot". */
+    /**
+     * Instructions for caller, e.g for pickup: "Please deliver during opening hours, and please don't park in disabled parking spot".
+     * @maxLength 1000
+     */
     instructions?: string | null;
     /** Pickup details. */
     pickupDetails?: PickupDetails;
@@ -979,7 +1164,10 @@ export interface SelectedCarrierServiceOptionPrices {
 export interface SelectedCarrierServiceOptionOtherCharge {
     /** Type of additional cost. */
     type?: ChargeType;
-    /** Details of the charge, such as 'Full Coverage Insurance of up to 80% of value of shipment'. */
+    /**
+     * Details of the charge, such as 'Full Coverage Insurance of up to 80% of value of shipment'.
+     * @maxLength 200
+     */
     details?: string | null;
     /** Price of added charge. */
     cost?: SelectedCarrierServiceOptionPrices;
@@ -997,32 +1185,56 @@ export interface DeliveryAllocation {
     applicableLineItems?: ApplicableLineItems;
 }
 export interface Carrier {
-    /** The carrier app id */
+    /**
+     * The carrier app id
+     * @format GUID
+     */
     appId?: string | null;
-    /** Unique code that acts as an ID for a shipping rate. For example, `"usps_std_overnight"`. */
+    /**
+     * Unique code that acts as an ID for a shipping rate. For example, `"usps_std_overnight"`.
+     * @maxLength 250
+     */
     code?: string;
 }
 export interface Region {
-    /** The delivery region id. */
+    /**
+     * The delivery region id.
+     * @format GUID
+     */
     _id?: string | null;
-    /** The delivery region name. */
+    /**
+     * The delivery region name.
+     * @maxLength 100
+     */
     name?: string | null;
 }
 export interface ApplicableLineItems {
-    /** Line items that the delivery solution is for. */
+    /**
+     * Line items that the delivery solution is for.
+     * @maxSize 300
+     * @minLength 1
+     * @maxLength 100
+     */
     lineItemIds?: string[];
 }
 export interface ShippingRegion {
     /**
      * Shipping region ID.
+     * @format GUID
      * @readonly
      */
     _id?: string;
-    /** Shipping region name. */
+    /**
+     * Shipping region name.
+     * @maxLength 100
+     */
     name?: string;
 }
 export interface CarrierServiceOption {
-    /** Carrier ID. */
+    /**
+     * Carrier ID.
+     * @format GUID
+     */
     carrierId?: string;
     /** Shipping options offered by this carrier for this request. */
     shippingOptions?: ShippingOption[];
@@ -1031,18 +1243,23 @@ export interface ShippingOption {
     /**
      * Unique code of provided shipping option like "usps_std_overnight".
      * For legacy calculators this would be the UUID of the option.
+     * @maxLength 100
      */
     code?: string;
     /**
      * Title of the option, such as USPS Standard Overnight Delivery (in the requested locale).
      * For example, "Standard" or "First-Class Package International".
+     * @maxLength 250
      */
     title?: string;
     /** Delivery logistics. */
     logistics?: DeliveryLogistics;
     /** Sipping price information. */
     cost?: ShippingPrice;
-    /** Delivery solution allocations to different delivery carriers and delivery regions */
+    /**
+     * Delivery solution allocations to different delivery carriers and delivery regions
+     * @maxSize 300
+     */
     deliveryAllocations?: DeliveryAllocation[];
     /** If the delivery solution is a partial and doesn't apply to all items. */
     partial?: boolean | null;
@@ -1062,31 +1279,39 @@ export interface OtherCharge {
 export interface BuyerInfo extends BuyerInfoIdOneOf {
     /**
      * Visitor ID - if the buyer is **not** a site member.
+     * @format GUID
      * @readonly
      */
     visitorId?: string;
     /**
      * Member ID - If the buyer is a site member.
+     * @format GUID
      * @readonly
      */
     memberId?: string;
     /**
      * Contact ID. For more information, see the Contacts API.
+     * @format GUID
      * @readonly
      */
     contactId?: string | null;
-    /** Buyer email address. */
+    /**
+     * Buyer email address.
+     * @format EMAIL
+     */
     email?: string | null;
 }
 /** @oneof */
 export interface BuyerInfoIdOneOf {
     /**
      * Visitor ID - if the buyer is **not** a site member.
+     * @format GUID
      * @readonly
      */
     visitorId?: string;
     /**
      * Member ID - If the buyer is a site member.
+     * @format GUID
      * @readonly
      */
     memberId?: string;
@@ -1247,11 +1472,16 @@ export interface GiftCard {
     obfuscatedCode?: string;
     /** Gift card value. */
     amount?: MultiCurrencyPrice;
-    /** App ID of the gift card provider. */
+    /**
+     * App ID of the gift card provider.
+     * @format GUID
+     */
     appId?: string;
     /**
      * External ID in the gift card provider's system.
      * Used for integration and tracking across different platforms.
+     * @minLength 1
+     * @maxLength 50
      */
     externalId?: string | null;
 }
@@ -1266,6 +1496,7 @@ export interface AppliedDiscount extends AppliedDiscountDiscountSourceOneOf {
     discountType?: DiscountType;
     /**
      * IDs of the line items the discount applies to.
+     * @format GUID
      * @deprecated IDs of line items the discount applies to.
      * @replacedBy line_items_discounts
      * @targetRemovalDate 2024-06-01
@@ -1275,6 +1506,8 @@ export interface AppliedDiscount extends AppliedDiscountDiscountSourceOneOf {
      * Number of subscription cycle this discount applies to
      * default None - all billing cycle
      * @internal
+     * @min 1
+     * @max 999
      */
     subscriptionCycles?: number | null;
 }
@@ -1306,11 +1539,18 @@ export interface Coupon {
 export interface MerchantDiscount {
     /** Discount value. */
     amount?: MultiCurrencyPrice;
-    /** Discount Percentage. Will be calculated from items price before other discounts. */
+    /**
+     * Discount Percentage. Will be calculated from items price before other discounts.
+     * @min 1
+     * @max 100
+     */
     percentage?: number | null;
 }
 export interface DiscountRule {
-    /** Discount rule ID */
+    /**
+     * Discount rule ID
+     * @format GUID
+     */
     _id?: string;
     /** Discount rule name */
     name?: DiscountRuleName;
@@ -1318,13 +1558,24 @@ export interface DiscountRule {
     amount?: MultiCurrencyPrice;
 }
 export interface DiscountRuleName {
-    /** Original discount rule name (in site's default language). */
+    /**
+     * Original discount rule name (in site's default language).
+     * @minLength 1
+     * @maxLength 256
+     */
     original?: string;
-    /** Translated discount rule name according to buyer language. Defaults to `original` when not provided. */
+    /**
+     * Translated discount rule name according to buyer language. Defaults to `original` when not provided.
+     * @minLength 1
+     * @maxLength 500
+     */
     translated?: string | null;
 }
 export interface LineItemDiscount {
-    /** ID of line item the discount applies to. */
+    /**
+     * ID of line item the discount applies to.
+     * @format GUID
+     */
     _id?: string;
     /** Discount value. */
     totalDiscountAmount?: MultiCurrencyPrice;
@@ -1332,9 +1583,17 @@ export interface LineItemDiscount {
 export interface CustomField {
     /** Custom field value. */
     value?: any;
-    /** Custom field title. */
+    /**
+     * Custom field title.
+     * @minLength 1
+     * @maxLength 500
+     */
     title?: string;
-    /** Translated custom field title. */
+    /**
+     * Translated custom field title.
+     * @minLength 1
+     * @maxLength 500
+     */
     translatedTitle?: string | null;
 }
 export declare enum WeightUnit {
@@ -1410,15 +1669,27 @@ export declare enum FallbackReason {
  * Tax breakdown is the tax amount split to the tax authorities that applied on the line item.
  */
 export interface AggregatedTaxBreakdown {
-    /** The name of the tax against which this tax amount was calculated. */
+    /**
+     * The name of the tax against which this tax amount was calculated.
+     * @maxLength 200
+     */
     taxName?: string;
-    /** The type of tax that was calculated. Depends on the company's nexus settings as well as the jurisdiction's tax laws. */
+    /**
+     * The type of tax that was calculated. Depends on the company's nexus settings as well as the jurisdiction's tax laws.
+     * @maxLength 200
+     */
     taxType?: string;
-    /** The name of the jurisdiction in which this tax detail applies. */
+    /**
+     * The name of the jurisdiction in which this tax detail applies.
+     * @maxLength 200
+     */
     jurisdiction?: string;
     /** The type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special). */
     jurisdictionTypeEnum?: JurisdictionType;
-    /** The rate at which this tax detail was calculated, e.g 0.1000 signifies 10% tax and 2.000 signifies 200% tax. (Decimal value) */
+    /**
+     * The rate at which this tax detail was calculated, e.g 0.1000 signifies 10% tax and 2.000 signifies 200% tax. (Decimal value)
+     * @decimalValue options { gte:0, maxScale:6 }
+     */
     rate?: string;
     /** The sum of all the tax from line items that calculated by the tax identifiers. */
     aggregatedTaxAmount?: MultiCurrencyPrice;
@@ -1461,13 +1732,23 @@ export interface CreatedBy extends CreatedByIdOneOf {
     /**
      * User ID - when the order was created by a Wix user on behalf of a buyer.
      * For example, via POS (point of service).
+     * @format GUID
      */
     userId?: string;
-    /** Member ID - when the order was created by a **logged in** site visitor. */
+    /**
+     * Member ID - when the order was created by a **logged in** site visitor.
+     * @format GUID
+     */
     memberId?: string;
-    /** Visitor ID - when the order was created by a site visitor that was **not** logged in. */
+    /**
+     * Visitor ID - when the order was created by a site visitor that was **not** logged in.
+     * @format GUID
+     */
     visitorId?: string;
-    /** App ID - when the order was created by an external application or Wix service. */
+    /**
+     * App ID - when the order was created by an external application or Wix service.
+     * @format GUID
+     */
     appId?: string;
 }
 /** @oneof */
@@ -1475,13 +1756,23 @@ export interface CreatedByIdOneOf {
     /**
      * User ID - when the order was created by a Wix user on behalf of a buyer.
      * For example, via POS (point of service).
+     * @format GUID
      */
     userId?: string;
-    /** Member ID - when the order was created by a **logged in** site visitor. */
+    /**
+     * Member ID - when the order was created by a **logged in** site visitor.
+     * @format GUID
+     */
     memberId?: string;
-    /** Visitor ID - when the order was created by a site visitor that was **not** logged in. */
+    /**
+     * Visitor ID - when the order was created by a site visitor that was **not** logged in.
+     * @format GUID
+     */
     visitorId?: string;
-    /** App ID - when the order was created by an external application or Wix service. */
+    /**
+     * App ID - when the order was created by an external application or Wix service.
+     * @format GUID
+     */
     appId?: string;
 }
 /** Reserved for internal use. */
@@ -1489,24 +1780,39 @@ export interface MembershipOptions {
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxSize 300
      */
     eligibleMemberships?: Membership[];
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxSize 300
      */
     invalidMemberships?: InvalidMembership[];
     /** Selected membership to apply to this checkout. */
     selectedMemberships?: SelectedMemberships;
 }
 export interface Membership {
-    /** Membership ID. */
+    /**
+     * Membership ID.
+     * @minLength 1
+     * @maxLength 100
+     */
     _id?: string;
-    /** ID of the application providing this payment option. */
+    /**
+     * ID of the application providing this payment option.
+     * @format GUID
+     */
     appId?: string;
     /** The name of this membership. */
     name?: MembershipName;
-    /** Line item IDs which are "paid for" by this membership. */
+    /**
+     * Line item IDs which are "paid for" by this membership.
+     * @minSize 1
+     * @maxSize 300
+     * @minLength 1
+     * @maxLength 100
+     */
     lineItemIds?: string[];
     /** Optional - For a membership that has limited credits, information about credit usage. */
     credits?: MembershipPaymentCredits;
@@ -1516,13 +1822,22 @@ export interface Membership {
     additionalData?: Record<string, any> | null;
 }
 export interface MembershipName {
-    /** Membership name. */
+    /**
+     * Membership name.
+     * @maxLength 100
+     */
     original?: string;
-    /** Translated membership name. Defaults to `original` when not provided. */
+    /**
+     * Translated membership name. Defaults to `original` when not provided.
+     * @maxLength 100
+     */
     translated?: string | null;
 }
 export interface MembershipPaymentCredits {
-    /** Membership's total amount of credits. */
+    /**
+     * Membership's total amount of credits.
+     * @min 1
+     */
     total?: number;
     /** Membership's remaining amount of credits. */
     remaining?: number;
@@ -1530,31 +1845,63 @@ export interface MembershipPaymentCredits {
 export interface InvalidMembership {
     /** Membership details. */
     membership?: Membership;
-    /** Reason why this membership is invalid and cannot be used. */
+    /**
+     * Reason why this membership is invalid and cannot be used.
+     * @minLength 1
+     * @maxLength 100
+     */
     reason?: string;
 }
 export interface SelectedMemberships {
-    /** Selected memberships. */
+    /**
+     * Selected memberships.
+     * @maxSize 300
+     */
     memberships?: SelectedMembership[];
 }
 export interface SelectedMembership {
-    /** Membership ID. */
+    /**
+     * Membership ID.
+     * @minLength 1
+     * @maxLength 100
+     */
     _id?: string;
-    /** ID of the app providing this payment option. */
+    /**
+     * ID of the app providing this payment option.
+     * @format GUID
+     */
     appId?: string;
-    /** IDs of the line items this membership applies to. */
+    /**
+     * IDs of the line items this membership applies to.
+     * @minSize 1
+     * @maxSize 300
+     * @minLength 1
+     * @maxLength 100
+     */
     lineItemIds?: string[];
 }
 export interface AdditionalFee {
-    /** Additional fee's unique code (or ID) for future processing. */
+    /**
+     * Additional fee's unique code (or ID) for future processing.
+     * @minLength 1
+     * @maxLength 100
+     */
     code?: string | null;
-    /** Translated additional fee's name. */
+    /**
+     * Translated additional fee's name.
+     * @minLength 1
+     * @maxLength 50
+     */
     name?: string;
     /** Additional fee's price. */
     price?: MultiCurrencyPrice;
     /** Tax details. */
     taxDetails?: ItemTaxFullDetails;
-    /** Provider's app id. */
+    /**
+     * Provider's app id.
+     * @minLength 1
+     * @maxLength 100
+     */
     providerAppId?: string | null;
     /** Additional fee's price before tax. */
     priceBeforeTax?: MultiCurrencyPrice;
@@ -1563,12 +1910,15 @@ export interface AdditionalFee {
     /**
      * Optional - Line items associated with this additional fee.
      * If no `lineItemIds` are provided, the fee will be associated with the whole cart/checkout/order.
+     * @format GUID
      */
     lineItemIds?: string[];
     /**
      * Number of subscription cycle this fee applies to
      * default None - all billing cycle
      * @internal
+     * @min 1
+     * @max 999
      */
     subscriptionCycles?: number | null;
     /** the source the additional fee was added from */
@@ -1587,11 +1937,13 @@ export interface ConversionInfo {
     /**
      * The site currency.
      * @readonly
+     * @format CURRENCY
      */
     siteCurrency?: string;
     /**
      * The rate used when converting from the site currency to the checkout currency.
      * @readonly
+     * @decimalValue options { gt:0, lte:1000000000000000 }
      */
     conversionRate?: string;
 }
@@ -1600,7 +1952,11 @@ export interface Violation {
     severity?: Severity;
     /** Target location on a checkout or cart page where the violation will be displayed. */
     target?: Target;
-    /** Violation description. Can include rich text. Only HTTP or HTTPS links in the following format are allowed: `<a href="https://www.wix.com">Click me</a>`. */
+    /**
+     * Violation description. Can include rich text. Only HTTP or HTTPS links in the following format are allowed: `<a href="https://www.wix.com">Click me</a>`.
+     * @minLength 1
+     * @maxLength 1000
+     */
     description?: string | null;
 }
 export declare enum Severity {
@@ -1689,12 +2045,14 @@ export interface CustomContentReference {
      * ID of the app providing the content.
      *
      * You can get your app's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
+     * @format GUID
      */
     appId?: string;
     /**
      * ID of the component within the app it belongs to.
      *
      * You can get your component's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
+     * @format GUID
      */
     componentId?: string;
 }
@@ -1702,14 +2060,49 @@ export interface ExternalReference {
     /**
      * ID of the app associated with the purchase flow.
      * For example, the Wix Pay Links app ID.
+     * @format GUID
+     * @immutable
      */
     appId?: string;
     /**
      * Reference to an external resource ID. Used to link the purchase flow to a specific entity in an external system.
      * For example, a Wix Pay Link ID.
+     * @minLength 1
+     * @maxLength 100
+     * @immutable
      */
     resourceId?: string | null;
 }
+export interface SubscriptionCharges {
+    /**
+     * ids of the items the subscription is defined on
+     * @format GUID
+     * @minSize 1
+     * @maxSize 300
+     */
+    lineItemIds?: string[];
+    /**
+     * Generated description explaining future charges amount and schedule.
+     * Translated to subscription order buyer language, or to site language if was not provided.
+     * @maxLength 1000
+     */
+    description?: string | null;
+    /**
+     * Charges for subscription.
+     * @maxSize 50
+     */
+    charges?: Charge[];
+}
+export interface Charge {
+    /** The cycle number from which the charge starts. */
+    cycleFrom?: number;
+    /** The number of cycles for which the charge is applicable. */
+    cycleCount?: number | null;
+    /** Charge summary. */
+    priceSummary?: PriceSummary;
+    /** The billing date from which the charge starts. */
+    cycleBillingDate?: Date | null;
+}
 export interface UpdatedCheckoutMessage {
     /** Previous checkout. */
     oldCheckout?: Checkout;
@@ -1721,28 +2114,20 @@ export 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;
-    /** Catalog line items to add to the checkout. */
+    /**
+     * Catalog line items to add to the checkout.
+     * @maxSize 300
+     */
     lineItems?: LineItem[];
     /**
      * Custom line items to add to the checkout. Custom line items don't trigger the Catalog service plugin.
      *
      * 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).
+     * @maxSize 300
      */
     customLineItems?: CustomLineItem[];
-    /**
-     * Sales channel that submitted the order.
-     * + `"UNSPECIFIED"`: Unspecified sales channel. This value is not supported.
-     * + `"WEB"`: A web client.
-     * + `"POS"`: [Point of sale solutions](https://support.wix.com/en/wix-mobile-pos-2196395)
-     * + `"EBAY"`: [eBay](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-ebay-shop)
-     * + `"AMAZON"`: [Amazon](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-amazon-shop)
-     * + `"WISH"`: [Wish](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-a-wish-shop)
-     * + `"WIX_INVOICES"`: Wix Invoices app in [your dashboard](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Finvoices/settings/general-settings)
-     * + `"WIX_APP_STORE"`: [Wix Owner app](https://support.wix.com/article/wix-owner-app-an-overview)
-     * + `"BACKOFFICE_MERCHANT"`: Wix merchant backoffice
-     * + `"OTHER_PLATFORM"`: Other sales platform.
-     */
+    /** Sales channel that submitted the order. */
     channelType: ChannelType;
     /**
      * Gift card code.
@@ -1756,6 +2141,7 @@ export interface CreateCheckoutRequest {
      * `overrideCheckoutUrl` allows the flexibility to redirect customers to a customized checkout page.
      *
      * 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`.
+     * @maxLength 1000
      */
     overrideCheckoutUrl?: string | null;
 }
@@ -1765,13 +2151,22 @@ export interface CustomLineItem {
      *
      * Min: `1`
      * Max: `100000`
+     * @min 1
+     * @max 100000
      */
     quantity?: number;
-    /** Custom line item price. For security reasons, the `price` field should come from backend Velo code, and not be passed from the frontend. */
+    /**
+     * Custom line item price. For security reasons, the `price` field should come from backend Velo code, and not be passed from the frontend.
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, lte:1000000000000000 }
+     */
     price?: string;
     /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */
     priceDescription?: PriceDescription;
-    /** Custom line item description lines. Used for displaying the cart, checkout and order. */
+    /**
+     * Custom line item description lines. Used for displaying the cart, checkout and order.
+     * @maxSize 10
+     */
     descriptionLines?: DescriptionLine[];
     /**
      * Custom line item media.
@@ -1783,9 +2178,13 @@ export interface CustomLineItem {
      * Custom line item ID. If passed, `id` must be unique.
      *
      * Default: auto-generated ID
+     * @format GUID
      */
     _id?: string | null;
-    /** Tax group ID for this custom line item. */
+    /**
+     * Tax group ID for this custom line item.
+     * @format GUID
+     */
     taxGroupId?: string | null;
     /** Name of the item or product. */
     productName?: ProductName;
@@ -1793,11 +2192,15 @@ export interface CustomLineItem {
     url?: string;
     /** Item type. Either a preset type or custom. */
     itemType?: ItemType;
-    /** Item price **before** catalog-defined discount. Defaults to `price` when not provided. */
+    /**
+     * Item price **before** catalog-defined discount. Defaults to `price` when not provided.
+     * @format DECIMAL_VALUE
+     */
     fullPrice?: string | null;
     /**
      * 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.
+     * @max 100000
      */
     quantityAvailable?: number | null;
     /** Physical properties of the item. */
@@ -1822,6 +2225,8 @@ export interface CustomLineItem {
      * + 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 same as `catalogReference.catalogItemId`.
      * + Used in membership validation.
+     * @minLength 1
+     * @maxLength 36
      */
     rootCatalogItemId?: string | null;
     /**
@@ -1829,11 +2234,12 @@ export interface CustomLineItem {
      *
      * Eligible for catalog items with type `DEPOSIT_ONLINE`.
      * When omitted, the item's price will not be split and is expected to be paid in a single installment.
+     * @format DECIMAL_VALUE
      */
     depositAmount?: string | null;
     /**
-     * Delivery Profile ID.
-     * @internal
+     * Delivery profile ID.
+     * @format GUID
      */
     deliveryProfileId?: string | null;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. */
@@ -1854,6 +2260,8 @@ export interface CustomLineItem {
     fixedQuantity?: boolean;
     /**
      * Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
+     * @minLength 1
+     * @maxLength 1000
      * @readonly
      */
     consentRequiredPaymentPolicy?: string | null;
@@ -1867,11 +2275,13 @@ export interface CustomLineItem {
     /**
      * Policies to be displayed to the customer on the checkout page.
      * @internal
+     * @maxSize 5
      */
     policies?: Policy[];
     /**
      * ID of the app managing the inventory.
      * @internal
+     * @format GUID
      */
     inventoryAppId?: string | null;
     /**
@@ -1881,11 +2291,23 @@ export interface CustomLineItem {
      * @internal
      */
     membersOnly?: boolean;
+    /**
+     * Address to use for tax calculation purposes.
+     * @internal
+     */
+    taxableAddress?: TaxableAddress;
 }
 export interface MerchantDiscountInput {
-    /** Discount amount. */
+    /**
+     * Discount amount.
+     * @decimalValue options { gte:0 }
+     */
     amount?: string;
-    /** IDs of the line items the discount applies to. */
+    /**
+     * IDs of the line items the discount applies to.
+     * @format GUID
+     * @maxSize 300
+     */
     lineItemIds?: string[];
 }
 export interface CreateCheckoutResponse {
@@ -1902,7 +2324,10 @@ export interface ShippingCalculationErrorDataShippingCalculationErrorOneOf {
     carrierErrors?: CarrierErrors;
 }
 export interface GetCheckoutRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
 }
 export interface GetCheckoutResponse {
@@ -1910,7 +2335,10 @@ export interface GetCheckoutResponse {
     checkout?: Checkout;
 }
 export interface GetCheckoutWithAllExtendedFieldsRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id?: string;
 }
 export interface GetCheckoutWithAllExtendedFieldsResponse {
@@ -1918,7 +2346,10 @@ export interface GetCheckoutWithAllExtendedFieldsResponse {
     checkout?: Checkout;
 }
 export interface GetCheckoutByCartIdRequest {
-    /** Cart ID. */
+    /**
+     * Cart ID.
+     * @format GUID
+     */
     _id: string;
 }
 export interface GetCheckoutByCartIdResponse {
@@ -1926,7 +2357,10 @@ export interface GetCheckoutByCartIdResponse {
     checkout?: Checkout;
 }
 export interface GetWixCheckoutURLRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
 }
 export interface GetWixCheckoutURLResponse {
@@ -1934,7 +2368,10 @@ export interface GetWixCheckoutURLResponse {
     checkoutUrl?: string;
 }
 export interface GetCheckoutURLRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
 }
 export interface GetCheckoutURLResponse {
@@ -1952,15 +2389,20 @@ export interface UpdateCheckoutRequest {
      * `overrideCheckoutUrl` allows the flexibility to redirect customers to a customized checkout page.
      *
      * 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`.
+     * @maxLength 1000
      */
     overrideCheckoutUrl?: string | null;
-    /** Catalog line items. */
+    /**
+     * Catalog line items.
+     * @maxSize 300
+     */
     lineItems?: LineItem[];
     /**
      * Custom line items. Custom line items don't trigger the Catalog service plugin.
      *
      * 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).
+     * @maxSize 300
      */
     customLineItems?: CustomLineItem[];
 }
@@ -1969,7 +2411,10 @@ export interface UpdateCheckoutResponse {
     checkout?: Checkout;
 }
 export interface RemoveCouponRequest {
-    /** ID of the checkout to remove the coupon from. */
+    /**
+     * ID of the checkout to remove the coupon from.
+     * @format GUID
+     */
     _id: string;
 }
 export interface RemoveCouponResponse {
@@ -1977,7 +2422,10 @@ export interface RemoveCouponResponse {
     checkout?: Checkout;
 }
 export interface RemoveGiftCardRequest {
-    /** ID of the checkout to remove the gift card from. */
+    /**
+     * ID of the checkout to remove the gift card from.
+     * @format GUID
+     */
     _id: string;
 }
 export interface RemoveGiftCardResponse {
@@ -1985,7 +2433,10 @@ export interface RemoveGiftCardResponse {
     checkout?: Checkout;
 }
 export interface RemoveOverrideCheckoutUrlRequest {
-    /** ID of the checkout to remove the override checkout url from. */
+    /**
+     * ID of the checkout to remove the override checkout url from.
+     * @format GUID
+     */
     _id: string;
 }
 export interface RemoveOverrideCheckoutUrlResponse {
@@ -1993,15 +2444,22 @@ export interface RemoveOverrideCheckoutUrlResponse {
     checkout?: Checkout;
 }
 export interface AddToCheckoutRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
-    /** Catalog line items. */
+    /**
+     * Catalog line items.
+     * @maxSize 100
+     */
     lineItems?: LineItem[];
     /**
      * Custom line items. Custom line items don't trigger the Catalog service plugin.
      *
      * 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).
+     * @maxSize 100
      */
     customLineItems?: CustomLineItem[];
 }
@@ -2010,9 +2468,17 @@ export interface AddToCheckoutResponse {
     checkout?: Checkout;
 }
 export interface RemoveLineItemsRequest {
-    /** ID of the checkout to remove line items from. */
+    /**
+     * ID of the checkout to remove line items from.
+     * @format GUID
+     */
     _id: string;
-    /** IDs of the line items to remove from the checkout. */
+    /**
+     * IDs of the line items to remove from the checkout.
+     * @format GUID
+     * @minSize 1
+     * @maxSize 300
+     */
     lineItemIds: string[];
 }
 export interface RemoveLineItemsResponse {
@@ -2020,7 +2486,10 @@ export interface RemoveLineItemsResponse {
     checkout?: Checkout;
 }
 export interface CreateOrderRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
     /** Indicates the payment method should be saved on the order */
     savePaymentMethod?: boolean;
@@ -2028,9 +2497,15 @@ export interface CreateOrderRequest {
     delayCapture?: boolean;
 }
 export interface CreateOrderResponse extends CreateOrderResponseIdOneOf {
-    /** ID of the newly created order. */
+    /**
+     * ID of the newly created order.
+     * @format GUID
+     */
     orderId?: string;
-    /** ID of newly created subscription. Learn more about your site's [Subscriptions](https://support.wix.com/en/article/wix-stores-managing-product-subscriptions). */
+    /**
+     * ID of newly created subscription. Learn more about your site's [Subscriptions](https://support.wix.com/en/article/wix-stores-managing-product-subscriptions).
+     * @format GUID
+     */
     subscriptionId?: string;
     /**
      * Payment gateway order ID.
@@ -2045,9 +2520,15 @@ export interface CreateOrderResponse extends CreateOrderResponseIdOneOf {
 }
 /** @oneof */
 export interface CreateOrderResponseIdOneOf {
-    /** ID of newly created order. */
+    /**
+     * ID of newly created order.
+     * @format GUID
+     */
     orderId?: string;
-    /** ID of newly created subscription. Learn more about your site's [Subscriptions](https://support.wix.com/en/article/wix-stores-managing-product-subscriptions). */
+    /**
+     * ID of newly created subscription. Learn more about your site's [Subscriptions](https://support.wix.com/en/article/wix-stores-managing-product-subscriptions).
+     * @format GUID
+     */
     subscriptionId?: string;
 }
 export interface PaymentErrorResponseData {
@@ -2056,12 +2537,16 @@ export interface PaymentErrorResponseData {
     failureDetails?: string | null;
 }
 export interface DoublePaymentErrorData extends DoublePaymentErrorDataIdOneOf {
+    /** @format GUID */
     orderId?: string;
+    /** @format GUID */
     subscriptionId?: string;
 }
 /** @oneof */
 export interface DoublePaymentErrorDataIdOneOf {
+    /** @format GUID */
     orderId?: string;
+    /** @format GUID */
     subscriptionId?: string;
 }
 export interface RedeemErrorData {
@@ -2072,7 +2557,10 @@ export interface ViolationsList {
     violations?: Violation[];
 }
 export interface CreateOrderAndChargeRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
     /** Payment token. */
     paymentToken?: string | null;
@@ -2082,9 +2570,15 @@ export interface CreateOrderAndChargeRequest {
     delayCapture?: boolean;
 }
 export interface CreateOrderAndChargeResponse extends CreateOrderAndChargeResponseIdOneOf {
-    /** ID of newly created order. */
+    /**
+     * ID of newly created order.
+     * @format GUID
+     */
     orderId?: string;
-    /** ID of newly created subscription. */
+    /**
+     * ID of newly created subscription.
+     * @format GUID
+     */
     subscriptionId?: string;
     /** Payment response token. */
     paymentResponseToken?: string | null;
@@ -2100,17 +2594,27 @@ export interface CreateOrderAndChargeResponse extends CreateOrderAndChargeRespon
 }
 /** @oneof */
 export interface CreateOrderAndChargeResponseIdOneOf {
-    /** ID of newly created order. */
+    /**
+     * ID of newly created order.
+     * @format GUID
+     */
     orderId?: string;
-    /** ID of newly created subscription. */
+    /**
+     * ID of newly created subscription.
+     * @format GUID
+     */
     subscriptionId?: string;
 }
 export interface MarkCheckoutAsCompletedRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
     /**
      * Order ID.
      * @internal
+     * @format GUID
      */
     orderId?: string | null;
 }
@@ -2121,13 +2625,23 @@ export interface CheckoutMarkedAsCompleted {
     checkout?: Checkout;
 }
 export interface UpdateLineItemsQuantityRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
-    /** Line item info to update. */
+    /**
+     * Line item info to update.
+     * @minSize 1
+     * @maxSize 100
+     */
     lineItems: LineItemQuantityUpdate[];
 }
 export interface LineItemQuantityUpdate {
-    /** ID of the line item to update. */
+    /**
+     * ID of the line item to update.
+     * @format GUID
+     */
     _id?: string;
     /**
      * New total amount of the line item,
@@ -2136,6 +2650,8 @@ export interface LineItemQuantityUpdate {
      * Min: `1`
      *
      * Max: `100000`
+     * @min 1
+     * @max 100000
      */
     quantity?: number;
 }
@@ -2144,7 +2660,10 @@ export interface UpdateLineItemsQuantityResponse {
     checkout?: Checkout;
 }
 export interface GetCheckoutPaymentSettingsRequest {
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     _id: string;
 }
 export interface GetCheckoutPaymentSettingsResponse {
@@ -2155,7 +2674,10 @@ export declare enum GetCheckoutPaymentSettingsResponsePaymentOption {
     MANUAL = "MANUAL"
 }
 export interface DeleteCheckoutRequest {
-    /** ID of the checkout to delete. */
+    /**
+     * ID of the checkout to delete.
+     * @format GUID
+     */
     _id?: string;
 }
 export interface DeleteCheckoutResponse {
@@ -2169,20 +2691,33 @@ export interface Subscription {
      * @readonly
      */
     _id?: string;
-    /** id of subscription in external system */
+    /**
+     * id of subscription in external system
+     * @format GUID
+     */
     externalId?: string | null;
     /**
      * Subscription creation date
      * @readonly
      */
     dateCreated?: Date | null;
-    /** The id of the cart this order was created from */
+    /**
+     * The id of the cart this order was created from
+     * @format GUID
+     */
     cartId?: string | null;
-    /** The id of the checkout this subscriptions was created from */
+    /**
+     * The id of the checkout this subscriptions was created from
+     * @format GUID
+     */
     checkoutId?: string | null;
     /** member or contact */
     buyerInfo?: V1BuyerInfo;
-    /** Line items ordered */
+    /**
+     * Line items ordered
+     * @minSize 1
+     * @maxSize 1
+     */
     lineItems?: V1LineItem[];
     /** Totals for subscription's line items */
     totals?: Totals;
@@ -2194,7 +2729,10 @@ export interface Subscription {
     shippingInfo?: V1ShippingInfo;
     /** Coupon that was applied to subscription */
     appliedCoupon?: AppliedCoupon;
-    /** Message from the customer (e.g., customization request) */
+    /**
+     * Message from the customer (e.g., customization request)
+     * @maxLength 1000
+     */
     buyerNote?: string | null;
     /** Custom field */
     customField?: V1CustomField;
@@ -2212,7 +2750,10 @@ export interface Subscription {
 }
 /** Buyer Info */
 export interface V1BuyerInfo {
-    /** Wix customer ID */
+    /**
+     * Wix customer ID
+     * @format GUID
+     */
     _id?: string;
     /** Customer type */
     identityType?: IdentityType;
@@ -2227,13 +2768,26 @@ export declare enum IdentityType {
 export interface V1LineItem {
     /** Line item ID (auto-generated) */
     index?: number;
-    /** Line item quantity */
+    /**
+     * Line item quantity
+     * @min 1
+     * @max 100000
+     */
     quantity?: number;
-    /** Line item variantId (from Stores Catalog) */
+    /**
+     * Line item variantId (from Stores Catalog)
+     * @format GUID
+     */
     variantId?: string | null;
-    /** Line item options ordered */
+    /**
+     * Line item options ordered
+     * @maxSize 6
+     */
     options?: OptionSelection[];
-    /** Line item custom text field selections */
+    /**
+     * Line item custom text field selections
+     * @maxSize 20
+     */
     customTextFields?: CustomTextFieldSelection[];
     /** Charges details */
     chargeDetails?: ChargeDetails;
@@ -2241,53 +2795,109 @@ export interface V1LineItem {
     productDetails?: ProductDetails;
 }
 export interface OptionSelection {
-    /** Option name */
+    /**
+     * Option name
+     * @maxLength 200
+     */
     option?: string;
-    /** Selected choice for this option */
+    /**
+     * Selected choice for this option
+     * @maxLength 500
+     */
     selection?: string;
 }
 export interface CustomTextFieldSelection {
-    /** Custom text field name */
+    /**
+     * Custom text field name
+     * @maxLength 100
+     */
     title?: string;
-    /** Custom text field value */
+    /**
+     * Custom text field value
+     * @maxLength 500
+     */
     value?: string;
 }
 export interface ChargeDetails {
-    /** price of line item (depends on subscription option) */
+    /**
+     * price of line item (depends on subscription option)
+     * @max 999999999.99
+     */
     price?: number;
-    /** Total price charged to the customer (for this line items) after computation of quantity and discount */
+    /**
+     * Total price charged to the customer (for this line items) after computation of quantity and discount
+     * @max 999999999.99
+     */
     totalPrice?: number | null;
-    /** Discount applied for this line item */
+    /**
+     * Discount applied for this line item
+     * @max 999999999.99
+     */
     discount?: number | null;
-    /** Tax applied for this line item */
+    /**
+     * Tax applied for this line item
+     * @max 999999999.99
+     */
     tax?: number | null;
     /** Is tax applied for this line item */
     taxIncludedInPrice?: boolean;
-    /** Tax rate %, as a decimal point >= 0 */
+    /**
+     * Tax rate %, as a decimal point >= 0
+     * @decimalValue options { maxScale:6, gte:0 }
+     */
     taxRate?: string | null;
 }
 export interface ProductDetails {
-    /** Line item product ID (optional for POS orders) */
+    /**
+     * Line item product ID (optional for POS orders)
+     * @minLength 1
+     */
     productId?: string | null;
-    /** Line item name */
+    /**
+     * Line item name
+     * @minLength 1
+     * @maxLength 100
+     */
     name?: string;
-    /** Line item name translated to buyer's language */
+    /**
+     * Line item name translated to buyer's language
+     * @minLength 1
+     * @maxLength 100
+     */
     translatedName?: string | null;
     /** Line item type (may be extended) */
     lineItemType?: LineItemType;
     /** Line item primary media for preview */
     mediaItem?: MediaItem;
-    /** Line item SKU */
+    /**
+     * Line item SKU
+     * @maxLength 40
+     */
     sku?: string | null;
-    /** Line item weight */
+    /**
+     * Line item weight
+     * @max 999999999.99
+     */
     weight?: number | null;
-    /** Line item notes */
+    /**
+     * Line item notes
+     * @maxLength 1000
+     */
     notes?: string | null;
-    /** Line item fulfillerId from stores fulfillers. No value means self fulfilled */
+    /**
+     * Line item fulfillerId from stores fulfillers. No value means self fulfilled
+     * @format GUID
+     */
     fulfillerId?: string | null;
-    /** Tax group id */
+    /**
+     * Tax group id
+     * @format GUID
+     */
     taxGroupId?: string | null;
-    /** App id from the catalog reference */
+    /**
+     * App id from the catalog reference
+     * @format GUID
+     */
     appId?: string | null;
 }
 export declare enum LineItemType {
@@ -2308,16 +2918,19 @@ export interface MediaItem {
     mediaType?: MediaItemType;
     /**
      * Media URL
+     * @format WEB_URL
      * @readonly
      */
     url?: string;
     /**
      * Media item width
+     * @max 5000
      * @readonly
      */
     width?: number;
     /**
      * Media item height
+     * @max 5000
      * @readonly
      */
     height?: number;
@@ -2325,7 +2938,10 @@ export interface MediaItem {
     _id?: string | null;
     /** Media external URL */
     externalImageUrl?: string | null;
-    /** Alternative text for presentation when media cannot be displayed */
+    /**
+     * Alternative text for presentation when media cannot be displayed
+     * @maxLength 256
+     */
     altText?: string | null;
 }
 export declare enum MediaItemType {
@@ -2335,17 +2951,35 @@ export declare enum MediaItemType {
     IMAGE = "IMAGE"
 }
 export interface Totals {
-    /** Subtotal of all line items, before tax */
+    /**
+     * Subtotal of all line items, before tax
+     * @max 999999999.99
+     */
     subtotal?: number;
-    /** Total shipping price, including tax */
+    /**
+     * Total shipping price, including tax
+     * @max 999999999.99
+     */
     shipping?: number;
-    /** Total tax */
+    /**
+     * Total tax
+     * @max 999999999.99
+     */
     tax?: number;
-    /** Total calculated discount value */
+    /**
+     * Total calculated discount value
+     * @max 999999999.99
+     */
     discount?: number;
-    /** Total price */
+    /**
+     * Total price
+     * @max 999999999.99
+     */
     total?: number;
-    /** Total weight */
+    /**
+     * Total weight
+     * @max 999999999.99
+     */
     weight?: number | null;
     /**
      * Total line items quantity
@@ -2354,7 +2988,11 @@ export interface Totals {
     quantity?: number;
 }
 export interface StoreSettings {
-    /** Currency used for pricing in this store */
+    /**
+     * Currency used for pricing in this store
+     * @maxLength 3
+     * @format CURRENCY
+     */
     currency?: string | null;
     /** Weight unit used in this store */
     weightUnit?: WeightUnit;
@@ -2362,56 +3000,103 @@ export interface StoreSettings {
      * The language to be used when communicating with the buyer
      * For a site that support multiple languages, this would be the language the buyer selected
      * Otherwise this would be the site language
+     * @minLength 2
+     * @maxLength 2
      */
     buyerLanguage?: string | null;
 }
 export interface Address extends AddressAddressLine1OptionsOneOf {
-    /** Address line 1 (free text) */
+    /**
+     * Address line 1 (free text)
+     * @maxLength 1000
+     */
     addressLine1?: string;
     /** Address line 1 (street) */
     street?: Street;
     /** Addressee name */
     fullName?: FullName;
-    /** Country code (2 letters) */
+    /**
+     * Country code (2 letters)
+     * @format COUNTRY
+     */
     country?: string | null;
-    /** State or district */
+    /**
+     * State or district
+     * @maxLength 50
+     */
     subdivision?: string | null;
-    /** City name */
+    /**
+     * City name
+     * @maxLength 150
+     */
     city?: string | null;
-    /** ZIP/postal code */
+    /**
+     * ZIP/postal code
+     * @maxLength 200
+     */
     zipCode?: string | null;
-    /** Phone number */
+    /**
+     * Phone number
+     * @maxLength 200
+     */
     phone?: string | null;
-    /** Company name */
+    /**
+     * Company name
+     * @maxLength 500
+     */
     company?: string | null;
-    /** Email address */
+    /**
+     * Email address
+     * @maxLength 500
+     */
     email?: string | null;
-    /** address line */
+    /**
+     * address line
+     * @maxLength 250
+     */
     addressLine2?: string | null;
     /** Tax information (for Brazil only) */
     vatId?: VatId;
 }
 /** @oneof */
 export interface AddressAddressLine1OptionsOneOf {
-    /** Address line 1 (free text) */
+    /**
+     * Address line 1 (free text)
+     * @maxLength 1000
+     */
     addressLine1?: string;
     /** Address line 1 (street) */
     street?: Street;
 }
 export interface FullName {
-    /** Customer's first name */
+    /**
+     * Customer's first name
+     * @maxLength 1000
+     */
     firstName?: string;
-    /** Customer's last name */
+    /**
+     * Customer's last name
+     * @maxLength 1000
+     */
     lastName?: string;
 }
 export interface Street {
-    /** Street number */
+    /**
+     * Street number
+     * @maxLength 500
+     */
     number?: string;
-    /** Street name */
+    /**
+     * Street name
+     * @maxLength 1000
+     */
     name?: string;
 }
 export interface VatId {
-    /** Customer's tax ID. */
+    /**
+     * Customer's tax ID.
+     * @maxLength 50
+     */
     number?: string;
     /**
      * Tax type.
@@ -2434,9 +3119,15 @@ export interface V1ShippingInfo extends V1ShippingInfoDetailsOneOf {
     shipmentDetails?: ShipmentDetails;
     /** Pickup details (when this object describes pickup) */
     pickupDetails?: V1PickupDetails;
-    /** Delivery option name */
+    /**
+     * Delivery option name
+     * @maxLength 250
+     */
     deliveryOption?: string;
-    /** Delivery option delivery time */
+    /**
+     * Delivery option delivery time
+     * @maxLength 500
+     */
     estimatedDeliveryTime?: string | null;
 }
 /** @oneof */
@@ -2449,53 +3140,101 @@ export interface V1ShippingInfoDetailsOneOf {
 export interface ShipmentDetails {
     /** Shipping destination address */
     address?: Address;
-    /** Discount applied for shipping */
+    /**
+     * Discount applied for shipping
+     * @max 999999999.99
+     */
     discount?: number | null;
-    /** Tax applied for shipping */
+    /**
+     * Tax applied for shipping
+     * @max 999999999.99
+     */
     tax?: number | null;
     /** Whether tax is included in the price */
     taxIncludedInPrice?: boolean;
-    /** Tax rate % for shipping, as a decimal point >= 0 */
+    /**
+     * Tax rate % for shipping, as a decimal point >= 0
+     * @decimalValue options { maxScale:6, gte:0 }
+     */
     taxRate?: string | null;
 }
 export interface V1PickupDetails {
     /** Pickup address */
     address?: PickupAddress;
-    /** Store owner's pickup instructions */
+    /**
+     * Store owner's pickup instructions
+     * @maxLength 1000
+     */
     pickupInstructions?: string | null;
 }
 export interface PickupAddress {
-    /** Country code (2 letters) */
+    /**
+     * Country code (2 letters)
+     * @format COUNTRY
+     */
     country?: string;
-    /** State/District */
+    /**
+     * State/District
+     * @maxLength 50
+     */
     subdivision?: string | null;
-    /** Address */
+    /**
+     * Address
+     * @maxLength 200
+     */
     addressLine?: string;
-    /** City */
+    /**
+     * City
+     * @maxLength 85
+     */
     city?: string;
-    /** ZIP/postal code */
+    /**
+     * ZIP/postal code
+     * @maxLength 50
+     */
     zipCode?: string;
 }
 export interface AppliedCoupon {
     /** Coupon ID */
     couponId?: string;
-    /** Coupon name */
+    /**
+     * Coupon name
+     * @maxLength 100
+     */
     name?: string;
-    /** Coupon code */
+    /**
+     * Coupon code
+     * @maxLength 100
+     */
     code?: string;
 }
 /** Custom field */
 export interface V1CustomField {
-    /** Free text that the customer entered in the custom field during the checkout process */
+    /**
+     * Free text that the customer entered in the custom field during the checkout process
+     * @maxLength 250
+     */
     value?: string;
-    /** Title for the custom field */
+    /**
+     * Title for the custom field
+     * @maxLength 200
+     */
     title?: string;
-    /** The title translated according to the buyer language */
+    /**
+     * The title translated according to the buyer language
+     * @maxLength 200
+     */
     translatedTitle?: string;
 }
 export interface V1SubscriptionOptionInfo {
+    /** @format GUID */
     _id?: string | null;
+    /**
+     * @minLength 1
+     * @maxLength 20
+     */
     title?: string;
+    /** @maxLength 60 */
     description?: string | null;
     discount?: Discount;
 }
@@ -2526,15 +3265,28 @@ export interface V1SubscriptionSettings {
     frequency?: SubscriptionFrequency;
     /** Whether subscription is renewed automatically at the end of each period. */
     autoRenewal?: boolean;
-    /** Number of billing cycles before subscription ends. Ignored if `autoRenewal: true`. */
+    /**
+     * Number of billing cycles before subscription ends. Ignored if `autoRenewal: true`.
+     * @min 2
+     * @max 999
+     */
     billingCycles?: number | null;
 }
 export interface BillingInfo {
-    /** Payment method used for this order */
+    /**
+     * Payment method used for this order
+     * @maxLength 50
+     */
     paymentMethod?: string | null;
-    /** Transaction ID from payment gateway (e.g., Wix Payments) */
+    /**
+     * Transaction ID from payment gateway (e.g., Wix Payments)
+     * @maxLength 100
+     */
     paymentGatewayTransactionId?: string | null;
-    /** Order ID from payment gateway (e.g., Wix Payments) */
+    /**
+     * Order ID from payment gateway (e.g., Wix Payments)
+     * @maxLength 100
+     */
     paymentGatewayOrderId?: string | null;
 }
 export interface Empty {
@@ -2610,9 +3362,15 @@ export interface ActionEvent {
     body?: string;
 }
 export interface MessageEnvelope {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -2620,26 +3378,50 @@ export interface MessageEnvelope {
     data?: string;
 }
 export interface IdentificationData extends IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
     /** @readonly */
     identityType?: WebhookIdentityType;
 }
 /** @oneof */
 export interface IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
 }
 export declare enum WebhookIdentityType {
@@ -3080,6 +3862,14 @@ interface CustomContentReferenceNonNullableFields {
 interface ExternalReferenceNonNullableFields {
     appId: string;
 }
+interface ChargeNonNullableFields {
+    cycleFrom: number;
+    priceSummary?: PriceSummaryNonNullableFields;
+}
+interface SubscriptionChargesNonNullableFields {
+    lineItemIds: string[];
+    charges: ChargeNonNullableFields[];
+}
 export interface CheckoutNonNullableFields {
     lineItems: LineItemNonNullableFields[];
     billingInfo?: AddressWithContactNonNullableFields;
@@ -3115,6 +3905,8 @@ export interface CheckoutNonNullableFields {
     payAfterFreeTrial?: PriceSummaryNonNullableFields;
     /** @internal */
     paymentRequired: boolean;
+    /** @internal */
+    subscriptionCharges: SubscriptionChargesNonNullableFields[];
 }
 export interface CreateCheckoutResponseNonNullableFields {
     checkout?: CheckoutNonNullableFields;
@@ -3164,9 +3956,15 @@ export interface GetCheckoutPaymentSettingsResponseNonNullableFields {
     blockedPaymentOptions: GetCheckoutPaymentSettingsResponsePaymentOption[];
 }
 export interface BaseEventMetadata {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -3233,6 +4031,8 @@ export interface CheckoutCompletedEnvelope {
  * @permissionId ECOM.READ_CHECKOUTS
  * @webhook
  * @eventType wix.ecom.v1.checkout_completed
+ * @serviceIdentifier com.wix.ecom.checkout.api.v1.CheckoutService
+ * @slug completed
  */
 export declare function onCheckoutCompleted(handler: (event: CheckoutCompletedEnvelope) => void | Promise<void>): void;
 export interface CheckoutCreatedEnvelope {
@@ -3258,6 +4058,8 @@ export interface CheckoutCreatedEnvelope {
  * @permissionId ECOM.READ_CHECKOUTS
  * @webhook
  * @eventType wix.ecom.v1.checkout_created
+ * @serviceIdentifier com.wix.ecom.checkout.api.v1.CheckoutService
+ * @slug created
  */
 export declare function onCheckoutCreated(handler: (event: CheckoutCreatedEnvelope) => void | Promise<void>): void;
 export interface CheckoutUpdatedEnvelope {
@@ -3283,6 +4085,8 @@ export interface CheckoutUpdatedEnvelope {
  * @permissionId ECOM.READ_CHECKOUTS
  * @webhook
  * @eventType wix.ecom.v1.checkout_updated
+ * @serviceIdentifier com.wix.ecom.checkout.api.v1.CheckoutService
+ * @slug updated
  */
 export declare function onCheckoutUpdated(handler: (event: CheckoutUpdatedEnvelope) => void | Promise<void>): void;
 /**
@@ -3302,8 +4106,8 @@ export declare function onCheckoutUpdated(handler: (event: CheckoutUpdatedEnvelo
  * @requiredField options.checkoutInfo.membershipOptions.selectedMemberships.memberships._id
  * @requiredField options.checkoutInfo.membershipOptions.selectedMemberships.memberships.appId
  * @requiredField options.checkoutInfo.membershipOptions.selectedMemberships.memberships.lineItemIds
- * @requiredField options.customLineItems.descriptionLines
  * @requiredField options.customLineItems.descriptionLines.name
+ * @requiredField options.customLineItems.descriptionLines.value
  * @requiredField options.customLineItems.itemType
  * @requiredField options.customLineItems.price
  * @requiredField options.customLineItems.productName
@@ -3327,6 +4131,8 @@ export declare function onCheckoutUpdated(handler: (event: CheckoutUpdatedEnvelo
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Manage eCommerce - Admin Permissions
  * @permissionScopeId SCOPE.ECOM.MANAGE-ADMIN
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3340,28 +4146,20 @@ export interface CreateCheckoutOptions {
     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;
-    /** Catalog line items to add to the checkout. */
+    /**
+     * Catalog line items to add to the checkout.
+     * @maxSize 300
+     */
     lineItems?: LineItem[];
     /**
      * Custom line items to add to the checkout. Custom line items don't trigger the Catalog service plugin.
      *
      * 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).
+     * @maxSize 300
      */
     customLineItems?: CustomLineItem[];
-    /**
-     * Sales channel that submitted the order.
-     * + `"UNSPECIFIED"`: Unspecified sales channel. This value is not supported.
-     * + `"WEB"`: A web client.
-     * + `"POS"`: [Point of sale solutions](https://support.wix.com/en/wix-mobile-pos-2196395)
-     * + `"EBAY"`: [eBay](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-ebay-shop)
-     * + `"AMAZON"`: [Amazon](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-amazon-shop)
-     * + `"WISH"`: [Wish](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-a-wish-shop)
-     * + `"WIX_INVOICES"`: Wix Invoices app in [your dashboard](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Finvoices/settings/general-settings)
-     * + `"WIX_APP_STORE"`: [Wix Owner app](https://support.wix.com/article/wix-owner-app-an-overview)
-     * + `"BACKOFFICE_MERCHANT"`: Wix merchant backoffice
-     * + `"OTHER_PLATFORM"`: Other sales platform.
-     */
+    /** Sales channel that submitted the order. */
     channelType: ChannelType;
     /**
      * Gift card code.
@@ -3375,6 +4173,7 @@ export interface CreateCheckoutOptions {
      * `overrideCheckoutUrl` allows the flexibility to redirect customers to a customized checkout page.
      *
      * 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`.
+     * @maxLength 1000
      */
     overrideCheckoutUrl?: string | null;
 }
@@ -3411,7 +4210,6 @@ export declare function getCheckout(_id: string): Promise<Checkout & CheckoutNon
  * Retrieves the checkout associated with a specified cart.
  * @param _id - Cart ID.
  * @public
- * @documentationMaturity preview
  * @requiredField _id
  * @permissionId ECOM.READ_CHECKOUTS
  * @permissionScope Manage Stores - all permissions
@@ -3504,8 +4302,8 @@ export declare function getCheckoutUrl(_id: string): Promise<GetCheckoutURLRespo
  * @requiredField checkout.membershipOptions.selectedMemberships.memberships._id
  * @requiredField checkout.membershipOptions.selectedMemberships.memberships.appId
  * @requiredField checkout.membershipOptions.selectedMemberships.memberships.lineItemIds
- * @requiredField options.customLineItems.descriptionLines
  * @requiredField options.customLineItems.descriptionLines.name
+ * @requiredField options.customLineItems.descriptionLines.value
  * @requiredField options.customLineItems.itemType
  * @requiredField options.customLineItems.productName
  * @requiredField options.customLineItems.quantity
@@ -3528,6 +4326,8 @@ export declare function getCheckoutUrl(_id: string): Promise<GetCheckoutURLRespo
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Manage eCommerce - Admin Permissions
  * @permissionScopeId SCOPE.ECOM.MANAGE-ADMIN
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3539,6 +4339,7 @@ export declare function updateCheckout(_id: string | null, checkout: UpdateCheck
 export interface UpdateCheckout {
     /**
      * Checkout ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
@@ -3546,6 +4347,8 @@ export interface UpdateCheckout {
      * Line items.
      *
      * Max: 300 items
+     * @minSize 1
+     * @maxSize 300
      * @readonly
      */
     lineItems?: LineItem[];
@@ -3553,13 +4356,17 @@ export interface UpdateCheckout {
     billingInfo?: AddressWithContact;
     /** Shipping information. */
     shippingInfo?: ShippingInfo;
-    /** [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer. */
+    /**
+     * [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer.
+     * @maxLength 1000
+     */
     buyerNote?: string | null;
     /** Buyer information. */
     buyerInfo?: BuyerInfo;
     /**
      * All converted prices are displayed in this currency in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
      * @readonly
+     * @format CURRENCY
      */
     conversionCurrency?: string;
     /**
@@ -3598,6 +4405,7 @@ export interface UpdateCheckout {
     taxSummary?: TaxSummary;
     /**
      * The currency used when submitting the order.
+     * @format CURRENCY
      * @readonly
      */
     currency?: string;
@@ -3655,9 +4463,15 @@ export interface UpdateCheckout {
     payLater?: PriceSummary;
     /** Memberships to apply when creating the order. */
     membershipOptions?: MembershipOptions;
-    /** Additional Fees. */
+    /**
+     * Additional Fees.
+     * @maxSize 100
+     */
     additionalFees?: AdditionalFee[];
-    /** Cart ID that this checkout was created from. Empty if this checkout wasn't created from a cart. */
+    /**
+     * Cart ID that this checkout was created from. Empty if this checkout wasn't created from a cart.
+     * @format GUID
+     */
     cartId?: string | null;
     /**
      * List of validation violations raised by the [Validations Custom Extension SPI](https://www.wix.com/velo/reference/spis/wix-ecom/ecom-validations/introduction).
@@ -3672,6 +4486,7 @@ export interface UpdateCheckout {
     extendedFields?: ExtendedFields;
     /**
      * Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
+     * @format GUID
      * @readonly
      */
     purchaseFlowId?: string | null;
@@ -3679,6 +4494,7 @@ export interface UpdateCheckout {
      * Additional settings for customization of the checkout process.
      *
      * Custom settings can only be defined when [creating a checkout](https://www.wix.com/velo/reference/wix-ecom-backend/checkout/createcheckout).
+     * @immutable
      */
     customSettings?: CustomSettings;
     /**
@@ -3693,6 +4509,7 @@ export interface UpdateCheckout {
      *
      * This field is empty until the checkout completes and becomes an order.
      * @internal
+     * @format GUID
      * @readonly
      */
     orderId?: string | null;
@@ -3705,6 +4522,7 @@ export interface UpdateCheckout {
     /**
      * The business location ID associated with the checkout.
      * Learn more about the [Locations API](https://dev.wix.com/docs/rest/business-management/locations/introduction).
+     * @format GUID
      */
     businessLocationId?: string | null;
     /**
@@ -3717,6 +4535,13 @@ export interface UpdateCheckout {
      * @readonly
      */
     paymentRequired?: boolean;
+    /**
+     * Charges information for each subscription in the Checkout.
+     * @internal
+     * @readonly
+     * @maxSize 100
+     */
+    subscriptionCharges?: SubscriptionCharges[];
 }
 export interface UpdateCheckoutOptions {
     /** 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). */
@@ -3727,15 +4552,20 @@ export interface UpdateCheckoutOptions {
      * `overrideCheckoutUrl` allows the flexibility to redirect customers to a customized checkout page.
      *
      * 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`.
+     * @maxLength 1000
      */
     overrideCheckoutUrl?: string | null;
-    /** Catalog line items. */
+    /**
+     * Catalog line items.
+     * @maxSize 300
+     */
     lineItems?: LineItem[];
     /**
      * Custom line items. Custom line items don't trigger the Catalog service plugin.
      *
      * 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).
+     * @maxSize 300
      */
     customLineItems?: CustomLineItem[];
 }
@@ -3818,8 +4648,8 @@ export declare function removeOverrideCheckoutUrl(_id: string): Promise<RemoveOv
  * @param _id - Checkout ID.
  * @public
  * @requiredField _id
- * @requiredField options.customLineItems.descriptionLines
  * @requiredField options.customLineItems.descriptionLines.name
+ * @requiredField options.customLineItems.descriptionLines.value
  * @requiredField options.customLineItems.itemType
  * @requiredField options.customLineItems.productName
  * @requiredField options.customLineItems.quantity
@@ -3842,6 +4672,8 @@ export declare function removeOverrideCheckoutUrl(_id: string): Promise<RemoveOv
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Manage eCommerce - Admin Permissions
  * @permissionScopeId SCOPE.ECOM.MANAGE-ADMIN
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3850,13 +4682,17 @@ export declare function removeOverrideCheckoutUrl(_id: string): Promise<RemoveOv
  */
 export declare function addToCheckout(_id: string, options?: AddToCheckoutOptions): Promise<AddToCheckoutResponse & AddToCheckoutResponseNonNullableFields>;
 export interface AddToCheckoutOptions {
-    /** Catalog line items. */
+    /**
+     * Catalog line items.
+     * @maxSize 100
+     */
     lineItems?: LineItem[];
     /**
      * Custom line items. Custom line items don't trigger the Catalog service plugin.
      *
      * 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).
+     * @maxSize 100
      */
     customLineItems?: CustomLineItem[];
 }