@wix/auto_sdk_bookings_bookings 1.0.60 → 1.0.62

package/build/cjs/index.d.ts

@@ -98,12 +98,18 @@ interface CreateBookingSignature {
      * We recommend following [this sample flow](https://dev.wix.com/docs/rest/business-solutions/bookings/end-to-end-booking-flows#book-a-course)
      * to minimize failed calls due to unavailability.
      *
+     * ### Booking status
+     *
+     * Create Booking defaults to `status=CREATED`. Such bookings aren't visible in the [Booking Calendar](https://support.wix.com/en/article/wix-bookings-about-the-wix-booking-calendar).
+     *
+     * Only [identities](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities) with `Manage Bookings` permissions can set `status=CONFIRMED`.
+     *
      * ### Related resources
      *
-     * Specifying a `resource` triggers an availability check, resulting in a failed
-     * call if the resource is unavailable. Omitting a resource allows Wix Bookings
-     * to assign a resource belonging to the relevant type randomly when the merchant
-     * confirms the booking.
+     * Specifying a `resource` triggers an availability check, and the Create Booking call fails if the resource is unavailable.
+     *
+     * If you omit `resource`, resource assignment and availability validation occur during booking confirmation.
+     * If no resources are available, the behavior depends on the confirmation method used and payment status.
      *
      * ### Participant information
      *
@@ -121,32 +127,17 @@ interface CreateBookingSignature {
      * If you specify `{"sendSmsReminder": true}`, the customer receives an SMS 24 hours
      * before the session starts. The phone number is taken from `contactDetails.phone`.
      *
-     * ### Booking status
-     *
-     * Bookings default to the `CREATED` status, not affecting the business calendar
-     * or resource availability. You can specify a different status when the calling
-     * [identity](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities)
-     * has `Manage Bookings` permissions.
-     *
      * ### Payment options
      *
-     * The specified `selectedPaymentOption` indicates how the customer intends to
-     * pay, allowing for later changes to a different method supported by the service.
+     * The specified `selectedPaymentOption` indicates how the customer intends to pay, allowing for later changes to a different method supported by the service.
      *
      * ### Payment status
      *
-     * A booking is initially created with `{"paymentStatus": "UNDEFINED"}` regardless
-     * of the payment status specified in Create Booking. If a customer uses an
-     * _eCommerce checkout_
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)),
-     * Wix Bookings automatically syncs the booking's payment status from
-     * the corresponding eCommerce order
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction)).
+     * All bookings are created with `paymentStatus=UNDEFINED`, ignoring the payment status you specify.
      *
-     * If a booking doesn't have a corresponding eCommerce order, for example, since
-     * the customer didn't use the eCommerce checkout, you can update the booking's
-     * payment status with Confirm Or Decline Booking
-     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings/confirm-or-decline-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking)).
+     * For customers paying with a Wix eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/checkout/checkout/introduction)), Wix Bookings automatically syncs the booking's payment status from the corresponding eCommerce order ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction)).
+     *
+     * For customers using a custom checkout, call Confirm or Decline Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings/confirm-or-decline-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking)) to update booking's payment status manually.
      *
      * ### Booking form data
      *