Global Currency

Hotel Tader’s GraphQL Reservations End-Points now support global currencies. This allows you to access properties that provide rates in currencies other than USD, in the Hotel Trader portfolio. The new field, currency, is available in the Quote, Book, GetReservation, Modify, and Cancel endpoints.

The currency node is included across all the endpoints to help maintain consistency and accuracy during the entire booking process.

Steps to start using global currencies

To initiate reservations in currencies other than USD, follow these 5 straightforward steps:

1. Include the new node in each step

Perform searches using the PropertyID as usual.

  • The Search response already includes the currency field.
  • This field specifies the currency of the rates provided in the response, for more information on supported currencies, read the FAQs below. Update your code and write to the new nodes in the Quote, and Book steps.

2. Track currency

Utilize the acquired currency value from the Search stage and maintain its continuity through to the Book phase. Your implementation needs to ensure that these fields are being tracked from the first step of Search, through to the Quote and Book steps.

3. Invoice management

Hotel Trader invoices each currency separately.

  • Ensure your accounts are configured appropriately to manage invoices in multiple currencies.
  • The invoicing schedule will be the same as that of the USD invoices that are in use and are as per our commercial contract with you.

4. Certification

To facilitate reservations in currencies beyond USD, completion of a brief certification process with Hotel Trader is mandatory. This step ensures the smooth facilitation of transactions across various currencies, mitigating potential corner cases in the long term.

Reach out to your Account Manager when you are ready to start certification for access to test properties and sandbox environments.

Follow these steps to get certified:

  1. Confirm the receipt and processing of the currency flag in Search and Book response from Hotel Trader. You are required to
    • Perform a few searches and report 2 prices and currencies associated with them.
    • Make 2 test bookings.
  2. Confirm the exact invoiced amount inclusive of taxes and fees payable at booking and property. Hotel Trader requires you to provide the following (along with the currency):
    1. price before taxes
    2. tax amount
    3. price after tax or invoice amount and
    4. amount payable at the property.

Once these values are validated by Hotel Trader, your certification is complete.

5. Updated mapping files

As part of our Global Currency launch, a new currency column has been added to the Mapping Files. Ensure that your automated workflows or Mapping File processing are updated to handle the additional column.


Global Currency FAQs

How does Hotel Trader handle properties that allow distribution in multiple currencies?

Hotel Trader has implemented the functionality to support multiple currencies at the property level. This means that a single hotel can opt to distribute in multiple currencies.

The price node will represent the currency associated with it and in very rare cases will a property have rates loaded in more than one currency.

What currencies are supported?

At launch, we are providing support for EUR and GBP. We will be adding support for more currencies as we go along. A complete list of currency codes can be found here.

Please note,

  • Although we have designed the system to support any currency, we will only enable those currencies that are requested and agreed to process and be invoiced by our clients.
  • Our system requires that the transaction and the invoice be in the same currency.

How will multiple currency support handle the cheapest rates?

In the current release of Global Currencies, Hotel Trader does not have a currency conversion logic in place.

The Search query will still show the numerically cheapest rate first in the response.

For example, in case the search yields Property 1 with a USD 101 rate and Property 2 with a EUR 100 rate, the first result will be Property 2 with the EUR 100 rate.