Pre-Certification
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.
GetProduct
SetAriV2
GetBookingList (v1 or v2)
GetBookingDetails
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.
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
1 MB
No
Post-Certification
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)
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).
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.
Yes, we do but only up to 2 decimal places
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.
It's possbile that the rate plan is set up as 'Beds Network - Payout' rate plan type which blocks any ARI update via API.
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.
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.
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.
Agoda Collect: <paymentmodel>1</paymentmodel>
Property Collect: <paymentmodel>2</paymentmodel>
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
Taiwan: Net_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
No, we don’t have commission attribute. The pricing structure is as stated in the answer above.
Test bookings can only be created in production environment on a test hotel assigned to you.
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
We do not allow booking with different room types, but only same room type with multiple room count.
We do not have such endpoint. However, you can use GetBookingList request which can look back booking creation date 90 days per request.
For every property which has payment method set other than UPC, GetBookingDetails won't provided card number since there's no UPC generated for each booking. Property must log in to YCS and settle payment by themselves.
For example, property settles 10 bookings and a single UPC number will be generated to have the total amount of all 10 bookings.
If your property has payment method = "UPC" (not "UPC on ePass") but still cannot get card number from GetBookingDetails or would like to check on property payment method, please submit a request to agoda.chain.support@agoda.com with hotel ID and booking ID so that our support team can assist.
It's because the booking is created, then later amended within a couple minutes of its creation (2-3 minutes) while the system is still processing the booking. Once the booking is completely processed to be available via API, the booking has already been amended.
Customer email address (obfuscated format) and phone number would only be provided if the feature 'request customer info' is activated for the property in YCS. In case the feature is not activated, please advise the property to contact agoda.chain.support@agoda.com for further assistance.
In many cases, the price is updated correctly, however, there are additional discount applied such as YCS promotion, channel discount, and etc.
If a booking has additional discount applied, GetBookingDetails response would have promotion_id / promotion_name (promotion discount) and/or channel_id with value other than = '1' (channel discount)
Booking acknowledgement is not yet supported via API, therefore, you would see acknowledge="0" when retrieving GetBookingList and GetBookingDetails.
In some cases where acknowledge="1", the acknowledgement is done via YCS or booking notification email sent to the property.
Below is an example of GetProduct response to identify child rate plan and master rate plan.
If master_rate = 0, it's a master rate plan.
If master _rate = other rate plan ID, this means it's a child rate plan linked to that master ID.
Only active and standalone channel_id will be returned in GetProduct response. Inactive and stackable channel_id (combination of 2 channels) will be omitted from GetProduct response.
There are 2 options to connect a property to channel manager.
Please submit a request to agoda.chain.support@agoda.com 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