beginner
advanced-bookings
mobile-app
riders

Rider Book Ahead Flow

What riders see when booking a scooter or bike model in advance, including location, time, model, quantity, deposit, assignment, and pickup behavior

Levy Fleets TeamApril 29, 202610 min read

Rider Book Ahead Flow

The mobile Book Ahead flow lets riders reserve a vehicle model before they arrive. The rider chooses when and where they want pickup, then books a model and quantity from available inventory.

Opening Book Ahead

Riders open Book Ahead from the mobile app drawer.

Depending on how the app was launched, Book Ahead may be scoped to a specific subaccount or vehicle type. For example, a fleet can direct riders into Book Ahead for bikes only or scooters only.

Step 1: Select a Pickup Location

The first card shows reservation pickup locations configured by the operator.

Each location can include:

  • Pickup location name.
  • Subaccount or market name.
  • Address.
  • Local timezone.

If no locations appear, the operator has not configured active reservation locations for the rider's selected market.

Step 2: Choose Pickup and Return Times

The rider selects:

TimeMeaning
PickupWhen the booking starts
ReturnWhen the booking should end

Times are entered in the pickup location's local timezone. The app shows the timezone below the picker so riders know which local time applies.

The return time must be after pickup. The backend also rejects reservations shorter than the configured minimum, with a hard minimum of one hour.

Step 3: Review Available Models

After location and time are selected, the app loads available models.

Each model card can show:

FieldMeaning
Model nameThe reservable vehicle model
Manufacturer or yearAdditional model context when available
Available quantityRemaining capacity for that model, location, and time window
Price eachReservation price for one unit for the selected time window
Deposit eachBooking deposit for one unit
TotalTotal reservation cost for selected quantity
Non-refundable depositDeposit that will be charged immediately

Availability is cap-based

The available quantity does not mean those exact vehicles are already assigned. It means the operator has configured enough model-level capacity for that location and time window.

Step 4: Select Quantity

If a model has available quantity, the rider can increase or decrease the booking quantity.

Quantity cannot exceed the model's available quantity for the selected window. For example, if only two units are available, the quantity selector stops at two.

Multi-unit reservations are useful for group bookings, events, tours, and planned rides. Pickup for multi-unit model bookings is operator-assisted.

Step 5: Confirm Booking

When the rider taps Book Model, the platform:

  1. Re-validates pickup location, model, time window, pricing tier, and cap availability.
  2. Creates the model reservation atomically.
  3. Charges the upfront booking deposit.
  4. Confirms the reservation if payment succeeds.
  5. Sends a booking confirmation notification.

If another rider books the last available capacity first, the reservation fails and the rider should choose another time, location, or model.

Deposit Messaging

The mobile app labels the booking deposit as non-refundable for model reservations.

The deposit is:

  • Charged immediately.
  • Applied toward the reservation total.
  • Stored on the reservation as the booking deposit.
  • Not a long-lived authorization hold.

If the deposit charge fails, the booking is not confirmed.

Do not describe this as a hold

Book Ahead uses an immediate charge for the booking deposit. Support and operator teams should not tell riders it is only a temporary authorization.

After Booking

After confirmation:

  • The rider sees the reservation in their reservation list.
  • The reservation may show no assigned vehicle at first.
  • The operator assigns a physical vehicle before pickup.
  • The rider receives an assignment notification when a vehicle is assigned.

For single-unit model bookings, check-in becomes available after assignment. For multi-unit bookings, pickup is intentionally operator-assisted.

Pickup Experience

At pickup time:

Booking TypePickup Behavior
Single-unit model booking with assignmentRider can check in from the reservation detail screen
Single-unit model booking without assignmentRider must wait for operator assignment
Multi-unit model bookingOperator assists pickup and vehicle handoff

During check-in, the system unlocks the assigned vehicle, enables throttle, creates the ride, and marks the assignment checked in.

If unlock fails, the system rolls reservation and ride state back so the rider is not left with a broken active reservation.

Checkout Experience

At checkout, the system:

  1. Locks the assigned vehicle.
  2. Calculates the remaining balance.
  3. Attempts to collect the remaining amount due.
  4. Completes the reservation.
  5. Releases the assignment.
  6. Sends the checkout notification.

If balance collection fails, the reservation can still complete, but the unpaid amount remains visible as a balance due.

Common Rider Questions

QuestionAnswer
Can I pick the exact scooter or bike?No. Book Ahead reserves a model and quantity. Operators assign the physical vehicle.
Why is no vehicle assigned yet?Operators may assign vehicles closer to pickup after charging, inspection, and staging.
Why can't I check in?Check-in is available only after assignment for single-unit model bookings.
Why is pickup assisted for multiple units?Multi-unit reservations need coordinated handoff, staging, and assignment handling.
Is the deposit refundable?Model reservation booking deposits are labeled and treated as non-refundable.