Global Currency

Hotel Tader’s GraphQL Reservations Endpoints support global currencies. This allows you to access properties in the Hotel Trader portfolio that provide rates in currencies other than USD. The currency field 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 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.

Follow these steps to get certified:

1. Confirm the receipt and processing of the currency flag in the 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.

Test Data

Use the following test properties for testing global currencies on the Sandbox environment:

5. Updated mapping files

The Mapping Files include a currency column. 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 present, we provide support for 10 global currencies. 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 be processed and 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?

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.