@wix/headless-bookings 0.0.117 → 1.0.0

package/cjs/dist/services/payment/payment.d.ts

@@ -4,7 +4,7 @@
  * Supports two modes: SSR (config with pre-fetched data) and lazy loading (reactive)
  */
 import { type PaymentServiceConfig, type PaymentServiceInternalConfig, type PricingServiceSelection } from './payment.def.js';
-export { PaymentServiceDefinition, type PaymentServiceConfig, type PaymentDetails, type LineItemAdditionalInfo, type PricingServiceSelection, } from './payment.def.js';
+export { PaymentServiceDefinition, type PaymentServiceConfig, type PaymentDetails, type LineItemAdditionalInfo, type PricingServiceSelection, type ServicePaymentOptions, } from './payment.def.js';
 export type { PaymentServiceAPI, PaymentServiceInternalConfig, } from './payment.def.js';
 export declare const PaymentService: import("@wix/services-definitions").ServiceFactory<string & {
     __api: import("./payment.def.js").PaymentServiceAPI;

package/cjs/dist/services/payment/payment.def.d.ts

@@ -5,6 +5,18 @@
 import type { Signal } from '@wix/services-definitions/core-services/signals';
 import type { CalculateTotalsResponse } from '@wix/auto_sdk_ecom_totals-calculator';
 import type { Service } from '@wix/auto_sdk_bookings_services';
+/**
+ * Service payment options derived from service.payment.options.
+ * Describes which payment methods the service supports.
+ */
+export interface ServicePaymentOptions {
+    /** Customer can pay online at booking time */
+    isOnline: boolean;
+    /** Customer can pay in person (on arrival) */
+    isInPerson: boolean;
+    /** A deposit is required at booking time */
+    isDeposit: boolean;
+}
 /**
  * Payment option for line items
  */
@@ -44,6 +56,8 @@ export interface PricingServiceSelection {
 export interface PaymentServiceConfig {
     /** Pre-calculated payment details for SSR (no API call) */
     paymentDetails?: PaymentDetails;
+    /** Service payment options for SSR (derived from service.payment.options) */
+    serviceOptions?: ServicePaymentOptions;
 }
 /**
  * Internal config used by Core component to pass lazy loading data
@@ -59,6 +73,7 @@ export interface PaymentServiceAPI {
     paymentDetailsSignal: Signal<PaymentDetails | null>;
     isLoadingSignal: Signal<boolean>;
     errorSignal: Signal<string | null>;
+    serviceOptionsSignal: Signal<ServicePaymentOptions>;
 }
 export declare const PaymentServiceDefinition: string & {
     __api: PaymentServiceAPI;

package/cjs/dist/services/payment/payment.js

@@ -20,6 +20,35 @@ const constants_js_1 = require("../constants.js");
 // ============================================================================
 // Helper Functions
 // ============================================================================
+const DEFAULT_SERVICE_OPTIONS = {
+    isOnline: false,
+    isInPerson: false,
+    isDeposit: false,
+};
+/**
+ * Derives static service payment options from the first service's configuration.
+ *
+ * Note on `isDeposit`: this reflects whether the service is *configured* with a
+ * deposit (i.e. `payment.fixed.deposit.value > 0`), consistent with how
+ * `buildLineItem` determines `hasDeposit`. Only `FIXED` rate type is checked;
+ * `VARIED` pricing is not currently supported for deposit detection here.
+ *
+ * This is distinct from the runtime `isDeposit` flag in `CorePayment.Data`, which
+ * is computed dynamically from the ecom API result (`payNow.amount < total.amount`).
+ * Use `Payment.ServiceOptions` to determine *which scenario to render* (static config),
+ * and `Payment.PayNow`/`Payment.PayLater` for the *actual split amounts* (runtime).
+ */
+function deriveServiceOptions(pricingServiceSelections) {
+    const service = pricingServiceSelections[0]?.service;
+    const options = service?.payment?.options;
+    const depositValue = service?.payment?.fixed?.deposit?.value;
+    const hasDeposit = !!depositValue && Number(depositValue) > 0;
+    return {
+        isOnline: !!options?.online,
+        isInPerson: !!options?.inPerson,
+        isDeposit: hasDeposit,
+    };
+}
 function getAdditionalInfo(service, lineItemId) {
     const payment = service.payment;
     const customPrice = payment?.rateType === auto_sdk_bookings_services_1.RateType.CUSTOM && payment.custom?.description
@@ -97,6 +126,7 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
     const paymentDetailsSignal = signalsService.signal(config.paymentDetails || null);
     const isLoadingSignal = signalsService.signal(false);
     const errorSignal = signalsService.signal(null);
+    const serviceOptionsSignal = signalsService.signal(config.serviceOptions || DEFAULT_SERVICE_OPTIONS);
     // Internal calculate function
     const calculate = async (pricingServiceSelections, totalParticipants) => {
         if (!pricingServiceSelections.length) {
@@ -122,10 +152,18 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
     };
     // Mode 1: SSR - paymentDetails already set in signal initialization
     if (config.paymentDetails) {
-        // No-op - data is pre-fetched
+        if (!config.serviceOptions &&
+            process.env['NODE_ENV'] !== 'production') {
+            console.warn('[PaymentService] SSR mode: `serviceOptions` was not provided in config. ' +
+                'Payment.ServiceOptions will return all-false defaults. ' +
+                'Use `loadPaymentConfig` to automatically derive serviceOptions, ' +
+                'or pass `serviceOptions` explicitly in `paymentServiceConfig`.');
+        }
+        // serviceOptionsSignal already initialized from config.serviceOptions (or DEFAULT_SERVICE_OPTIONS)
     }
     // Mode 2: Lazy loading - pricingServiceSelections provided via internal config
     else if (config.pricingServiceSelections?.length) {
+        serviceOptionsSignal.set(deriveServiceOptions(config.pricingServiceSelections));
         void calculate(config.pricingServiceSelections, config.totalParticipants ?? 1);
     }
     // Mode 3: Reactive - observe BookingService signals (client-side only)
@@ -147,6 +185,9 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
                 service: selection.service,
                 lineItemId: selection.instanceId,
             }));
+            if (pricingServiceSelections.length) {
+                serviceOptionsSignal.set(deriveServiceOptions(pricingServiceSelections));
+            }
             void calculate(pricingServiceSelections, numParticipants);
         });
     }
@@ -154,6 +195,7 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
         paymentDetailsSignal,
         isLoadingSignal,
         errorSignal,
+        serviceOptionsSignal,
     };
 });
 /**
@@ -169,13 +211,19 @@ async function loadPaymentConfig(params) {
         if (!pricingServiceSelections.length) {
             return {
                 type: 'success',
-                config: { paymentDetails: undefined },
+                config: {
+                    paymentDetails: undefined,
+                    serviceOptions: DEFAULT_SERVICE_OPTIONS,
+                },
             };
         }
         const paymentDetails = await calculatePaymentDetails(pricingServiceSelections, totalParticipants);
         return {
             type: 'success',
-            config: { paymentDetails },
+            config: {
+                paymentDetails,
+                serviceOptions: deriveServiceOptions(pricingServiceSelections),
+            },
         };
     }
     catch (error) {

package/cjs/dist/utils/navigation.d.ts

@@ -1,7 +1,7 @@
 export interface NavigationInfo {
     postFlowUrl: string;
 }
-export declare function navigateToCheckout({ checkoutId, navigationInfo, }: {
-    checkoutId: string;
+export declare function navigateToCheckout({ cartId, navigationInfo, }: {
+    cartId: string;
     navigationInfo: NavigationInfo;
 }): Promise<void>;

package/cjs/dist/utils/navigation.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.navigateToCheckout = navigateToCheckout;
 const redirects_1 = require("@wix/redirects");
-async function navigateToCheckout({ checkoutId, navigationInfo, }) {
+async function navigateToCheckout({ cartId, navigationInfo, }) {
     const { redirectSession } = await redirects_1.redirects.createRedirectSession({
-        ecomCheckout: { checkoutId },
+        ecomCheckout: { checkoutId: cartId },
         callbacks: {
             postFlowUrl: navigationInfo.postFlowUrl,
         },

package/dist/api/calculate-cart/index.d.ts

@@ -0,0 +1,3 @@
+import { type CalculateCartOptions, type CalculateCartResponse } from '@wix/auto_sdk_ecom_cart-v-2';
+export declare function calculateCart(cartId: string, options?: CalculateCartOptions): Promise<CalculateCartResponse>;
+export type { CalculateCartResponse, CartSummary, } from '@wix/auto_sdk_ecom_cart-v-2';

package/dist/api/calculate-cart/index.js

@@ -0,0 +1,4 @@
+import { calculateCart as calculateCartSdk, } from '@wix/auto_sdk_ecom_cart-v-2';
+export async function calculateCart(cartId, options) {
+    return calculateCartSdk(cartId, options);
+}

package/dist/api/create-cart/index.d.ts

@@ -0,0 +1,3 @@
+import { type CreateCartOptions, type Cart } from '@wix/auto_sdk_ecom_cart-v-2';
+export declare function createCart(options?: CreateCartOptions): Promise<Cart>;
+export { ChannelType, type CreateCartOptions, type Cart, } from '@wix/auto_sdk_ecom_cart-v-2';

package/dist/api/create-cart/index.js

@@ -0,0 +1,5 @@
+import { createCart as createCartSdk, } from '@wix/auto_sdk_ecom_cart-v-2';
+export async function createCart(options) {
+    return createCartSdk(options);
+}
+export { ChannelType, } from '@wix/auto_sdk_ecom_cart-v-2';

package/dist/api/index.d.ts

@@ -7,14 +7,8 @@
 export { getServiceById, getServiceBySlug, queryServices, convertPlatformFilterToApiFilter, type PagingMetadata, type QueryServicesRequest, SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from './query-services/index.js';
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, type CreateBookingOptions, type Booking, type CreateBookingRequest, type CreateBookingResponse, type ParticipantNotification, type ContactDetails, } from './create-booking/index.js';
-export { createCheckout, ChannelType, type CreateCheckoutRequest, type CreateCheckoutResponse, } from './create-checkout/index.js';
-export { createOrder, type CreateOrderOptions, type CreateOrderResponse, } from './create-order/index.js';
+export { createCart, ChannelType, type CreateCartOptions, type Cart, } from './create-cart/index.js';
+export { calculateCart, type CalculateCartResponse, type CartSummary, } from './calculate-cart/index.js';
+export { placeOrder, type PlaceOrderOptions, type PlaceOrderResponse, } from './place-order/index.js';
 export { queryLocations, getLocationById, type QueryLocationsResult, type LocationData, } from './query-locations/index.js';
 export { queryCategories, type QueryCategoriesResult, type Category, } from './query-categories/index.js';
-/**
- * PagingMetadata includes:
- * - limit: Number of items per page
- * - offset: Number of items to skip
- * - count: Number of items returned in the current page
- * - hasNext: Whether there are more services available to load
- */

package/dist/api/index.js

@@ -7,14 +7,8 @@
 export { getServiceById, getServiceBySlug, queryServices, convertPlatformFilterToApiFilter, SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from './query-services/index.js';
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, } from './create-booking/index.js';
-export { createCheckout, ChannelType, } from './create-checkout/index.js';
-export { createOrder, } from './create-order/index.js';
+export { createCart, ChannelType, } from './create-cart/index.js';
+export { calculateCart, } from './calculate-cart/index.js';
+export { placeOrder, } from './place-order/index.js';
 export { queryLocations, getLocationById, } from './query-locations/index.js';
 export { queryCategories, } from './query-categories/index.js';
-/**
- * PagingMetadata includes:
- * - limit: Number of items per page
- * - offset: Number of items to skip
- * - count: Number of items returned in the current page
- * - hasNext: Whether there are more services available to load
- */

package/dist/api/place-order/index.d.ts

@@ -0,0 +1,3 @@
+import { type PlaceOrderOptions, type PlaceOrderResponse } from '@wix/auto_sdk_ecom_cart-v-2';
+export declare function placeOrder(cartId: string, options?: PlaceOrderOptions): Promise<PlaceOrderResponse>;
+export type { PlaceOrderOptions, PlaceOrderResponse, } from '@wix/auto_sdk_ecom_cart-v-2';

package/dist/api/place-order/index.js

@@ -0,0 +1,4 @@
+import { placeOrder as placeOrderSdk, } from '@wix/auto_sdk_ecom_cart-v-2';
+export async function placeOrder(cartId, options) {
+    return placeOrderSdk(cartId, options);
+}

package/dist/react/booking/Book.js

@@ -60,7 +60,7 @@ export const Book = React.forwardRef((props, ref) => {
     return (_jsx(CoreBook.Book, { onCheckout: (result) => {
             // Create navigateToCheckout with checkoutId captured
             const navigateToCheckout = (options) => navigateToCheckoutUtil({
-                checkoutId: result.checkoutId,
+                cartId: result.cartId,
                 navigationInfo: { postFlowUrl: options.postFlowUrl },
             });
             // Return user's callback result so core can await it

package/dist/react/core/booking/Book.d.ts

@@ -24,7 +24,7 @@ export interface BookProps {
      * Return a Promise to keep loading state active until it resolves.
      */
     onCheckout?: (result: {
-        checkoutId: string;
+        cartId: string;
     }) => void | Promise<unknown>;
     /**
      * Called when booking completes without requiring checkout.

package/dist/react/core/booking/Book.js

@@ -49,7 +49,7 @@ export function Book(props) {
         try {
             const result = await bookingService.actions.book();
             if (result.type === BookResultType.CheckoutRequired) {
-                await onCheckout?.({ checkoutId: result.checkoutId });
+                await onCheckout?.({ cartId: result.cartId });
             }
             else {
                 await onComplete?.({ orderId: result.orderId });

package/dist/react/core/payment/Payment.d.ts

@@ -4,7 +4,7 @@
  * Note: Currently supports single service only
  */
 import React from 'react';
-import { type PaymentServiceConfig, type PricingServiceSelection } from '../../../services/payment/payment.js';
+import { type PaymentServiceConfig, type PricingServiceSelection, type ServicePaymentOptions } from '../../../services/payment/payment.js';
 import type { MoneyData } from '@wix/headless-components/react';
 /**
  * Props for Payment.Root component
@@ -164,6 +164,19 @@ export interface LineItemProviderProps {
  * ```
  */
 export declare function LineItemProvider(props: LineItemProviderProps): React.ReactNode;
+/**
+ * Props for ServiceOptions render prop component
+ */
+export interface ServiceOptionsProps {
+    children: (options: ServicePaymentOptions) => React.ReactNode;
+}
+/**
+ * Core component that exposes service payment options via render props.
+ * Reads isOnline, isInPerson, isDeposit from the payment service signal.
+ *
+ * @component
+ */
+export declare function ServiceOptions(props: ServiceOptionsProps): React.ReactNode;
 /**
  * Props for LineItemInfo render prop component
  */

package/dist/react/core/payment/Payment.js

@@ -188,6 +188,17 @@ export function LineItemProvider(props) {
     };
     return (_jsx(LineItemContext.Provider, { value: contextValue, children: children }));
 }
+/**
+ * Core component that exposes service payment options via render props.
+ * Reads isOnline, isInPerson, isDeposit from the payment service signal.
+ *
+ * @component
+ */
+export function ServiceOptions(props) {
+    const paymentService = useService(PaymentServiceDefinition);
+    const serviceOptions = paymentService.serviceOptionsSignal.get();
+    return props.children(serviceOptions);
+}
 /**
  * Core component that provides access to line item info via render props.
  * Must be used within LineItemProvider.

package/dist/react/payment/Payment.d.ts

@@ -5,7 +5,7 @@
 import React from 'react';
 import { AsChildChildren } from '@wix/headless-utils/react';
 import { MoneyData } from '@wix/headless-components/react';
-import type { PaymentServiceConfig, PricingServiceSelection } from '../../services/payment/payment.js';
+import type { PaymentServiceConfig, PricingServiceSelection, ServicePaymentOptions } from '../../services/payment/payment.js';
 export declare const TestIds: {
     readonly paymentRoot: "payment-root";
     readonly paymentSubtotal: "payment-subtotal";
@@ -19,6 +19,7 @@ export declare const TestIds: {
     readonly paymentLineItemTotal: "payment-line-item-total";
     readonly paymentLineItemSubtotal: "payment-line-item-subtotal";
     readonly paymentLineItemDeposit: "payment-line-item-deposit";
+    readonly paymentServiceOptions: "payment-service-options";
 };
 /**
  * Props for Payment.Root component
@@ -194,6 +195,41 @@ export interface PayLaterProps extends Omit<React.HTMLAttributes<HTMLElement>, '
  * ```
  */
 export declare const PayLater: React.ForwardRefExoticComponent<PayLaterProps & React.RefAttributes<HTMLElement>>;
+/**
+ * Props for Payment.ServiceOptions component
+ */
+export interface ServiceOptionsProps {
+    asChild?: boolean;
+    /** Render prop receiving service payment options. This component renders no
+     * visible DOM element by default — it is a flags-only data component. */
+    children?: AsChildChildren<ServicePaymentOptions>;
+}
+/**
+ * Exposes service payment options via render props.
+ * Use this to determine which payment scenario to render without reading the service entity directly.
+ *
+ * Payment scenarios:
+ * - `isOnline=true, isInPerson=false, isDeposit=false` → Pay now only (Due now = total)
+ * - `isOnline=true, isInPerson=false, isDeposit=true` → Pay now + security deposit
+ * - `isOnline=true, isInPerson=true` → Radio: Pay Online / Pay on Arrival
+ * - `isOnline=false, isInPerson=true` → Pay on arrival only
+ *
+ * @component
+ * Note: This component renders no visible DOM element. It is a flags-only data
+ * component — use `asChild` with a render function to consume the flags.
+ * For the actual split amounts (deposit / pay-later), use `Payment.PayNow` and
+ * `Payment.PayLater`.
+ *
+ * @example
+ * ```tsx
+ * <Payment.ServiceOptions asChild>
+ *   {({ isOnline, isInPerson, isDeposit }) => (
+ *     // render the correct payment scenario
+ *   )}
+ * </Payment.ServiceOptions>
+ * ```
+ */
+export declare const ServiceOptions: React.ForwardRefExoticComponent<ServiceOptionsProps & React.RefAttributes<HTMLElement>>;
 /**
  * Props for Payment.LineItems component (Container Level)
  */

package/dist/react/payment/Payment.js

@@ -20,6 +20,7 @@ export const TestIds = {
     paymentLineItemTotal: 'payment-line-item-total',
     paymentLineItemSubtotal: 'payment-line-item-subtotal',
     paymentLineItemDeposit: 'payment-line-item-deposit',
+    paymentServiceOptions: 'payment-service-options',
 };
 /**
  * Root component that provides payment context to the entire app.
@@ -161,6 +162,36 @@ export const PayLater = React.forwardRef((props, ref) => {
     return (_jsx(CorePayment.Data, { children: ({ payLater, isDeposit }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payLater, isDeposit }, "data-testid": TestIds.paymentPayLater, "data-has-deposit": isDeposit, children: isDeposit && payLater && payLater.amount > 0 && (_jsx(Money, { money: payLater })) })) }));
 });
 PayLater.displayName = 'Payment.PayLater';
+/**
+ * Exposes service payment options via render props.
+ * Use this to determine which payment scenario to render without reading the service entity directly.
+ *
+ * Payment scenarios:
+ * - `isOnline=true, isInPerson=false, isDeposit=false` → Pay now only (Due now = total)
+ * - `isOnline=true, isInPerson=false, isDeposit=true` → Pay now + security deposit
+ * - `isOnline=true, isInPerson=true` → Radio: Pay Online / Pay on Arrival
+ * - `isOnline=false, isInPerson=true` → Pay on arrival only
+ *
+ * @component
+ * Note: This component renders no visible DOM element. It is a flags-only data
+ * component — use `asChild` with a render function to consume the flags.
+ * For the actual split amounts (deposit / pay-later), use `Payment.PayNow` and
+ * `Payment.PayLater`.
+ *
+ * @example
+ * ```tsx
+ * <Payment.ServiceOptions asChild>
+ *   {({ isOnline, isInPerson, isDeposit }) => (
+ *     // render the correct payment scenario
+ *   )}
+ * </Payment.ServiceOptions>
+ * ```
+ */
+export const ServiceOptions = React.forwardRef((props, ref) => {
+    const { asChild, children } = props;
+    return (_jsx(CorePayment.ServiceOptions, { children: ({ isOnline, isInPerson, isDeposit }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, customElement: children, customElementProps: { isOnline, isInPerson, isDeposit }, "data-testid": TestIds.paymentServiceOptions, "data-is-online": isOnline, "data-is-in-person": isInPerson, "data-is-deposit": isDeposit, children: null })) }));
+});
+ServiceOptions.displayName = 'Payment.ServiceOptions';
 /**
  * Container component for line items.
  * Follows the 3-level List/Options/Repeater pattern.

package/dist/services/booking/book-action/bookAction.d.ts

@@ -1,24 +1,2 @@
-/**
- * Book Action - Orchestrates the booking flow
- *
- * 1. Validates booking data with canBook()
- * 2. Creates a booking via createBooking() from API layer
- * 3. Creates a checkout via createCheckout() from API layer
- * 4. Determines if checkout is required or can be skipped
- * 5. Returns appropriate result for navigation
- */
 import { type BookActionParams, type BookResult } from './types.js';
-/**
- * Executes the complete booking flow:
- * 1. Validates that all required data is present
- * 2. Creates a booking with the selected service, time slot, and form data
- * 3. Creates a checkout session for payment (includes contact details from booking)
- * 4. Determines if checkout page is required or can be skipped
- * 5. If checkout can be skipped (free/offline), creates order directly
- * 6. Returns appropriate result for navigation
- *
- * @param params - The booking action parameters
- * @returns BookResult with either checkoutId or orderId
- * @throws Error if validation fails, or booking/checkout/order creation fails
- */
 export declare function executeBookAction(params: BookActionParams): Promise<BookResult>;

package/dist/services/booking/book-action/bookAction.js

@@ -1,35 +1,13 @@
-/**
- * Book Action - Orchestrates the booking flow
- *
- * 1. Validates booking data with canBook()
- * 2. Creates a booking via createBooking() from API layer
- * 3. Creates a checkout via createCheckout() from API layer
- * 4. Determines if checkout is required or can be skipped
- * 5. Returns appropriate result for navigation
- */
 import { createBooking } from '../../../api/create-booking/index.js';
-import { createCheckout } from '../../../api/create-checkout/index.js';
-import { createOrder } from '../../../api/create-order/index.js';
+import { createCart } from '../../../api/create-cart/index.js';
+import { calculateCart } from '../../../api/calculate-cart/index.js';
+import { placeOrder } from '../../../api/place-order/index.js';
 import { buildBookingRequest } from './buildBookingRequest.js';
-import { buildCheckoutRequest } from './buildCheckoutRequest.js';
+import { buildCartRequest } from './buildCartRequest.js';
 import { canBook } from './canBook.js';
 import { isCheckoutRequired } from './isCheckoutRequired.js';
 import { BookResultType, } from './types.js';
-/**
- * Executes the complete booking flow:
- * 1. Validates that all required data is present
- * 2. Creates a booking with the selected service, time slot, and form data
- * 3. Creates a checkout session for payment (includes contact details from booking)
- * 4. Determines if checkout page is required or can be skipped
- * 5. If checkout can be skipped (free/offline), creates order directly
- * 6. Returns appropriate result for navigation
- *
- * @param params - The booking action parameters
- * @returns BookResult with either checkoutId or orderId
- * @throws Error if validation fails, or booking/checkout/order creation fails
- */
 export async function executeBookAction(params) {
-    // Step 0: Validate
     if (!canBook({
         serviceSelections: params.serviceSelections,
         formSubmission: params.formSubmission,
@@ -48,34 +26,37 @@ export async function executeBookAction(params) {
     if (!bookingId) {
         throw new Error('Failed to create booking');
     }
-    // Step 2: Create checkout
-    // businessLocationId: prefer timeSlot.location, fallback to global location
+    // Step 2: Create cart
     const firstSelection = params.serviceSelections[0];
     if (!firstSelection) {
         throw new Error('No service selection found');
     }
     const businessLocationId = firstSelection.timeSlot?.location?._id ?? undefined;
-    const checkoutRequest = buildCheckoutRequest({
+    const cartRequest = buildCartRequest({
         bookingId,
         contactDetails,
         businessLocationId,
         appId: params.appId,
     });
-    const checkoutResponse = await createCheckout(checkoutRequest);
-    const checkout = checkoutResponse.checkout;
-    if (!checkout?._id) {
-        throw new Error('Failed to create checkout');
+    const cart = await createCart(cartRequest);
+    if (!cart._id) {
+        throw new Error('Failed to create cart');
     }
-    // Step 3: Determine if checkout is required or can be skipped
+    // Step 3: Calculate cart to get totals (not stored on Cart V2 entity)
+    const { cart: calculatedCart, summary } = await calculateCart(cart._id);
+    if (!calculatedCart || !summary) {
+        throw new Error('Failed to calculate cart');
+    }
+    // Step 4: Determine if checkout is required or can be skipped
     const service = firstSelection.service;
-    if (isCheckoutRequired(checkout, service)) {
-        return { type: BookResultType.CheckoutRequired, checkoutId: checkout._id };
+    if (isCheckoutRequired(calculatedCart, summary, service)) {
+        return { type: BookResultType.CheckoutRequired, cartId: cart._id };
     }
-    // Step 4: Skip checkout - create order directly
-    const orderResponse = await createOrder(checkout._id);
+    // Step 5: Skip checkout — place order directly
+    const orderResponse = await placeOrder(cart._id);
     const orderId = orderResponse.orderId;
     if (!orderId) {
-        throw new Error('Failed to create order');
+        throw new Error('Failed to place order');
     }
     return { type: BookResultType.CheckoutSkipped, orderId };
 }

package/dist/services/booking/book-action/buildCartRequest.d.ts

@@ -0,0 +1,10 @@
+import { type CreateCartOptions } from '../../../api/create-cart/index.js';
+import type { ContactDetails } from '../../../api/create-booking/index.js';
+export interface BuildCartParams {
+    bookingId: string;
+    contactDetails?: ContactDetails;
+    businessLocationId?: string;
+    /** Optional app ID override for the catalog reference. Defaults to BOOKING_APP_ID. */
+    appId?: string;
+}
+export declare function buildCartRequest(params: BuildCartParams): CreateCartOptions;

package/dist/services/booking/book-action/buildCartRequest.js

@@ -0,0 +1,34 @@
+import { ChannelType, } from '../../../api/create-cart/index.js';
+import { BOOKING_APP_ID } from '../../constants.js';
+export function buildCartRequest(params) {
+    const { bookingId, contactDetails, businessLocationId, appId } = params;
+    const cart = {
+        source: { channelType: ChannelType.WEB },
+    };
+    if (businessLocationId) {
+        cart.businessInfo = { locationId: businessLocationId };
+    }
+    if (contactDetails) {
+        cart.customerInfo = {
+            ...(contactDetails.email ? { email: contactDetails.email } : {}),
+        };
+        if (contactDetails.fullAddress?.country) {
+            cart.deliveryInfo = { address: { ...contactDetails.fullAddress } };
+            cart.paymentInfo = {
+                billingAddress: { ...contactDetails.fullAddress },
+            };
+        }
+    }
+    return {
+        catalogItems: [
+            {
+                quantity: 1,
+                catalogReference: {
+                    catalogItemId: bookingId,
+                    appId: appId ?? BOOKING_APP_ID,
+                },
+            },
+        ],
+        cart,
+    };
+}

package/dist/services/booking/book-action/index.d.ts

@@ -4,6 +4,6 @@
 export { executeBookAction } from './bookAction.js';
 export { canBook, type CanBookParams } from './canBook.js';
 export { buildBookingRequest } from './buildBookingRequest.js';
-export { buildCheckoutRequest, type BuildCheckoutParams, } from './buildCheckoutRequest.js';
+export { buildCartRequest, type BuildCartParams } from './buildCartRequest.js';
 export { isCheckoutRequired } from './isCheckoutRequired.js';
 export { BookResultType, type BookProps, type BookResult, type BookingError, type BookActionParams, type BookChildProps, } from './types.js';

package/dist/services/booking/book-action/index.js

@@ -4,6 +4,6 @@
 export { executeBookAction } from './bookAction.js';
 export { canBook } from './canBook.js';
 export { buildBookingRequest } from './buildBookingRequest.js';
-export { buildCheckoutRequest, } from './buildCheckoutRequest.js';
+export { buildCartRequest } from './buildCartRequest.js';
 export { isCheckoutRequired } from './isCheckoutRequired.js';
 export { BookResultType, } from './types.js';

package/dist/services/booking/book-action/isCheckoutRequired.d.ts

@@ -1,20 +1,4 @@
-/**
- * Determines if checkout page is required based on payment amounts
- */
-import type { Checkout } from '@wix/auto_sdk_ecom_checkout';
+import type { Cart } from '../../../api/create-cart/index.js';
+import type { CartSummary } from '../../../api/calculate-cart/index.js';
 import type { Service } from '@wix/auto_sdk_bookings_services';
-/**
- * Determines if checkout page is required based on payment amounts.
- *
- * Skip checkout when:
- * - Free booking: payNow = 0 AND payLater = 0
- * - Offline payment: payNow = 0
- *
- * Force checkout when:
- * - Service has cancellation fee policy
- *
- * @param checkout - The checkout response from createCheckout
- * @param service - The service being booked
- * @returns true if checkout page is required, false if can skip to order
- */
-export declare function isCheckoutRequired(checkout: Checkout, service: Service): boolean;
+export declare function isCheckoutRequired(cart: Cart, summary: CartSummary, service: Service): boolean;