@salesforce/b2c-tooling-sdk 1.15.1 → 1.17.0

package/data/script-api/dw.customer.consent.ShopperConsentException.md

@@ -0,0 +1,63 @@
+<!-- prettier-ignore-start -->
+# Class ShopperConsentException
+
+- [TopLevel.Object](TopLevel.Object.md)
+  - [dw.customer.consent.ShopperConsentException](dw.customer.consent.ShopperConsentException.md)
+
+This exception is thrown by [ShopperConsentMgr](dw.customer.consent.ShopperConsentMgr.md) methods when an error occurs
+during consent subscription operations.
+
+
+The 'errorCode' property is set to one of the following values:
+
+- [ShopperConsentErrorCodes.FEATURE_DISABLED](dw.customer.consent.ShopperConsentErrorCodes.md#feature_disabled)- Indicates that the Marketing Consent  feature is not enabled.
+- [ShopperConsentErrorCodes.RETRIEVAL_ERROR](dw.customer.consent.ShopperConsentErrorCodes.md#retrieval_error)- Indicates that an error occurred while  retrieving consent subscriptions.
+- [ShopperConsentErrorCodes.UPDATE_ERROR](dw.customer.consent.ShopperConsentErrorCodes.md#update_error)- Indicates that an error occurred while  updating consent subscriptions.
+- [ShopperConsentErrorCodes.CUSTOMER_NOT_AUTHENTICATED](dw.customer.consent.ShopperConsentErrorCodes.md#customer_not_authenticated)- Indicates that the customer  is not authenticated (required for consent status retrieval).
+- [ShopperConsentErrorCodes.INTERNAL_ERROR](dw.customer.consent.ShopperConsentErrorCodes.md#internal_error)- Indicates that an internal error occurred.
+
+
+
+## Property Summary
+
+| Property | Description |
+| --- | --- |
+| [errorCode](#errorcode): [String](TopLevel.String.md) `(read-only)` | Returns the error code indicating the reason for the failure. |
+
+## Constructor Summary
+
+This class does not have a constructor, so you cannot create it directly.
+## Method Summary
+
+| Method | Description |
+| --- | --- |
+| [getErrorCode](dw.customer.consent.ShopperConsentException.md#geterrorcode)() | Returns the error code indicating the reason for the failure. |
+
+### Methods inherited from class Error
+
+[captureStackTrace](TopLevel.Error.md#capturestacktraceerror-function), [toString](TopLevel.Error.md#tostring)
+### Methods inherited from class Object
+
+[assign](TopLevel.Object.md#assignobject-object), [create](TopLevel.Object.md#createobject), [create](TopLevel.Object.md#createobject-object), [defineProperties](TopLevel.Object.md#definepropertiesobject-object), [defineProperty](TopLevel.Object.md#definepropertyobject-object-object), [entries](TopLevel.Object.md#entriesobject), [freeze](TopLevel.Object.md#freezeobject), [fromEntries](TopLevel.Object.md#fromentriesiterable), [getOwnPropertyDescriptor](TopLevel.Object.md#getownpropertydescriptorobject-object), [getOwnPropertyNames](TopLevel.Object.md#getownpropertynamesobject), [getOwnPropertySymbols](TopLevel.Object.md#getownpropertysymbolsobject), [getPrototypeOf](TopLevel.Object.md#getprototypeofobject), [hasOwnProperty](TopLevel.Object.md#hasownpropertystring), [is](TopLevel.Object.md#isobject-object), [isExtensible](TopLevel.Object.md#isextensibleobject), [isFrozen](TopLevel.Object.md#isfrozenobject), [isPrototypeOf](TopLevel.Object.md#isprototypeofobject), [isSealed](TopLevel.Object.md#issealedobject), [keys](TopLevel.Object.md#keysobject), [preventExtensions](TopLevel.Object.md#preventextensionsobject), [propertyIsEnumerable](TopLevel.Object.md#propertyisenumerablestring), [seal](TopLevel.Object.md#sealobject), [setPrototypeOf](TopLevel.Object.md#setprototypeofobject-object), [toLocaleString](TopLevel.Object.md#tolocalestring), [toString](TopLevel.Object.md#tostring), [valueOf](TopLevel.Object.md#valueof), [values](TopLevel.Object.md#valuesobject)
+## Property Details
+
+### errorCode
+- errorCode: [String](TopLevel.String.md) `(read-only)`
+  - : Returns the error code indicating the reason for the failure.
+
+
+---
+
+## Method Details
+
+### getErrorCode()
+- getErrorCode(): [String](TopLevel.String.md)
+  - : Returns the error code indicating the reason for the failure.
+
+    **Returns:**
+    - The error code.
+
+
+---
+
+<!-- prettier-ignore-end -->

package/data/script-api/dw.customer.consent.ShopperConsentMgr.md

@@ -0,0 +1,152 @@
+<!-- prettier-ignore-start -->
+# Class ShopperConsentMgr
+
+- [TopLevel.Object](TopLevel.Object.md)
+  - [dw.customer.consent.ShopperConsentMgr](dw.customer.consent.ShopperConsentMgr.md)
+
+Provides static helper methods for managing shopper marketing consent subscriptions.
+
+
+This API enables retrieving and updating marketing consent preferences.
+Consent subscriptions define communication categories (e.g., "Newsletter", "Product Updates")
+and the channels (EMAIL, SMS, WHATSAPP) through which marketing communications can be sent.
+
+
+
+
+**Prerequisites:**
+
+- The Marketing Consent feature must be enabled and configured
+- For consent status retrieval, the current request must have a customer context
+
+
+
+
+
+**Example usage:**
+
+```
+var ShopperConsentMgr = require('dw/customer/consent/ShopperConsentMgr');
+
+// Get all subscriptions for the current site
+var subscriptions = ShopperConsentMgr.getSubscriptions();
+
+for each (var sub in subscriptions) {
+    trace('Subscription: ' + sub.subscriptionId + ' - ' + sub.title);
+    trace('Available channels: ' + sub.channels.join(', '));
+}
+
+// Get subscriptions with consent status (for authenticated customers)
+var subsWithStatus = ShopperConsentMgr.getSubscriptions(null, true);
+
+// Update consent for a specific subscription
+ShopperConsentMgr.updateSubscription(
+    'customer@example.com',
+    'newsletter-subscription',
+    'EMAIL',
+    'OPT_IN'
+);
+```
+
+
+**See Also:**
+- [MarketingConsentSubscription](dw.customer.consent.MarketingConsentSubscription.md)
+- [ConsentStatusEntry](dw.customer.consent.ConsentStatusEntry.md)
+
+
+## Property Summary
+
+| Property | Description |
+| --- | --- |
+| [subscriptions](#subscriptions): [Collection](dw.util.Collection.md) `(read-only)` | Retrieves marketing consent subscriptions for the current site. |
+
+## Constructor Summary
+
+This class does not have a constructor, so you cannot create it directly.
+## Method Summary
+
+| Method | Description |
+| --- | --- |
+| static [getSubscriptions](dw.customer.consent.ShopperConsentMgr.md#getsubscriptions)() | Retrieves marketing consent subscriptions for the current site. |
+| static [getSubscriptions](dw.customer.consent.ShopperConsentMgr.md#getsubscriptionslist-boolean)([List](dw.util.List.md), [Boolean](TopLevel.Boolean.md)) | Retrieves marketing consent subscriptions for the current site with optional filtering and status. |
+| static [updateSubscription](dw.customer.consent.ShopperConsentMgr.md#updatesubscriptionstring-string-string-string)([String](TopLevel.String.md), [String](TopLevel.String.md), [String](TopLevel.String.md), [String](TopLevel.String.md)) | Updates consent status for a subscription. |
+
+### Methods inherited from class Object
+
+[assign](TopLevel.Object.md#assignobject-object), [create](TopLevel.Object.md#createobject), [create](TopLevel.Object.md#createobject-object), [defineProperties](TopLevel.Object.md#definepropertiesobject-object), [defineProperty](TopLevel.Object.md#definepropertyobject-object-object), [entries](TopLevel.Object.md#entriesobject), [freeze](TopLevel.Object.md#freezeobject), [fromEntries](TopLevel.Object.md#fromentriesiterable), [getOwnPropertyDescriptor](TopLevel.Object.md#getownpropertydescriptorobject-object), [getOwnPropertyNames](TopLevel.Object.md#getownpropertynamesobject), [getOwnPropertySymbols](TopLevel.Object.md#getownpropertysymbolsobject), [getPrototypeOf](TopLevel.Object.md#getprototypeofobject), [hasOwnProperty](TopLevel.Object.md#hasownpropertystring), [is](TopLevel.Object.md#isobject-object), [isExtensible](TopLevel.Object.md#isextensibleobject), [isFrozen](TopLevel.Object.md#isfrozenobject), [isPrototypeOf](TopLevel.Object.md#isprototypeofobject), [isSealed](TopLevel.Object.md#issealedobject), [keys](TopLevel.Object.md#keysobject), [preventExtensions](TopLevel.Object.md#preventextensionsobject), [propertyIsEnumerable](TopLevel.Object.md#propertyisenumerablestring), [seal](TopLevel.Object.md#sealobject), [setPrototypeOf](TopLevel.Object.md#setprototypeofobject-object), [toLocaleString](TopLevel.Object.md#tolocalestring), [toString](TopLevel.Object.md#tostring), [valueOf](TopLevel.Object.md#valueof), [values](TopLevel.Object.md#valuesobject)
+## Property Details
+
+### subscriptions
+- subscriptions: [Collection](dw.util.Collection.md) `(read-only)`
+  - : Retrieves marketing consent subscriptions for the current site.
+      
+      
+      This method returns all available consent subscriptions without consent status information.
+
+
+
+---
+
+## Method Details
+
+### getSubscriptions()
+- static getSubscriptions(): [Collection](dw.util.Collection.md)
+  - : Retrieves marketing consent subscriptions for the current site.
+      
+      
+      This method returns all available consent subscriptions without consent status information.
+
+
+    **Returns:**
+    - A collection of [MarketingConsentSubscription](dw.customer.consent.MarketingConsentSubscription.md) objects.
+
+    **Throws:**
+    - ShopperConsentException - if the consent feature is not enabled or retrieval fails.
+
+
+---
+
+### getSubscriptions(List, Boolean)
+- static getSubscriptions(tags: [List](dw.util.List.md), includeConsentStatus: [Boolean](TopLevel.Boolean.md)): [Collection](dw.util.Collection.md)
+  - : Retrieves marketing consent subscriptions for the current site with optional filtering and status.
+      
+      
+      Use this method to retrieve subscriptions filtered by tags and optionally include
+      the current consent status for authenticated customers.
+
+
+    **Parameters:**
+    - tags - Optional list of tags to filter subscriptions. Pass null for all subscriptions.
+    - includeConsentStatus - If true, includes the current consent status for each subscription.                              Requires a customer context.
+
+    **Returns:**
+    - A collection of [MarketingConsentSubscription](dw.customer.consent.MarketingConsentSubscription.md) objects.
+
+    **Throws:**
+    - ShopperConsentException - if the consent feature is not enabled, retrieval fails,                                  or consent status retrieval fails.
+
+
+---
+
+### updateSubscription(String, String, String, String)
+- static updateSubscription(contactPointValue: [String](TopLevel.String.md), subscriptionId: [String](TopLevel.String.md), channel: [String](TopLevel.String.md), status: [String](TopLevel.String.md)): void
+  - : Updates consent status for a subscription.
+      
+      
+      This method updates the consent status in Salesforce Core for the specified
+      contact point and subscription channel combination.
+
+
+    **Parameters:**
+    - contactPointValue - The contact point value (email address or phone number).
+    - subscriptionId - The subscription ID.
+    - channel - The channel type ("EMAIL", "SMS", or "WHATSAPP").
+    - status - The consent status ("OPT\_IN" or "OPT\_OUT").
+
+    **Throws:**
+    - ShopperConsentException - if the consent feature is not enabled or update fails.
+
+
+---
+
+<!-- prettier-ignore-end -->

package/data/script-api/dw.customer.consent.md

@@ -0,0 +1,10 @@
+# Package dw.customer.consent
+
+## Classes
+| Class | Description |
+| --- | --- |
+| [ConsentStatusEntry](dw.customer.consent.ConsentStatusEntry.md) | Represents the consent status for a specific channel and contact point. |
+| [MarketingConsentSubscription](dw.customer.consent.MarketingConsentSubscription.md) | Represents a marketing consent subscription for a shopper. |
+| [ShopperConsentErrorCodes](dw.customer.consent.ShopperConsentErrorCodes.md) | Error codes for [ShopperConsentException](dw.customer.consent.ShopperConsentException.md). |
+| [ShopperConsentException](dw.customer.consent.ShopperConsentException.md) | This exception is thrown by [ShopperConsentMgr](dw.customer.consent.ShopperConsentMgr.md) methods when an error occurs  during consent subscription operations. |
+| [ShopperConsentMgr](dw.customer.consent.ShopperConsentMgr.md) | Provides static helper methods for managing shopper marketing consent subscriptions. |

package/data/script-api/dw.extensions.payments.SalesforcePaymentsHooks.md

@@ -35,6 +35,7 @@ inside the hooks property:
 "hooks": [
      {"name": "dw.extensions.payments.asyncPaymentSucceeded", "script": "./payments.js"},
      {"name": "dw.extensions.payments.adyenNotification", "script": "./payments.js"},
+     {"name": "dw.extensions.payments.adyenFailureNotification", "script": "./payments.js"},
      {"name": "dw.extensions.payments.sendOrderConfirmationEmail", "script": "./emails.js"}
 ]
 ```
@@ -54,6 +55,7 @@ A hook entry has a 'name' and a 'script' property.
 
 | Constant | Description |
 | --- | --- |
+| [extensionPointAdyenFailureNotification](#extensionpointadyenfailurenotification): [String](TopLevel.String.md) = "dw.extensions.payments.adyenFailureNotification" | The extension point name dw.extensions.payments.adyenFailureNotification. |
 | [extensionPointAdyenNotification](#extensionpointadyennotification): [String](TopLevel.String.md) = "dw.extensions.payments.adyenNotification" | The extension point name dw.extensions.payments.adyenNotification. |
 | [extensionPointAsyncPaymentSucceeded](#extensionpointasyncpaymentsucceeded): [String](TopLevel.String.md) = "dw.extensions.payments.asyncPaymentSucceeded" | The extension point name dw.extensions.payments.asyncPaymentSucceeded. |
 | [extensionPointSendOrderConfirmationEmail](#extensionpointsendorderconfirmationemail): [String](TopLevel.String.md) = "dw.extensions.payments.sendOrderConfirmationEmail" | The extension point name dw.extensions.payments.sendOrderConfirmationEmail. |
@@ -66,6 +68,7 @@ This class does not have a constructor, so you cannot create it directly.
 
 | Method | Description |
 | --- | --- |
+| [adyenFailureNotification](dw.extensions.payments.SalesforcePaymentsHooks.md#adyenfailurenotificationorder)([Order](dw.order.Order.md)) | Called when an Adyen webhook notification with a failed payment is received for the given order. |
 | [adyenNotification](dw.extensions.payments.SalesforcePaymentsHooks.md#adyennotificationorder)([Order](dw.order.Order.md)) | Called when an Adyen webhook notification is received for the given order. |
 | [asyncPaymentSucceeded](dw.extensions.payments.SalesforcePaymentsHooks.md#asyncpaymentsucceededorder)([Order](dw.order.Order.md)) | Called when asynchronous payment succeeded for the given order. |
 | [sendOrderConfirmationEmail](dw.extensions.payments.SalesforcePaymentsHooks.md#sendorderconfirmationemailorder)([Order](dw.order.Order.md)) | Called to send order confirmation email after successful payment processing. |
@@ -76,6 +79,14 @@ This class does not have a constructor, so you cannot create it directly.
 [assign](TopLevel.Object.md#assignobject-object), [create](TopLevel.Object.md#createobject), [create](TopLevel.Object.md#createobject-object), [defineProperties](TopLevel.Object.md#definepropertiesobject-object), [defineProperty](TopLevel.Object.md#definepropertyobject-object-object), [entries](TopLevel.Object.md#entriesobject), [freeze](TopLevel.Object.md#freezeobject), [fromEntries](TopLevel.Object.md#fromentriesiterable), [getOwnPropertyDescriptor](TopLevel.Object.md#getownpropertydescriptorobject-object), [getOwnPropertyNames](TopLevel.Object.md#getownpropertynamesobject), [getOwnPropertySymbols](TopLevel.Object.md#getownpropertysymbolsobject), [getPrototypeOf](TopLevel.Object.md#getprototypeofobject), [hasOwnProperty](TopLevel.Object.md#hasownpropertystring), [is](TopLevel.Object.md#isobject-object), [isExtensible](TopLevel.Object.md#isextensibleobject), [isFrozen](TopLevel.Object.md#isfrozenobject), [isPrototypeOf](TopLevel.Object.md#isprototypeofobject), [isSealed](TopLevel.Object.md#issealedobject), [keys](TopLevel.Object.md#keysobject), [preventExtensions](TopLevel.Object.md#preventextensionsobject), [propertyIsEnumerable](TopLevel.Object.md#propertyisenumerablestring), [seal](TopLevel.Object.md#sealobject), [setPrototypeOf](TopLevel.Object.md#setprototypeofobject-object), [toLocaleString](TopLevel.Object.md#tolocalestring), [toString](TopLevel.Object.md#tostring), [valueOf](TopLevel.Object.md#valueof), [values](TopLevel.Object.md#valuesobject)
 ## Constant Details
 
+### extensionPointAdyenFailureNotification
+
+- extensionPointAdyenFailureNotification: [String](TopLevel.String.md) = "dw.extensions.payments.adyenFailureNotification"
+  - : The extension point name dw.extensions.payments.adyenFailureNotification.
+
+
+---
+
 ### extensionPointAdyenNotification
 
 - extensionPointAdyenNotification: [String](TopLevel.String.md) = "dw.extensions.payments.adyenNotification"
@@ -110,6 +121,19 @@ This class does not have a constructor, so you cannot create it directly.
 
 ## Method Details
 
+### adyenFailureNotification(Order)
+- adyenFailureNotification(order: [Order](dw.order.Order.md)): [Status](dw.system.Status.md)
+  - : Called when an Adyen webhook notification with a failed payment is received for the given order.
+
+    **Parameters:**
+    - order - the order for which the failure notification was received
+
+    **Returns:**
+    - a non-null result ends the hook execution, and is ignored
+
+
+---
+
 ### adyenNotification(Order)
 - adyenNotification(order: [Order](dw.order.Order.md)): [Status](dw.system.Status.md)
   - : Called when an Adyen webhook notification is received for the given order.

package/data/script-api/dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md

@@ -23,6 +23,10 @@ whether the site is activated with Express Checkout, Multi-Step Checkout or both
 | --- | --- |
 | [cardCaptureAutomatic](#cardcaptureautomatic): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if the capture method is set to automatic for credit card Payment Intents created for this site, or  false if the capture method is set to manual. |
 | [expressCheckoutEnabled](#expresscheckoutenabled): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if Express Checkout is enabled for the site. |
+| [expressOnCartEnabled](#expressoncartenabled): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if Express Checkout is enabled on the Cart page. |
+| [expressOnCheckoutEnabled](#expressoncheckoutenabled): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if Express Checkout is enabled on the Checkout page. |
+| [expressOnMiniCartEnabled](#expressonminicartenabled): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if Express Checkout is enabled on the Mini-Cart. |
+| [expressOnPdpEnabled](#expressonpdpenabled): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if Express Checkout is enabled on the Product Detail Page. |
 | [futureUsageOffSession](#futureusageoffsession): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if the payment card credential storage is configured to set up all applicable payments for off  session reuse, or false if the credential storage is configured to set up for on session reuse only the payments  for which the shopper actively confirms use of saved credentials. |
 | [multiStepCheckoutEnabled](#multistepcheckoutenabled): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if Multi-Step Checkout is enabled for the site. |
 
@@ -35,6 +39,10 @@ This class does not have a constructor, so you cannot create it directly.
 | --- | --- |
 | [isCardCaptureAutomatic](dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md#iscardcaptureautomatic)() | Returns true if the capture method is set to automatic for credit card Payment Intents created for this site, or  false if the capture method is set to manual. |
 | [isExpressCheckoutEnabled](dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md#isexpresscheckoutenabled)() | Returns true if Express Checkout is enabled for the site. |
+| [isExpressOnCartEnabled](dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md#isexpressoncartenabled)() | Returns true if Express Checkout is enabled on the Cart page. |
+| [isExpressOnCheckoutEnabled](dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md#isexpressoncheckoutenabled)() | Returns true if Express Checkout is enabled on the Checkout page. |
+| [isExpressOnMiniCartEnabled](dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md#isexpressonminicartenabled)() | Returns true if Express Checkout is enabled on the Mini-Cart. |
+| [isExpressOnPdpEnabled](dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md#isexpressonpdpenabled)() | Returns true if Express Checkout is enabled on the Product Detail Page. |
 | [isFutureUsageOffSession](dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md#isfutureusageoffsession)() | Returns true if the payment card credential storage is configured to set up all applicable payments for off  session reuse, or false if the credential storage is configured to set up for on session reuse only the payments  for which the shopper actively confirms use of saved credentials. |
 | [isMultiStepCheckoutEnabled](dw.extensions.payments.SalesforcePaymentsSiteConfiguration.md#ismultistepcheckoutenabled)() | Returns true if Multi-Step Checkout is enabled for the site. |
 
@@ -57,6 +65,34 @@ This class does not have a constructor, so you cannot create it directly.
   - : Returns true if Express Checkout is enabled for the site.
 
 
+---
+
+### expressOnCartEnabled
+- expressOnCartEnabled: [Boolean](TopLevel.Boolean.md) `(read-only)`
+  - : Returns true if Express Checkout is enabled on the Cart page.
+
+
+---
+
+### expressOnCheckoutEnabled
+- expressOnCheckoutEnabled: [Boolean](TopLevel.Boolean.md) `(read-only)`
+  - : Returns true if Express Checkout is enabled on the Checkout page.
+
+
+---
+
+### expressOnMiniCartEnabled
+- expressOnMiniCartEnabled: [Boolean](TopLevel.Boolean.md) `(read-only)`
+  - : Returns true if Express Checkout is enabled on the Mini-Cart.
+
+
+---
+
+### expressOnPdpEnabled
+- expressOnPdpEnabled: [Boolean](TopLevel.Boolean.md) `(read-only)`
+  - : Returns true if Express Checkout is enabled on the Product Detail Page.
+
+
 ---
 
 ### futureUsageOffSession
@@ -98,6 +134,46 @@ This class does not have a constructor, so you cannot create it directly.
     - true if Express Checkout is enabled for the site, or false if not
 
 
+---
+
+### isExpressOnCartEnabled()
+- isExpressOnCartEnabled(): [Boolean](TopLevel.Boolean.md)
+  - : Returns true if Express Checkout is enabled on the Cart page.
+
+    **Returns:**
+    - true if Express Checkout is enabled on Cart, or false if not
+
+
+---
+
+### isExpressOnCheckoutEnabled()
+- isExpressOnCheckoutEnabled(): [Boolean](TopLevel.Boolean.md)
+  - : Returns true if Express Checkout is enabled on the Checkout page.
+
+    **Returns:**
+    - true if Express Checkout is enabled on Checkout, or false if not
+
+
+---
+
+### isExpressOnMiniCartEnabled()
+- isExpressOnMiniCartEnabled(): [Boolean](TopLevel.Boolean.md)
+  - : Returns true if Express Checkout is enabled on the Mini-Cart.
+
+    **Returns:**
+    - true if Express Checkout is enabled on Mini-Cart, or false if not
+
+
+---
+
+### isExpressOnPdpEnabled()
+- isExpressOnPdpEnabled(): [Boolean](TopLevel.Boolean.md)
+  - : Returns true if Express Checkout is enabled on the Product Detail Page.
+
+    **Returns:**
+    - true if Express Checkout is enabled on PDP, or false if not
+
+
 ---
 
 ### isFutureUsageOffSession()

package/data/script-api/dw.object.CustomAttributes.md

@@ -4,23 +4,16 @@
 - [TopLevel.Object](TopLevel.Object.md)
   - [dw.object.CustomAttributes](dw.object.CustomAttributes.md)
 
-This class is used together with other classes that contain custom attributes
-and is used to read and write these attributes. The actual attributes are
-accessible as ECMA properties. The syntax for setting and retrieving the
-value of a custom attribute depends upon the type of the attribute. If the
-wrong syntax is used to set an individual attribute than an exception will be
-thrown.
+This class is used together with other classes that contain custom attributes and is used to read and write these
+attributes. The actual attributes are accessible as ECMA properties. The syntax for setting and retrieving the value
+of a custom attribute depends upon the type of the attribute. An exception will be thrown, if the wrong syntax is
+used to set an individual attribute.
 
 
-
-
-The following script examples demonstrate how to work with custom attributes.
-Suppose we have an ExtensibleObject named "eo" possessing attributes of all
-the different types supported by the Commerce Cloud Digital metadata system. The
-following script snippet shows that setting single-valued attributes is
-simply a matter of using the assignment operator and standard ECMA primitives
-and built-in types:
-
+The following script examples demonstrate how to work with custom attributes. Suppose we have an ExtensibleObject
+named "eo" possessing attributes of all the different types supported by the Commerce Cloud Digital metadata system.
+The following script snippet shows that setting single-valued attributes is simply a matter of using the assignment
+operator and standard ECMA primitives and built-in types:
 
 
 
@@ -57,21 +50,73 @@ var date : Date = eo.custom.dtvalue;
 
 
 
+**Retrieving multi-value attributes and working with Java-backed arrays**
 
+Multi-value attributes return Java-backed arrays, which contain copies of the internal data. In contrast to native
+JavaScript arrays, a Java-backed array behaves differently in the following ways:
 
-Setting and retrieving the values for multi-value attributes is also
-straightforward and uses ECMA arrays to represent the multiple values. Set-of
-attributes and enum-of attributes are handled in a very similar manner. The
-chief difference is that enum-of attributes are limited to a prescribed set
-of value definitions whereas set-of attributes are open-ended. Furthermore,
-each value in an enum-of attribute has a value and a display name which
-affects the retrieval logic.
+- `Array.isArray( javaBackedArray )`will return `false`. If you want to do something based  on the value type, use `javaBackedArray instanceof Array`instead.
+- Adding to or removing elements from a Java-backed array is not supported. You need to create a new native  JavaScript array based on the Java-backed array, e.g. with `Array.from( javaBackedArray )`and do the  modifications there.
 
-Multi-value attributes are returned as an array. This array is read-only and
-can't be used to update the multi-value attribute. To update the multi-value
-attribute an array with new values must be assigned to the attribute.
 
 
+```
+var setofstring : Array = eo.custom.setofstringvalue;
+if( Array.isArray( setofstring ) ) // returns false
+{
+  // this will never be reached, since setofstring is a Java-backed array and not a native JavaScript array
+}
+if( setofstring instanceof Array ) // returns true
+{
+  // this will be reached, since setofstring is a Java-backed array
+}
+```
+
+
+
+**Updating multi-value attributes**
+
+Retrieved data from a multi-value attribute returns a Java-backed array, which contains a copy of the internal data,
+so changes made to the Java-backed array do not affect the multi-value attribute. To update the multi-value attribute
+(e.g. adding a new element), it needs to be reassigned.
+
+
+```
+// retrieve a Java-backed array and convert it to a native JavaScript array
+var setofstring : Array = eo.custom.setofstringvalue;
+var newValue = Array.from( setofstring );
+
+// add new element
+newValue.append( "new element" );
+
+// reassign the new array to the multi-value attribute to persist the change
+eo.custom.setofstringvalue = newValue;
+```
+
+
+If you only want to change individual elements without appending or removing elements from the Java-backed array, you
+may even modify it directly.
+
+
+```
+// retrieve a Java-backed array
+var setofstring : Array = eo.custom.setofstringvalue;
+
+// change individual element
+setofstring[0] = "updated element";
+
+// reassign the array to the multi-value attribute to persist the change
+eo.custom.setofstringvalue = setofstring;
+```
+
+
+
+**Set-of attributes and enum-of attributes**
+
+Set-of attributes and enum-of attributes are handled in a very similar manner. The chief difference is that enum-of
+attributes are limited to a prescribed set of value definitions whereas set-of attributes are open-ended.
+Furthermore, each value in an enum-of attribute has a value and a display name which affects the retrieval logic.
+
 
 
 
@@ -104,10 +149,8 @@ var displayvalue3 : String = enumofintmulti[2].getDisplayValue();
 
 
 
-
-
-For further details on the Commerce Cloud Digital attribute system, see the core
-Commerce Cloud Digital documentation.
+For further details on the Commerce Cloud Digital attribute system, see the core Commerce Cloud Digital
+documentation.
 
 
 

package/data/script-api/dw.object.md

@@ -4,7 +4,7 @@
 | Class | Description |
 | --- | --- |
 | [ActiveData](dw.object.ActiveData.md) | Represents the active data for an object in Commerce Cloud Digital. |
-| [CustomAttributes](dw.object.CustomAttributes.md) | This class is used together with other classes that contain custom attributes  and is used to read and write these attributes. |
+| [CustomAttributes](dw.object.CustomAttributes.md) | This class is used together with other classes that contain custom attributes and is used to read and write these  attributes. |
 | [CustomObject](dw.object.CustomObject.md) | Represents a custom object and its corresponding attributes. |
 | [CustomObjectMgr](dw.object.CustomObjectMgr.md) | Manager class which provides methods for creating, retrieving, deleting,  and searching for custom objects. |
 | [Extensible](dw.object.Extensible.md) | Base class alternative to ExtensibleObject for objects customizable through the metadata system. |

package/data/script-api/dw.order.Basket.md

@@ -794,8 +794,9 @@ This class does not have a constructor, so you cannot create it directly.
       [LineItemCtnr.CHANNEL_TYPE_INSTAGRAMCOMMERCE](dw.order.LineItemCtnr.md#channel_type_instagramcommerce), [LineItemCtnr.CHANNEL_TYPE_GOOGLE](dw.order.LineItemCtnr.md#channel_type_google),
       [LineItemCtnr.CHANNEL_TYPE_YOUTUBE](dw.order.LineItemCtnr.md#channel_type_youtube), [LineItemCtnr.CHANNEL_TYPE_TIKTOK](dw.order.LineItemCtnr.md#channel_type_tiktok),
       [LineItemCtnr.CHANNEL_TYPE_SNAPCHAT](dw.order.LineItemCtnr.md#channel_type_snapchat), [LineItemCtnr.CHANNEL_TYPE_WHATSAPP](dw.order.LineItemCtnr.md#channel_type_whatsapp) The
-      value for [LineItemCtnr.CHANNEL_TYPE_CUSTOMERSERVICECENTER](dw.order.LineItemCtnr.md#channel_type_customerservicecenter) is also available, but it can not be
-      set by the scripting API, it is set only internally.
+      value for [LineItemCtnr.CHANNEL_TYPE_CUSTOMERSERVICECENTER](dw.order.LineItemCtnr.md#channel_type_customerservicecenter) and
+      [LineItemCtnr.CHANNEL_TYPE_CHATGPT](dw.order.LineItemCtnr.md#channel_type_chatgpt) and [LineItemCtnr.CHANNEL_TYPE_GEMINI](dw.order.LineItemCtnr.md#channel_type_gemini) are also
+      available, but it can not be set by the scripting API, it is set only internally.
 
 
     **Parameters:**

package/data/script-api/dw.order.GiftCertificateLineItem.md

@@ -49,7 +49,7 @@ This class does not have a constructor, so you cannot create it directly.
 
 ### Methods inherited from class LineItem
 
-[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
+[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [getTaxes](dw.order.LineItem.md#gettaxes), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [setTaxes](dw.order.LineItem.md#settaxescollection), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
 ### Methods inherited from class ExtensibleObject
 
 [describe](dw.object.ExtensibleObject.md#describe), [getCustom](dw.object.ExtensibleObject.md#getcustom)