currencies (B.XML)¶
This call is intended for the Connectivity Partner to be able to retrieve a list of currency codes with their corresponding currency name that are used on Booking.com. The currency information is based on a subset of ISO 4217 Alphabetic codes and currency names but altered in some cases. The most current list as returned by this call should therefore be considered the authoritative source of currency codes and names for the API.
Step 1: Request for a list of countries and country codes¶
POST https://supply-xml.booking.com/hotels/xml/currenciesRequest — HTTP Message Body Model¶
<?xml version="1.0" encoding="UTF-8"?>
<request>
<username>providermachinelogin</username>
<password>********</password>
</request>Request — Node Overview¶
| Node Name | Nest Level | Parent Node | Value Range | Data Type | Node Multiplicity |
|---|---|---|---|---|---|
| password | L1 | request | -- | string | 1 |
| request | L0 | NULL(root) | -- | -- | 1 |
| username | L1 | request | -- | string | 1 |
Request — cURL Model¶
curl -H "Host: providerhostname" \
-H "Connection: keep-alive" \
-H "Content-Length: XXX" \
-H "Cache-Control: no-cache" \
-H "Origin: XXXXXXXXXXXXX" \
-H "User-Agent: Provider User-Agent name" \
-H "Content-Type: text/xml;charset=UTF-8" \
-H "Accept: */*" \
-H "Accept-Encoding: gzip,deflate" \
--http1.1 \
-d @messagebody.xml -X POST \
'https://supply-xml.booking.com/hotels/xml/currencies'Step 2: Response of currency codes/names¶
| Type | HTTP Method | Message Sender | Message Receiver |
|---|---|---|---|
| Response | POST | Booking.com | Connectivity Partner |
Response — HTTP Message Body Sample¶
<?xml version="1.0" encoding="UTF-8"?>
<currencies>
<currency currencycode="EUR" name="Euro" />
<currency currencycode="USD" name="U.S. dollar" />
<currency currencycode="BHD" name="Bahrain dinar" />
<currency currencycode="BWP" name="Botswana pula" />
<!-- example output. Use the API for a complete updated list -->
</currencies>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXX==] -->
Dual-Currency Countries¶
Properties located in the following countries have more than one allowed currency. You can use the OTA_HotelDescriptiveContentNotif or Property API to set a different currency for the property. Countries not in the list below support only one allowed currency and is assigned by default.
NOTE: The below values are accurate as of Dec 2023. Expanding the existing currency endpoint to include this information is being considered.
| Country Code | Default Currency | Additional Currency |
|---|---|---|
| af | AFN | USD |
| ar | USD | ARS |
| bg | BGN | EUR |
| bj | EUR | XOF |
| br | BRL | USD |
| cl | USD | CLP |
| co | COP | USD |
| cz | EUR | CZK |
| ga | EUR | USD |
| ge | GEL | USD |
| gn | EUR | USD |
| gt | GTQ | USD |
| hu | EUR | HUF |
| id | IDR | USD |
| il | ILS | USD |
| is | EUR | ISK |
| ma | EUR | MAD |
| md | MDL | EUR |
| ml | XOF | USD |
| mo | HKD | MOP |
| mu | EUR | USD |
| mx | USD | MXN |
| my | MYR | USD |
| mz | MZN | USD |
| ng | USD | NGN |
| pk | PKR | USD |
| ro | RON | EUR |
| sl | USD | SLL |
| th | THB | USD |
| tn | EUR | TND |
| tr | EUR | TRY |
| ua | UAH | EUR |
| uz | USD | UZS |
| vn | VND | USD |
| ws | USD | WST |