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

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/_api/bookings-service/v2/bookings/{bookingId}/decline

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?