Last updated

countrycurrencies (B.XML)

This call is intended for the Connectivity Partner to be able to retrieve a list of country codes with their corresponding currency codes that are used on Booking.com. The country codes are based as a subset of ISO 3166-1 alpha-2 codes, and the currency codes are based on a subset of ISO 4217 Alphabetic codes, however, they do not always correspond exactly. Please note the following important facts regarding currency on Booking.com:

  1. While most currency codes do correspond with their ISO 4217's entity country, there are several notable exceptions where the country currency is not the currency in use on Booking.com.
  2. The Connectivity Partner cannot change currency. Currency is a Booking.com system setting based on the country where the accommodation was built.

Example:

<countrycurrency countrycode="mx" currencycode="USD"/>

This means that Mexico ('mx') is an exception where country currency of ISO 4217 is not in use on the Booking.com API. The United States Dollar (USD) is used for accommmodations in Mexico. Therefore, all prices need to be in United States Dollars. If the provider sends '1500' expecting currency MXN (Mexican pesos), the system will instead sell the room at 1500 USD. Any currency information sent by the provider will therefore not be processed.

The most current list as returned by this call should be considered the authoritative source of the currency code for the given country code for the API.

Step 1: Request for a list of country codes and currency codes

GET https://supply-xml.booking.com/hotels/xml/countrycurrencies

Response of country codes/names

<?xml version="1.0" encoding="UTF-8"?>
<countrycurrencies>
  <countrycurrency countrycode="ad" currencycode="EUR" />
  <countrycurrency countrycode="ae" currencycode="AED" />
  <countrycurrency countrycode="af" currencycode="AFN" />
  <!-- example output. Use the API for a complete updated list -->
</countrycurrencies>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXX==] -->

Response — Node Overview

Node NameNest LevelParent NodeValue RangeData TypeNode Multiplicity
countrycurrenciesL0NULL(root)----1
countrycurrencyL1countrycurrencies----[see below]
  • The response body consists of a countrycurrencies root element. This is the parent node to the countrycurrency node, whose multiplicity is determined by the number of countries available (240 at the time of writing).

  • The empty child node countrycurrency contains the @countrycode and the @currencycode described below.

Response — Attribute(@) Overview

Attribute NameNode NameValue RangeData TypeNode Multiplicity
@countrycodecountrycurrency--string1
@currencycodecountrycurrency--string1
  • The @countrycode of country contains the two lowercase letters of the ISO 3166-1 alpha-2 code of the country.

  • The @currencycode of country contains the ISO 4217-based alphabetic codes of the corresponding @countrycode.

As with every standard Booking.com response, an RUID string terminates the message inside an XML comment node and should be stored by the Connectivity Partner for at least 30 days.

Errors/Warnings

No common, known errors exist with this call.

If an error/warning is encountered, and basic troubleshooting methods has been found ineffective, please provide the error/warning message along with the RUID of the response message to your Booking.com support contact.