POST

Confirm Or Decline Booking


Developer Preview

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:

  • You provide UNDEFINED, NOT_PAID, REFUNDED, or EXEMPT as payment status.
  • There is a double booking conflict.

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:

  • If the booking's 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.
  • If the booking's flowControlSettings.skipBusinessConfirmation was set to true, the booking skips PENDING status and is marked CONFIRMED immediately.
Authentication

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

Permissions
Manage Bookings - all permissions
Manage Bookings
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/bookings/v2/confirmation/{bookingId}:confirmOrDecline

Errors
404Not Found

There is 1 error with this status code:

428Failed Precondition

There is 1 error with this status code:

See the entire list and learn more about Wix errors.

Did this help?