Offers Guide
Accept and manage home warranty claims through customizable offers
Offers are the core mechanism for resolving home warranty claims, providing customers with replacement products, upgrades, or buyout options.
Benefits
- Operational: Automate claim processing, standardize workflows, and reduce manual work
- Financial: Generate upgrade revenue while reducing processing costs
- Customer: Provide clear options, quick resolutions, and transparent self-service choices
Core Concepts
Replacement Product
Base product covered by warranty
Buyout
Cash settlement option for claim resolution
Upgrade
Premium product available for additional cost
Difference Payment
Amount customer pays for upgrade (upgrade price minus covered amount)
Add-On
Optional services or parts (e.g. Install, Disposal, recommended parts) bundled with the replacement at offer creation.
Curator
The role that prepares an offer — chooses the replacement, attaches add-ons, and may accept on the customer’s behalf.
Offer States
Pending
Generating Upgrades
Ready
Awaiting Customer
Sent to customer Next states: - Order Placed - Buyout Selected - Expired - Canceled
Terminal States
Order Placed
Customer selected replacement product
Buyout Selected
Customer chose cash settlement
Canceled
Offer terminated
Expired
Past validity period
Customer Experience
Accept Replacement
Get your covered replacement product delivered and installed at no additional cost.
Choose Buyout
Receive a cash settlement directly to handle the replacement yourself.
Select Upgrade
Choose an upgrade product and pay the difference between your coverage and the upgrade price.
Next Steps
Review Documentation
Development
Testing
Production
Endpoints
Offers endpoints
Every endpoint with parameters, response schemas, and code samples.