Facility Booking Widget
Show facility availability, accept booking requests, and handle manager approval and booking conflicts.
Use this widget when you want to show facility availability and let users submit booking requests from your site.
What you need
Use this section to make sure the booking widget can load and show the booking form.
| Requirement | Required | Why it matters |
|---|---|---|
facility-booking-widget.js | Yes | This is the widget file for facility booking flows |
| Your API key | Yes | Authenticates requests from the widget |
data-api-key | Yes | Passes your API key into the widget |
data-enable-booking="true" | Yes, for booking form | Turns on the booking request form |
| Facility context | Yes | Tells the widget which facility to load |
Public booking endpoint
Use this section when you want to submit a booking request from your own flow instead of relying only on the widget.
POST https://dev.playrondo.com/api/dashboard/public/facilities/:facilityId/bookingsWhat happens after a booking request
Use this section to understand the approval flow after a user submits a request.
A booking request goes to the facility manager for approval.
- The user submits a booking request from your widget or booking flow.
- The request appears in the Rondo dashboard for review.
- The facility manager approves or rejects it in Rondo dashboard → Facility.
- You can set up Webhooks to receive booking lifecycle notifications.
Conflict response
Use this section to handle booking races when another request claims the same slot first.
{
"error": "Slot no longer available",
"code": "SLOT_CONFLICT"
}Widget note
Use this section to account for fixed branding in the embedded experience.
The Powered by Rondo footer appears in all widgets, and it cannot be removed.
Next step: Continue to Webhooks if facility owners need approval and status notifications.
Updated 32 minutes ago