Service Purchase Flow
Purpose
The Service Purchase Modal guides landlords and property managers through the process of requesting an on-demand service or subscribing to a recurring service. It consolidates selection, scheduling, and payment setup into one intuitive wizard and adapts based on how it’s opened.
Where It Can Be Opened
Service Details page
service-to-property
The service is fixed; user chooses the property.
Property Details page
property-to-service
The property is fixed; user chooses the service.
Active Services → Add Services
property-to-service
Same as above; property preselected.
Active Services → Buy Again
property-to-service (auto-advance)
Both property and service preselected; skips selection step.
Modes and Behavior Differences
🧩 service-to-property
Top Card: shows the chosen service.
First Step: select an eligible property (only ACTIVE properties).
If the service is recurring, the properties that have that service are not listed
Once selected, a Property Chip appears at the top for quick reference.
🏠 property-to-service
Top Card: shows the chosen property.
First Step: select an available service (filtered to on-demand or unsubscribed services).
Once selected, a Service Chip appears at the top for reference.
Wizard Steps (Dynamic by Service Type)
Validation and Buttons
Next is disabled until required fields in each step are completed.
Back always available after the first step.
Confirm & Continue finalizes the purchase or subscription.
For subscriptions, a payment method must be selected before confirming.
Pricing and Estimation
Hourly (e.g., Cleaning)
Estimated duration based on bedrooms (studio–4+). Estimated price = hourly rate × estimated hours.
Flat-rate services
Show fixed price per task.
Recurring services
Show subscription pricing (monthly or prorated).
⚠️ Important: For one-time purchases, the price shown is indicative only. The host is not charged immediately — the request first goes to Operations for review and pricing.
Payment and Cards
Manage saved cards during the Confirmation step:
Set default, delete, or add a new one.
Subscriptions require a valid payment method immediately.
On-demand services do not charge upfront — billing happens later after Operations sets the final price.
Submission Behavior by Type
🧹 On-Demand (Task Purchase)
After clicking Confirm and Continue:
Creates a service request (task) linked to the property.
No payment occurs yet — the request is sent to Operations for pricing.
The modal shows a success state:
“Your service request has been submitted.”
Buttons: View Task Details or Contact Support.
Background refresh updates the Active Services and Tasks views.
If Automation is enabled:
Creates a recurring task automation tied to reservation events (e.g., after check-out).
You can specify offset time, direction (before/after), and inclusion of existing reservations.
🔁 Recurring (Subscription)
Subscribes the property immediately using the selected payment method.
The modal closes upon success, refreshing service data across the app.
Compact Chips and Editing
Once you move past any selection or scheduling step:
Top chips appear summarizing your choices (Property, Service, Date/Time).
Clicking a chip reopens that step for quick edits before confirmation.
Auto-Advance Logic
When launched with both property and service preselected (e.g., via Buy Again), the wizard automatically skips the selection step and opens directly to the next relevant question (equipment/bedding/date).
Filtering and Safety Rules
Property selection excludes properties already covered by this service (subscription or tier).
Service selection excludes services already active on the selected property.
Only on-demand services appear in property-to-service mode.
🧪 QA Testing Checklist
Purchase Modal
Last updated