Peapod User Manual - Guest Guide
Version: v0.19.0 Last Updated: December 17, 2025 Platform: iOS (iPhone, iPad)
â Back to Index
4. For Guests
4.1 Guest Overview
čŻč¨čŽžç˝Ž: éŚćŹĄĺ¨ä¸ĺ˝ĺşä˝żç¨ćśéťčޤćžç¤şçŽä˝ä¸ćďźç¨ćˇĺŻĺ¨çťĺ˝éĄľé˘ĺłä¸č§ĺć˘čł English çé˘ă
As a guest, you can: - đ Search & Browse - Find accommodations by location, dates, amenities - đ§ Smart AI Search - Use Trip Intent Detection for personalized results - đ Book Stays - Reserve properties with secure payment - đ Add Experiences (Future feature â not available in Release 1.0 China) - Optional activity bundles during booking - đŹ Message Hosts - Ask questions before/during your stay - â Leave Reviews - Share your experience with photos - đ Earn Rewards - Loyalty points for bookings - đą Manage Trips - View upcoming and past stays - đĽ Refer Friends & Hosts - Earn rewards through referrals - âď¸ Set Preferences - Customize your experience
New Features: - Trip Intent Detection - AI Search understands trip types (work, family, romantic) and auto-applies relevant filters - Experience Bundles (Future feature â not available in Release 1.0 China) - Curated local activities, tours, and services available during booking
4.2 Browse & Search for Accommodations
4.2.1 Explore View (Home Screen)
Location: Main tab â âExploreâ (magnifying glass icon)
What Youâll See: - Smart Search Bar (2 buttons: Search, AI Search) - Map/List view toggle - Featured listings grid/list - Nearby search button - Saved searches bookmark button - Filter button with active count badge - Listing count badge - Sort button (right next to listing count badge) - Favorites heart icon - Notification bell
Top Navigation Bar: - Map toggle (map/list.bullet icon) - Switch between list and map view - Saved searches (bookmark icon) - Access your saved search criteria - Nearby search (location icon) - Find listings near your current location - Listing count badge (house icon + number) - See total available listings - Sort button (next to listing count) - Choose how to sort results - Favorites filter (heart icon) - Show only favorited properties - Filter button (slider.horizontal.3 icon) - Open advanced filters - Notification bell - View notifications
How to Navigate: - Scroll vertically - Browse listings - Tap search bar - Enter specific search - Toggle map - Switch between list and map view - Tap nearby - Find listings near your location - Tap heart - Toggle favorites-only filter - Tap filter - Open filter sheet
4.2.2 Map View
What Is Map View?
Interactive map interface for visual exploration of listings. Perfect for: - Understanding property locations in context - Seeing clusters of options in specific neighborhoods - Evaluating proximity to points of interest - Adjusting search radius visually - Comparing distances between properties
Location: Explore view â Toggle âList/Mapâ button (top nav) OR auto-activated by Nearby Search
Key Features: 1. Search Circle Visualization - Pink circle shows search area with adjustable radius (5-50 miles) 2. Inline Radius Control - Real-time slider without leaving map view 3. Search & AI Search Buttons - Direct search access from map 4. Distance Display - See exact distance to each listing 5. Map Style Toggle - Switch between Standard/Satellite/Hybrid views 6. Session Persistence - Radius preference saved across app restarts
Map View Booking Flow:
- Open Map View: Tap map toggle button or use Nearby Search
- See Search Circle: Pink circle shows your search area (default 25 miles)
- Adjust Radius: Use inline slider at bottom to expand/shrink search area
- Browse Listings: Tap pins on map to see property cards
- Change Map Style: Tap style button for Standard/Satellite/Hybrid view
- Search or Filter: Use top bar buttons to refine results
- View Details: Tap listing card to see full property details
Map Controls: - Search Button - Opens search sheet to enter new location - AI Search Button - Natural language search - Sort Button - Reorder listings (turns pink when active) - Filter Button - Apply detailed filters - Radius Slider - Adjust search radius (5-50 miles) - Style Button - Toggle Standard/Satellite/Hybrid - Zoom In - Plus (+) button on right side to zoom in - Zoom Out - Minus (-) button on right side to zoom out - Pan/Move Map - Drag map to explore different areas
Map Interaction - Listing Card Popup:
When you tap a listing pin on the map, a compact listing card pops up showing: - Property photo (swipeable if multiple photos) - Property title - Price per night - Distance from search center (e.g., â0.8 miâ, â3.2 miâ) - Guest capacity (e.g., â4 guestsâ) - Star rating and review count (if available) - Quick preview of key amenities
Using the Listing Card: 1. Tap a pin on the map - Listing card pops up at bottom of screen 2. Swipe photos - See multiple property images (if available) 3. Tap the card - Opens full listing detail page (section 1.6) 4. Tap X or tap map elsewhere - Dismiss the card 5. Tap another pin - Card updates to show that listing
Card Benefits: - â Preview listings without leaving map view - â Compare nearby properties quickly - â See photos and price at a glance - â Fast navigation to full details
Distance Display: Distance badges appear on listing cards showing accurate distance from your search location (e.g., â0.8 miâ, â3.2 miâ). Also visible in List view when using Nearby Search or âNearest Firstâ sort.
See Appendix B for technical details on PostGIS backend, search circle architecture, and performance optimizations.
4.2.3 Search Listings
How to Search: 1. Tap search bar at top of Explore view 2. Enter your destination (e.g., âSea World, San Diegoâ) 3. Select dates (check-in and check-out) 4. Add guests (adults and children) 5. Tap âSearch X placesâ to see instant results
Search Results: - List of available properties - Price per night displayed - Key amenities shown - Distance from search center - Guest rating (if reviewed) - Favorite heart icon (tap to favorite)
4.2.4 View Listing Details
Tap any listing card from search results to open the detailed listing page with all property information.
Listing Detail Page Sections:
A. Photo Gallery - Swipe left/right through the photo carousel - Tap any photo to view full-screen - Pinch to zoom for details - Tap X to close full-screen view
B. Property Overview - Property title and location - Host name with profile photo - Price per night - Guest capacity - Bedroom, bathroom, and bed counts
C. Amenities - Complete list with icons - Organized by category (Essential, Features, Safety) - Tap âShow allâ for full list if truncated
D. Booking and Cancellation - Cancellation policy information - Flexible, Moderate, or Strict policy details - Refund schedule based on cancellation timing
E. House Rules - Check-in and check-out times - Smoking, pet, and event policies - Additional property-specific rules
F. Nearby - Nearby points of interest - Distance to attractions and landmarks - Local amenities and facilities
G. Where Youâll Sleep - Bedroom breakdown with bed types - Visual representation of sleeping arrangements - Total bed count and bed types (Queen, King, Single, etc.) - Shows each bedroomâs configuration
H. About This Space - Detailed property description written by the host - Highlights unique features and amenities
I. Where Youâll Be - Interactive map showing exact property location - Distance to city center
J. Reviews - Overall rating (1-5 stars) and total review count - Rating breakdown showing distribution across star levels - Filter by star rating (All, 5 Stars, 4 Stars, etc.) - Individual guest reviews with: - Reviewer name, avatar, and date - Star rating and review text - Photo gallery (swipe horizontally if photos included) - âShow moreâ button for longer reviews - Host responses (if any)
Review Photo Gallery: - Photos display in a horizontal scrollable row below review text - Swipe left/right to browse all photos - Tap photo to view full size (future feature)
K. Booking Section (Bottom Sticky) - Price breakdown showing all costs - Date selector for check-in/check-out - Guest count selector - âBook Nowâ (instant book) or âRequest to Bookâ button
How to Book: 1. Select your dates using the calendar 2. Adjust guest count 3. Review the price breakdown (nightly rate Ă nights + fees) 4. Tap âBook Nowâ or âRequest to Bookâ
L. Q&A Section - Public questions and answers between guests and host - âAsk a Questionâ button for pre-booking inquiries - Faster than private messaging for common questions
How to Ask a Question: 1. Scroll to âQ&Aâ section 2. Tap âAsk a Questionâ 3. Type your question 4. Tap âSubmitâ 5. Receive notification when the host answers
Common Questions to Ask: - Check-in procedures - Parking availability - Pet accommodations - Suitability for children/elderly - Nearby amenities - WiFi speed - Any listing-specific questions
4.2.5 Filter & Sort Results
Opening Filter Sheet:
From the Explore view, tap the filter button (top right) to open the filter sheet. Youâll see a 2x4 grid of 8 filter sections. Select any section to configure filters, and the live count updates as you make changes. Tap âShow X resultsâ to apply filters and return to search results.
Filter Sections (8 Total):
1. Price - Set your budget with a range slider ($0 - $1000+) - Quick select options: Under $100, $100-$200, $200-$500, $500+ - Live results count updates as you adjust the range
2. Guest Ratings - Filter by minimum rating: Any, 4.0+, 4.5+, 4.8+, or Perfect 5.0 stars - Helps you find highly-rated properties - Clear selection to remove the filter
3. Property & Layout - Property Types: House, Apartment, Guest Room, Hotel, Hostel, Boutique Hotel, Resort (multi-select) - Single-Unit Types: House, Apartment, Guest Room â book the entire property - Multi-Unit Types: Hotel, Hostel, Boutique Hotel, Resort â book room/bed types within the property - Rooms & Beds: Set minimum requirements for bedrooms (1-10 or âAnyâ), bathrooms (1-10 or âAnyâ), and beds (1-10 or âAnyâ) - Use +/- buttons to adjust minimums - Note for Hotels/Hostels: Filters apply at the room/bed type level (see Search Behavior section below)
4. Photo & Video - Filter listings by media availability - Photos: Minimum photo count (e.g., 5+ photos, 10+ photos) - Videos: Filter for listings with video tours - Helps find well-documented properties with comprehensive visual content
5. Amenities - Filter by property features grouped by category: - Essential (WiFi, Kitchen, Parking, etc.) - Features (Pool, Hot tub, Gym, etc.) - Safety (Smoke detector, First aid, etc.) - Accessibility (Wheelchair accessible, Step-free entry, Accessible parking, Accessible bathroom, Wide doorways, Elevator access, Grab bars, Low bed height) - Entertainment - Family-friendly - Other - Select multiple amenities to narrow your search - Accessibility features are grouped within the Amenities section for easy discovery
How Amenities Work for Hotels/Hostels: - Shared Amenities: Property-wide features (Pool, Gym, Restaurant) available to all guests - Room-Type Amenities: Specific to certain room types (Balcony, Minibar, Private Bathroom) - Combined Amenities: Search filters match room types where shared + room amenities include ALL your selected amenities - Example: If you filter for âWiFi + Balconyâ, only room types with both (either shared or room-specific) will match
6. Booking & Cancellation - Booking Options: Filter for Instant Book, Self Check-In, or Superhost properties - Cancellation Policies: Choose your flexibility level: - Flexible (Full refund 24h+ before check-in) - Moderate (Full refund 5 days+ before) - Strict (50% refund 7 days+ before)
7. House Rules & Host Language - House Rules - 3-state filter for property rules (Yes/No/Any): - Pets allowed - Smoking allowed - Events allowed - Quiet hours - Toggle between Yes (required), No (not allowed), or Any (no preference) - Host Language - Filter by languages spoken by your host: - English, Spanish, French, German, Italian, Portuguese - Chinese (Mandarin), Japanese, Korean - Arabic, Russian, Dutch - Multi-select to find hosts who speak your preferred language
8. Commute / Distance
Find properties within a specific travel time to your workplace, school, or any destination. Perfect for business travelers, students, conference attendees, or anyone needing proximity to a specific location.
How to Use: 1. Enter your destination (address, landmark, or place name) 2. Tap âSetâ to verify the location (green checkmark appears) 3. Choose transport mode: Drive, Transit, Bicycle, or Walk 4. Set maximum travel time (5-120 minutes) 5. Results filter to show only properties within your commute time
Key Features: - Location verification with green checkmark - Four transport modes (Drive, Transit, Bicycle, Walk) - Per-mode persistence (each mode remembers its own time setting) - Session memory (settings saved when you close the app) - Map integration (car icon on map for quick access)
Pro Tips: - Use landmarks for easier entry (âSalesforce Towerâ vs full address) - Compare Drive vs Transit modes (transit often faster in cities) - Set realistic times per mode (20 min drive â 20 min walk!) - Combine with price filters for affordable & convenient options - Use map view to see commute-filtered results geographically
See Appendix A for geocoding details and technical information.
Filter Application:
After configuring your filters: - Red badges on section tabs show active filters - Bottom bar displays total active filter count - Live result count updates as you make changes - Tap âShow X resultsâ to apply and return to search - OR tap âApplyâ (top right) to save - OR tap âCancelâ to discard changes - The Explore view updates instantly with filtered results - Filter button shows active count badge
4.2.6 AI Search Listings
Location: Smart Search Bar â AI Search button (sparkles icon)
How AI Search Works:
AI Search allows you to describe your perfect stay in natural language instead of using filters. Simply describe what youâre looking for, and AI will interpret your request and apply the appropriate filters.
How to Use AI Search: 1. Tap the search bar at the top of Explore view 2. Tap âAI Searchâ button (sparkles icon) 3. Describe your ideal stay in natural language 4. Tap âSearch with AIâ 5. Review the âWe understood:â summary showing parsed details (location, dates, guests, property type, amenities, price) 6. Tap âSearch with these filtersâ to see results, or âModifyâ to adjust
Example Queries: - âBeachfront villa with pool for 4 people in Hawaii Dec 20-27â - âPet-friendly apartment near Central Park under $200 next weekendâ - âQuiet place with good wifi for remote work Jan 15-30â - âQuiet condo near LA Disneyland for 3 from Sep 20 to 25thâ - âApartment within 30 min drive to Salesforce Tower for 2 people next weekâ
What AI Can Understand: - Location (cities, neighborhoods, landmarks) - Dates (flexible formats: ânext weekendâ, âSep 20-25â, âfrom Monday to Fridayâ) - Guest count (âfor 4 peopleâ, â3 guestsâ, âfamily of 5â) - Property types (âvillaâ, âapartmentâ, âcondoâ, âhouseâ) - Amenities (âpoolâ, âwifiâ, âpet-friendlyâ, âparkingâ, âbeachfrontâ) - Price (âunder $200â, âcheapâ, âluxuryâ, âbudget-friendlyâ) - Special needs (âquietâ, âgood for remote workâ, âfamily-friendlyâ) - Trip Intent (work, family, romantic, budget, luxury, outdoors, pet-friendly)
Trip Intent Detection (New):
AI Search now automatically detects your trip type and applies intent-specific filters:
Detected Trip Types: - Work/Business Trip â Strong WiFi, dedicated workspace, quiet, late check-in, near transit - Family Trip â Entire place, 2+ bedrooms, crib/high chair, washer/dryer, kitchen, parking - Romantic/Honeymoon â Private entrance, quiet hours, late checkout, hot tub/fireplace (if available) - Group Trip â Large capacity, multiple beds, entertainment, spacious living areas - Budget â Price cap + âBest Valueâ sort, non-refundable options highlighted - Luxury â Premium amenities, high-end properties, concierge services - Outdoors/Nature â Hiking nearby, scenic views, outdoor spaces - Remote Work â Fast WiFi (50+ Mbps), desk, ergonomic chair, quiet environment - Pet-Friendly â Pets allowed, nearby parks, ground floor when possible
How Trip Intent Works: 1. Type your search with trip context (e.g., âwork trip near downtownâ) 2. AI detects intent and shows pill badge (e.g., âWorkâ badge) 3. Relevant filters automatically applied 4. Tap intent pill to remove or switch intent 5. Override anytime - full control maintained
Example Intent-Based Queries: - âFamily trip near SeaWorld next month under $250/night, needs kitchen + parkingâ - âRomantic cabin with fireplace within 2 hours of San Diego, this weekendâ - âQuiet place for remote work for 10 days with strong WiFi and desk, March 3-13â - âBudget-friendly apartment for student, close to UCSD, September semesterâ - âLuxury beachfront villa for group trip, sleeps 12, pool and ocean viewâ
Benefits: - â Faster than manual filter selection - â More natural way to search - â Intent-aware results match your trip purpose - â Discovers relevant filters you might not think of - â Great for specific, complex requirements - â Transparent - see which intent was detected
4.2.8 Search Behavior for Hotels & Hostels (Multi-Unit Properties)
NEW FEATURE: Hotels, Hostels, Boutique Hotels, and Resorts now support multi-unit search, meaning filters are evaluated at the room/bed type level.
How Multi-Unit Search Works:
When you search for accommodations, the system handles property types differently:
| Property Type | Search Behavior |
|---|---|
| House, Apartment, Guest Room | Filters apply to the entire property (single-unit) |
| Hotel, Hostel, Boutique Hotel, Resort | Filters apply to individual room/bed types (multi-unit) |
For Hotels/Hostels, search filters work like this:
- Guest Count Filter - Matches room/bed types that accommodate your party
- Example: 2 guests â Shows rooms with max_guests ⼠2
- For Hostels: Number of beds to book (1 bed = 1 guest typically)
- Price Filter - Matches room/bed types within your budget
- Example: $50-$150 â Shows only room types in that range
- The search card displays the cheapest matching room type price
- Beds Filter - Matches room/bed types with minimum beds
- Example: 2+ beds â Shows rooms with 2 or more beds
- Amenities Filter - Matches room/bed types with combined amenities
- Combined = Shared property amenities + Room-specific amenities
- Example: Filter for âWiFi + Balconyâ matches rooms where both are available
- Availability Filter - Checks if at least one unit of that type is available
- Even if 10 rooms exist, shows only if 1+ is available for your dates
Search Results Display:
For Hotels/Hostels, each listing card shows: - Property name and location (same as before) - âFrom $X/roomâ or âFrom $X/bedâ - cheapest matching room/bed type price - Room/Bed type name - e.g., âDeluxe King Roomâ or â6-Bed Mixed Dormâ - Standard badges - Superhost, Instant Book, Self Check-in
Example Search Scenario:
You search for: - Location: San Diego - Dates: Dec 20-22 - Guests: 2 - Price: $100-$200 - Amenities: WiFi, Pool
Beach Resort Hotel has 3 room types: 1. Standard Room ($120/night) - 2 guests, WiFi 2. Deluxe Suite ($180/night) - 4 guests, WiFi, Balcony 3. Executive Suite ($350/night) - 4 guests, WiFi, Balcony, Jacuzzi
Result: Hotel appears with âFrom $120/room â Standard Roomâ because: - Standard Room matches price ($120 within $100-$200 â ) - Standard Room matches guests (2 â ) - Standard Room has WiFi â and Pool is shared â - At least 1 Standard Room is available for Dec 20-22 â
The Executive Suite doesnât show because it exceeds the $200 price filter.
Tips for Searching Hotels/Hostels:
- đ¨ Hotels: Search by âroomâ - each room type has its own price and amenities
- đď¸ Hostels: Search by âbedâ - youâre booking a bed in a shared dorm
- đ° Price shown is per room/bed per night - not per person
- đ Availability is per room type - one type may be full while another has openings
- ⨠Amenities matter - some amenities are room-specific (balcony, minibar)
Sort Options:
Available Sort Modes (8):
- Recommended (default) - âBest value with qualityâ
- Balances price affordability with quality ratings
- Best overall value for most travelers
- Best Value - âGreat bang for your buckâ
- Optimized price-to-quality ratio
- Great for budget-conscious travelers seeking quality
- Price: Low to High - âLowest price firstâ
- Shows cheapest listings first
- Perfect for budget travelers
- Price: High to Low - âHighest price firstâ
- Shows most expensive listings first
- Great for luxury seekers
- Rating - âHighest ratingâ
- Sorts by average rating score
- Shows top-rated properties first
- Nearest First - âClosest to search locationâ
- Sorts by distance from your search location
- Requires location-based search
- Top Rated - âHighest rated (5+ reviews)â
- Shows highly-rated properties with proven track record
- Requires minimum 5 reviews for credibility
- Most Popular - âMost bookedâ
- Shows properties with highest booking volume
- Great for finding tried-and-true popular stays
How to Sort: 1. Tap âSortâ button in top navigation (next to listing count) 2. Select your desired sort mode from the list 3. Results re-sort instantly 4. Sort button turns pink to indicate active custom sort
Filter Bookmarks:
What Are Filter Bookmarks?
Filter bookmarks let you save your favorite combinations of filters and sort settings for quick reuse. Perfect for: - Frequent travelers with specific preferences - Users who search the same criteria regularly - Quick access to complex filter combinations
Location: Filter sheet â Bookmarks tab (default view)
What Gets Saved: - â All active filters (price, property type, amenities, etc.) - â Sort preferences (criteria and order) - â Location (not saved - you pick each time) - â Dates (not saved - you pick each time) - â Guest count (not saved - you pick each time)
Why Location, Dates, and Guests Arenât Saved: These change frequently based on your travel plans. Bookmarks focus on your preferences (what kind of property you like), not your itinerary (where/when youâre traveling).
How to Save a Bookmark: 1. Configure your desired filters (e.g., Pool + WiFi, $100-200, Pet-friendly) 2. Set your preferred sort order (e.g., Price: Low to High) 3. Tap âBookmarksâ tab at bottom of filter sheet 4. Tap âSave Current Filtersâ button 5. Enter a descriptive name (e.g., âBudget Beach Staysâ, âWork-Friendly Condosâ) 6. Tap âSaveâ
How to Use a Bookmark: 1. Tap bookmark icon in top nav bar (OR filter button â Bookmarks tab) 2. Select a bookmark from your list 3. Filters and sort are instantly applied 4. Add your location/dates/guests as usual 5. Tap âShow X resultsâ
How to Edit Bookmarks: 1. Open filter sheet â Bookmarks tab 2. Swipe left on any bookmark 3. Tap âEditâ to rename or âDeleteâ to remove
Benefits: - ⥠Save 30+ seconds on complex filter setups - đŻ Consistent search criteria every time - đ Easily switch between different search styles - đĄ Remember what filters worked well before
Example Bookmarks: - âFamily Beach Tripsâ - Pool, Beach, 3+ bedrooms, $200-400 - âBusiness Travelâ - WiFi, Workspace, Quiet, Near downtown - âBudget Weekendsâ - Under $100, Instant book, Free parking - âPet-Friendly Cabinsâ - Pets allowed, Mountain view, Fireplace
4.2.7 Nearby Search
What Is Nearby Search?
Find accommodations near your current GPS location with one tap. Perfect for: - Last-minute bookings when traveling - Discovering stays near your current location - Emergency accommodation needs - Exploring options in unfamiliar areas
Location: Explore view â Top nav bar â Location icon button
How It Works: 1. App requests your current GPS coordinates 2. Searches within 5-mile radius 3. Automatically switches to map view 4. Shows listings closest to you first 5. Sort defaults to âDistance: Nearest firstâ
How to Use Nearby Search:
First Time Use: 1. Tap location icon in top nav bar 2. Grant location permission when prompted (âAllow While Using Appâ or âAllow Onceâ) 3. Wait for GPS coordinates (2-10 seconds) 4. Map view opens automatically showing listings within 5 miles 5. Results sorted by distance (nearest first)
Subsequent Use: 1. Tap location icon (top nav bar) 2. GPS location retrieved quickly (1-2 seconds) 3. Map updates to your current position 4. Nearby listings load with distance badges
Search Radius: - Default: 5 miles (8 km) - Adjustable via filters (Future feature)
What Happens: 1. â GPS location retrieved 2. â Map view activated 3. â Search center set to your coordinates 4. â Results filtered to 5-mile radius 5. â Sorted by distance 6. â Your filters/bookmarks still apply (if any active)
Privacy: - Location accessed only when you tap the button - Not stored or tracked - Not shared with hosts until you book - You control permission in iOS Settings
Troubleshooting: - âLocation services disabledâ: Enable in iOS Settings â Privacy â Location Services â Peapod - âSlow to loadâ: First launch may take 10 seconds for GPS lock. Subsequent uses faster. - âNo resultsâ: Increase search radius or clear filters - âWrong locationâ: Ensure GPS (not WiFi positioning) is enabled
Benefits: - đŻ Instant local accommodation discovery - đ Perfect for road trips and spontaneous travel - ⥠One-tap search (no typing required) - đşď¸ Visual map-based browsing
4.3 Book a Stay
4.3.1 Standard Booking Flow
Prerequisites: - Account created and logged in - Payment method added (can add during booking) - Dates selected - Guest count confirmed
Currency Note (v1): In the current version, you can only book listings priced in your home currency: - USD users: Can book USD-priced listings (typically US properties) - CNY users: Can book CNY-priced listings (typically China properties) - International bookings (cross-currency) will be supported in a future release
Booking Steps:
Step 1: Review Booking Details - Confirm check-in and check-out dates - Confirm guest count (adults and children tracked separately) - Review total nights - See price preview - Tap âBook Nowâ (instant book) or âRequest to Bookâ
Guest Count Details: Adults and children are tracked separately to help hosts prepare appropriate amenities (cribs, high chairs, etc.). Property capacity limits apply to total guests.
Step 2: Price Breakdown Review the complete cost breakdown: - Base price (nightly rate Ă nights) - Cleaning fee (if applicable) - Service fee (12% platform fee) - Taxes (if applicable) - Total price
Tap âPrice detailsâ to expand and see each itemized cost.
Step 3: Payment Method - Add payment method if none saved (Apple Pay or Credit/Debit Card) - Use saved payment method if available - Apple Pay recommended for fastest, most secure checkout
Apple Pay Benefits: - One-tap payment with Face ID/Touch ID - Most secure payment method - No need to manually enter card details - Fastest checkout experience
Step 4: Confirm Booking 1. Review all details one final time 2. Read Terms & Conditions and Cancellation Policy 3. Tap âConfirm and Payâ 4. Authenticate with Face ID/Touch ID (Apple Pay) or complete card payment 5. Wait for confirmation (2-5 seconds)
Step 5: Booking Confirmed
What You Receive: - âBooking Confirmedâ message in app - Booking reference number - Host contact information - âView Bookingâ and âMessage Hostâ buttons - Email confirmation with booking details
4.3.2 Instant Booking
What is Instant Book?
Listings with âInstant Bookâ enabled can be booked immediately without waiting for host approval. Payment is authorized and the booking is confirmed on the spot.
How to Identify Instant Book: - Look for the â⥠Instant Bookâ badge on listing cards - Listing detail page shows âBook Nowâ button (not âRequest to Bookâ) - Follow standard booking steps (payment processes immediately) - Booking confirmed instantly (no host approval needed)
Benefits for Guests: - â Immediate confirmation - â No waiting for host response - â Secure your dates instantly - â Better for last-minute bookings
4.3.3 Request to Book (Not Instant Book)
How It Works: 1. Identify listings without the instant book badge 2. Listing detail page shows âRequest to Bookâ button 3. Follow standard booking steps 4. Write a message to the host (optional but recommended) 5. Tap âSend Requestâ 6. Wait for host approval (up to 24 hours)
Message to Host Tips: - Introduce yourself - Explain purpose of stay - Mention any special requests - Be polite and clear
What Happens Next: - Host has 24 hours to respond - Youâll receive notification when host responds - If approved: - Payment is processed automatically - Booking is confirmed - If declined: - No charge is made - Host may provide reason - You can search for alternative properties
4.3.4 Payment Holds & Charges
How Payment Works: 1. Authorization Hold - Full amount held on your card when booking confirmed 2. Capture - Charge is finalized 24 hours before check-in 3. Host Payout - Host receives payment 24 hours after check-in
Security Deposit: - Some properties require security deposit - Held separately on your card - Released 3-5 days after checkout (if no damage)
4.3.5 Booking Confirmation
After Successful Booking:
What You Receive: - đ§ Email Confirmation - Booking details, reference number (can be configured in preference page) - đą In-App Notification - Booking confirmed - đŹ Automatic Message Thread - Opens with host
Booking Details Include: - Property name and address - Check-in/check-out dates and times - Total price paid - Guest count - Host contact information - Booking reference number - Directions to property - WiFi password (if provided) - Entry instructions
4.3.6 Booking Hotels & Hostels (Room/Bed Selection)
NEW FEATURE (Slice V): Hotels, Hostels, Boutique Hotels, and Resorts now support multi-unit booking, allowing you to choose specific room or bed types and book multiple units in a single reservation.
How Multi-Unit Properties Differ:
| Property Type | Selection Unit | Example | Inventory |
|---|---|---|---|
| Hotel/Boutique Hotel | Room Type | âDeluxe King Roomâ, âStandard Doubleâ | Book 1+ rooms |
| Hostel | Bed Type | âBunk in 6-Bed Dormâ, âFemale Dorm Bedâ | Book 1+ beds |
| Resort | Room/Suite Type | âOcean View Suiteâ, âGarden Villaâ | Book 1+ units |
| House/Apartment | Entire Property | Book the whole place | 1 unit only |
Booking Flow for Hotels/Hostels:
Step 1: View Listing Detail
When viewing a Hotel or Hostel listing, youâll see new sections:
A. Property Overview (same as before) - Photos, location, host info, shared amenities
B. Room Types / Bed Types Section (NEW) - Scrollable cards showing each available room/bed type - Each card displays: - Type name (e.g., âDeluxe Suiteâ, â4-Bed Mixed Dormâ) - Price per night per room/bed - Beds and bed type (e.g., â1 King Bedâ or â1 Bunk Bedâ) - Max guests per unit - Room-specific amenities (Balcony, Minibar, Private Bath, etc.) - Availability indicator for your dates
Step 2: Select a Room/Bed Type
- Tap a room/bed type card to view full details
- See detailed description, all amenities, and photos
- Review room-specific house rules (if any)
- Tap âSelect This Roomâ or âSelect This Bedâ
Step 3: Choose Quantity
For Groups/Families: - Use the quantity picker to book multiple rooms/beds - Example: Book 2 Deluxe Rooms for a family reunion - Example: Book 4 beds in a dorm for a group trip
Quantity Picker Shows: - Available units for your dates (e.g., â5 of 10 rooms availableâ) - Total price updates as you change quantity - Max guests = units_booked Ă max_guests_per_unit
Step 4: Review & Book
Booking Summary Shows: - Room/Bed Type: âDeluxe King Roomâ - Quantity: â2 Roomsâ - Dates: Dec 20-23 (3 nights) - Price Calculation: Room Rate: $150/night Ă 3 nights Ă 2 rooms = $900 Cleaning Fee: $30 Ă 2 rooms = $60 Service Fee: 12% = $115.20 âââââââââââââââââââââââââââââââââââââââââââââââââ Total: $1,075.20 - Max Guests: 4 (2 per room Ă 2 rooms)
Step 5: Payment & Confirmation
Proceed with standard payment flow (Section 4.3.1). After booking: - Confirmation shows: Room type name + quantity booked - Room assignment: Specific rooms (e.g., âRoom 501â) may be assigned by host - Check-in instructions: Same as other bookings
Availability Indicators:
| Indicator | Meaning |
|---|---|
| â â5 Availableâ | 5 units of this type available for your dates |
| â ď¸ â2 Leftâ | Limited availability - book soon |
| â âFully Bookedâ | No units available for selected dates |
| đ âCheckingâŚâ | Loading availability (change dates to refresh) |
Viewing Your Hotel/Hostel Booking:
In Trips â Upcoming, your booking card shows: - Property name and thumbnail - Room/Bed type name (e.g., âDeluxe King Roomâ) - Units booked (e.g., â2 Roomsâ or â3 Bedsâ) - Check-in/check-out dates - Total price paid
Booking Details Page Shows: - Full room type description - Room-specific amenities - Assigned room numbers (if provided by host) - Standard booking actions (Message Host, Cancel, Get Directions)
Important Notes:
- đ¨ Hotels/Boutique Hotels: Private rooms with ensuite bathrooms
- đď¸ Hostels: Shared dorms at budget prices; book by the bed
- đď¸ Resorts: Premium accommodations with resort amenities
- đ Real-time availability: Updates as others book
- đĽ Guest limit:
units_booked Ă max_guests_per_unit - đ˘ Room assignment: Specific rooms assigned by host (automatic or manual)
- đ° Pricing: Per room/bed per night (not per person)
Why Choose Hotels/Hostels on Peapod?
- Better Rates - Direct booking often cheaper than OTAs
- Loyalty Points - Earn rewards on every stay (same as vacation rentals)
- Host Communication - Direct messaging with property staff
- Transparent Pricing - No hidden fees, same checkout flow
- Room-Level Amenities - See exactly what each room type offers
- Flexible Booking - Book multiple rooms/beds in one transaction
4.4 Manage Your Bookings
4.4.1 View All Bookings
Location: Main tab â âTripsâ (suitcase icon)
How to View Bookings: 1. Tap âTripsâ tab in bottom navigation 2. Select a category: Upcoming, Past, or Cancelled 3. Scroll to browse all bookings in that category
Booking Categories: - Upcoming - Future reservations - Past - Completed stays - Cancelled - Cancelled bookings
Each Booking Card Shows: - Property photo - Property name - Dates - Location - Booking status - Quick actions (Message Host, View Details, Cancel)
4.4.2 View Booking Details
Tap any booking card from Trips to open the detailed booking page.
Booking Detail Page: - Property Information - Photo, name, address - Dates - Check-in and check-out with times - Guests - Number of guests - Status - Confirmed, Pending, Checked In, Completed, Cancelled - Payment Status - Paid, Pending, Refunded - Price Breakdown - All charges itemized - Host Contact - Name, photo, âMessage Hostâ button
Available Actions: - Get Directions (opens Maps app) - Message Host - Cancel Booking (if eligible) - Report Issue - Leave Review (after stay)
4.4.3 Cancel a Booking
Eligibility: - Only upcoming bookings can be cancelled - Refund depends on cancellation policy and time until check-in - Real-time refund preview before confirmation
Cancellation Policies: 1. Flexible - Full refund if cancelled 24+ hours before check-in - Base price: 100% refund (>24h), 50% refund (<24h) - Service fee: Refundable
- Moderate - Full refund if cancelled 5+ days before check-in
- Base price: 100% refund (>5 days), 50% refund (2-5 days), 0% (<2 days)
- Service fee: Refundable
- Strict - Full refund if cancelled 14+ days before check-in
- Base price: 100% refund (>14 days), 50% refund (7-14 days), 0% (<7 days)
- Service fee: Non-refundable
- Non-refundable - No refunds (10% discount)
- Base price: 0% refund at any time
- Lowest price option, no flexibility
Important: Whatâs Always Refunded - â Cleaning fee: 100% refunded (no cleaning needed if you donât stay) - â Taxes: 100% refunded (no tax applies if you donât stay) - The cancellation policy percentage only applies to the base price (accommodation)
Automatic Refund Calculation: - Real-time preview showing exact refund amount before confirming - Detailed breakdown of base price, cleaning fee, service fee, and tax refunds - Policy-based calculation automatically applies correct rules - Time-aware calculation considers hours/days until check-in
How to Cancel: 1. Go to Trips â Select upcoming booking 2. Scroll to bottom and tap âCancel Bookingâ button (red) 3. Review the refund preview alert showing: - Current cancellation policy - Time remaining until check-in - Calculated refund amount - Detailed breakdown (base price + fees + taxes) 4. Tap âConfirm Cancellationâ to proceed or âGo Backâ to cancel 5. Wait for processing (2-3 seconds) 6. Review cancellation confirmation with refund summary
After Cancellation: - Booking status changes to âCancelledâ - Refund processed automatically to original payment method (3-5 business days) - Refund amount matches preview (no surprises) - Host is notified automatically - Cancellation email sent to both guest and host - Booking moves to âCancelledâ tab
Refund Examples:
Example 1: Flexible Policy (cancelled 48h before) - Booking: $500 base + $50 cleaning + $60 service fee + $40 tax = $650 total - Base price refund: 100% = $500 â - Cleaning fee refund: 100% = $50 â (always refunded) - Taxes refund: 100% = $40 â (always refunded) - Service fee refund: 100% = $60 â (Flexible allows) - Total refund: $650 (full refund)
Example 2: Moderate Policy (cancelled 3 days before) - Booking: $500 base + $50 cleaning + $60 service fee + $40 tax = $650 total - Base price refund: 50% = $250 (partial per policy) - Cleaning fee refund: 100% = $50 â (always refunded) - Taxes refund: 100% = $40 â (always refunded) - Service fee refund: 100% = $60 â (Moderate allows) - Total refund: $400 (not $325 - cleaning & taxes always refunded!)
Example 3: Strict Policy (cancelled 5 days before = no base refund) - Booking: $500 base + $50 cleaning + $60 service fee + $40 tax = $650 total - Base price refund: 0% = $0 (within 7-day window) - Cleaning fee refund: 100% = $50 â (always refunded) - Taxes refund: 100% = $40 â (always refunded) - Service fee refund: 0% = $0 (Strict = non-refundable) - Total refund: $90 (cleaning + taxes only)
Example 4: Non-refundable - Booking: $450 base (10% discount) + $50 cleaning + $54 service fee + $36 tax = $590 total - Cancelled: Any time - Total refund: $86 (cleaning $50 + taxes $36 only)
4.4.4 Modify Booking Dates
â Available: Fully automated date modifications with automatic approval, payment processing, and instant confirmation.
How It Works:
Peapodâs smart modification system follows your bookingâs cancellation policy to automatically approve or require host approval:
Automatic Approval (No Host Approval Needed): - Flexible Policy: Modifications âĽ24 hours before check-in are auto-approved - Moderate Policy: Modifications âĽ5 days before check-in are auto-approved - Strict Policy: Modifications âĽ7 days before check-in are auto-approved
Requires Host Approval: - Modifications outside the policy period above must be approved by the host
How to Modify Your Booking:
- Open Your Booking
- Go to Trips â Upcoming â Select booking
- Tap âModify Datesâ button
- Select New Dates
- Choose new check-in and check-out dates
- System calculates price difference automatically
- See preview: refund amount or additional charge
- Review Price Changes
- Shortened Stay â Partial refund to your payment method
- Extended Stay â Additional charge to your saved card
- Same Price â No payment adjustment needed
- Confirm Modification
- Tap âConfirm Changesâ
- Payment processes automatically (if needed)
- Success: Booking updated instantly + confirmation notifications sent
- Payment Failed: Modification blocked, original booking unchanged
What Happens Next:
If Auto-Approved: - â Booking updated with new dates immediately - â Payment/refund processed automatically via Stripe - â You receive confirmation notification with updated itinerary - â Host receives notification about the change - â Email confirmation sent to both parties
If Requires Host Approval: - âł Request sent to host - âł Host has 24 hours to approve/decline - âł You receive notification when host responds - â If approved: Payment processes and booking updates - â If declined: No charge, original dates remain
Payment Processing:
- Refunds (shortened stay) process within 3-5 business days
- Additional charges (extended stay) use your saved payment method
- Payment failures block the modification - your original booking remains unchanged
- All payment details shown before you confirm
Important Notes:
- â ď¸ Modifications must be made BEFORE check-in
- â ď¸ Payment method must be valid for extended stays
- â ď¸ Both you and host receive notifications on success/failure
- â ď¸ If payment fails, modification is blocked and original booking is preserved
- â No hidden fees - price difference shown upfront
- â Cancellation policy rules apply (same as cancellation refunds)
Example Scenarios:
Example 1: Shorten Stay (Refund) - Original: Dec 10-15 (5 nights Ă $100 = $500) - New: Dec 10-13 (3 nights Ă $100 = $300) - Result: $200 refund to your payment method (3-5 business days)
Example 2: Extend Stay (Additional Charge) - Original: Dec 10-13 (3 nights Ă $100 = $300) - New: Dec 10-17 (7 nights Ă $100 = $700) - Result: $400 additional charge to your saved card (instant)
Example 3: Date Shift (Same Price) - Original: Dec 10-15 (5 nights Ă $100 = $500) - New: Dec 12-17 (5 nights Ă $100 = $500) - Result: No payment needed, dates updated instantly
Troubleshooting:
- âPayment method requiredâ - Add/update payment method in account settings
- âCard declinedâ - Update payment method and try again
- âModification blockedâ - Payment failed, original booking unchanged
- âPending host approvalâ - Outside policy period, wait for host response
4.5 Message Your Host
4.5.1 Access Messages
Location: Main tab â âInboxâ (chat bubble icon)
How to Access: 1. Tap âInboxâ tab in bottom navigation 2. View list of all conversations (most recent first) 3. Red unread badge appears on tab if you have new messages 4. Tap any conversation to open
Inbox View Shows: - Host profile photo - Property name - Last message preview - Timestamp (e.g., â2h agoâ) - Unread count (red badge)
4.5.2 Start a Conversation
Before Booking: 1. From listing detail page, scroll to host section or tap host avatar 2. Tap âContact Hostâ button 3. Type your message 4. Tap âSendâ (paper airplane icon)
After Booking: - Conversation is automatically created when you book - Access from Inbox or Booking Details - Tap âMessage Hostâ button
4.5.3 Send Messages
How to Send: 1. Tap message input field at bottom 2. Type your message 3. Tap send button (paper airplane icon) 4. Message appears in thread with âDeliveredâ status 5. Status updates to âReadâ when host reads it
Message Features: - Real-time delivery - Read receipts - Typing indicators (âHost is typingâŚâ) - Timestamps - Message threading
Message Etiquette: - Be polite and professional - Ask clear, specific questions - Provide relevant details about your stay - Respond promptly to host inquiries
4.5.4 Common Questions to Ask Hosts
Before Booking: - Early check-in or late checkout availability? - Parking instructions? - Public transport access? - Quiet hours or neighborhood rules? - Pet policy specifics? - Suitable for children/elderly?
Before Check-In: - Exact entry instructions? - WiFi password? - Thermostat usage? - Trash/recycling procedures? - Where to park?
During Stay: - Report any issues immediately - Ask questions about appliances - Request local recommendations - Notify of any damage
4.6 During Your Stay
4.6.1 Check-In
Before You Arrive: 1. Go to Trips â Upcoming booking 2. Tap booking to view details 3. Read the âCheck-In Instructionsâ section carefully 4. Note the property address and host contact info 5. Tap âGet Directionsâ to navigate with Maps
Check-In Process: - Standard Check-In Time: 3:00 PM (varies by property) - Follow hostâs specific instructions: - Keypad code - Key pickup location - Meet host in person - Lockbox code - Smart lock app
If You Canât Access Property: 1. Message host immediately via Inbox 2. If no response within 15 minutes, call host (phone number in booking details) 3. If still unable to access, tap âReport Issueâ in booking or contact Peapod support
4.6.2 During Your Stay
House Rules Reminder: - Follow all house rules posted - Respect check-out time - Maintain cleanliness - Report any damage immediately - No unauthorized guests - Respect neighbors - No smoking (unless allowed) - No parties (unless allowed)
Need Assistance? - First: Message your host - If host unavailable: Contact Peapod support - Emergency: Contact local emergency services (911)
Maintenance Issues: 1. Notice an issue (e.g., WiFi down, AC broken) 2. Message host immediately via Inbox 3. Document issue with photos (tap camera icon in message) 4. Host should respond within 2 hours 5. If unresolved, tap âReport Issueâ in booking 6. You may be eligible for a partial refund if the issue remains unresolved
4.6.3 Check-Out
Standard Check-Out Time: 11:00 AM (varies by property)
Check-Out Checklist:
On the morning of checkout: - â Gather all belongings (check closets, drawers, bathrooms) - â Dispose of trash (follow host instructions) - â Wash dishes or load dishwasher - â Strip beds (if requested by host) - â Turn off lights, thermostat, appliances - â Lock all doors and windows - â Return keys (if applicable) - â Leave by checkout time
Late Check-Out: - Must be arranged with host in advance - Message host to request - May incur additional fee - Not guaranteed
4.7 Reviews & Ratings
4.7.1 Why Reviews Matter
- Help future guests make informed decisions
- Provide feedback to hosts
- Build trust in the Peapod community
- Improve platform quality
- Influence search ranking
4.7.2 When to Leave a Review
Review Window: - Opens immediately after check-out - Closes 14 days after check-out - Reviews published after both guest and host submit (or after 14 days)
Review Prompt:
After checkout, youâll receive: - In-app notification: âHow was your stay?â - Email reminder (if not completed after 3 days)
How to Access Review: - Tap the notification to go directly to the review page - OR go to Trips â Past â Select booking â âLeave Reviewâ
4.7.3 How to Write a Review
Step 1: Access Review Page - Go to Trips â Past bookings â Select completed booking - Tap âLeave Reviewâ button
Step 2: Rate the Property (1-5 stars) Rate each category by tapping stars: - Overall rating - Cleanliness - Accuracy (matches listing description) - Communication (host responsiveness) - Location - Value for money
Step 3: Write Review Text (Optional but Encouraged) - Type your experience (500 characters max) - Share highlights and mention any issues - Character count displayed as you type
Step 4: Add Photos (Optional, up to 5) 1. Tap âAdd Photosâ button 2. Choose from photo library 3. Photos appear as thumbnails 4. Tap X to remove unwanted photos 5. Photos upload when you submit the review
Photo Guidelines: - â Show property accurately (rooms, amenities, views) - â Highlight positive or negative aspects - â Good lighting and focus - â Respectful of host privacy - â Donât include people without permission - â Donât include personal information - â Maximum 5 photos per review - â File size automatically compressed (max 5MB per photo)
Photo Upload Behavior: - Photos compressed automatically before upload - Upload happens when you submit the review - If photos fail to upload, youâll see a warning but review text is still saved - You can add photos later if upload fails
Step 5: Submit 1. Review your ratings and text 2. Tap âSubmit Reviewâ button 3. Confirmation appears 4. Review is private until both guest and host submit (or 14 days pass)
Review Guidelines: - â Be honest and constructive - â Focus on your experience - â Mention specific details (cleanliness, accuracy, location) - â Help future guests decide - â Donât include personal attacks - â Donât share personal contact info - â Donât mention price (price changes over time) - â Donât threaten host with bad review
After Submission: - Review is private until both sides review (or 14 days pass) - Cannot be edited once published - Host can respond publicly to your review - Review appears on listing page - Contributes to overall listing rating
4.8 Loyalty Program (Rewards)
4.8.1 How Peapod Rewards Work
Earn Points: - Booking Completed - Points based on eligible amount (base price + cleaning fee) - Leave Review - 50 bonus points - Referrals - Points when friends book (coming soon) - Special Promotions - Limited-time bonus points
Points Value: - 1 point = 0.01 in your home currency ($0.01 USD or ÂĽ0.01 CNY) - Points are valued in YOUR home currency (set during account creation) - Points never expire - Can be combined with other discounts
What is âEligible Amountâ? - Eligible amount = Base price + Cleaning fee - Excludes: service fees and taxes - This is the base for both earning and redeeming points
Earning Formula: - Points earned = Eligible amount Ă Tier earning rate - Example (Silver tier, 3%): $100 base + $20 cleaning = $120 eligible â 360 points ($3.60 value) - Review bonus = +50 points - Total = 410 points ($4.10 value)
Currency & Points: - Your points are always valued in your home currency - USD users: 1 point = $0.01 - CNY users: 1 point = ÂĽ0.01 - Points balance shown with approximate value (e.g., â9,126 points â $91.26â)
4.8.2 View Your Rewards
Location: Main tab â âRewardsâ (star icon)
How to View: 1. Tap âRewardsâ tab in bottom navigation 2. View rewards dashboard showing: - Current points balance - Current tier (Silver, Gold, Platinum, Diamond) - Progress to next tier - Earning history - Redemption history 3. Tap âRedeem Pointsâ to use your points
4.8.3 Guest Loyalty Tiers
Tier Levels (Based on Annual Spending):
| Tier | Annual Spend | Earning Rate | Key Benefits |
|---|---|---|---|
| Silver | $0+ | 3% | Standard support |
| Gold | $2,500+ | 4% | Priority support, early promotions |
| Platinum | $5,000+ | 5% | Premium support, exclusive deals, late checkout |
| Diamond | $10,000+ | 6% | VIP 24/7, upgrades, personal concierge |
Example Earnings by Tier:
For a $200 booking (base $180 + cleaning $20 = $200 eligible): - Silver (3%): 600 points = $6.00 value - Gold (4%): 800 points = $8.00 value - Platinum (5%): 1,000 points = $10.00 value - Diamond (6%): 1,200 points = $12.00 value
Note: Tiers are based on ANNUAL SPENDING only, not number of bookings. Your spending resets each year. Spending is tracked in your home currency.
Tier Progress:
To view your tier progress: - Current tier badge displayed on dashboard - Progress bar shows spending toward next tier - Tap âView Requirementsâ to see detailed tier benefits and spending thresholds - Annual spending total tracked automatically
4.8.4 Redeem Points
Redemption Options: - Booking Discount - Apply points to reduce your booking cost
How to Redeem: 1. During checkout, toggle âUse Pointsâ to ON 2. Use slider to select how many points to redeem 3. See real-time discount preview in price breakdown 4. Complete booking - points deducted from your balance 5. Discount appears in final receipt
Redemption Rules: - Maximum redemption: 20% of eligible amount (base price + cleaning fee) - Minimum redemption: 100 points - 1 point = 0.01 in your home currency (1 cent discount) - Points deducted immediately upon booking - If booking cancelled, points refunded - Points never expire - Cannot cash out (use for booking discounts only)
Redemption Example:
Booking: $200 base + $50 cleaning = $250 eligible amount - Max redemption: 20% Ă $250 = $50 = 5,000 points - Your balance: 3,000 points - You can redeem: Up to 3,000 points = $30 discount
After redemption: - Total: $250 - $30 discount = $220 + fees + taxes
4.9 Referral System
Location: Rewards tab â Referral (Guest users only)
4.9.1 How Guest Referrals Work
Simple & Straightforward: Invite friends to join Peapod. Earn 2% commission on their bookings for 12 months. No signup bonuses, no holding periods - just clean, immediate earnings!
Getting Started: 1. Go to Rewards tab â Referral sub-tab 2. Your unique referral code is displayed (e.g., âJOHN1234â) 3. Tap âCopyâ to copy code OR âShareâ to share invite link 4. Share via iMessage, WhatsApp, Email, or any app
How You Earn: 1. Friend signs up with your referral code 2. Friend books a stay 3. You earn 2% of booking amount immediately (as points) 4. Commission continues for 12 months from signup date 5. No holding period - points available right away!
Earnings Example: - Friend books $100 stay â You earn 200 points ($2.00) - Friend books $500 stay â You earn 1,000 points ($10.00) - Friend books $1,000 stay â You earn 2,000 points ($20.00) - Total after 3 bookings: 3,200 points ($32.00)
Points Conversion: - 100 points = $1.00 USD - Use points to redeem on future bookings
UI Elements (Referral Tab): - Your Referral Code - Large, monospaced display - Copy Button - One-tap copy to clipboard - Share Button - Opens iOS share sheet - Total Referral Earnings - Total points earned - Stats Cards: - Total Referrals (friends who signed up) - Active Referrals (still within 12 months) - Total Bookings (all bookings from referrals) - Last 12 Months (recent earnings) - Referral History - Transaction list with: - Referee name - Booking amount - Points earned - Date - Commission percentage
4.9.2 Sharing Your Referral Code
Method 1: Copy & Paste 1. Tap âCopyâ button 2. Paste code anywhere (text, email, etc.) 3. Friend enters code during signup
Method 2: Share Link (Recommended) 1. Tap âShareâ button 2. iOS share sheet appears 3. Choose app (iMessage, WhatsApp, Email, etc.) 4. Message auto-fills with: ``` Hey! Iâm using Peapod to find amazing places to stay. Join me with my referral code JOHN1234 and start exploring!
https://peapod.com/join?ref=JOHN1234 ``` 5. Send to friends!
Admin Can Customize Share Message: - Admins can edit the share message template - Available in Admin â Config â Referral â Share Message - Use placeholders: {CODE}, {NAME}, {LINK}
4.9.3 Tracking Your Referral Earnings
Referral Dashboard (Rewards â Referral):
Top Section - Summary: - Total Referral Earnings: 0 pts - Approximate value in USD
Referral Code Card: - Your code (JOHN1234) - Copy & Share buttons
Stats Grid (4 Cards): 1. Total Referrals - How many friends signed up 2. Active Referrals - Still within 12-month window 3. Total Bookings - All bookings from referrals 4. Last 12 Months - Recent earnings (points)
Referral History: - List of all commission transactions - Shows: Friend name, booking amount, points earned, date - Pull to refresh for latest data
Empty State: - âNo referrals yetâ - âShare your referral code to earn rewards!â
4.9.4 Referral Rules & Limitations
Eligibility: - â Guest users only (travelers) - â Hosts, Admins, Curators cannot refer
Duration: - 12 months from friendâs signup date - Configurable by admin (default: 12 months)
Commission Rate: - 2% of refereeâs booking amounts - Configurable by admin (default: 2%)
Signup Flow: - Optional referral code field during guest signup - Only visible when âGuestâ account type selected - Code auto-applied when using share link
Important Notes: - Self-referrals not allowed - Code must be entered during signup (canât add later) - Commission awarded when booking status = âcompletedâ - No holding period - immediate availability - Must wait 90 days after earning (anti-fraud) - Cashout via Stripe (bank transfer or debit card) - Points never expire
How to Cash Out: 1. Go to Rewards â âReferralsâ 2. Check âAvailable to cash outâ balance 3. Tap âCash Outâ 4. Enter amount (minimum 2,500 points) 5. Select payout method (bank account or debit card) 6. Confirm details and tap âRequest Payoutâ 7. Funds transferred in 3-5 business days
Cashout Important Notes: - Points earned from referrals can be used only for booking discounts - Cash withdrawal is not available in CN Release 1.0 - All loyalty and referral points can only be redeemed as booking discounts - 90-day holding period prevents fraud and chargebacks - Points never expire, even locked ones
4.10 Profile & Settings
For common profile and account features, see the Common Features section in the main manual:
- Profile Management - View and edit your profile, profile tabs
- Messaging System - How to send and receive messages
- Notification Settings - Configure alerts and notifications
- Account Settings - Email, password, 2FA, security
- Region & Language - Language, currency, time zone
- Privacy Settings - Visibility, data download, account deletion
- Help & Support - Get help, contact support, report problems
- Sign Out - How to sign out
Guest-Specific Profile Features:
Profile Stats: - Trips count (completed bookings) - Reviews received count - Years as member
Stats are displayed below your name and update in real-time.
Identity Verification:
Guests can verify their identity to build trust with hosts:
- From your profile, tap âVerifyâ button (shield icon)
- Choose verification type:
- Email (verify via link)
- Phone (SMS code) - Primary verification method for CN Release 1.0
- Government ID (Future feature â not available in Release 1.0)
- Student status (for discounts)
- Follow the verification steps
- Receive confirmation
- âPhone Verifiedâ badge appears on your profile
CN Release 1.0 Identity Verification:
For CN Release 1.0, identity verification uses phone/SMS verification only: - US Users: SMS verification via Twilio to US mobile numbers - China Users: SMS verification via Twilio to Chinese mobile numbers (+86) - After verification: âPhone Verifiedâ badge displayed on your profile
Note: Full document ID verification (WeChat ID, government ID upload) is planned for a future release and is not available in CN Release 1.0.
Verification Benefits: - Builds trust with hosts - Phone Verified badge increases booking approval rate - Student verification unlocks discounts - Verified users preferred by hosts
Viewing Other Usersâ Profiles:
You can view public profiles of hosts, reviewers, and other users:
How to Access: - Tap host name on listing - Tap user avatar in messages - Tap reviewer name in reviews
What You Can See (Public View): - Avatar and name - User type - Member since - Reviews received - About section (bio, languages) - Listings (if host)
What You Cannot See: - Email address - Phone number - Payment methods - Private settings
Appendices
For detailed reference material, see the separate appendix document:
Contains: - Appendix A: Commute Filter Technical Details - Appendix B: Booking Modification Reference - Appendix C: AI-Powered Features - Appendix D: Points & Rewards Details
â Back to Index | Host Guide â