@wix/auto_sdk_ecom_cart 1.0.85 → 1.0.87

package/build/internal/es/index.typings.d.mts

@@ -22,13 +22,16 @@ interface Cart {
     /** Buyer information. */
     buyerInfo?: BuyerInfo;
     /**
-     * The site's default currency, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+     * The site’s default currency, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This represents the base currency configured for the site and remains constant regardless of the customer’s currency selection.
      * @format CURRENCY
      * @readonly
      */
     currency?: string;
     /**
-     * The currency selected by the buyer during the purchase flow, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+     * The currency [selected by the customer](https://support.wix.com/en/article/multicurrency-an-overview) during the purchase flow, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+     *
+     * This reflects the customer’s preferred display currency and may differ from the site’s default currency.
+     * When no specific currency is selected by the customer, this matches the `currency` property.
      * @readonly
      * @format CURRENCY
      */
@@ -95,6 +98,8 @@ interface Cart {
     purchaseFlowId?: string | null;
     /** Selected shipping option. */
     selectedShippingOption?: SelectedShippingOption;
+    /** Fields extended by data extensions */
+    extendedFields?: ExtendedFields;
     /**
      * The business location ID associated with the cart.
      *
@@ -103,7 +108,10 @@ interface Cart {
      */
     businessLocationId?: string | null;
     /**
-     * Currency used for payment, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+     * The currency used for payment, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+     *
+     * This is determined by the [customer's selected currency](https://support.wix.com/en/article/multicurrency-an-overview) and the site’s supported payment currencies.
+     * If the customer’s selected currency is supported for payment, this matches the `conversionCurrency` property. If not supported, this falls back to the `currency` property.
      * @readonly
      * @format CURRENCY
      */
@@ -3198,13 +3206,16 @@ interface UpdateCartOptions {
         /** Buyer information. */
         buyerInfo?: BuyerInfo;
         /**
-         * The site's default currency, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+         * The site’s default currency, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This represents the base currency configured for the site and remains constant regardless of the customer’s currency selection.
          * @format CURRENCY
          * @readonly
          */
         currency?: string;
         /**
-         * The currency selected by the buyer during the purchase flow, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+         * The currency [selected by the customer](https://support.wix.com/en/article/multicurrency-an-overview) during the purchase flow, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+         *
+         * This reflects the customer’s preferred display currency and may differ from the site’s default currency.
+         * When no specific currency is selected by the customer, this matches the `currency` property.
          * @readonly
          * @format CURRENCY
          */
@@ -3271,6 +3282,8 @@ interface UpdateCartOptions {
         purchaseFlowId?: string | null;
         /** Selected shipping option. */
         selectedShippingOption?: SelectedShippingOption;
+        /** Fields extended by data extensions */
+        extendedFields?: ExtendedFields;
         /**
          * The business location ID associated with the cart.
          *
@@ -3279,7 +3292,10 @@ interface UpdateCartOptions {
          */
         businessLocationId?: string | null;
         /**
-         * Currency used for payment, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+         * The currency used for payment, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
+         *
+         * This is determined by the [customer's selected currency](https://support.wix.com/en/article/multicurrency-an-overview) and the site’s supported payment currencies.
+         * If the customer’s selected currency is supported for payment, this matches the `conversionCurrency` property. If not supported, this falls back to the `currency` property.
          * @readonly
          * @format CURRENCY
          */