Booking Statuses
Every booking in SlotBase has three independent status indicators: booking status, approval status, and payment status. Together, these tell you exactly where a booking stands in its lifecycle.
This page serves as a reference for all possible values and their meanings.
Booking Status
The booking status tracks the overall state of the session, from initial hold through completion.
| Status | Description | How It's Set |
|---|---|---|
| HELD | A temporary reservation has been created while the player confirms. The slot is reserved but not yet committed. | Automatically when a player selects a time slot |
| CONFIRMED | The booking is confirmed and the session is scheduled. | When the player confirms (and no approval is required), or when an admin creates a booking |
| CHECKED_IN | The player has arrived at the facility and been checked in. | Manually by an admin at the front desk |
| COMPLETED | The session time has passed and the booking is finished. | Automatically after the session end time |
| CANCELLED | The booking was cancelled by the player or an admin. | When cancel action is taken (subject to cancellation policy) |
| NO_SHOW | The player did not arrive for their session. | Manually by an admin after the session time passes |
Booking Status Flow
HELD --> CONFIRMED --> CHECKED_IN --> COMPLETED
| |
| +--> CANCELLED
| |
| +--> NO_SHOW
|
+--> (expired, slot released)
A booking in HELD status is not yet a confirmed booking. If the hold expires, no booking record is created and the slot returns to the available pool.
Approval Status
The approval status only applies when a facility has enabled the requireBookingApproval setting. It tracks whether a booking has been reviewed and approved by an admin.
| Status | Description | How It's Set |
|---|---|---|
| NOT_REQUIRED | The facility does not require approval for this booking. | Default when approval is disabled in facility settings |
| PENDING | The booking is waiting for an admin to review and approve it. | Automatically when a player confirms at a facility that requires approval |
| APPROVED | An admin has manually approved the booking. | When an admin clicks Approve |
| AUTO_APPROVED | The booking was automatically approved because the auto-approve timeout elapsed without admin action. | Automatically after the configured autoApproveAfterMins period |
| REJECTED | An admin has rejected the booking and provided a reason. | When an admin clicks Reject and enters a reason |
Approval Status Flow
NOT_REQUIRED (approval disabled)
-- or --
PENDING --> APPROVED (manual)
|
+--> AUTO_APPROVED (timeout)
|
+--> REJECTED (with reason)
When a booking is REJECTED, the player receives a notification with the admin's reason. The booking is effectively cancelled and the time slot becomes available again.
Payment Status
The payment status tracks whether the player has paid for the session.
| Status | Description | How It's Set |
|---|---|---|
| PENDING | Payment has not yet been collected. | Default for new bookings |
| PAID | The full amount has been collected. | After successful online payment or when admin records offline payment |
| PARTIAL | A partial payment has been made. | When admin records a partial payment |
| REFUNDED | The payment has been refunded to the player. | After an admin processes a refund |
| WAIVED | The fee has been waived entirely. | When an admin marks the fee as waived |
Payment status is independent of booking status. A booking can be CONFIRMED with payment PENDING if the facility allows players to pay at the door.
Status Combinations
Here are common status combinations you will encounter:
| Booking Status | Approval Status | Payment Status | Meaning |
|---|---|---|---|
| HELD | NOT_REQUIRED | PENDING | Player is in the process of confirming |
| CONFIRMED | NOT_REQUIRED | PAID | Standard confirmed and paid booking |
| CONFIRMED | PENDING | PENDING | Awaiting admin approval; not yet paid |
| CONFIRMED | APPROVED | PAID | Approved and paid -- ready to play |
| CONFIRMED | REJECTED | PENDING | Admin rejected -- player will be notified |
| CHECKED_IN | APPROVED | PAID | Player has arrived and checked in |
| COMPLETED | NOT_REQUIRED | PAID | Session finished normally |
| CANCELLED | NOT_REQUIRED | REFUNDED | Cancelled and refund issued |
| NO_SHOW | NOT_REQUIRED | PAID | Player did not show; fee retained |
Where to See Statuses
- Player Dashboard: Your bookings show the booking status and payment status under My Bookings.
- Admin Calendar: Bookings are color-coded by status on the facility calendar.
- Admin Booking List: The full booking list in the admin dashboard shows all three statuses with filter options.