About the Bookings API

Use this API to manage bookings to a site's services.

A booking is an entity that represents a session that was ordered (but not necessarily paid for) for a specific time and rate for a specific customer. A customer can book a single class or an appointment (= session), or book an bundle of sessions at once, e.g., a course (= schedule).

A booking contains the following:

• Customer information: Contact details (contact ID, name, email, address, phone number), and any additional fields set by the owner - under formInfo.
• Booked session details: Session name, date, start & end time, location and rate.
• Payment details: Final price that the customer is being charged, payment option the customer chose when booking (online payment, in-person payment, membership) and the payment method used in case of an online payment (e.g., credit card, Paypal). Will also contain coupon code if entered during checkout.
• Status: Current booking status (confirmed, declined, canceled, etc.).

Terminology

• Visitor: Anyone who is not registered as a member in the Wix site (upon booking, visitors are registered as contacts).
• Member: Someone who is registered as a member in the Wix site.
• Owner: The Wix site owner (who has Wix Bookings installed).
• Slot: An available period of time in a schedule that can be booked by a customer. While this includes existing sessions that are available for booking, it can also represent a period of time that can be booked based on the availability of a resource (e.g., a barber with appointments of 30 minutes each that are open for booking every weekday between 8:00 - 17:00). These slots are calculated by the constraints of the schedule.
• Wix Paid Plans: A pre-paid bundle of services or membership including access to certain services. Access a member's pricing plans by calling the Checkout Options endpoint with the member's contact ID.

Bookings Statuses

Each booking has a status. Statuses include:

• Confirmed: When the session is free, when payment is expected in person, or when online payment was approved.
• Pending: When a booking requires the owner's approval, it is "pending" until the owner either confirms or declines the booking. In addition, if a customer is booked to a waitlist, the booking will be "pending" until it is added to the session.
• Pending Checkout: When the booking's online payment is waiting for payment approval. Will automatically change to "confirmed" when the payment is approved.
• Declined: When the owner has declined a booking that requires their approval.
• Canceled: When the customer or the business owner has canceled the previously confirmed booking.

Use Cases

Bookings V1 has been replaced with Bookings V2 and will be removed on December 31, 2024. For use cases your app could support, refer to the Bookings V2 sample flows.