Overview
What is the PriceTravel Wholesalers API
Section titled “What is the PriceTravel Wholesalers API”A set of REST services over HTTP that provides an electronic sales channel for PriceTravel Holding’s tourist products. Used by B2B partners (wholesalers, OTAs, gateways) to integrate hotel inventory, rates, and booking capabilities.
About PriceTravel Holding
Section titled “About PriceTravel Holding”The largest retail travel agency in Mexico, headquartered in Cancún. The company has long-standing alliances with hotel partners across Mexico, the Caribbean, Latin America, and major international suppliers worldwide.
Capabilities
Section titled “Capabilities”- Get full hotel content: rooms, restaurants, amenities, location, photos, videos.
- Search rates across multiple hotels in a single request.
- Complete booking process: search → check → hold → book → cancel.
- Multi-room bookings with shared rate keys.
Partner onboarding flow
Section titled “Partner onboarding flow”- Read API documentation.
- Sign business partner agreement with Price Travel Holding.
- Receive credentials:
client_id,client_secret, andPartnerKey. - Develop and test integration in Integration / Test environment.
- Complete certification process.
- Get production access.
Terminology
Section titled “Terminology”| Term | Meaning |
|---|---|
| Partner | Entity with a signed business agreement. |
| Client | The application calling the API. |
| Channel ID | Numeric ID identifying a specific partner integration. |
| RateKey | Encrypted token referencing a specific rate at a specific moment. |
| BookingKey | Encrypted token referencing a held rate, ready to confirm. |
| BookingId | Numeric ID of a confirmed reservation. |
High-level architecture
Section titled “High-level architecture”Partner App │ ├─→ Token endpoint (auth) ├─→ Hotels endpoints (rates, checkrates) ├─→ Bookings endpoints (hold, create, get, cancel) └─→ Content Catalog endpoints (hotels, mealplans, cities)
