Quick answers to questions operators ask most. For deeper coverage, see the linked articles.
Setup
What's the minimum I need to start renting?
A pickup location, at least one vehicle model with at least one vehicle, an inventory cap, and a pricing tier. An agreement template is strongly recommended for legal protection. See Setting up your first shop.
Do I need IoT / GPS / smart locks?
No. Shop Rentals is for owned-fleet rentals where the bike sits at your counter until rented. IoT-equipped fleets use the Car Sharing module.
Can I run multiple shops as one subaccount?
Yes — multiple reservation_locations per subaccount. Each location
has its own inventory caps. The booking page can show all locations or
filter to one.
Can I have multiple subaccounts for different shops?
Yes. Each subaccount has its own pricing, vehicles, customers, and public booking slug. Useful when shops have different tax setups or brands.
Bookings
Can a customer book multiple bikes in one reservation?
Yes — quantity > 1. The walk-in wizard creates one reservation per
session, but the
new-booking flow supports multi-bike.
Public page is currently quantity=1 only.
How do I extend a customer's rental mid-rental?
Open the booking detail, edit return_at. Save. The pricing snapshot
is preserved unless you cross into a different tier's rate table.
Can I edit the price after booking?
Yes — edit adjustment_cents and adjustment_reason on the
reservation. The total recalculates. See
Booking detail page.
What happens if a customer no-shows?
The no-show cron flips the booking to no_show 2 hours after pickup
if never checked_in. Cancellation fee applies per your tier policy.
How do I handle bike swaps mid-rental?
Update vehicle_uuid on the reservation via the assignments dropdown
on the booking detail. The old vehicle becomes available; the new one
is locked in.
Customers
Can I create a customer without an email?
Yes — only phone is required for quick-create. Customer won't receive emailed receipts but everything else works.
Can a customer have multiple cards on file?
Yes — the payment_methods table supports multiple. One is marked
default. Operators can switch defaults.
Can a customer log in / see their booking history?
Today, no native customer portal. The manage-link gives them read-mostly access per booking. A full customer login is on the roadmap for Shop Rentals.
What if two people share a phone?
Use slightly different phones if possible. Otherwise create one "household" record. Most shops just go with the lead booker.
Refunds & cancellations
How quickly does a refund show up for the customer?
Wallet refund: immediate. Card refund: 5-10 business days for the customer's bank to surface it. We can't speed up Stripe.
Can I refund part of a booking?
Yes — partial refund mode in the refund modal. Enter an explicit dollar amount.
Can I refund the cancellation fee?
Yes — issue a partial refund matching the fee amount with reason "Waiving cancellation fee — operator decision."
What if a refund fails partway through?
The system rolls back the reservation_refunds row if the wallet credit
or Stripe API call fails. You won't end up with a half-recorded refund.
How do I refund a gift card customer?
Wallet or card refunds work normally. To credit back the gift card itself, manually update via SQL (see Gift cards).
Add-ons & gift cards
Can I add an add-on after the booking is created?
Today via SQL/API only. A native button on the booking detail is on the roadmap.
Can a customer use multiple gift cards on one booking?
Yes — call the redeem endpoint multiple times with different codes.
Do gift cards expire?
By default, no. You can set an expires_at per card. Most US states
have minimum legal validity (5+ years).
Can I issue gift cards in bulk?
Today via SQL/API. A bulk-issuance UI is queued.
Public booking & embed
How do I change my public booking URL?
Edit the slug at /dashboard/shop-rentals/public. The old URL stops
working immediately — update external links.
Why doesn't my embed widget appear on my website?
Check: (a) the script tag is actually in your HTML, (b) data-subaccount
matches your slug, (c) the public booking page is enabled. See
Embedding the widget.
Can I customize the booking page beyond colors?
Today: button color, button text, logo, confirmation message, cancellation policy text. Beyond that, the layout is fixed. Custom themes are on the roadmap.
Can customers pay on the public page?
Today the public page creates the booking and a capacity hold. Card collection is currently API-only or operator-driven; client-side Stripe Elements on the public page is a roadmap item.
Payments
Why does my Stripe customer ID show test mode for the demo account?
The demo subaccount auto-routes to Stripe test mode via the per-subaccount routing helper. All other subaccounts use live keys. This is intentional and isolated.
What test card should I use for QA?
4242 4242 4242 4242 for happy path.
4000 0000 0000 9995 for insufficient funds.
4000 0027 6000 3184 for 3DS auth flows.
How does Stripe Connect (Express) interact with this?
If your subaccount uses Stripe Connect, charges flow through your connected account. The platform takes the application fee. Refunds apply normally. No special operator action.
Inventory & maintenance
How do I take a bike out of service?
Go to the vehicle detail page → Service Log section → click "Take out of service" with a reason. See Out-of-service lifecycle.
Can I batch-apply a maintenance event to multiple bikes?
Today only via SQL. Bulk-event UI is queued.
How do I see how many rentals each bike has?
Query reservations.vehicle_uuid grouped:
SELECT vehicle_uuid, count(*)
FROM reservations
WHERE vehicle_uuid IS NOT NULL
AND status IN ('completed', 'active')
GROUP BY 1
ORDER BY count DESC;
A built-in "Vehicle utilization" report is on the roadmap.
Reporting
How do I export bookings to CSV?
Today no built-in CSV export. Query the database directly or use the Bookings list filters and copy-paste. CSV export UI is queued.
How do I see refunds for tax filing?
See Refund and revenue reporting.
Pull from reservation_refunds joined with reservations for the
relevant date range.
Can I see which add-ons are most popular?
Query reservation_addons aggregated by addon_id. Built-in report
is on the roadmap.
What's on the roadmap
Most-asked features queued:
- Stripe Elements card capture in walk-in wizard
- Customer login portal with booking history
- CSV export of bookings
- Bulk add-on / gift card / OOS UIs
- Native maintenance scheduling cron + email reminders
- SMS reminder notifications
- OTA distribution (Viator, GetYourGuide)
- Multi-language receipts
- Custom domain support for public booking pages
If a feature you need isn't here, file a feature request via the sidebar's Feature request button — we triage these weekly.