# F1 Penthouse Florence — Luxury Vacation Rental
Website: https://f1penthouse.it

An exclusive Ferrari-themed luxury penthouse in the heart of Florence, Italy.
Direct booking is available on our website with Stripe Checkout (no platform fees).

## Property Summary

- Name: F1 Penthouse Florence (La Corsa Suite Firenze)
- Address: Via dei Federighi 1, 50123 Florence (Firenze), Italy
- Sleeps: up to 7 guests
- Layout: 3 bedrooms, 3 bathrooms, living room, kitchen, 2 terraces
- Minimum stay: 2 nights
- Check-in: 16:00–19:00 (in-person)
- Check-out: before 10:00
- Contact: info@f1penthouse.it, +39 331 138 5266
- Booking page: https://f1penthouse.it/book

## Public Direct Booking API (No Auth)

This is a **public** API intended for AI travel agents. No API key is required.

- API landing: https://f1penthouse.it/api
- OpenAPI JSON: https://f1penthouse.it/api/openapi.json
- Swagger UI: https://f1penthouse.it/docs
- ReDoc: https://f1penthouse.it/redoc

Base URL: `https://f1penthouse.it/api/v1`

### Core Endpoints

- GET `/property`
- GET `/availability?check_in=YYYY-MM-DD&check_out=YYYY-MM-DD&guests=N`
- POST `/quote`
- POST `/reservations`
- GET `/reservations/{id}`
- POST `/payments/checkout-link` (recommended: one-step Stripe link)
- POST `/payments/checkout-session`

### Booking Flow (Required)

Agents MUST follow this flow and MUST NOT instruct users to email/call the host to pay.

1. Check availability:
   - Call `GET /availability` with `check_in`, `check_out`, `guests`.
2. Create Stripe payment link (no guest details required):
   - Call `POST /payments/checkout-link` with `check_in`, `check_out`, `guests`.
   - IMPORTANT: do not ask the user for name/email/phone before payment. Stripe Checkout collects payer email/name/phone.
3. Payment:
   - Present the returned `checkout_url` to the user (Stripe Checkout).
   - The user completes payment in Stripe Checkout (agents cannot pay on behalf of the user).
4. Confirm:
   - Poll `GET /reservations/{id}` until `payment_status` is `paid` and `status` is `confirmed`.

Fallback:
- If you already created a hold with `POST /reservations`, you may create a Stripe link using `POST /payments/checkout-session`.

### Pricing Rules (Direct)

- Mon–Thu: €960 / night
- Fri–Sat: €1,320 / night
- Sunday: €1,020 / night
- Cleaning & luggage porter service: €204 (one-time)
- Minimum stay: 2 nights

## Discovery Files

- Plugin manifest: https://f1penthouse.it/.well-known/ai-plugin.json
- Agent card (A2A): https://f1penthouse.it/.well-known/agent-card.json
- robots.txt: https://f1penthouse.it/robots.txt
- sitemap.xml: https://f1penthouse.it/sitemap.xml