What are the certification steps?
Certification consists of 2 steps including self-certification and pilot phase
Self-Certification: A script testing in survey format for partner to complete after finishing the development.
Pilot: A trial period connecting with 2-3 live properties to ensure connection stability.
What are the mandatory calls that must be developed?
GetBookingList (v1 or v2)
What is difference between a generic endpoint and a unique endpoint for each call?
Unique endpoint: This endpoint is unique for a specific request so ‘type’ is not required in request body.
Generic endpoint: This endpoint is a universal endpoint which can be used for any Agoda API request; however, ‘type’ is mandatory in request body.
What are the day limits for each call?
SetAri: 730 days from today
GetAri: 31 days
GetBookingList: Date range = 90 days, looking back 740 days
GetBookingListV2: Date/Time range = 60 mins, looking back 740 days
What is the size limit of each request?
Does Agoda restrict request limit per day?
Does Agoda support child daily rate?
Yes, we do. However, Child daily pricing is not yet supported in YCS Calendar so child pricing can only be retrieved and viewed via API call (GetAri)
What is the difference between Min LOS and Min Night for Stay-Through?
Min LOS: applies only on the arrival date.
Min Night for Stay-Through: applies on stay period, meaning any stay date that arrives or touches this min stay through, the booking will be abided by the rules of that night to the entire stay.
For example: if the property set a restriction on Friday, Jan 1st.
Min LOS: applies only on to bookings checking-in/arriving on Fri Jan 1st.
Min Night for Stay-Through: applies to any booking that includes Fri, Jan 1st (but not bookings checking out on Jan 1st).
Why does CTA/CTD not available in YCS?
Agoda does support CTA/CTD at 2 levels, room level and room/rate plan level via API. However, Agoda YCS UI only has CTA/CTD at room level displayed while CTA/CTD at room/rate plan level can be retrieved and checked by using GetAriV1 or GetAriV2 request.
Does Agoda support price with decimal value?
Yes, we do but only up to 2 decimal places
Why does child rate plan is still opened, when master rate plan is closed?
Restrictions of child rate plan and master rate plan are managed separately. Although we do not allow price update to child rate plan, we allow restrictions update via API for child rate plan.
Why does the rate plan is still opened, when channel manager successfully pushed 'close out = true'?
It's possbile that the rate plan is set up as 'Beds Network - Payout' rate plan type which blocks any ARI update via API.
Can property manage channel discount themselves?
Yes, they can manage channel in YCS > Rates & Availability > Rates Channel.
Only certain channels can be self-managed by the property. If certain channels are not available in the page, please contact Accommodation Services Team via YCS Help Widget for further assistance to manage the channels.
Does Agoda have push booking notification?
Agoda doesn’t have push booking, only BookingHint (Booking Notification), and pull booking calls such as GetBookingList (v1 or v2) and GetBookingDetails.
For BookingHint, Agoda pushes booking notification to channel manager partner when there are new, amend, cancel bookings. Then channel manager partner retrieves complete booking details from Agoda by using GetBookingDetails request.
To set up BookingHint, please provide us an URL endpoint and an email address to receive booking notification email in case BookingHint failed to be pushed.
What is the difference of GetBookingListV1 and GetBookingListV2?
GetBookingListV1: To retrieve the bookings for one specific property or up to 5 properties at once.
GetBookingListV2: To retrieve the bookings without specifying a hotel. This will return all bookings that updated in specified period (Max. 60 mins) of all hotels belongs on channel manager.
How to identify Agoda collect and property collect reservation?
Agoda Collect: <paymentmodel>1</paymentmodel>
Property Collect: <paymentmodel>2</paymentmodel>
Why are we seeing different pricing structures returned in GetBookingDetails?
Agoda has different configurations to return different pricing structures in GetBookingDetails, which are based on property location and payment model. Including:
Default (Agoda Collect): net_inclusive and ref_sell
Property Collect: Sell_inclusive
US and its territories*: Net_exclusive, Net_inclusive, Tax and fee
*US and its territories include: USA, Puerto Rico, US Virgin Islands, Marshall Islands, American Samoa, Guam, Palau, Northern Mariana Islands, Federated States of Micronesia
Is there a Commission attribute in GetBookingDetails?
No, we don’t have commission attribute. The pricing structure is as stated in the answer above.
How do I create test bookings in Sandbox?
Test bookings can only be created in production environment on a test hotel assigned to you.
Making a test booking in Production, do I have to use real credit card?
Yes, however, please follow below steps to avoid charges made on your credit card.
Please at least create bookings with stay period a month in advance
Make test bookings with Book Now Pay Later payment option
You can later manage your bookings (amend or cancel) from My Booking Menu
Once all tests have been completed, please do not forget to cancel all test bookings before the charge date
Can a booking have multiple room types?
We do not allow booking with different room types, but only same room type with multiple room count.
Does Agoda have an endpoint to pull all future bookings?
Why GetBookingDetails does not provide UPC card number?
Why channel manager receives booking with status = 'AmendBooking' without recieving 'ConfirmBooking' status first?
Why customer email address and phone number is not provided in GetBookingDetails?
Why booking price are lower than the price pushed by channel manager?
How do you acknowledge booking via API?
How to identify child/linked rate plan in GetProduct?
Why does some channel_id not reflect in GetProduct response?
After the certification, how can I connect a channel manager to a property on Agoda?
There are 2 options to connect a property to channel manager.
Please submit a request to firstname.lastname@example.org with hotel ID and hotel name so that our support team can grant API access.
Property can select channel manager themselves in Property Settings Page in YCS - please see below example.
Log in to YCS
Go to Property >> Property Settings >> Property Information
Scroll down until 'Optional Settings' section
Select 'Enable channel manager mode' and select the preferred channel manager name from the drop-down list