Hotel API integration
Hotelbeds API integration with live rates, bookings and vouchers
Connect your Hotelbeds account to PHPTRAVELS and sell its hotels next to your own: live rates and availability, rate checks before payment, instant confirmation, PDF vouchers, amendments and cancellations.
- Live rates and availability
- Rate check before payment
- Vouchers and cancellations
- Mapping and caching
How it works
Hotelbeds inside your hotel booking engine
Hotelbeds is an independent B2B bed bank that distributes contracted hotel inventory to travel companies through its API. PHPTRAVELS calls that API with your own credentials and runs the full flow, from search and rate check to confirmation, voucher and cancellation, with logging, retries and idempotency keys so a timeout never turns into a duplicate booking.
- Get your Hotelbeds API key, secret and allowed markets and currencies
- Add the keys in the admin and set markups per market or channel
- Map destinations, hotels and room and board codes, with cached content
- Test search, rate check, booking, voucher and cancellation in the test environment
- Complete certification where your contract requires it, then switch to live
- Environment
- Test
- Endpoint
- api.test.hotelbeds.com
- Credentials
- API key: •••• · Secret: ••••
- Markup
- 12% on net rates
- Markets and currency
- ES, AE · EUR
Search and booking
Hotelbeds rooms with boards, rate types and cancellation terms
Every Hotelbeds result carries the details your guests and agents compare, and the rules your booking flow needs.
- 4★Rambla Garden HotelDouble room · Bed and breakfast$486per stay
- 5★Port Vell SuitesJunior suite · Half board$742per stay
- Eixample ApartmentsOne-bedroom apartment · Room only$395per stay
Mapping and caching
Destination, hotel and room-type mapping with a timed content cache, cleared when a booking confirms.
Rate checks
Rates that need a recheck are re-priced before payment, so guests pay the amount Hotelbeds confirms.
Remarks and policies
Rate comments, cancellation windows and fees shown before booking and printed on the voucher.
Retries and idempotency
Exponential backoff, a circuit breaker and idempotency keys keep timeouts from creating duplicate bookings.
Supplier logs
Request and response logs, error traces and rate-limit handling, exportable as an audit trail.
Multi-currency display
Hotelbeds net rates shown in your guests' currencies with your FX and rounding rules.
Booking flow
From Hotelbeds search to voucher and cancellation
The steps PHPTRAVELS runs for every Hotelbeds booking, the same way for your public site and your agents.
Search
Availability by destination, dates and occupancy, merged with your own hotels.
Rate check
Rates marked for recheck are re-priced and their policies refreshed.
Pay
Guest details and payment, with card capture held until Hotelbeds confirms.
Confirm
The booking is sent with an idempotency key and the Hotelbeds reference is stored.
Voucher
A PDF voucher with the supplier reference and remarks is emailed to the guest.
Amend or cancel
Changes and cancellations follow the rate's policy, with refunds from the admin.
Inventory
Hotelbeds next to your other hotel sources
Hotelbeds is one supplier in the stays module, so its rooms sit in the same search as your contracts and other bed banks.
Hotelbeds hotels
Hotel content, rooms, boards, rates and policies from your Hotelbeds account.
Transfers and activities
Hotelbeds transfers and activities can be added when your contract enables those APIs.
Other suppliers and contracts
Your own contracted hotels and other hotel APIs, each with its own markup rules.
Hotel suppliers you can connect:
Agoda
Amadeus
Booking.com
Hotelbeds
Hotelston
RateHawk
Stuba
TBO Holidays
Travelport
Wanderbeds
Back office
Run Hotelbeds sales from one admin
Margins, agents, payments and supplier records for Hotelbeds bookings, in the same dashboard as every other product.
Markups and commissions
On Hotelbeds net rates per market, city, hotel or channel, as fixed amounts or percentages.
Agents and sub-agents
B2B portals with credit limits, commissions and approval rules for Hotelbeds bookings.
Payments
Card, saved token or offline payment, captured on confirmation and refunded on cancellation.
Supplier references
Find any booking by its Hotelbeds reference, resend vouchers and track amendments.
Alerts
Notifications for failed bookings, price changes at rate check and supplier errors.
Reports
Bookings, margins and supplier payables for Hotelbeds, ready to export.
Compare
Building a Hotelbeds connector in-house vs PHPTRAVELS
Many teams start by coding the Hotelbeds API themselves. This is typically what that involves, next to the ready integration.
| Area | In-house build | PHPTRAVELS |
|---|---|---|
| Booking flow | In-house buildSearch, rate check, booking and cancellation calls written and tested by your developers | PHPTRAVELSSearch, rate check, confirmation, voucher and cancellation built into the hotel module |
| Content mapping | In-house buildRoom and board codes mapped by hand for the project | PHPTRAVELSDestination, hotel and room mapping with cached content |
| Timeouts and errors | In-house buildDuplicate bookings possible unless retries are designed in | PHPTRAVELSRetries, backoff and idempotency keys on every booking |
| Website and agents | In-house buildA separate booking site and agent portal still to build | PHPTRAVELSB2C website and B2B agent portal in the same installation |
| Operations | In-house buildLogs and alerts often added later | PHPTRAVELSSupplier logs, alerts and exportable audit trails |
| More suppliers | In-house buildEach new supplier is another project | PHPTRAVELSAdd other hotel, flight and car APIs from the same admin |
Use cases
Who sells Hotelbeds with PHPTRAVELS
Online travel agencies
A large hotel catalogue on your own brand, with Hotelbeds rooms beside your direct deals.
B2B agencies
Sub-agents book Hotelbeds hotels at their own rates and pay from credit or wallet.
DMCs and tour operators
Hotels, transfers and activities from Hotelbeds combined into packages and itineraries.
Why PHPTRAVELS
Your contract, your platform, your code
Source code included
Self-hosted under a commercial licence, so your developers can extend the Hotelbeds flow.
Your Hotelbeds account
You hold the contract, the net rates and the keys, stored in your own installation.
24 languages
Sell Hotelbeds hotels in your markets' languages and currencies, including right-to-left.
B2C and B2B
One installation for your public website and your agent portal.
FAQ
Hotelbeds API integration questions
What travel companies ask before connecting Hotelbeds.
Talk to salesIt connects your Hotelbeds account to the PHPTRAVELS hotel module, so guests and agents search live Hotelbeds rates and availability, and PHPTRAVELS handles the rate check, booking, voucher, amendments and cancellations.
Yes. You sign the contract with Hotelbeds and receive your own API key, secret and allowed markets and currencies. Some markets need certification before Hotelbeds enables live access.
No. Hotelbeds is an independent B2B bed bank. PHPTRAVELS integrates with Hotelbeds and with Expedia separately, and both can run in the same installation.
Bedsonline is a brand within the Hotelbeds group aimed at travel agents. PHPTRAVELS connects through the Hotelbeds APIs and maps the content in the hotel module.
Yes, when your Hotelbeds contract enables those APIs. They can be sold alone or alongside hotels.
It depends on your plan and on which Hotelbeds products and payment flows you enable. Plans start with Startup at $2499 as a one-time licence; see the pricing page or ask sales for a quote.
Keep exploring