@wix/headless-bookings 1.0.17 → 1.0.18

package/cjs/dist/__mocks__/booking/booking-client-service.js

@@ -29,18 +29,20 @@ function createMockSignalsService() {
     };
 }
 function createMockBookingService(config = {}) {
-    const { serviceSelections = [], location = null, timezone = 'UTC', formSubmission = null, selectedPaymentOption, } = config;
+    const { serviceSelections = [], location = null, timezone = 'UTC', formSubmission = null, selectedPaymentOption, depositSelected, } = config;
     const serviceSelectionsSignal = mockSignal(serviceSelections);
     const locationSignal = mockSignal(location);
     const timezoneSignal = mockSignal(timezone);
     const formSubmissionSignal = mockSignal(formSubmission);
     const selectedPaymentOptionSignal = mockSignal(selectedPaymentOption);
+    const depositSelectedSignal = mockSignal(depositSelected);
     return {
         serviceSelections: serviceSelectionsSignal,
         location: locationSignal,
         timezone: timezoneSignal,
         formSubmission: formSubmissionSignal,
         selectedPaymentOption: selectedPaymentOptionSignal,
+        depositSelected: depositSelectedSignal,
         actions: {
             updateItem: vitest_1.vi.fn(),
             setItem: vitest_1.vi.fn(),
@@ -56,6 +58,7 @@ function createMockBookingService(config = {}) {
             setFormSubmission: vitest_1.vi.fn(),
             clearFormSubmission: vitest_1.vi.fn(),
             setSelectedPaymentOption: vitest_1.vi.fn(),
+            setDepositSelected: vitest_1.vi.fn(),
             setAllDay: vitest_1.vi.fn(),
             clearAll: vitest_1.vi.fn(),
             book: vitest_1.vi.fn(),

package/cjs/dist/__mocks__/services/services-mocks.d.ts

@@ -158,6 +158,19 @@ export declare function createLargeStaffMemberList(count: number): StaffMember[]
  * Mock service with deposit configured
  */
 export declare const mockServiceWithDeposit: Service;
+/** Deposit set as a fixed amount under `depositDetails`, the newer field. */
+export declare const mockServiceDepositDetailsAmount: Service;
+/** Percentage deposit: `options.deposit` set, no amount anywhere on the entity. */
+export declare const mockServicePercentageDeposit: Service;
+/**
+ * Mock service with a deposit that may also be paid in full upfront — the only
+ * configuration where `booking.depositSelected` may be `false`.
+ */
+export declare const mockServiceWithDepositFullUpfront: Service;
+/**
+ * Mock VARIED-rate service with a deposit (both under `payment.varied`).
+ */
+export declare const mockServiceVariedWithDeposit: Service;
 /**
  * Mock service with in-person payment option
  */

package/cjs/dist/__mocks__/services/services-mocks.js

@@ -3,7 +3,7 @@
  * Shared mock data for booking service tests
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockServiceInPerson = exports.mockServiceWithDeposit = exports.mockSingleStaffMemberListConfig = exports.mockEmptyStaffMemberListConfig = exports.mockStaffMemberListConfig = exports.mockStaffMembers = exports.mockStaffMemberNoName = exports.mockStaffMemberMinimal = exports.mockStaffMember2 = exports.mockStaffMember = exports.mockAvailabilityFilter = exports.mockAvailabilityPagingMetadataLast = exports.mockAvailabilityPagingMetadata = exports.mockServicesWithAvailability = exports.mockServiceListConfigWithCategories = exports.mockCategories = exports.mockServiceConfig = exports.mockEmptyServiceListConfig = exports.mockServiceListConfigWithMore = exports.mockServiceListConfig = exports.mockPagingMetadataEmpty = exports.mockPagingMetadataWithMore = exports.mockPagingMetadata = exports.mockServices = exports.mockServiceDayRange = exports.mockServiceHourRange = exports.mockServiceFixedDuration = exports.mockServiceMinimal = exports.mockServiceCourse = exports.mockServiceClass = exports.mockServiceNoFee = exports.mockServiceCustomPrice = exports.mockServiceVariedPrice = exports.mockService = void 0;
+exports.mockServiceInPerson = exports.mockServiceVariedWithDeposit = exports.mockServiceWithDepositFullUpfront = exports.mockServicePercentageDeposit = exports.mockServiceDepositDetailsAmount = exports.mockServiceWithDeposit = exports.mockSingleStaffMemberListConfig = exports.mockEmptyStaffMemberListConfig = exports.mockStaffMemberListConfig = exports.mockStaffMembers = exports.mockStaffMemberNoName = exports.mockStaffMemberMinimal = exports.mockStaffMember2 = exports.mockStaffMember = exports.mockAvailabilityFilter = exports.mockAvailabilityPagingMetadataLast = exports.mockAvailabilityPagingMetadata = exports.mockServicesWithAvailability = exports.mockServiceListConfigWithCategories = exports.mockCategories = exports.mockServiceConfig = exports.mockEmptyServiceListConfig = exports.mockServiceListConfigWithMore = exports.mockServiceListConfig = exports.mockPagingMetadataEmpty = exports.mockPagingMetadataWithMore = exports.mockPagingMetadata = exports.mockServices = exports.mockServiceDayRange = exports.mockServiceHourRange = exports.mockServiceFixedDuration = exports.mockServiceMinimal = exports.mockServiceCourse = exports.mockServiceClass = exports.mockServiceNoFee = exports.mockServiceCustomPrice = exports.mockServiceVariedPrice = exports.mockService = void 0;
 exports.createLargeServiceList = createLargeServiceList;
 exports.createLargeStaffMemberList = createLargeStaffMemberList;
 const auto_sdk_bookings_services_1 = require("@wix/auto_sdk_bookings_services");
@@ -540,6 +540,97 @@ exports.mockServiceWithDeposit = {
         },
     },
 };
+/** Deposit set as a fixed amount under `depositDetails`, the newer field. */
+exports.mockServiceDepositDetailsAmount = {
+    ...exports.mockService,
+    _id: 'test-service-deposit-details-amount',
+    name: 'Deposit Details Amount Service',
+    payment: {
+        rateType: auto_sdk_bookings_services_1.RateType.FIXED,
+        fixed: {
+            price: {
+                value: '100.00',
+                currency: 'USD',
+            },
+            depositDetails: {
+                amount: {
+                    value: '25.00',
+                    currency: 'USD',
+                },
+            },
+        },
+        options: {
+            online: true,
+            deposit: true,
+        },
+    },
+};
+/** Percentage deposit: `options.deposit` set, no amount anywhere on the entity. */
+exports.mockServicePercentageDeposit = {
+    ...exports.mockService,
+    _id: 'test-service-percentage-deposit',
+    name: 'Percentage Deposit Service',
+    payment: {
+        rateType: auto_sdk_bookings_services_1.RateType.FIXED,
+        fixed: {
+            price: {
+                value: '10',
+                currency: 'USD',
+            },
+            fullUpfrontPaymentAllowed: true,
+        },
+        options: {
+            online: true,
+            inPerson: false,
+            deposit: true,
+        },
+    },
+};
+/**
+ * Mock service with a deposit that may also be paid in full upfront — the only
+ * configuration where `booking.depositSelected` may be `false`.
+ */
+exports.mockServiceWithDepositFullUpfront = {
+    ...exports.mockService,
+    _id: 'test-service-deposit-full-upfront',
+    name: 'Service with Deposit and Full Upfront Allowed',
+    payment: {
+        rateType: auto_sdk_bookings_services_1.RateType.FIXED,
+        fixed: {
+            price: {
+                value: '100.00',
+                currency: 'USD',
+            },
+            deposit: {
+                value: '30.00',
+                currency: 'USD',
+            },
+            fullUpfrontPaymentAllowed: true,
+        },
+    },
+};
+/**
+ * Mock VARIED-rate service with a deposit (both under `payment.varied`).
+ */
+exports.mockServiceVariedWithDeposit = {
+    ...exports.mockService,
+    _id: 'test-service-varied-deposit',
+    name: 'Varied Service with Deposit',
+    payment: {
+        rateType: auto_sdk_bookings_services_1.RateType.VARIED,
+        varied: {
+            defaultPrice: {
+                value: '80.00',
+                currency: 'USD',
+            },
+            deposit: {
+                value: '20.00',
+                currency: 'USD',
+            },
+            fullUpfrontPaymentAllowed: true,
+        },
+    },
+};
 /**
  * Mock service with in-person payment option
  */

package/cjs/dist/react/core/booking/Booking.d.ts

@@ -45,6 +45,12 @@ export interface BookingData {
      * heuristic applies. Set via `actions.setSelectedPaymentOption`.
      */
     selectedPaymentOption: SelectedPaymentOption | undefined;
+    /**
+     * Deposit-vs-full-upfront choice. `true` pays only the deposit now, `false`
+     * pays the full price now, `undefined` means not chosen. Set via
+     * `actions.setDepositSelected`.
+     */
+    depositSelected: boolean | undefined;
     actions: BookingServiceActions;
 }
 /**

package/cjs/dist/react/core/booking/Booking.js

@@ -118,6 +118,7 @@ function Data(props) {
     const timezone = bookingService.timezone.get();
     const formSubmission = bookingService.formSubmission.get();
     const selectedPaymentOption = bookingService.selectedPaymentOption.get();
+    const depositSelected = bookingService.depositSelected.get();
     const { actions } = bookingService;
     const location = resolveLocation(bookingLocation, serviceSelections);
     return children({
@@ -126,6 +127,7 @@ function Data(props) {
         timezone,
         formSubmission,
         selectedPaymentOption,
+        depositSelected,
         actions,
     });
 }

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

@@ -172,7 +172,8 @@ export interface ServiceOptionsProps {
 }
 /**
  * Core component that exposes service payment options via render props.
- * Reads isOnline, isInPerson, isDeposit from the payment service signal.
+ * Reads isOnline, isInPerson, isDeposit, canPayFullUpfront from the payment
+ * service signal.
  *
  * @component
  */

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

@@ -93,10 +93,12 @@ function Data(props) {
     const additionalInfoList = paymentDetails?.additionalInfo?.lineItems || [];
     const firstLineItemInfo = additionalInfoList[0];
     const customPrice = firstLineItemInfo?.customPrice || null;
-    // Computed flags
-    const hasTax = tax !== null && tax.amount > 0;
-    const hasDiscount = discount !== null && discount.amount > 0;
-    const isDeposit = payNow !== null && total !== null && payNow.amount < total.amount;
+    // Computed flags (amounts may be strings — compare numerically)
+    const hasTax = tax !== null && Number(tax.amount) > 0;
+    const hasDiscount = discount !== null && Number(discount.amount) > 0;
+    const isDeposit = payNow !== null &&
+        total !== null &&
+        Number(payNow.amount) < Number(total.amount);
     return props.children({
         subtotal,
         total,
@@ -202,7 +204,8 @@ function LineItemProvider(props) {
 }
 /**
  * Core component that exposes service payment options via render props.
- * Reads isOnline, isInPerson, isDeposit from the payment service signal.
+ * Reads isOnline, isInPerson, isDeposit, canPayFullUpfront from the payment
+ * service signal.
  *
  * @component
  */
@@ -229,9 +232,9 @@ function ServiceOptions(props) {
  */
 function LineItemInfo(props) {
     const { lineItem, currency } = useLineItemContext();
-    // Computed flags
-    const hasDiscount = lineItem.discount !== null && lineItem.discount.amount > 0;
-    const hasDeposit = lineItem.deposit !== null && lineItem.deposit.amount > 0;
+    // Computed flags (amounts may be strings — compare numerically)
+    const hasDiscount = lineItem.discount !== null && Number(lineItem.discount.amount) > 0;
+    const hasDeposit = lineItem.deposit !== null && Number(lineItem.deposit.amount) > 0;
     return props.children({
         lineItem,
         currency,

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

@@ -210,7 +210,8 @@ export interface ServiceOptionsProps {
  *
  * 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=false, isDeposit=true, canPayFullUpfront=false` → Pay now + security deposit
+ * - `isOnline=true, isInPerson=false, isDeposit=true, canPayFullUpfront=true` → Radio: Pay deposit now / Pay in full now
  * - `isOnline=true, isInPerson=true` → Radio: Pay Online / Pay on Arrival
  * - `isOnline=false, isInPerson=true` → Pay on arrival only
  *
@@ -223,7 +224,7 @@ export interface ServiceOptionsProps {
  * @example
  * ```tsx
  * <Payment.ServiceOptions asChild>
- *   {({ isOnline, isInPerson, isDeposit }) => (
+ *   {({ isOnline, isInPerson, isDeposit, canPayFullUpfront }) => (
  *     // render the correct payment scenario
  *   )}
  * </Payment.ServiceOptions>

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

@@ -183,7 +183,7 @@ exports.Total.displayName = 'Payment.Total';
  */
 exports.PayNow = react_1.default.forwardRef((props, ref) => {
     const { asChild, children, className } = props;
-    return ((0, jsx_runtime_1.jsx)(CorePayment.Data, { children: ({ payNow, isDeposit }) => ((0, jsx_runtime_1.jsx)(react_2.AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payNow, isDeposit }, "data-testid": exports.TestIds.paymentPayNow, "data-has-deposit": isDeposit, children: isDeposit && payNow && payNow.amount > 0 && ((0, jsx_runtime_1.jsx)(react_3.Money, { money: payNow })) })) }));
+    return ((0, jsx_runtime_1.jsx)(CorePayment.Data, { children: ({ payNow, isDeposit }) => ((0, jsx_runtime_1.jsx)(react_2.AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payNow, isDeposit }, "data-testid": exports.TestIds.paymentPayNow, "data-has-deposit": isDeposit, children: isDeposit && payNow && Number(payNow.amount) > 0 && ((0, jsx_runtime_1.jsx)(react_3.Money, { money: payNow })) })) }));
 });
 exports.PayNow.displayName = 'Payment.PayNow';
 /**
@@ -198,7 +198,7 @@ exports.PayNow.displayName = 'Payment.PayNow';
  */
 exports.PayLater = react_1.default.forwardRef((props, ref) => {
     const { asChild, children, className } = props;
-    return ((0, jsx_runtime_1.jsx)(CorePayment.Data, { children: ({ payLater, isDeposit }) => ((0, jsx_runtime_1.jsx)(react_2.AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payLater, isDeposit }, "data-testid": exports.TestIds.paymentPayLater, "data-has-deposit": isDeposit, children: isDeposit && payLater && payLater.amount > 0 && ((0, jsx_runtime_1.jsx)(react_3.Money, { money: payLater })) })) }));
+    return ((0, jsx_runtime_1.jsx)(CorePayment.Data, { children: ({ payLater, isDeposit }) => ((0, jsx_runtime_1.jsx)(react_2.AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payLater, isDeposit }, "data-testid": exports.TestIds.paymentPayLater, "data-has-deposit": isDeposit, children: isDeposit && payLater && Number(payLater.amount) > 0 && ((0, jsx_runtime_1.jsx)(react_3.Money, { money: payLater })) })) }));
 });
 exports.PayLater.displayName = 'Payment.PayLater';
 /**
@@ -207,7 +207,8 @@ exports.PayLater.displayName = 'Payment.PayLater';
  *
  * 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=false, isDeposit=true, canPayFullUpfront=false` → Pay now + security deposit
+ * - `isOnline=true, isInPerson=false, isDeposit=true, canPayFullUpfront=true` → Radio: Pay deposit now / Pay in full now
  * - `isOnline=true, isInPerson=true` → Radio: Pay Online / Pay on Arrival
  * - `isOnline=false, isInPerson=true` → Pay on arrival only
  *
@@ -220,7 +221,7 @@ exports.PayLater.displayName = 'Payment.PayLater';
  * @example
  * ```tsx
  * <Payment.ServiceOptions asChild>
- *   {({ isOnline, isInPerson, isDeposit }) => (
+ *   {({ isOnline, isInPerson, isDeposit, canPayFullUpfront }) => (
  *     // render the correct payment scenario
  *   )}
  * </Payment.ServiceOptions>
@@ -228,7 +229,12 @@ exports.PayLater.displayName = 'Payment.PayLater';
  */
 exports.ServiceOptions = react_1.default.forwardRef((props, ref) => {
     const { asChild, children } = props;
-    return ((0, jsx_runtime_1.jsx)(CorePayment.ServiceOptions, { children: ({ isOnline, isInPerson, isDeposit }) => ((0, jsx_runtime_1.jsx)(react_2.AsChildSlot, { ref: ref, asChild: asChild, customElement: children, customElementProps: { isOnline, isInPerson, isDeposit }, "data-testid": exports.TestIds.paymentServiceOptions, "data-is-online": isOnline, "data-is-in-person": isInPerson, "data-is-deposit": isDeposit, children: null })) }));
+    return ((0, jsx_runtime_1.jsx)(CorePayment.ServiceOptions, { children: ({ isOnline, isInPerson, isDeposit, canPayFullUpfront }) => ((0, jsx_runtime_1.jsx)(react_2.AsChildSlot, { ref: ref, asChild: asChild, customElement: children, customElementProps: {
+                isOnline,
+                isInPerson,
+                isDeposit,
+                canPayFullUpfront,
+            }, "data-testid": exports.TestIds.paymentServiceOptions, "data-is-online": isOnline, "data-is-in-person": isInPerson, "data-is-deposit": isDeposit, "data-can-pay-full-upfront": canPayFullUpfront, children: null })) }));
 });
 exports.ServiceOptions.displayName = 'Payment.ServiceOptions';
 /**

package/cjs/dist/services/booking/book-action/buildBookingRequest.js

@@ -7,6 +7,7 @@ exports.buildBookingRequest = buildBookingRequest;
 const auto_sdk_bookings_availability_time_slots_1 = require("@wix/auto_sdk_bookings_availability-time-slots");
 const auto_sdk_bookings_bookings_1 = require("@wix/auto_sdk_bookings_bookings");
 const constants_js_1 = require("../../constants.js");
+const servicePayment_js_1 = require("../../servicePayment.js");
 /**
  * Derives the selected payment option from service payment settings.
  * Maps service.payment.options to booking API's selectedPaymentOption.
@@ -56,12 +57,20 @@ function buildBookingRequest(params) {
     const resource = item.timeSlot.resources?.[0] ?? item.resources?.[0];
     // Get location: prefer timeSlot.location, fallback to params.location
     const slotLocation = item.timeSlot.location ?? location;
+    // Consumer override (if set) wins over the service-config heuristic.
+    const selectedPaymentOption = params.selectedPaymentOption ?? deriveSelectedPaymentOption(item.service);
+    // The only state where the schema allows `false`. Outside it, omitting the key
+    // leaves the server default in place.
+    const depositSelectedApplies = params.depositSelected !== undefined &&
+        selectedPaymentOption === 'ONLINE' &&
+        (0, servicePayment_js_1.requiresDeposit)(item.service) &&
+        (0, servicePayment_js_1.isFullUpfrontPaymentAllowed)(item.service);
     return {
         booking: {
-            // Payment option: consumer override (if set) wins over the
-            // service-config heuristic.
-            selectedPaymentOption: params.selectedPaymentOption ??
-                deriveSelectedPaymentOption(item.service),
+            selectedPaymentOption,
+            ...(depositSelectedApplies && {
+                depositSelected: params.depositSelected,
+            }),
             // Participants
             totalParticipants: item.totalParticipants || 1,
             // App that created the booking (used to filter bookings by source app).

package/cjs/dist/services/booking/book-action/types.d.ts

@@ -59,6 +59,12 @@ export interface BookActionParams {
      * service. When omitted, the existing service-config heuristic applies.
      */
     selectedPaymentOption?: SelectedPaymentOption;
+    /**
+     * Optional consumer choice: `true` pays only the deposit now, `false` pays the
+     * full price now. Dropped unless the booking is ONLINE and the service has a
+     * deposit with `fullUpfrontPaymentAllowed`. Omit to keep the server default.
+     */
+    depositSelected?: boolean;
     /**
      * DAY-range only. When `true`, the picked per-day slots are collapsed into a
      * single Booking spanning the whole range (`firstSlot.startDate ->

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

@@ -89,6 +89,12 @@ export interface BookingServiceActions {
      * is cleared and the heuristic applies again.
      */
     setSelectedPaymentOption(value: SelectedPaymentOption | null): void;
+    /**
+     * Set (or clear with `undefined`) the deposit-vs-full-upfront choice. `true`
+     * charges only the deposit now, `false` charges the full price now. Gate the UI
+     * on `Payment.ServiceOptions`' `isDeposit && canPayFullUpfront`.
+     */
+    setDepositSelected(value: boolean | undefined): void;
     /**
      * Toggle the DAY-range `allDay` flag. When `true`, `book()` collapses the
      * picked per-day slots into one range-spanning Booking created via
@@ -117,6 +123,12 @@ export interface BookingService {
      * service-config heuristic. Set to `'ONLINE'` or `'OFFLINE'` to override.
      */
     selectedPaymentOption: Signal<SelectedPaymentOption | undefined>;
+    /**
+     * Signal containing the deposit-vs-full-upfront choice. `true` pays only the
+     * deposit now, `false` pays the full price now. `undefined` means "not chosen"
+     * — `book()` omits the field and the preview keeps its deposit default.
+     */
+    depositSelected: Signal<boolean | undefined>;
     /** Actions for modifying booking state */
     actions: BookingServiceActions;
 }
@@ -146,6 +158,11 @@ export interface BookingServiceConfig {
      * service-config heuristic; set to `'ONLINE'` or `'OFFLINE'` to override.
      */
     selectedPaymentOption?: SelectedPaymentOption;
+    /**
+     * Optional initial deposit-vs-full-upfront choice. Omit to keep the server's
+     * default.
+     */
+    depositSelected?: boolean;
     /** Optional app ID override for the catalog reference. Defaults to the bookings app ID. */
     appId?: string;
     /**

package/cjs/dist/services/booking/booking.js

@@ -74,6 +74,7 @@ exports.BookingService = services_definitions_1.implementService.withConfig()(ex
     const timezoneSignal = signalsService.signal(config.timezone ?? getClientTimezone());
     const formSubmissionSignal = signalsService.signal(config.formSubmission || null);
     const selectedPaymentOptionSignal = signalsService.signal(config.selectedPaymentOption);
+    const depositSelectedSignal = signalsService.signal(config.depositSelected);
     // Internal-only signal: set via `setAllDay`, read by `book()`. Not
     // exposed on the service surface — consumers derive and push the value
     // (e.g. from the picker's selection mode), so there's no read-back.
@@ -176,6 +177,10 @@ exports.BookingService = services_definitions_1.implementService.withConfig()(ex
         setSelectedPaymentOption(value) {
             selectedPaymentOptionSignal.set(value ?? undefined);
         },
+        // Deposit vs full upfront action
+        setDepositSelected(value) {
+            depositSelectedSignal.set(value);
+        },
         // All-day (DAY-range) action
         setAllDay(value) {
             allDaySignal.set(value);
@@ -195,6 +200,7 @@ exports.BookingService = services_definitions_1.implementService.withConfig()(ex
             const location = locationSignal.get();
             const timezone = timezoneSignal.get();
             const selectedPaymentOption = selectedPaymentOptionSignal.get();
+            const depositSelected = depositSelectedSignal.get();
             const allDay = allDaySignal.get();
             // Validation happens inside executeBookAction
             return (0, bookAction_js_1.executeBookAction)({
@@ -205,6 +211,7 @@ exports.BookingService = services_definitions_1.implementService.withConfig()(ex
                 appId: config.appId,
                 sourceAppId: config.sourceAppId,
                 selectedPaymentOption,
+                depositSelected,
                 allDay,
             });
         },
@@ -215,6 +222,7 @@ exports.BookingService = services_definitions_1.implementService.withConfig()(ex
         timezone: timezoneSignal,
         formSubmission: formSubmissionSignal,
         selectedPaymentOption: selectedPaymentOptionSignal,
+        depositSelected: depositSelectedSignal,
         actions,
     };
 });

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

@@ -28,9 +28,12 @@ export type ErrorPaymentConfigResult = {
  * @param params.totalParticipants - Number of participants (default: 1)
  * @param params.selectedPaymentOption - Optional consumer-selected payment option;
  *   overrides the service-config heuristic on each line item's `paymentOption`.
+ * @param params.depositSelected - Optional deposit-vs-full-upfront choice; `false`
+ *   resolves a deposit service to full payment. Omit to keep the deposit default.
  */
 export declare function loadPaymentConfig(params: {
     pricingServiceSelections: PricingServiceSelection[];
     totalParticipants?: number;
     selectedPaymentOption?: SelectedPaymentOption;
+    depositSelected?: boolean;
 }): Promise<SuccessPaymentConfigResult | ErrorPaymentConfigResult>;

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

@@ -16,8 +16,17 @@ export interface ServicePaymentOptions {
     isOnline: boolean;
     /** Customer can pay in person (on arrival) */
     isInPerson: boolean;
-    /** A deposit is required at booking time */
+    /**
+     * A deposit is required at booking time — including percentage deposits, which
+     * set no amount. For the amount use `Payment.PayNow` / `Payment.PayLater`.
+     */
     isDeposit: boolean;
+    /**
+     * Customers may pay the full price upfront instead of only the deposit.
+     * Meaningful only with `isDeposit`; together they gate the
+     * deposit-vs-pay-in-full toggle.
+     */
+    canPayFullUpfront: boolean;
 }
 /**
  * Payment option for line items
@@ -83,6 +92,11 @@ export interface PaymentServiceInternalConfig extends PaymentServiceConfig {
      * set, overrides the service-config heuristic in line item `paymentOption`.
      */
     selectedPaymentOption?: SelectedPaymentOption;
+    /**
+     * Deposit-vs-full-upfront choice for lazy loading. `false` resolves a deposit
+     * service to full payment instead of `DEPOSIT_ONLINE`.
+     */
+    depositSelected?: boolean;
 }
 export interface PaymentServiceAPI {
     paymentDetailsSignal: Signal<PaymentDetails | null>;