POST

Decline Multi Service Booking

Updates the status for all single-service bookings in a multi-service booking to DECLINED.

Call this method to reject multi-service bookings that can't be accommodated or don't meet business requirements.

Status requirements

  • Original status: All single-service bookings must have PENDING, CREATED, or WAITING_LIST status.
  • Target status: All bookings move to DECLINED together (all-or-nothing operation).

Checkout restrictions

Only call this method if the customer paid via a custom checkout. For Wix eCommerce checkouts, Wix Bookings automatically manages the bookings' statuses based on payment processing.

Additional updates

  • Payment status: Updates if you specify a new declineBookingsInfo.paymentStatus.
  • Customer notifications: Send messages using participantNotification.
  • Revision control: Requires current revision numbers for all single-service bookings.

Refer to Decline Booking for more details about declining single-service bookings.

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/multi_service_bookings/{multiServiceBookingId}/decline
Errors
400Invalid Argument

There are 3 errors with this status code.

403Permission Denied

There is 1 error with this status code.

404Not Found

There are 2 errors with this status code.

428Failed Precondition

There are 3 errors with this status code.

500Internal

There is 1 error with this status code.

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

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