Handle multi-currency pricing and point-of-sale configuration correctly in airline booking APIs

domain: iata.org · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Understand that airline fares are filed in specific POS (point of sale) markets defined by country of sale and ticketing carrier; the same itinerary can have materially different prices depending on POS
  2. Configure your API requests with the correct POS country code and sales currency to retrieve fares applicable to your market; use the currency and country parameters explicitly rather than relying on defaults
  3. When displaying prices, distinguish between the fare currency (in which the fare is filed), the ticketing currency (in which the ticket is issued), and the display currency (what the user sees); apply exchange rates only at the display layer
  4. For multi-currency storefronts, retrieve prices in the fare currency and perform FX conversion using a near-real-time exchange rate service; store the fare currency amount in the booking record alongside the converted display amount
  5. At payment, charge in the ticketing currency unless your payment processor and airline agreement explicitly support multi-currency settlement; mismatches between charged and ticketing currency create reconciliation and chargeback risks

Known gotchas

Related routes

Handle multi-currency pricing display vs settlement correctly in travel bookings
travel-general · 6 steps · unrated
Configure Shopify Markets for international pricing, localized currency, and duties-inclusive checkout
ecommerce-ops · 6 steps · unrated
Configure Shopify Markets with localized domains, currency overrides, and tax-inclusive pricing for an EU market segment
Shopify Markets · 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