Skip to main content

Hotel-X Credentials

API Key

An API key is a unique alphanumeric code used for authentication when accessing the Hotel-X API. It must be included in the HTTP Authorization request header to verify and authenticate the user agent with the server. This secure identifier ensures that only authorized users can access API functionalities.

How to Find and Manage Your API Keys:

  1. Log in to the Travelgate App.
  2. Click on Manage > API Keys in the menu that appears when you click on your user icon in the top right corner.
  3. Navigate to API Settings to view a list of API keys associated with your organization (encrypted).
  4. To create a new API key, click Create New API Key and complete the required form. Copy the API key immediately, as this is the only time it will be fully displayed.
    • Important: Generated API keys cannot be retrieved later. If lost, a new one must be created. Previously used API keys will remain active.
info

Your API key remains the same across both test and production environments.

Access

An access is a combination of authentication details and configurations that enable a Buyer to connect with a Seller. It helps differentiate Sellers and manage multiple credentials or configurations from the same Seller (e.g., B2B vs. B2C feeds). You can review access details in My Connections.

info

Depending on their system specifications, each Seller may have different access credentials requirements. For example, some may need specific fields, while others require designated URL endpoints for methods such as search, quote, book, or others. This information should always be provided and confirmed by each Seller.

Make sure your credentials are active and fully functional before proceeding, as using inactive credentials can cause delays.

To facilitate testing, the following accesses have been pre-activated for your account:

  • Travelgate Test Seller: Access 2 with context HOTELTEST
  • Smyrooms Test: Access 5647 with context LOGITEST

How to Obtain an Access Code from an Actual Seller

To obtain an access code from a Seller, you must establish a commercial agreement with the desired Partner and request activation via the Auto-Activations Form.

important
  • Avoid making live bookings during the Hotel-X implementation process until Travelgate has certified your development. If you create test bookings, ensure they are canceled and refundable.
  • To ensure proper billing, all cancellations must be handled via the API. If you encounter any issues, contact Customer Support for assistance.

Client

A client is an entity purchasing accommodation services through the Hotel-X API. Client codes remain consistent across all Travelgate implementations and help identify the requesting business and its assigned configurations.

Multiple client codes may be used to distinguish different traffic types, such as B2B and B2C transactions (e.g., client_b2b, client_b2c). Since all accesses are compatible with any client code, selecting the appropriate one is essential. You can review client information in your API Settings.

Context

A context represents the content codes used by Buyers and Sellers. Each Seller has a unique context, which may differ between test and production environments. Context codes include specific hotel, board, and room codes. This information is available in My Connections.

Buyers can either use their own context or select content providers. Buyer context codes are generated by the Buyer (not provided by Travelgate) and are used in mapping file names to align Supplier codes with the Buyer's mapped codes. For more information, see the Mapping Plugin.

What is the Difference Between Access and Context?
  • Access contains your authentication credentials for a specific connection.
  • Context is the internal Travelgate code required to request Supplier codes or mapped Buyer codes (uploaded to our SFTP).

For more details, refer to the Hotel-X Buyers API Documentation and API Settings.