POST

Decline Booking


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.

Authentication

This method may require higher-level permissions than the caller has, based on their identity and roles and permissions. In these cases, you can ensure the method is called with the required level of authorization by using one of the following:

Permissions
Manage Bookings
Learn more about app permissions.
Method Declaration
Copy
Errors
404Not Found

There is 1 error with this status code.

428Failed Precondition

There are 2 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?