Option Identifiers
What Is the id
(optionRefId) of an Option?
The id
or optionRefId
is a unique identifier assigned to each option. It is crucial not to modify this identifier, as it is used throughout the entire Booking Flow.
To ensure a seamless booking experience, you must use the id
or optionRefId
from the previous query response in your subsequent request:
- Use the
id
from the Search response in your Quote request. - Use the
optionRefId
from the Quote response in your Book request.
What Is the Lifetime of an OptionRefId
?
There are no specific time restrictions imposed by Travelgate on the lifetime of an OptionRefId
. However, each Seller may have different constraints. For instance, some Sellers might impose a maximum time gap (e.g., 5 minutes) between Search and Quote requests.
If I encounter an error in the Quote Response, can I continue using the same Search id
?
If you encounter an error in the Quote response, you must initiate a new Search request and restart the Booking Flow. This ensures that a fresh id
is generated, improving the accuracy and consistency of the booking process.
Can I Use the OptionRefId
for Custom Logic in My API?
No, you must not use or interpret the OptionRefId
to implement any custom logic within your API. The OptionRefId
is unique to each connection and may vary across different connections. Relying on it for business logic may lead to unexpected errors.
Option identifiers in the Legacy Pull Buyers API
If you are still using the Travelgate's Legacy Pull Buyers API, follow these steps:
- In the Availability response, you will receive a tag called
Parameters
. This tag and its content are crucial for the integration. - Copy the
Parameters
of the selected option from the Availability response, ensuring the entire tag is included. - Paste the copied
Parameters
tag into the body of your Valuation request. - Run the Valuation request method. If successful, the response will include the same
Parameters
tag, but with updated content. - Finally, paste the
Parameters
tag from the Valuation response into the body of your Reservation request to complete the booking process.
For further details, please refer to our Hotel-X Pull Buyers API Documentation.