Cherry Seed

What are the three currency values in a WooCommerce multi-currency transaction and which one should analytics track?

base currency display currency settlement currency multi-currency WooCommerce

Quick Answer

A WooCommerce multi-currency transaction involves three distinct currency values: the base currency (the store's default currency set in WooCommerce settings), the display currency (the currency shown to the customer via a currency switcher plugin), and the settlement currency (the currency the payment gateway actually processes and deposits). Most WooCommerce tracking implementations report the display currency to analytics platforms, which creates data corruption when the display currency differs from the base or settlement currency. According to WooCommerce documentation, the base currency is the canonical revenue figure, and analytics events should reference it rather than the converted display value to maintain consistent revenue reporting.

Full Answer

Currency switcher plugins allow WooCommerce stores to show prices in the visitor's local currency. When a customer in Japan views a store with USD as its base currency, the plugin converts displayed prices to JPY. This improves the shopping experience but introduces a data integrity problem for analytics and conversion tracking.

The base currency is what WooCommerce uses internally for all calculations, inventory, and order records. It is the store's single source of truth for revenue. The display currency is the converted value shown in the storefront — calculated by the currency switcher using an exchange rate that may update daily, hourly, or not at all depending on configuration. The settlement currency is what the payment processor actually charges the customer and deposits into the merchant account, which may differ from both the base and display currencies depending on the gateway's multi-currency handling.

The tracking problem occurs because most WooCommerce analytics integrations — GA4 tags, Facebook Pixel events, Google Ads conversion tags — fire on the frontend and capture the display currency value. If a customer buys a $100 USD product while viewing the store in EUR at a 0.92 rate, the tracking event reports EUR 92 rather than USD 100. GA4 receives EUR 92, Google Ads receives EUR 92, and Facebook receives EUR 92 — while WooCommerce's order record shows USD 100.

The revenue discrepancy compounds across orders, currencies, and time as exchange rates fluctuate. Monthly revenue in GA4 may show a different total than WooCommerce's order export because each order was tracked at a different exchange rate on a different day. Server-side tracking implementations that read the order value from WooCommerce's base currency field rather than the frontend display value eliminate this corruption at the source.

Sources

Programmatic Access

GET https://seresa.io/wp-json/cherry-tree-by-seresa/v1/seeds/937

Cite This Answer

Cherry Tree by Seresa - https://seresa.io/seed/wordpress-tracking/three-currency-values-woocommerce-multi-currency-transaction