1. Help Center
  2. Buying on TravelgateX
  3. Getting started with Hotel-X Buyers API

Hotel-X Booking Flow Certification

Find out what you need to do to get your Booking Flow step certified.

Ensuring that our Partners fully understand our API, can make good use of it and that the information transmitted is correct is essential for a successful collaboration. That's why all the Partners connecting to our platform are required to pass a certification process, whether they are buying or selling in our marketplace.

Booking Flow Certification

When to apply?

You should apply once you've finished the implementation of the booking flow methods.

What we will be checking?

In the Hotel-X certification, we will be checking the following points: 
  • Usage of general data structure of our API
  • Usage of the correct Booking Flow (Search, Quote, Book) and Management (Booking Query, Cancel).
  • The arrival and departure dates.
  • The correct handling of the prices (net price, gross price, commission, etc.).
  • Possible cancellation policies applied to that booking (if you use it).
  • The information of the room selected (id, code, description, etc.).
  • The meal plan selected.
  • Provide Seller's remarks on the entire booking flow.
  • Enabled GZIP compression header.
  • Understanding of the different payment types supported through Hotel-X.

What information do you need to provide for the certification?

In order to proceed with the certification we'll need:

  • A CURL request and response of each of the Booking Flow methods from each of the cases detailed below.
  • The resulting Hotel-X response interpretation screenshots of your system so we can ensure you are showing the information correctly. 

What access code should I use throughout my development and certification?

You can use any of the default accesses from "My Connections". You can also activate any Seller you have an agreement with, even their production environment. However, bear in mind that you should only perform reservations once you've passed the certification process

We recommend using access "0" for your certification process as it will return all the information you need to complete your cases. 

Additional notes and recommendations:

  • Audit transactions in Search: Make sure you configure both your Query and Query variables according to this information:
query ($criteriaSearch: HotelCriteriaSearchInput, $settings: HotelSettingsInput, $filter: FilterInput) {
  hotelX {
    search(criteria: $criteriaSearch, settings: $settings, filter: $filter) {
      auditData {
        transactions {
          request
          response
        }
      }
...
"auditTransactions": xxxx,

How to apply for the Hotel-X  Booking Flow certification? 

Once you are ready apply for the Hotel-X certification, you will need to submit a ticket via our Help Center attaching the four test scenarios outlined previously.