Hotel pricing

Every hotel price is a whole-stay price for all the rooms, in the currency of your agency (the sandbox agency settles in DZD). There is no per-night amount except the supplier's dailyPrices. Three numbers matter:

totalPrice = what you pay + agencyCommission
what you pay = totalPrice - agencyCommission

A real example

The cheapest rate of the sandbox test hotel for three nights, from get_rates (the supplier prices in EUR, the agency settles in DZD):

{
  "exchangeRate": 285,
  "pricing": {
    "supplierCurrency": "EUR",
    "agencyCurrency": "DZD",
    "originalPrice": 3,
    "agencyCommission": 2.97,
    "totalPrice": 1484.97,
    "taxes": {
      "cityTax": {
        "includedInPrice": false,
        "amount": 23.1,
        "currency": "HNL"
      },
      "electricityFee": {
        "includedInPrice": true,
        "amount": 0.6,
        "currency": "EUR"
      },
      "resortFee": {
        "includedInPrice": true,
        "amount": 0.68,
        "currency": "EUR"
      }
    }
  }
}

• The traveler pays 1,484.97 DZD (totalPrice).
• Your commission is 2.97 DZD (agencyCommission).
• You are debited 1,482.00 DZD (1484.97 - 2.97). The sandbox does not debit anything: book_hotel answers balanceDebited: false there.
• The same hotel and the same rate in a search_advanced answer, in the search's own names:

{
  "exchange_rate": 285,
  "agency_currency": "DZD",
  "agency_commission": 2.97,
  "final_price": 1484.97,
  "b2b_price": 1482
}

Where each price is

The names differ between the search (snake_case) and the rest (camelCase): final_price is totalPrice, b2b_price is netPrice, agency_currency is agencyCurrency. The camelCase blocks also carry snake_case twins (total_price, agency_commission, agency_currency, supplier_currency, exchange_rate): see Legacy names. Amounts are rounded to two decimals.

The fields of a pricing block

Internal fields of the cost build-up (FX-Port's own commission and the supplier's cost lines) are never returned: do not build on a field that is not listed here.

Your commission

agencyCommission comes from the commission rule of your agency. To set it for one booking, send commission_override to book_hotel: { "type": "fixed", "value": 50 } is 50 in your currency per room, { "type": "percentage", "value": 5 } is 5% of what you pay. What you are debited does not change: the traveler price becomes what you pay plus the new commission.

The exchange rate

exchangeRate says how many units of your agency currency one unit of the supplier's currency is worth (285.0: 1 EUR is 285 DZD). It is on each rate of get_rates and pre_book (outside pricing), and on each hotel of hotels_pricing. Use it only to convert supplier-currency amounts for display, such as taxes and penalties; never to recompute a price.

Taxes

taxes lists the taxes and fees of the rate by name (cityTax, resortFee, electricityFee, vat ...). Each one has includedInPrice, amount and currency:

• includedInPrice: true: already inside totalPrice. Show it as information.
• includedInPrice: false: the traveler pays it at the hotel, on top of totalPrice. Show it clearly: it is not charged to your agency.
• amount is never converted. It is in currency, which is the supplier's currency (EUR) or the local currency of the hotel (HNL for a hotel in Honduras). Convert it with care, or show it as it is.

Cancellation penalties

The cancellationPolicy.policies[] windows carry the supplier's penalty: originalAmount in originalCurrency (EUR). The currency field of a window is only the label of your agency currency: originalAmount is not in it. There is no penalty in your currency in the rate. Show the penalty as the supplier states it, or as a share of the stay (originalAmount ÷ originalPrice) and say that the exact amount is known when the booking is cancelled: the answer of cancel_hotel gives what is refunded to your agency and to the traveler.

Related