This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Updates the booking status
to CONFIRMED
, PENDING
, or DECLINED
based
on the paymentStatus
you provide, double booking conflicts, and whether
the service requires business approval.
Call this endpoint only when using a custom checkout page. Don't
call it when using a Wix eCommerce checkout.
In such cases, Wix automatically updates the booking status based on
the paymentStatus
of the corresponding
Wix eCommerce order.
The booking status
is set to DECLINED
if both of the following conditions
are met:
UNDEFINED
, NOT_PAID
, REFUNDED
, or EXEMPT
as payment status.If only one or none of these conditions is met, status
is set to PENDING
or CONFIRMED
depending on whether the service requires business approval.
If there is a double booking conflict, doubleBooked
is set to true
.
There are small but important differences in confirmation behavior if the
booking was created with special flowControlSettings
:
flowControlSettings.skipAvailabilityValidation
was set to
true
, the booking is never declined regardless of double booking conflicts.
Instead, it's marked CONFIRMED
or PENDING
, depending on whether the
service requires business approval.flowControlSettings.skipBusinessConfirmation
was set to
true
, the booking skips PENDING
status and is marked CONFIRMED
immediately.You can only call this method when authenticated as a Wix app or Wix user identity.