declineBooking( )

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. In such cases, Wix Bookings automatically updates the booking status based on the paymentStatus of the corresponding Wix eCommerce order.

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 method doesn't support this scenario.

When to call Confirm Or Decline Booking instead

Decline Booking doesn't check whether a slot or schedule is still available. For these checks you can call Confirm or Decline Booking.

Original status validation

You can only decline bookings with a status of PENDING, CREATED, or WAITING_LIST.

Payment status

Also updates the booking's paymentStatus, if you specify a new payment status.

Notify customers

You can specify a participantNotification.message for the customer. To send the message, you must also specify participantNotification.notifyParticipants as true.