Handle multi-currency pricing display vs settlement correctly in travel bookings

domain: travel-general · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Determine the display currency (what the user sees) vs the settlement currency (what is actually charged) early in the flow — these may differ, especially when booking across borders.
  2. Most travel APIs return prices in a base currency defined by the content source (e.g. Amadeus returns in the currency of the point-of-sale or the fare currency); request the user's preferred display currency explicitly if the API supports it, otherwise convert client-side.
  3. Use a reliable FX rate source (e.g. European Central Bank daily rates, Open Exchange Rates) for display conversion; clearly label converted prices as 'approximate' and show the base currency price too for transparency.
  4. At checkout, pass the settlement currency to the payment processor — do not pass a display-converted amount; let the payment processor or the API handle the definitive currency conversion to avoid double-conversion errors.
  5. Store the booked price in both the API's returned currency and the user's display currency with the exchange rate and timestamp — you will need this for refund calculations and customer service.
  6. Be aware that airline ticket prices are often filed in USD internally (especially IATA BSP settlements) and converted to local currency by the GDS — a small rounding difference between displayed price and charged price is normal and should be disclosed.

Known gotchas

Related routes

Handle multi-currency pricing and point-of-sale configuration correctly in airline booking APIs
iata.org · 5 steps · unrated
Implement multi-currency settlement on Stripe by configuring presentment and settlement currencies
stripe.com · 6 steps · unrated
Handle currency minor units correctly across payment providers to avoid 100x over- or under-charges
payments-general · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans