1. YCS5 API Push Booking Hint
The YCS5 API Push Booking Hint allows partners to receive new, modified or cancelled reservation notifications in near real time, as Agoda customers make these bookings. This version of the Agoda API aims to improve the performance of the connectivity product Agoda offers. As this is a notification-based API, where Agoda initiates the notifications, partners interested in implementing this API need to contact Agoda to get started. In order to get started with this, please contact BD-Connectivity@agoda.com.
2. BookingHint Delivery Process
Agoda sends booking hint notification with booking status to channel manager endpoint when booking is created or its status is changed and channel manager have to return success or failure response to Agoda upon delivery of a notification.
Booking hint will be pushed to channel manager every 10 seconds. Channel manager will only get the latest booking status if original booking created and amended or cancelled within the 10 second schedule. There is retry process of 3 intervals 15 secs apart, to resend hint notification should channel manager endpoint experiencing technical issue. If the retry exceeded the setting, Agoda will send list of failed booking hint to channel manager designated email address and in case of failures, we recommend channel manger to trigger a getbookinglist request to retrieve reservation information.
After bookinghint notification received by channel manager, Agoda expects partner to send getbookingdetail request to retrieve full reservation information
3. Information included in a booking hint notification
A bookinghint notification will contain:
request time stamp
last action date and time
booking status – confirm, amend, cancel