@wix/auto_sdk_ecom_cart 1.0.85 → 1.0.86

package/build/cjs/index.typings.d.ts

@@ -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
      */
@@ -103,7 +106,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
      */
@@ -3064,13 +3070,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
          */
@@ -3145,7 +3154,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
          */