@wix/auto_sdk_bookings_bookings 1.0.94 → 1.0.95

package/build/es/index.typings.d.mts

@@ -85,7 +85,9 @@ interface Booking extends BookingParticipantsInfoOneOf {
     /**
      * Payment option selected by the customer. If the customer hasn't completed their checkout, they may still change the payment method. Must be one of the payment options offered by the [service](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/introduction), unless `skipSelectedPaymentOptionValidation` is `true`.
      *
-     * When undefined during an [eCommerce checkout](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/checkout/introduction), Wix Bookings uses the service's default payment option
+     * When the customer pays with a [Wix eCommerce checkout](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/checkout/introduction), this field is required.
+     * Otherwise, the Create Booking call fails.
+     * For custom checkouts, you don't have to specify this field.
      */
     selectedPaymentOption?: SelectedPaymentOptionWithLiterals;
     /**
@@ -3954,10 +3956,18 @@ declare function onBookingNumberOfParticipantsUpdated(handler: (event: BookingNu
  *
  * ### eCommerce checkout restriction
  *
- * Call this method only when using a custom checkout page. Don't
- * call it when using a [Wix eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction).
- * In such cases, Wix automatically updates the booking status based on
- * the `paymentStatus` of the corresponding [Wix eCommerce order](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction).
+ * Call this method only when using a custom checkout page.
+ * Don't call it when using a [Wix eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction).
+ * In such cases, Wix Bookings automatically updates the booking status based on the `paymentStatus` of the corresponding [Wix eCommerce order](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction).
+ *
+ * ### When to call Confirm Booking or Decline Booking instead
+ *
+ * This method has specific limitations based on payment status and double booking conflicts.
+ * Use the alternative methods in these scenarios:
+ * + **To force confirm double-booked free bookings:** Call [Confirm Booking](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-booking).
+ * Confirm Or Decline Booking can't confirm double-booked free bookings.
+ * + **To decline bookings without double booking conflicts:** Call [Decline Booking](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/decline-booking).
+ * Confirm Or Decline Booking only declines bookings when both a double booking conflict exists and payment status is unpaid.
  *
  * ### New booking status
  *
@@ -4562,6 +4572,10 @@ interface RemoveBookingsFromMultiServiceBookingOptions {
  *
  * The specified `selectedPaymentOption` indicates how the customer intends to pay, allowing for later changes to a different method supported by the service.
  *
+ * When the customer pays with a [Wix eCommerce checkout](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/checkout/introduction), you must specify a `selectedPaymentOption`.
+ * Otherwise, the Create Booking call fails.
+ * For custom checkouts, you don't have to specify a `selectedPaymentOption`.
+ *
  * ### Payment status
  *
  * All bookings are created with `paymentStatus=UNDEFINED`, ignoring the payment status you specify.
@@ -4797,6 +4811,11 @@ interface RescheduleBookingOptionsParticipantsInfoOneOf {
  * In such cases, Wix automatically updates the booking status based on
  * the `paymentStatus` of the corresponding [Wix eCommerce order](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction).
  *
+ * ### When to call Confirm Booking
+ *
+ * When using a custom checkout flow for free bookings, call this method to confirm bookings even when a double booking conflict exists.
+ * The alternative [Confirm or Decline Booking](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking) method doesn't support confirming double-booked free bookings in this scenario.
+ *
  * ### When to call Confirm Or Decline Booking instead
  *
  * Confirm Booking doesn't check whether a slot or schedule is still available.
@@ -4915,22 +4934,24 @@ interface UpdateExtendedFieldsOptions {
     namespaceData: Record<string, any> | null;
 }
 /**
- * Updates the booking status to `DECLINED` and updates the relevant session's
- * `participants.approvalStatus` to `DECLINED` without checking whether the relevant
- * slot or schedule is still available.
+ * Updates the booking status to `DECLINED` without checking whether the relevant slot or schedule is still available.
  *
  *
  * ### eCommerce checkout restriction
  *
- * Call this method only when using a custom checkout page. Don't
- * call it when using a [Wix eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction).
- * In such cases, Wix automatically updates the booking status based on
- * the `paymentStatus` of the corresponding [Wix eCommerce order](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction).
+ * Call this method only when using a custom checkout page.
+ * Don't call it when using a [Wix eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction).
+ * In such cases, Wix Bookings automatically updates the booking status based on the `paymentStatus` of the corresponding [Wix eCommerce order](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction).
+ *
+ * ### When to call Decline Booking
+ *
+ * When using a custom checkout, call this method to decline bookings that don't have a double booking conflict.
+ * The alternative [Confirm or Decline Booking](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking) method doesn't support this scenario.
  *
  * ### When to call Confirm Or Decline Booking instead
  *
- * The method doesn't check whether a slot or schedule is still available. For
- * these checks you can call [Confirm or Decline Booking](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking).
+ * Decline Booking doesn't check whether a slot or schedule is still available.
+ * For these checks you can call [Confirm or Decline Booking](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking).
  *
  * ### Original status validation
  *