Public Court Rental Docs

Public User Guide

This documentation page is available to public users and explains the booking and payment flow.

Home Public Docs

Public User Guide

This guide explains how customers browse courts, create reservations, submit payment details, and manage bookings without creating an account.

Public Pages

  • / opens the Duwata booking directory.
  • /:slug opens a specific booking page.
  • /:slug/courts opens the court directory for that booking page.
  • /:slug/my-bookings shows bookings saved in the current browser for that booking page.
  • /:slug/view-booking lets anyone look up an approved booking by booking ID.
  • /docs/public shows this public guide.

What You Can Do

  • Browse all available courts.
  • Filter courts by sport or court type.
  • Check available times by date.
  • Choose a numbered court when a venue has multiple courts.
  • Choose a booking duration.
  • Reserve a slot temporarily.
  • View the configured payment name, number, and QR image for the venue.
  • Submit payment sender and reference details.
  • Reopen pending bookings from the same browser.
  • Cancel a reservation while it is still awaiting payment.
  • Look up approved bookings by booking ID.

Booking Rules

  • Bookings can be made up to 30 days ahead.
  • Booking duration must be between 1 and 24 hours.
  • The selected start time must match an available time slot.
  • The full duration must fit inside the court operating hours.
  • The selected numbered court must exist for that venue.
  • Required customer fields are name and contact number.
  • Optional notes can be added for the admin.

Step-By-Step Booking

  1. Filter courts by type if needed.
  2. Select a venue.
  3. Pick a date.
  4. Choose a booking duration.
  5. Choose a numbered court.
  6. Pick an available start time.
  7. Enter name, contact number, and optional notes.
  8. Submit the booking request.

Color guide:

  • Green means available.
  • Gray means the selected duration does not fit from that start time.
  • Orange means reserved while payment/admin review is pending.
  • Red means already confirmed booked.
  • Teal means currently selected.

Payment Flow

After a valid booking request is accepted, the system creates a temporary reservation.

The payment step shows:

  • Booking ID
  • Amount due
  • Reservation expiry time
  • Countdown timer
  • Payment name, such as GCash Number, Maya Number, or GoTyme Number
  • Payment number
  • Optional QR image provided by the venue
  • Sender name field
  • Reference number field
  • Optional payment notes field

Submit payment details only after completing payment through the displayed payment instructions.

If the venue provides a QR image, you can tap it to open a full-size preview before paying.

Reservation Timer

New reservations are held for 15 minutes.

During that time:

  • The slot is blocked from other bookings.
  • You can submit payment details.
  • You can cancel the booking before payment submission.

If the timer expires before payment details are submitted, the booking becomes expired and the slot becomes available again.

My Bookings

My Bookings works without a customer account. The app stores a private booking access token in the browser that created the booking.

You can see booking ID, court, date/time, amount due, status, payment reference, payment submission time, and live countdown for pending payment.

Available actions:

  • awaiting_payment: proceed to payment or cancel.
  • payment_submitted: wait for admin review.
  • approved: booking is confirmed.
  • rejected, cancelled, or expired: no payment action is available.

Public Booking Lookup

Use /view-booking to look up an approved booking by booking ID.

This lookup only shows confirmed approved bookings. Pending, rejected, expired, and cancelled bookings are not shown through public lookup.

Booking Statuses

  • Awaiting Payment: reservation created, payment details not yet submitted.
  • Payment Submitted: payment details submitted and waiting for admin review.
  • Approved: booking confirmed.
  • Rejected: admin rejected the booking or payment details.
  • Cancelled: booking was cancelled.
  • Expired: reservation timer ended before payment submission.

Rate Limits

Booking creation is limited to 5 booking requests per 15 minutes by contact number and client IP.

If you see a rate-limit message, wait for the timer window to reset before trying again.

Privacy And Access Notes

  • My Bookings is stored in your browser, not in a customer login account.
  • Clearing browser storage may remove local booking access.
  • Using another browser or device may not show your saved bookings.
  • Keep your booking ID and payment reference for support.

Common Problems

  • Missing booking in My Bookings: check browser/device, browser storage, and booking status.
  • Payment submission failed: check expiry, required fields, booking status, and browser access token.
  • Gray time: selected duration does not fit from that start time.
  • Orange time: another reservation is temporarily holding the slot.

Tips

  • Submit payment details before the 15-minute countdown ends.
  • Double-check the payment reference before submitting.
  • Return through My Bookings if you need to finish payment later.
  • Contact the venue/admin with your booking ID if there is a payment issue.

Related Docs