commerce-sdk-isomorphic 4.0.0-unstable-20251203080747 → 4.0.0-unstable-20251205080739

package/lib/index.cjs.d.ts

@@ -41798,6 +41798,56 @@ type Status$2 = {
 } & {
     [key: string]: any;
 };
+/**
+ * @type OrderPaymentInstrumentPaymentReferenceGatewayProperties: The payment gateway specific properties.
+ *
+ * @property stripe: Stripe specific properties.
+ *
+ * @property adyen: Ayden specific properties.
+ *
+ * @property paypal: PayPal specific properties.
+ *
+ */
+type OrderPaymentInstrumentPaymentReferenceGatewayProperties = {
+    stripe?: {
+        [key: string]: any;
+    };
+    adyen?: {
+        [key: string]: any;
+    };
+    paypal?: {
+        [key: string]: any;
+    };
+} & {
+    [key: string]: any;
+};
+/**
+ * @type OrderPaymentInstrumentPaymentReference: Payment reference information for various payment service providers, only when Salesforce Payments is enabled.
+ *
+ * @property paymentReferenceId: Payment reference identifier. Can be payment intent ID for Stripe, PSP reference for Adyen, PayPal order ID for PayPal, or similar identifier for other payment providers.
+ * - **Max Length:** 256
+ *
+ * @property clientSecret: Client secret for payment confirmation. Used primarily by Stripe for client-side payment confirmation.
+ * - **Max Length:** 256
+ *
+ * @property redirectUrl: Redirect URL for payment methods that require user redirection to complete payment.
+ * - **Max Length:** 2048
+ *
+ * @property gateway: The payment gateway used to process the payment.
+ *
+ * @property gatewayProperties:
+ *
+ */
+type OrderPaymentInstrumentPaymentReference = {
+    paymentReferenceId?: string;
+    clientSecret?: string;
+    redirectUrl?: string;
+    gateway?: OrderPaymentInstrumentPaymentReferenceGatewayEnum;
+    gatewayProperties?: OrderPaymentInstrumentPaymentReferenceGatewayProperties;
+} & {
+    [key: string]: any;
+};
+type OrderPaymentInstrumentPaymentReferenceGatewayEnum = "stripe" | "paypal" | "adyen";
 /**
  * @type PaymentCard: Document representing a payment card.
  *
@@ -41863,6 +41913,8 @@ type PaymentCard$2 = {
  * @property paymentMethodId: The payment method ID. It is read only.
  * - **Max Length:** 256
  *
+ * @property paymentReference:
+ *
  */
 type OrderPaymentInstrument$2 = {
     amount?: number;
@@ -41872,6 +41924,7 @@ type OrderPaymentInstrument$2 = {
     paymentCard?: PaymentCard$2;
     paymentInstrumentId?: string;
     paymentMethodId?: string;
+    paymentReference?: OrderPaymentInstrumentPaymentReference;
 } & {
     [key: string]: any;
 };
@@ -42411,6 +42464,21 @@ type OptionItem$2 = {
 } & {
     [key: string]: any;
 };
+/**
+ * @type SomInfo: Additional information retrieved from Salesforce Order Management (SOM)  See https://developer.salesforce.com/docs/atlas.en-us.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_orderitemsummary.htm for more information.
+ *
+ * @property status: Salesforce Order Management (SOM) status
+ *
+ * @property quantityAvailableToCancel: The quantity that can be cancelled.
+ *
+ */
+type SomInfo = {
+    status?: SomInfoStatusEnum;
+    quantityAvailableToCancel?: number;
+} & {
+    [key: string]: any;
+};
+type SomInfoStatusEnum = "ordered" | "returned" | "canceled" | "paid" | "reshipped" | "fulfilled" | "partially_fulfilled" | "allocated" | "partially_allocated" | "return_initiated";
 /**
  * @type ProductItem: Document representing a product item.
  *
@@ -42461,6 +42529,8 @@ type OptionItem$2 = {
  *
  * @property shippingItemId: If the product line item has a related shipping item, this value is its ID. A related shipping item represents a surcharge applied to individual products using a particular shipping method. It is read only.
  *
+ * @property somInfo:
+ *
  * @property tax: The tax for the product item, not including price adjustments. It is read only.
  *
  * @property taxBasis: The price used to calculate the tax for this product item. It is read only.
@@ -42493,6 +42563,7 @@ type ProductItem$2 = {
     quantity?: number;
     shipmentId?: string;
     shippingItemId?: string;
+    somInfo?: SomInfo;
     tax?: number;
     taxBasis?: number;
     taxClassId?: string;
@@ -42607,11 +42678,86 @@ type BasketTaxationEnum$2 = "gross" | "net";
  * A specialized value indicating the system default values for locales.
  */
 type DefaultFallback$3 = "default";
+/**
+ * @type FailOrderRequest: Document representing a fail order request.
+ *
+ * @property reasonCode: The reason code for failing the order.
+ *
+ */
+type FailOrderRequest = {
+    reasonCode?: FailOrderRequestReasonCodeEnum;
+} & {
+    [key: string]: any;
+};
+type FailOrderRequestReasonCodeEnum = "payment_confirm_failure" | "payment_capture_failure" | "payment_auth_failure";
 /**
  * @type LocaleCode
  * A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
  */
 type LocaleCode$4 = DefaultFallback$3 | string;
+/**
+ * @type ShipmentItem: Individual item within a shipment
+ *
+ * @property id: Unique identifier for the shipment item
+ *
+ * @property productItemId: Reference to the product item in the order
+ *
+ * @property quantity: Quantity of product items with the referenced productItemId in this shipment
+ *
+ */
+type ShipmentItem = {
+    id?: string;
+    productItemId?: string;
+    quantity?: number;
+} & {
+    [key: string]: any;
+};
+/**
+ * @type SchemasShipment: Shipment information from Salesforce Order Management created during fulfillment process. See https://developer.salesforce.com/docs/atlas.en-us.230.0.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_fulfillmentorder.htm for more information.
+ *
+ * @property id: Unique identifier for the shipment
+ *
+ * @property status: Current status of the shipment
+ *
+ * @property provider: Shipping provider name
+ *
+ * @property trackingNumber: Tracking number for the shipment
+ *
+ * @property trackingUrl: URL to track the shipment
+ *
+ * @property expectedDeliveryDate: Expected delivery date and time
+ *
+ * @property actualDeliveryDate: Actual delivery date and time (null if not yet delivered)
+ *
+ * @property shipmentItems: Items included in this shipment
+ *
+ */
+type SchemasShipment = {
+    id?: string;
+    status?: string;
+    provider?: string;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    expectedDeliveryDate?: string;
+    actualDeliveryDate?: string;
+    shipmentItems?: Array<ShipmentItem>;
+} & {
+    [key: string]: any;
+};
+/**
+ * @type SchemasSomInfo: Additional information retrieved from Salesforce Order Management (SOM)  See https://developer.salesforce.com/docs/atlas.en-us.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_ordersummary.htm for more information.
+ *
+ * @property status: Current status of the order
+ *
+ * @property shipments: List of shipments associated with the order
+ *
+ */
+type SchemasSomInfo = {
+    status?: string;
+    shipments?: Array<SchemasShipment>;
+} & {
+    [key: string]: any;
+};
 /**
  * @type Order: Document representing an order.
  *
@@ -42689,6 +42835,8 @@ type LocaleCode$4 = DefaultFallback$3 | string;
  * - **Min Length:** 1
  * - **Max Length:** 32
  *
+ * @property somInfo:
+ *
  * @property sourceCode: The source code assigned to the basket from which this order was created. It is read only.
  *
  * @property status: The status.
@@ -42738,6 +42886,7 @@ type Order$0 = {
     shippingTotal?: number;
     shippingTotalTax?: number;
     siteId?: string;
+    somInfo?: SchemasSomInfo;
     sourceCode?: string;
     status?: OrderStatusEnum;
     taxTotal?: number;
@@ -42809,21 +42958,35 @@ type OrderPaymentCardRequest$1 = {
     [key: string]: any;
 };
 /**
- * @type SalesforcePaymentsRequest: Document representing a Salesforce Payments request.
+ * @type PaymentReferenceRequest: Properties for Payments Reference Request
  *
- * @property paymentMethodType: The payment method type (for example: Visa).
- * - **Max Length:** 100
+ * @property paymentMethodType: Payment Method Type
+ * - **Max Length:** 64
  *
- * @property zoneId: The zone ID.
+ * @property zoneId: The unique identifier for a Payments zone.
+ * - **Pattern:** /^[a-zA-Z0-9\\-_]{1,100}$/
+ * - **Min Length:** 1
  * - **Max Length:** 100
  *
+ * @property shippingPreference: Shipping preference for PayPal payment processing. Applicable only for basket payment instruments.
+ * - **Max Length:** 64
+ *
+ * @property gateway: The payment gateway used to process the payment.
+ *
+ * @property gatewayProperties:
+ *
  */
-type SalesforcePaymentsRequest$0 = {
+type PaymentReferenceRequest = {
     paymentMethodType?: string;
     zoneId?: string;
+    shippingPreference?: PaymentReferenceRequestShippingPreferenceEnum;
+    gateway?: PaymentReferenceRequestGatewayEnum;
+    gatewayProperties?: OrderPaymentInstrumentPaymentReferenceGatewayProperties;
 } & {
     [key: string]: any;
 };
+type PaymentReferenceRequestShippingPreferenceEnum = "GET_FROM_FILE" | "NO_SHIPPING" | "SET_PROVIDED_ADDRESS";
+type PaymentReferenceRequestGatewayEnum = "stripe" | "paypal" | "adyen";
 /**
  * @type OrderPaymentInstrumentRequest: Document representing an order payment instrument request.
  *
@@ -42840,7 +43003,7 @@ type SalesforcePaymentsRequest$0 = {
  * @property paymentMethodId: The payment method ID.
  * - **Max Length:** 256
  *
- * @property paymentReferenceRequest: The payment reference request used by Salesforce Payments.
+ * @property paymentReferenceRequest: Payment reference information for various payment service providers, only when Salesforce Payments is enabled.
  *
  */
 type OrderPaymentInstrumentRequest = {
@@ -42849,7 +43012,7 @@ type OrderPaymentInstrumentRequest = {
     giftCertificateCode?: string;
     paymentCard?: OrderPaymentCardRequest$1;
     paymentMethodId?: string;
-    paymentReferenceRequest?: SalesforcePaymentsRequest$0;
+    paymentReferenceRequest?: PaymentReferenceRequest;
 } & {
     [key: string]: any;
 };
@@ -42964,6 +43127,7 @@ type Taxes$1 = {
 } & {
     [key: string]: any;
 };
+type GetOrderExpandEnum = "som" | "som_shipments";
 type createOrderQueryParameters = {
     siteId: string;
     locale?: LocaleCode$4;
@@ -42979,9 +43143,19 @@ type createPaymentInstrumentForOrderPathParameters = {
     organizationId: string;
     orderNo: string;
 };
+type failOrderQueryParameters = {
+    siteId: string;
+    locale?: LocaleCode$4;
+    reopenBasket?: boolean;
+};
+type failOrderPathParameters = {
+    organizationId: string;
+    orderNo: string;
+};
 type getOrderQueryParameters = {
     siteId: string;
     locale?: LocaleCode$4;
+    expand?: Array<"som" | "som_shipments">;
 };
 type getOrderPathParameters = {
     orderNo: string;
@@ -43031,11 +43205,11 @@ type updatePaymentInstrumentForOrderPathParameters = {
 /**
  * All path parameters that are used by at least one ShopperOrders method.
  */
-type ShopperOrdersPathParameters = Partial<createOrderPathParameters & createPaymentInstrumentForOrderPathParameters & getOrderPathParameters & getPaymentMethodsForOrderPathParameters & getTaxesFromOrderPathParameters & guestOrderLookupPathParameters & removePaymentInstrumentFromOrderPathParameters & updatePaymentInstrumentForOrderPathParameters & {}>;
+type ShopperOrdersPathParameters = Partial<createOrderPathParameters & createPaymentInstrumentForOrderPathParameters & failOrderPathParameters & getOrderPathParameters & getPaymentMethodsForOrderPathParameters & getTaxesFromOrderPathParameters & guestOrderLookupPathParameters & removePaymentInstrumentFromOrderPathParameters & updatePaymentInstrumentForOrderPathParameters & {}>;
 /**
  * All query parameters that are used by at least one ShopperOrders method.
  */
-type ShopperOrdersQueryParameters = Partial<createOrderQueryParameters & createPaymentInstrumentForOrderQueryParameters & getOrderQueryParameters & getPaymentMethodsForOrderQueryParameters & getTaxesFromOrderQueryParameters & guestOrderLookupQueryParameters & removePaymentInstrumentFromOrderQueryParameters & updatePaymentInstrumentForOrderQueryParameters & {}>;
+type ShopperOrdersQueryParameters = Partial<createOrderQueryParameters & createPaymentInstrumentForOrderQueryParameters & failOrderQueryParameters & getOrderQueryParameters & getPaymentMethodsForOrderQueryParameters & getTaxesFromOrderQueryParameters & guestOrderLookupQueryParameters & removePaymentInstrumentFromOrderQueryParameters & updatePaymentInstrumentForOrderQueryParameters & {}>;
 /**
  * All parameters that are used by ShopperOrders.
  */
@@ -43044,7 +43218,9 @@ type ShopperOrdersParameters = ShopperOrdersPathParameters & BaseUriParameters &
  * [Shopper Orders](https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-orders:Summary)
  * ==================================
  *
- * *# API Overview
+ * *[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/shopper-orders/shopper-orders-oas-v1-public.yaml)
+ 
+ # API Overview
  
  The Shopper Orders API enables you to:
  
@@ -43107,6 +43283,7 @@ declare class ShopperOrders<ConfigParameters extends ShopperOrdersParameters & R
     static readonly apiPaths: {
         createOrder: string;
         createPaymentInstrumentForOrder: string;
+        failOrder: string;
         getOrder: string;
         getPaymentMethodsForOrder: string;
         getTaxesFromOrder: string;
@@ -43136,11 +43313,24 @@ declare class ShopperOrders<ConfigParameters extends ShopperOrdersParameters & R
             "orderNo",
             "siteId"
         ];
+        readonly failOrder: readonly [
+            "organizationId",
+            "orderNo",
+            "siteId",
+            "locale",
+            "reopenBasket"
+        ];
+        readonly failOrderRequired: readonly [
+            "organizationId",
+            "orderNo",
+            "siteId"
+        ];
         readonly getOrder: readonly [
             "orderNo",
             "organizationId",
             "siteId",
-            "locale"
+            "locale",
+            "expand"
         ];
         readonly getOrderRequired: readonly [
             "orderNo",
@@ -43322,6 +43512,71 @@ declare class ShopperOrders<ConfigParameters extends ShopperOrdersParameters & R
         };
         body: OrderPaymentInstrumentRequest & CustomRequestBody;
     }>, rawResponse?: T): Promise<T extends true ? Response : Order$0>;
+    /**
+     * Fails an unplaced order and optionally reopens the basket when indicated.
+     Creates a HistoryEntry in the failed Order with provided reasonCode.
+     *
+     * If you would like to get a raw Response object use the other failOrder function.
+     *
+     * @param options - An object containing the options for this method.
+     * @param options.parameters - An object containing the parameters for this method.
+     * @param options.parameters.organizationId - An identifier for the organization the request is being made by
+     * @param options.parameters.orderNo - The order number of the order to be modified.
+     * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
+     * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+     * @param options.parameters.reopenBasket - Set to true to reopen basket from the order.
+     A basket can only be reopened if no other basket for the customer exists at the moment of the call to fail Order,
+     since a customer is limited to 1 storefront basket at a time.
+     * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
+     * @param options.body - The data to send as the request body.
+     *
+     * @returns A promise of type void.
+     */
+    failOrder(options: RequireParametersUnlessAllAreOptional<{
+        parameters?: CompositeParameters<{
+            organizationId: string;
+            orderNo: string;
+            siteId: string;
+            locale?: LocaleCode$4;
+            reopenBasket?: boolean;
+        } & QueryParameters, ConfigParameters>;
+        headers?: {
+            [key: string]: string;
+        };
+        body: FailOrderRequest & CustomRequestBody;
+    }>): Promise<void>;
+    /**
+     * Fails an unplaced order and optionally reopens the basket when indicated.
+     Creates a HistoryEntry in the failed Order with provided reasonCode.
+     *
+     * @param options - An object containing the options for this method.
+     * @param options.parameters - An object containing the parameters for this method.
+     * @param options.parameters.organizationId - An identifier for the organization the request is being made by
+     * @param options.parameters.orderNo - The order number of the order to be modified.
+     * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
+     * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+     * @param options.parameters.reopenBasket - Set to true to reopen basket from the order.
+     A basket can only be reopened if no other basket for the customer exists at the moment of the call to fail Order,
+     since a customer is limited to 1 storefront basket at a time.
+     * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
+     * @param options.body - The data to send as the request body.
+     * @param rawResponse - Set to true to return entire Response object instead of DTO.
+     *
+     * @returns A promise of type Response if rawResponse is true, a promise of type void otherwise.
+     */
+    failOrder<T extends boolean>(options: RequireParametersUnlessAllAreOptional<{
+        parameters?: CompositeParameters<{
+            organizationId: string;
+            orderNo: string;
+            siteId: string;
+            locale?: LocaleCode$4;
+            reopenBasket?: boolean;
+        } & QueryParameters, ConfigParameters>;
+        headers?: {
+            [key: string]: string;
+        };
+        body: FailOrderRequest & CustomRequestBody;
+    }>, rawResponse?: T): Promise<T extends true ? Response : void>;
     /**
      * Gets information for an order.
      *
@@ -43333,6 +43588,12 @@ declare class ShopperOrders<ConfigParameters extends ShopperOrdersParameters & R
      * @param options.parameters.organizationId - An identifier for the organization the request is being made by
      * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
      * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+     * @param options.parameters.expand - When a 'som' expand is selected, data is primarily loaded from Salesforce Order Management (SOM), if available.
+     When data is available in SOM, the expand parameter has the following behavior:
+     "expand=som": order and related order entities (product items, delivery group, etc) are returned.
+     "expand=som_shipments": order and fulfillment (shipment) data is returned.
+     "expand=som,som_shipments": order, related order entities and fulfillment (shipment) data is returned
+     If your instance is not integrated with SOM or the order data is not available, the `expand=som` command is disregarded.
      * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
      *
      * @returns A promise of type Order.
@@ -43343,6 +43604,7 @@ declare class ShopperOrders<ConfigParameters extends ShopperOrdersParameters & R
             organizationId: string;
             siteId: string;
             locale?: LocaleCode$4;
+            expand?: Array<GetOrderExpandEnum>;
         } & QueryParameters, ConfigParameters>;
         headers?: {
             [key: string]: string;
@@ -43357,6 +43619,12 @@ declare class ShopperOrders<ConfigParameters extends ShopperOrdersParameters & R
      * @param options.parameters.organizationId - An identifier for the organization the request is being made by
      * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
      * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+     * @param options.parameters.expand - When a 'som' expand is selected, data is primarily loaded from Salesforce Order Management (SOM), if available.
+     When data is available in SOM, the expand parameter has the following behavior:
+     "expand=som": order and related order entities (product items, delivery group, etc) are returned.
+     "expand=som_shipments": order and fulfillment (shipment) data is returned.
+     "expand=som,som_shipments": order, related order entities and fulfillment (shipment) data is returned
+     If your instance is not integrated with SOM or the order data is not available, the `expand=som` command is disregarded.
      * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
      * @param rawResponse - Set to true to return entire Response object instead of DTO.
      *
@@ -43368,6 +43636,7 @@ declare class ShopperOrders<ConfigParameters extends ShopperOrdersParameters & R
             organizationId: string;
             siteId: string;
             locale?: LocaleCode$4;
+            expand?: Array<GetOrderExpandEnum>;
         } & QueryParameters, ConfigParameters>;
         headers?: {
             [key: string]: string;
@@ -43842,6 +44111,56 @@ declare namespace ShopperOrdersApiTypes {
     } & {
         [key: string]: any;
     };
+    /**
+     * @type OrderPaymentInstrumentPaymentReferenceGatewayProperties: The payment gateway specific properties.
+     *
+     * @property stripe: Stripe specific properties.
+     *
+     * @property adyen: Ayden specific properties.
+     *
+     * @property paypal: PayPal specific properties.
+     *
+     */
+    type OrderPaymentInstrumentPaymentReferenceGatewayProperties = {
+        stripe?: {
+            [key: string]: any;
+        };
+        adyen?: {
+            [key: string]: any;
+        };
+        paypal?: {
+            [key: string]: any;
+        };
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type OrderPaymentInstrumentPaymentReference: Payment reference information for various payment service providers, only when Salesforce Payments is enabled.
+     *
+     * @property paymentReferenceId: Payment reference identifier. Can be payment intent ID for Stripe, PSP reference for Adyen, PayPal order ID for PayPal, or similar identifier for other payment providers.
+     * - **Max Length:** 256
+     *
+     * @property clientSecret: Client secret for payment confirmation. Used primarily by Stripe for client-side payment confirmation.
+     * - **Max Length:** 256
+     *
+     * @property redirectUrl: Redirect URL for payment methods that require user redirection to complete payment.
+     * - **Max Length:** 2048
+     *
+     * @property gateway: The payment gateway used to process the payment.
+     *
+     * @property gatewayProperties:
+     *
+     */
+    type OrderPaymentInstrumentPaymentReference = {
+        paymentReferenceId?: string;
+        clientSecret?: string;
+        redirectUrl?: string;
+        gateway?: OrderPaymentInstrumentPaymentReferenceGatewayEnum;
+        gatewayProperties?: OrderPaymentInstrumentPaymentReferenceGatewayProperties;
+    } & {
+        [key: string]: any;
+    };
+    type OrderPaymentInstrumentPaymentReferenceGatewayEnum = "stripe" | "paypal" | "adyen";
     /**
      * @type PaymentCard: Document representing a payment card.
      *
@@ -43907,6 +44226,8 @@ declare namespace ShopperOrdersApiTypes {
      * @property paymentMethodId: The payment method ID. It is read only.
      * - **Max Length:** 256
      *
+     * @property paymentReference:
+     *
      */
     type OrderPaymentInstrument = {
         amount?: number;
@@ -43916,6 +44237,7 @@ declare namespace ShopperOrdersApiTypes {
         paymentCard?: PaymentCard;
         paymentInstrumentId?: string;
         paymentMethodId?: string;
+        paymentReference?: OrderPaymentInstrumentPaymentReference;
     } & {
         [key: string]: any;
     };
@@ -44455,6 +44777,21 @@ declare namespace ShopperOrdersApiTypes {
     } & {
         [key: string]: any;
     };
+    /**
+     * @type SomInfo: Additional information retrieved from Salesforce Order Management (SOM)  See https://developer.salesforce.com/docs/atlas.en-us.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_orderitemsummary.htm for more information.
+     *
+     * @property status: Salesforce Order Management (SOM) status
+     *
+     * @property quantityAvailableToCancel: The quantity that can be cancelled.
+     *
+     */
+    type SomInfo = {
+        status?: SomInfoStatusEnum;
+        quantityAvailableToCancel?: number;
+    } & {
+        [key: string]: any;
+    };
+    type SomInfoStatusEnum = "ordered" | "returned" | "canceled" | "paid" | "reshipped" | "fulfilled" | "partially_fulfilled" | "allocated" | "partially_allocated" | "return_initiated";
     /**
      * @type ProductItem: Document representing a product item.
      *
@@ -44505,6 +44842,8 @@ declare namespace ShopperOrdersApiTypes {
      *
      * @property shippingItemId: If the product line item has a related shipping item, this value is its ID. A related shipping item represents a surcharge applied to individual products using a particular shipping method. It is read only.
      *
+     * @property somInfo:
+     *
      * @property tax: The tax for the product item, not including price adjustments. It is read only.
      *
      * @property taxBasis: The price used to calculate the tax for this product item. It is read only.
@@ -44537,6 +44876,7 @@ declare namespace ShopperOrdersApiTypes {
         quantity?: number;
         shipmentId?: string;
         shippingItemId?: string;
+        somInfo?: SomInfo;
         tax?: number;
         taxBasis?: number;
         taxClassId?: string;
@@ -44674,11 +45014,86 @@ declare namespace ShopperOrdersApiTypes {
     } & {
         [key: string]: any;
     };
+    /**
+     * @type FailOrderRequest: Document representing a fail order request.
+     *
+     * @property reasonCode: The reason code for failing the order.
+     *
+     */
+    type FailOrderRequest = {
+        reasonCode?: FailOrderRequestReasonCodeEnum;
+    } & {
+        [key: string]: any;
+    };
+    type FailOrderRequestReasonCodeEnum = "payment_confirm_failure" | "payment_capture_failure" | "payment_auth_failure";
     /**
      * @type LocaleCode
      * A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
      */
     type LocaleCode$0 = DefaultFallback | string;
+    /**
+     * @type ShipmentItem: Individual item within a shipment
+     *
+     * @property id: Unique identifier for the shipment item
+     *
+     * @property productItemId: Reference to the product item in the order
+     *
+     * @property quantity: Quantity of product items with the referenced productItemId in this shipment
+     *
+     */
+    type ShipmentItem = {
+        id?: string;
+        productItemId?: string;
+        quantity?: number;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type SchemasShipment: Shipment information from Salesforce Order Management created during fulfillment process. See https://developer.salesforce.com/docs/atlas.en-us.230.0.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_fulfillmentorder.htm for more information.
+     *
+     * @property id: Unique identifier for the shipment
+     *
+     * @property status: Current status of the shipment
+     *
+     * @property provider: Shipping provider name
+     *
+     * @property trackingNumber: Tracking number for the shipment
+     *
+     * @property trackingUrl: URL to track the shipment
+     *
+     * @property expectedDeliveryDate: Expected delivery date and time
+     *
+     * @property actualDeliveryDate: Actual delivery date and time (null if not yet delivered)
+     *
+     * @property shipmentItems: Items included in this shipment
+     *
+     */
+    type SchemasShipment = {
+        id?: string;
+        status?: string;
+        provider?: string;
+        trackingNumber?: string;
+        trackingUrl?: string;
+        expectedDeliveryDate?: string;
+        actualDeliveryDate?: string;
+        shipmentItems?: Array<ShipmentItem>;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type SchemasSomInfo: Additional information retrieved from Salesforce Order Management (SOM)  See https://developer.salesforce.com/docs/atlas.en-us.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_ordersummary.htm for more information.
+     *
+     * @property status: Current status of the order
+     *
+     * @property shipments: List of shipments associated with the order
+     *
+     */
+    type SchemasSomInfo = {
+        status?: string;
+        shipments?: Array<SchemasShipment>;
+    } & {
+        [key: string]: any;
+    };
     /**
      * @type Order: Document representing an order.
      *
@@ -44756,6 +45171,8 @@ declare namespace ShopperOrdersApiTypes {
      * - **Min Length:** 1
      * - **Max Length:** 32
      *
+     * @property somInfo:
+     *
      * @property sourceCode: The source code assigned to the basket from which this order was created. It is read only.
      *
      * @property status: The status.
@@ -44805,6 +45222,7 @@ declare namespace ShopperOrdersApiTypes {
         shippingTotal?: number;
         shippingTotalTax?: number;
         siteId?: string;
+        somInfo?: SchemasSomInfo;
         sourceCode?: string;
         status?: OrderStatusEnum$0;
         taxTotal?: number;
@@ -44875,12 +45293,36 @@ declare namespace ShopperOrdersApiTypes {
     } & {
         [key: string]: any;
     };
-    type SalesforcePaymentsRequest = {
+    /**
+     * @type PaymentReferenceRequest: Properties for Payments Reference Request
+     *
+     * @property paymentMethodType: Payment Method Type
+     * - **Max Length:** 64
+     *
+     * @property zoneId: The unique identifier for a Payments zone.
+     * - **Pattern:** /^[a-zA-Z0-9\\-_]{1,100}$/
+     * - **Min Length:** 1
+     * - **Max Length:** 100
+     *
+     * @property shippingPreference: Shipping preference for PayPal payment processing. Applicable only for basket payment instruments.
+     * - **Max Length:** 64
+     *
+     * @property gateway: The payment gateway used to process the payment.
+     *
+     * @property gatewayProperties:
+     *
+     */
+    type PaymentReferenceRequest = {
         paymentMethodType?: string;
         zoneId?: string;
+        shippingPreference?: PaymentReferenceRequestShippingPreferenceEnum;
+        gateway?: PaymentReferenceRequestGatewayEnum;
+        gatewayProperties?: OrderPaymentInstrumentPaymentReferenceGatewayProperties;
     } & {
         [key: string]: any;
     };
+    type PaymentReferenceRequestShippingPreferenceEnum = "GET_FROM_FILE" | "NO_SHIPPING" | "SET_PROVIDED_ADDRESS";
+    type PaymentReferenceRequestGatewayEnum = "stripe" | "paypal" | "adyen";
     /**
      * @type OrderPaymentInstrumentRequest: Document representing an order payment instrument request.
      *
@@ -44897,7 +45339,7 @@ declare namespace ShopperOrdersApiTypes {
      * @property paymentMethodId: The payment method ID.
      * - **Max Length:** 256
      *
-     * @property paymentReferenceRequest: The payment reference request used by Salesforce Payments.
+     * @property paymentReferenceRequest: Payment reference information for various payment service providers, only when Salesforce Payments is enabled.
      *
      */
     type OrderPaymentInstrumentRequest = {
@@ -44906,7 +45348,7 @@ declare namespace ShopperOrdersApiTypes {
         giftCertificateCode?: string;
         paymentCard?: OrderPaymentCardRequest;
         paymentMethodId?: string;
-        paymentReferenceRequest?: SalesforcePaymentsRequest;
+        paymentReferenceRequest?: PaymentReferenceRequest;
     } & {
         [key: string]: any;
     };
@@ -45021,6 +45463,7 @@ declare namespace ShopperOrdersApiTypes {
     } & {
         [key: string]: any;
     };
+    type GetOrderExpandEnum = "som" | "som_shipments";
     type createOrderQueryParameters = {
         siteId: string;
         locale?: LocaleCode$0;
@@ -45036,9 +45479,19 @@ declare namespace ShopperOrdersApiTypes {
         organizationId: string;
         orderNo: string;
     };
+    type failOrderQueryParameters = {
+        siteId: string;
+        locale?: LocaleCode$0;
+        reopenBasket?: boolean;
+    };
+    type failOrderPathParameters = {
+        organizationId: string;
+        orderNo: string;
+    };
     type getOrderQueryParameters = {
         siteId: string;
         locale?: LocaleCode$0;
+        expand?: Array<"som" | "som_shipments">;
     };
     type getOrderPathParameters = {
         orderNo: string;
@@ -45088,11 +45541,11 @@ declare namespace ShopperOrdersApiTypes {
     /**
      * All path parameters that are used by at least one ShopperOrders method.
      */
-    type ShopperOrdersPathParameters = Partial<createOrderPathParameters & createPaymentInstrumentForOrderPathParameters & getOrderPathParameters & getPaymentMethodsForOrderPathParameters & getTaxesFromOrderPathParameters & guestOrderLookupPathParameters & removePaymentInstrumentFromOrderPathParameters & updatePaymentInstrumentForOrderPathParameters & {}>;
+    type ShopperOrdersPathParameters = Partial<createOrderPathParameters & createPaymentInstrumentForOrderPathParameters & failOrderPathParameters & getOrderPathParameters & getPaymentMethodsForOrderPathParameters & getTaxesFromOrderPathParameters & guestOrderLookupPathParameters & removePaymentInstrumentFromOrderPathParameters & updatePaymentInstrumentForOrderPathParameters & {}>;
     /**
      * All query parameters that are used by at least one ShopperOrders method.
      */
-    type ShopperOrdersQueryParameters = Partial<createOrderQueryParameters & createPaymentInstrumentForOrderQueryParameters & getOrderQueryParameters & getPaymentMethodsForOrderQueryParameters & getTaxesFromOrderQueryParameters & guestOrderLookupQueryParameters & removePaymentInstrumentFromOrderQueryParameters & updatePaymentInstrumentForOrderQueryParameters & {}>;
+    type ShopperOrdersQueryParameters = Partial<createOrderQueryParameters & createPaymentInstrumentForOrderQueryParameters & failOrderQueryParameters & getOrderQueryParameters & getPaymentMethodsForOrderQueryParameters & getTaxesFromOrderQueryParameters & guestOrderLookupQueryParameters & removePaymentInstrumentFromOrderQueryParameters & updatePaymentInstrumentForOrderQueryParameters & {}>;
     /**
      * All parameters that are used by ShopperOrders.
      */
@@ -45101,7 +45554,9 @@ declare namespace ShopperOrdersApiTypes {
      * [Shopper Orders](https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-orders:Summary)
      * ==================================
      *
-     * *# API Overview
+     * *[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/shopper-orders/shopper-orders-oas-v1-public.yaml)
+     
+     # API Overview
      
      The Shopper Orders API enables you to:
      
@@ -45164,6 +45619,7 @@ declare namespace ShopperOrdersApiTypes {
         static readonly apiPaths: {
             createOrder: string;
             createPaymentInstrumentForOrder: string;
+            failOrder: string;
             getOrder: string;
             getPaymentMethodsForOrder: string;
             getTaxesFromOrder: string;
@@ -45193,11 +45649,24 @@ declare namespace ShopperOrdersApiTypes {
                 "orderNo",
                 "siteId"
             ];
+            readonly failOrder: readonly [
+                "organizationId",
+                "orderNo",
+                "siteId",
+                "locale",
+                "reopenBasket"
+            ];
+            readonly failOrderRequired: readonly [
+                "organizationId",
+                "orderNo",
+                "siteId"
+            ];
             readonly getOrder: readonly [
                 "orderNo",
                 "organizationId",
                 "siteId",
-                "locale"
+                "locale",
+                "expand"
             ];
             readonly getOrderRequired: readonly [
                 "orderNo",
@@ -45379,6 +45848,71 @@ declare namespace ShopperOrdersApiTypes {
             };
             body: OrderPaymentInstrumentRequest & CustomRequestBody;
         }>, rawResponse?: T): Promise<T extends true ? Response : Order>;
+        /**
+         * Fails an unplaced order and optionally reopens the basket when indicated.
+         Creates a HistoryEntry in the failed Order with provided reasonCode.
+         *
+         * If you would like to get a raw Response object use the other failOrder function.
+         *
+         * @param options - An object containing the options for this method.
+         * @param options.parameters - An object containing the parameters for this method.
+         * @param options.parameters.organizationId - An identifier for the organization the request is being made by
+         * @param options.parameters.orderNo - The order number of the order to be modified.
+         * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
+         * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+         * @param options.parameters.reopenBasket - Set to true to reopen basket from the order.
+         A basket can only be reopened if no other basket for the customer exists at the moment of the call to fail Order,
+         since a customer is limited to 1 storefront basket at a time.
+         * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
+         * @param options.body - The data to send as the request body.
+         *
+         * @returns A promise of type void.
+         */
+        failOrder(options: RequireParametersUnlessAllAreOptional<{
+            parameters?: CompositeParameters<{
+                organizationId: string;
+                orderNo: string;
+                siteId: string;
+                locale?: LocaleCode$0;
+                reopenBasket?: boolean;
+            } & QueryParameters, ConfigParameters>;
+            headers?: {
+                [key: string]: string;
+            };
+            body: FailOrderRequest & CustomRequestBody;
+        }>): Promise<void>;
+        /**
+         * Fails an unplaced order and optionally reopens the basket when indicated.
+         Creates a HistoryEntry in the failed Order with provided reasonCode.
+         *
+         * @param options - An object containing the options for this method.
+         * @param options.parameters - An object containing the parameters for this method.
+         * @param options.parameters.organizationId - An identifier for the organization the request is being made by
+         * @param options.parameters.orderNo - The order number of the order to be modified.
+         * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
+         * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+         * @param options.parameters.reopenBasket - Set to true to reopen basket from the order.
+         A basket can only be reopened if no other basket for the customer exists at the moment of the call to fail Order,
+         since a customer is limited to 1 storefront basket at a time.
+         * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
+         * @param options.body - The data to send as the request body.
+         * @param rawResponse - Set to true to return entire Response object instead of DTO.
+         *
+         * @returns A promise of type Response if rawResponse is true, a promise of type void otherwise.
+         */
+        failOrder<T extends boolean>(options: RequireParametersUnlessAllAreOptional<{
+            parameters?: CompositeParameters<{
+                organizationId: string;
+                orderNo: string;
+                siteId: string;
+                locale?: LocaleCode$0;
+                reopenBasket?: boolean;
+            } & QueryParameters, ConfigParameters>;
+            headers?: {
+                [key: string]: string;
+            };
+            body: FailOrderRequest & CustomRequestBody;
+        }>, rawResponse?: T): Promise<T extends true ? Response : void>;
         /**
          * Gets information for an order.
          *
@@ -45390,6 +45924,12 @@ declare namespace ShopperOrdersApiTypes {
          * @param options.parameters.organizationId - An identifier for the organization the request is being made by
          * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
          * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+         * @param options.parameters.expand - When a 'som' expand is selected, data is primarily loaded from Salesforce Order Management (SOM), if available.
+         When data is available in SOM, the expand parameter has the following behavior:
+         "expand=som": order and related order entities (product items, delivery group, etc) are returned.
+         "expand=som_shipments": order and fulfillment (shipment) data is returned.
+         "expand=som,som_shipments": order, related order entities and fulfillment (shipment) data is returned
+         If your instance is not integrated with SOM or the order data is not available, the `expand=som` command is disregarded.
          * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
          *
          * @returns A promise of type Order.
@@ -45400,6 +45940,7 @@ declare namespace ShopperOrdersApiTypes {
                 organizationId: string;
                 siteId: string;
                 locale?: LocaleCode$0;
+                expand?: Array<GetOrderExpandEnum>;
             } & QueryParameters, ConfigParameters>;
             headers?: {
                 [key: string]: string;
@@ -45414,6 +45955,12 @@ declare namespace ShopperOrdersApiTypes {
          * @param options.parameters.organizationId - An identifier for the organization the request is being made by
          * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
          * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+         * @param options.parameters.expand - When a 'som' expand is selected, data is primarily loaded from Salesforce Order Management (SOM), if available.
+         When data is available in SOM, the expand parameter has the following behavior:
+         "expand=som": order and related order entities (product items, delivery group, etc) are returned.
+         "expand=som_shipments": order and fulfillment (shipment) data is returned.
+         "expand=som,som_shipments": order, related order entities and fulfillment (shipment) data is returned
+         If your instance is not integrated with SOM or the order data is not available, the `expand=som` command is disregarded.
          * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
          * @param rawResponse - Set to true to return entire Response object instead of DTO.
          *
@@ -45425,6 +45972,7 @@ declare namespace ShopperOrdersApiTypes {
                 organizationId: string;
                 siteId: string;
                 locale?: LocaleCode$0;
+                expand?: Array<GetOrderExpandEnum>;
             } & QueryParameters, ConfigParameters>;
             headers?: {
                 [key: string]: string;
@@ -45792,6 +46340,56 @@ declare namespace ShopperOrdersModelTypes {
     } & {
         [key: string]: any;
     };
+    /**
+     * @type OrderPaymentInstrumentPaymentReferenceGatewayProperties: The payment gateway specific properties.
+     *
+     * @property stripe: Stripe specific properties.
+     *
+     * @property adyen: Ayden specific properties.
+     *
+     * @property paypal: PayPal specific properties.
+     *
+     */
+    type OrderPaymentInstrumentPaymentReferenceGatewayProperties = {
+        stripe?: {
+            [key: string]: any;
+        };
+        adyen?: {
+            [key: string]: any;
+        };
+        paypal?: {
+            [key: string]: any;
+        };
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type OrderPaymentInstrumentPaymentReference: Payment reference information for various payment service providers, only when Salesforce Payments is enabled.
+     *
+     * @property paymentReferenceId: Payment reference identifier. Can be payment intent ID for Stripe, PSP reference for Adyen, PayPal order ID for PayPal, or similar identifier for other payment providers.
+     * - **Max Length:** 256
+     *
+     * @property clientSecret: Client secret for payment confirmation. Used primarily by Stripe for client-side payment confirmation.
+     * - **Max Length:** 256
+     *
+     * @property redirectUrl: Redirect URL for payment methods that require user redirection to complete payment.
+     * - **Max Length:** 2048
+     *
+     * @property gateway: The payment gateway used to process the payment.
+     *
+     * @property gatewayProperties:
+     *
+     */
+    type OrderPaymentInstrumentPaymentReference = {
+        paymentReferenceId?: string;
+        clientSecret?: string;
+        redirectUrl?: string;
+        gateway?: OrderPaymentInstrumentPaymentReferenceGatewayEnum;
+        gatewayProperties?: OrderPaymentInstrumentPaymentReferenceGatewayProperties;
+    } & {
+        [key: string]: any;
+    };
+    type OrderPaymentInstrumentPaymentReferenceGatewayEnum = "stripe" | "paypal" | "adyen";
     /**
      * @type PaymentCard: Document representing a payment card.
      *
@@ -45857,6 +46455,8 @@ declare namespace ShopperOrdersModelTypes {
      * @property paymentMethodId: The payment method ID. It is read only.
      * - **Max Length:** 256
      *
+     * @property paymentReference:
+     *
      */
     type OrderPaymentInstrument = {
         amount?: number;
@@ -45866,6 +46466,7 @@ declare namespace ShopperOrdersModelTypes {
         paymentCard?: PaymentCard;
         paymentInstrumentId?: string;
         paymentMethodId?: string;
+        paymentReference?: OrderPaymentInstrumentPaymentReference;
     } & {
         [key: string]: any;
     };
@@ -46405,6 +47006,21 @@ declare namespace ShopperOrdersModelTypes {
     } & {
         [key: string]: any;
     };
+    /**
+     * @type SomInfo: Additional information retrieved from Salesforce Order Management (SOM)  See https://developer.salesforce.com/docs/atlas.en-us.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_orderitemsummary.htm for more information.
+     *
+     * @property status: Salesforce Order Management (SOM) status
+     *
+     * @property quantityAvailableToCancel: The quantity that can be cancelled.
+     *
+     */
+    type SomInfo = {
+        status?: SomInfoStatusEnum;
+        quantityAvailableToCancel?: number;
+    } & {
+        [key: string]: any;
+    };
+    type SomInfoStatusEnum = "ordered" | "returned" | "canceled" | "paid" | "reshipped" | "fulfilled" | "partially_fulfilled" | "allocated" | "partially_allocated" | "return_initiated";
     /**
      * @type ProductItem: Document representing a product item.
      *
@@ -46455,6 +47071,8 @@ declare namespace ShopperOrdersModelTypes {
      *
      * @property shippingItemId: If the product line item has a related shipping item, this value is its ID. A related shipping item represents a surcharge applied to individual products using a particular shipping method. It is read only.
      *
+     * @property somInfo:
+     *
      * @property tax: The tax for the product item, not including price adjustments. It is read only.
      *
      * @property taxBasis: The price used to calculate the tax for this product item. It is read only.
@@ -46487,6 +47105,7 @@ declare namespace ShopperOrdersModelTypes {
         quantity?: number;
         shipmentId?: string;
         shippingItemId?: string;
+        somInfo?: SomInfo;
         tax?: number;
         taxBasis?: number;
         taxClassId?: string;
@@ -46624,11 +47243,86 @@ declare namespace ShopperOrdersModelTypes {
     } & {
         [key: string]: any;
     };
+    /**
+     * @type FailOrderRequest: Document representing a fail order request.
+     *
+     * @property reasonCode: The reason code for failing the order.
+     *
+     */
+    type FailOrderRequest = {
+        reasonCode?: FailOrderRequestReasonCodeEnum;
+    } & {
+        [key: string]: any;
+    };
+    type FailOrderRequestReasonCodeEnum = "payment_confirm_failure" | "payment_capture_failure" | "payment_auth_failure";
     /**
      * @type LocaleCode
      * A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
      */
     type LocaleCode = DefaultFallback | string;
+    /**
+     * @type ShipmentItem: Individual item within a shipment
+     *
+     * @property id: Unique identifier for the shipment item
+     *
+     * @property productItemId: Reference to the product item in the order
+     *
+     * @property quantity: Quantity of product items with the referenced productItemId in this shipment
+     *
+     */
+    type ShipmentItem = {
+        id?: string;
+        productItemId?: string;
+        quantity?: number;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type SchemasShipment: Shipment information from Salesforce Order Management created during fulfillment process. See https://developer.salesforce.com/docs/atlas.en-us.230.0.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_fulfillmentorder.htm for more information.
+     *
+     * @property id: Unique identifier for the shipment
+     *
+     * @property status: Current status of the shipment
+     *
+     * @property provider: Shipping provider name
+     *
+     * @property trackingNumber: Tracking number for the shipment
+     *
+     * @property trackingUrl: URL to track the shipment
+     *
+     * @property expectedDeliveryDate: Expected delivery date and time
+     *
+     * @property actualDeliveryDate: Actual delivery date and time (null if not yet delivered)
+     *
+     * @property shipmentItems: Items included in this shipment
+     *
+     */
+    type SchemasShipment = {
+        id?: string;
+        status?: string;
+        provider?: string;
+        trackingNumber?: string;
+        trackingUrl?: string;
+        expectedDeliveryDate?: string;
+        actualDeliveryDate?: string;
+        shipmentItems?: Array<ShipmentItem>;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type SchemasSomInfo: Additional information retrieved from Salesforce Order Management (SOM)  See https://developer.salesforce.com/docs/atlas.en-us.order_management_developer_guide.meta/order_management_developer_guide/sforce_api_objects_ordersummary.htm for more information.
+     *
+     * @property status: Current status of the order
+     *
+     * @property shipments: List of shipments associated with the order
+     *
+     */
+    type SchemasSomInfo = {
+        status?: string;
+        shipments?: Array<SchemasShipment>;
+    } & {
+        [key: string]: any;
+    };
     /**
      * @type Order: Document representing an order.
      *
@@ -46706,6 +47400,8 @@ declare namespace ShopperOrdersModelTypes {
      * - **Min Length:** 1
      * - **Max Length:** 32
      *
+     * @property somInfo:
+     *
      * @property sourceCode: The source code assigned to the basket from which this order was created. It is read only.
      *
      * @property status: The status.
@@ -46755,6 +47451,7 @@ declare namespace ShopperOrdersModelTypes {
         shippingTotal?: number;
         shippingTotalTax?: number;
         siteId?: string;
+        somInfo?: SchemasSomInfo;
         sourceCode?: string;
         status?: OrderStatusEnum;
         taxTotal?: number;
@@ -46825,12 +47522,36 @@ declare namespace ShopperOrdersModelTypes {
     } & {
         [key: string]: any;
     };
-    type SalesforcePaymentsRequest = {
+    /**
+     * @type PaymentReferenceRequest: Properties for Payments Reference Request
+     *
+     * @property paymentMethodType: Payment Method Type
+     * - **Max Length:** 64
+     *
+     * @property zoneId: The unique identifier for a Payments zone.
+     * - **Pattern:** /^[a-zA-Z0-9\\-_]{1,100}$/
+     * - **Min Length:** 1
+     * - **Max Length:** 100
+     *
+     * @property shippingPreference: Shipping preference for PayPal payment processing. Applicable only for basket payment instruments.
+     * - **Max Length:** 64
+     *
+     * @property gateway: The payment gateway used to process the payment.
+     *
+     * @property gatewayProperties:
+     *
+     */
+    type PaymentReferenceRequest = {
         paymentMethodType?: string;
         zoneId?: string;
+        shippingPreference?: PaymentReferenceRequestShippingPreferenceEnum;
+        gateway?: PaymentReferenceRequestGatewayEnum;
+        gatewayProperties?: OrderPaymentInstrumentPaymentReferenceGatewayProperties;
     } & {
         [key: string]: any;
     };
+    type PaymentReferenceRequestShippingPreferenceEnum = "GET_FROM_FILE" | "NO_SHIPPING" | "SET_PROVIDED_ADDRESS";
+    type PaymentReferenceRequestGatewayEnum = "stripe" | "paypal" | "adyen";
     /**
      * @type OrderPaymentInstrumentRequest: Document representing an order payment instrument request.
      *
@@ -46847,7 +47568,7 @@ declare namespace ShopperOrdersModelTypes {
      * @property paymentMethodId: The payment method ID.
      * - **Max Length:** 256
      *
-     * @property paymentReferenceRequest: The payment reference request used by Salesforce Payments.
+     * @property paymentReferenceRequest: Payment reference information for various payment service providers, only when Salesforce Payments is enabled.
      *
      */
     type OrderPaymentInstrumentRequest = {
@@ -46856,7 +47577,7 @@ declare namespace ShopperOrdersModelTypes {
         giftCertificateCode?: string;
         paymentCard?: OrderPaymentCardRequest;
         paymentMethodId?: string;
-        paymentReferenceRequest?: SalesforcePaymentsRequest;
+        paymentReferenceRequest?: PaymentReferenceRequest;
     } & {
         [key: string]: any;
     };
@@ -46980,6 +47701,9 @@ declare namespace ShopperOrdersTypes {
     type createOrderPathParameters = ShopperOrdersApiTypes.createOrderPathParameters;
     type createPaymentInstrumentForOrderQueryParameters = ShopperOrdersApiTypes.createPaymentInstrumentForOrderQueryParameters;
     type createPaymentInstrumentForOrderPathParameters = ShopperOrdersApiTypes.createPaymentInstrumentForOrderPathParameters;
+    type failOrderQueryParameters = ShopperOrdersApiTypes.failOrderQueryParameters;
+    type failOrderPathParameters = ShopperOrdersApiTypes.failOrderPathParameters;
+    type GetOrderExpandEnum = ShopperOrdersApiTypes.GetOrderExpandEnum;
     type getOrderQueryParameters = ShopperOrdersApiTypes.getOrderQueryParameters;
     type getOrderPathParameters = ShopperOrdersApiTypes.getOrderPathParameters;
     type getPaymentMethodsForOrderQueryParameters = ShopperOrdersApiTypes.getPaymentMethodsForOrderQueryParameters;
@@ -47005,6 +47729,8 @@ declare namespace ShopperOrdersTypes {
     type Discount = ShopperOrdersModelTypes.Discount;
     type DiscountTypeEnum = ShopperOrdersModelTypes.DiscountTypeEnum;
     type ErrorResponse = ShopperOrdersModelTypes.ErrorResponse;
+    type FailOrderRequest = ShopperOrdersModelTypes.FailOrderRequest;
+    type FailOrderRequestReasonCodeEnum = ShopperOrdersModelTypes.FailOrderRequestReasonCodeEnum;
     type GiftCertificateItem = ShopperOrdersModelTypes.GiftCertificateItem;
     type GroupedTaxItem = ShopperOrdersModelTypes.GroupedTaxItem;
     type LocaleCode = ShopperOrdersModelTypes.LocaleCode;
@@ -47022,11 +47748,17 @@ declare namespace ShopperOrdersTypes {
     type OrderLookupRequest = ShopperOrdersModelTypes.OrderLookupRequest;
     type OrderPaymentCardRequest = ShopperOrdersModelTypes.OrderPaymentCardRequest;
     type OrderPaymentInstrument = ShopperOrdersModelTypes.OrderPaymentInstrument;
+    type OrderPaymentInstrumentPaymentReference = ShopperOrdersModelTypes.OrderPaymentInstrumentPaymentReference;
+    type OrderPaymentInstrumentPaymentReferenceGatewayEnum = ShopperOrdersModelTypes.OrderPaymentInstrumentPaymentReferenceGatewayEnum;
+    type OrderPaymentInstrumentPaymentReferenceGatewayProperties = ShopperOrdersModelTypes.OrderPaymentInstrumentPaymentReferenceGatewayProperties;
     type OrderPaymentInstrumentRequest = ShopperOrdersModelTypes.OrderPaymentInstrumentRequest;
     type PaymentCard = ShopperOrdersModelTypes.PaymentCard;
     type PaymentCardSpec = ShopperOrdersModelTypes.PaymentCardSpec;
     type PaymentMethod = ShopperOrdersModelTypes.PaymentMethod;
     type PaymentMethodResult = ShopperOrdersModelTypes.PaymentMethodResult;
+    type PaymentReferenceRequest = ShopperOrdersModelTypes.PaymentReferenceRequest;
+    type PaymentReferenceRequestShippingPreferenceEnum = ShopperOrdersModelTypes.PaymentReferenceRequestShippingPreferenceEnum;
+    type PaymentReferenceRequestGatewayEnum = ShopperOrdersModelTypes.PaymentReferenceRequestGatewayEnum;
     type PriceAdjustment = ShopperOrdersModelTypes.PriceAdjustment;
     type ProductDetailsLink = ShopperOrdersModelTypes.ProductDetailsLink;
     type ProductItem = ShopperOrdersModelTypes.ProductItem;
@@ -47034,12 +47766,16 @@ declare namespace ShopperOrdersTypes {
     type ProductListItemReferenceTypeEnum = ShopperOrdersModelTypes.ProductListItemReferenceTypeEnum;
     type ProductListLink = ShopperOrdersModelTypes.ProductListLink;
     type ProductListLinkTypeEnum = ShopperOrdersModelTypes.ProductListLinkTypeEnum;
-    type SalesforcePaymentsRequest = ShopperOrdersModelTypes.SalesforcePaymentsRequest;
+    type SchemasShipment = ShopperOrdersModelTypes.SchemasShipment;
+    type SchemasSomInfo = ShopperOrdersModelTypes.SchemasSomInfo;
     type Shipment = ShopperOrdersModelTypes.Shipment;
     type ShipmentShippingStatusEnum = ShopperOrdersModelTypes.ShipmentShippingStatusEnum;
+    type ShipmentItem = ShopperOrdersModelTypes.ShipmentItem;
     type ShippingItem = ShopperOrdersModelTypes.ShippingItem;
     type ShippingMethod = ShopperOrdersModelTypes.ShippingMethod;
     type ShippingPromotion = ShopperOrdersModelTypes.ShippingPromotion;
+    type SomInfo = ShopperOrdersModelTypes.SomInfo;
+    type SomInfoStatusEnum = ShopperOrdersModelTypes.SomInfoStatusEnum;
     type Status = ShopperOrdersModelTypes.Status;
     type TaxItem = ShopperOrdersModelTypes.TaxItem;
     type TaxItems = ShopperOrdersModelTypes.TaxItems;