priceCurrency

PriceCurrency is a data field used to specify the currency in which a price is denominated. It typically contains a three-letter ISO 4217 currency code, such as USD, EUR, JPY, or GBP, and is used to disambiguate prices that may be shown in different regions or systems.

In data models and markup, priceCurrency is commonly paired with a price value to form a complete monetary amount. For example, a price could be represented as price: "19.99" and priceCurrency: "USD" in a JSON-LD or other structured data format. In schema.org, priceCurrency is a property of monetary amount and price specification types and is used by offers, products, and price-related annotations to convey the currency of the price.

The use of ISO 4217 codes ensures consistency and interoperability across platforms, marketplaces, and APIs. Codes are typically uppercase and standardized; incorrect or ambiguous codes can lead to misinterpretation of amounts and faulty financial calculations. Validation often involves checking that the code is a valid ISO 4217 value and that it matches the currency expectations of the locale or business rules.

When presenting prices in multiple currencies, systems may display price and priceCurrency together, while maintaining separate fields for currency conversion or regional pricing. It is important to keep priceCurrency aligned with the intended currency for display, tax calculations, and payment processing to avoid confusion or errors.

In summary, priceCurrency is a concise, standardized indicator of the currency for a given price, enabling clear international pricing, data exchange, and accurate financial handling across diverse applications.