Hotel API integration
Agoda API integration for your hotel booking website
Connect your Agoda partner account to PHPTRAVELS and sell Agoda hotels and homes next to your own contracts: live rates and availability, a price check before payment, confirmation, vouchers and cancellations.
- Live rates and availability
- Hotels, homes and apartments
- Your markup on every rate
- Setup guide in the docs
How it works
A pre-built Agoda connector in the stays module
Agoda, part of Booking Holdings, is an online travel platform with a deep hotel and holiday-rental catalogue across Asia and beyond. PHPTRAVELS ships a ready Agoda module for the stays category: it calls the Agoda partner API with your own credentials and runs search, price check, booking, voucher and cancellation in the same flow as your other hotel suppliers. The setup is covered step by step in a video walkthrough on the PHPTRAVELS docs.
- Join the Agoda partner programme and get your site ID and API key
- Enable the Agoda module and add the credentials in the admin
- Set markups and the cities and currencies you want to sell
- Test search, price check, booking and cancellation before going live
- Switch the module to live and Agoda rooms appear in your search
- Environment
- Sandbox
- Endpoint
- Agoda partner API
- Credentials
- Site ID: •••• · API key: ••••
- Markup
- 10% on Agoda rates
- Markets and currency
- TH, MY, SG · USD
Search and booking
Agoda rooms with prices, policies and status on every result
Each Agoda result carries the room, board and cancellation details guests compare, and the status your booking flow needs.
- 4★Riverside Grand HotelDeluxe river view · Breakfast included–per stay
- 5★Sukhumvit Park ResidenceExecutive suite · Room only–per stay
- Silom Loft ApartmentOne-bedroom home · Room only–per stay
Hotel and city mapping
Agoda cities and properties mapped to your destinations, so one search returns Agoda rooms and your own hotels.
Price check before payment
The selected room is re-priced with Agoda before the guest pays, so the charged amount matches the confirmed rate.
Cancellation policies
Refundable windows, fees and non-refundable rates shown before booking and printed on the voucher.
Timeouts and retries
Booking calls are retried safely, so a slow response does not create a second reservation.
Supplier logs
Agoda requests, responses and errors logged in the admin for support and audits.
Multi-currency display
Agoda rates shown in your guests' currencies with your exchange and rounding rules.
Booking flow
From Agoda search to voucher and cancellation
The steps PHPTRAVELS runs for every Agoda booking, the same way on your public site and in the agent portal.
Search
Agoda availability by city, dates and occupancy, merged with your other hotels.
Price check
The chosen room is re-priced and its policy refreshed before checkout.
Pay
Guest details and payment, by card, wallet or offline method.
Confirm
The booking is sent to Agoda and its reference is stored on the reservation.
Voucher
A voucher with the Agoda reference and policy is emailed to the guest.
Cancel or refund
Cancellations follow the rate's policy, with refunds handled from the admin.
Inventory
Agoda next to your other hotel sources
Agoda is one supplier in the stays module, so its rooms sit in the same search as your contracts and other bed banks.
Agoda hotels and homes
Hotels, resorts, apartments and holiday homes from your Agoda partner account.
Other hotel APIs
Hotelbeds, Hotelston, RateHawk, Stuba and other stay suppliers, each with its own markup rules.
Your own contracts
Hotels you contract directly, loaded in the admin or managed by partners in the extranet.
Hotel suppliers you can connect:
Agoda
Amadeus
Booking.com
Hotelbeds
Hotelston
RateHawk
Stuba
TBO Holidays
Travelport
Wanderbeds
Back office
Run Agoda sales from one admin
Margins, agents, payments and supplier records for Agoda bookings, in the same dashboard as every other product.
Markups and commissions
On Agoda rates per city, hotel or channel, as fixed amounts or percentages.
B2B agents
Agents book Agoda hotels at their own rates and pay from credit or wallet.
Payments
Card or offline payment, recorded against the booking and refunded on cancellation.
Supplier references
Find any booking by its Agoda reference and resend vouchers in one click.
Alerts
Notifications for failed bookings, price changes at checkout and supplier errors.
Reports
Agoda bookings, margins and payables, ready to export.
Compare
Coding an Agoda connector in-house vs PHPTRAVELS
Some teams start by writing the Agoda API calls themselves. This is typically what that involves, next to the ready module.
| Area | In-house build | PHPTRAVELS |
|---|---|---|
| Booking flow | In-house buildSearch, price check, booking and cancellation calls written and tested by your developers | PHPTRAVELSSearch, price check, confirmation, voucher and cancellation built into the stays module |
| Content mapping | In-house buildAgoda cities and hotels mapped by hand for the project | PHPTRAVELSCity and hotel mapping to your destinations in the admin |
| Timeouts and errors | In-house buildDuplicate bookings possible unless retries are designed in | PHPTRAVELSSafe retries and logged errors on every booking call |
| Website and agents | In-house buildA booking site and agent portal still to build | PHPTRAVELSB2C website and B2B agent portal in the same installation |
| Setup | In-house buildInternal notes, if anyone writes them | PHPTRAVELSA video setup guide in the PHPTRAVELS docs |
| 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 Agoda with PHPTRAVELS
Online travel agencies
A large Asia-Pacific hotel catalogue on your own brand, beside your direct deals.
B2B agencies
Sub-agents book Agoda hotels and homes at their own rates from the agent portal.
DMCs and tour operators
Agoda stays combined with tours, transfers and flights into packages.
Why PHPTRAVELS
Your Agoda account, your platform, your code
Source code included
Self-hosted under a commercial licence, so your developers can extend the Agoda flow.
Your Agoda credentials
You hold the partner agreement and the keys, stored in your own installation.
24 languages
Sell Agoda stays in your markets' languages and currencies, including right-to-left.
B2C and B2B
One installation for your public website and your agent portal.
It connects your Agoda partner account to the PHPTRAVELS stays module, so guests and agents search live Agoda rates and availability, and PHPTRAVELS handles the price check, booking, voucher and cancellation.
It is pre-built. Agoda is a ready module in the stays category, with a video setup guide in the PHPTRAVELS docs, so you enable it and add your credentials rather than commissioning development.
Yes. You apply to the Agoda partner programme and receive your own site ID and API key. Agoda decides which products and booking access your account gets.
No. Both belong to Booking Holdings but run separate platforms and partner programmes. PHPTRAVELS connects to Agoda; there is no official Booking.com connector.
Yes. Agoda runs next to Hotelbeds, Hotelston, RateHawk, Stuba and your own contracted hotels, each with its own markup rules, in one search.
It depends on your plan and on which suppliers and payment flows you enable. Plans start with Startup as a one-time licence; see the pricing page or ask sales for a quote.
Keep exploring
More from the platform
- Hotels APIBedbank, OTA, GDS and direct hotel APIs explained
- Hotelston API integrationHotelston hotel rates in your booking engine
- Hotelbeds API integrationContent and Booking APIs, rate checks and hotel mapping
- Booking.com and Priceline APIsBooking.com, Priceline and Expedia hotel API access
- StaysBedbanks and direct contracts
- All integrationsThe live, complete list