Description
VeloX Multi-Currency is a high-performance, precision multi-currency switcher and payment gateway routing engine built natively for modern WooCommerce.
Show prices in customer currencies, eliminate floating-point rounding errors with deterministic minor-unit integer math, and route checkouts exclusively through compatible payment gateways.
Architectural Highlights
- Dedicated Payment Gateway Routing: Restrict specific currencies to designated payment gateways (e.g., INR to Razorpay, USD to PayPal or Stripe) to prevent payment decline errors during checkout.
- Cache-Safe Price Rendering: Leverages immutable
data-velox-baseHTML attributes andVary: CookieHTTP headers so page caches (WP Rocket, LiteSpeed, Cloudflare) never display frozen currency rates. - Deterministic Minor-Unit Integer Math: Eliminates IEEE 754 floating-point rounding issues with zero-fraction arithmetic and anti-zero rounding guard.
- WooCommerce Store API & Checkout Blocks: Full native compatibility with modern WooCommerce Cart & Checkout Blocks as well as Classic Checkout and High-Performance Order Storage (HPOS).
Key Features
- Multi-Currency Support: Configure unlimited customer currencies with custom exchange rate markups and precision rounding rules.
- Dedicated Payment Gateway Routing: Lock any currency exclusively to specific payment gateways (e.g. INR -> Razorpay only, USD -> PayPal only). Incompatible payment methods are automatically suppressed at checkout to prevent payment declines.
- Cache-Safe Price Rendering: Automatically embeds
data-velox-baseHTML attributes and emitsVary: Cookieheaders so caching engines never serve frozen currency prices. - Deterministic Integer Money Math: Stores and calculates values in ISO-4217 minor units with an anti-zero guard to prevent small exchange rates from ever rounding down to 0.00.
- Real-Time AJAX Switching: Instant price updates across shop, single product, cart, and checkout without full page reloads.
- Floating Switcher, Shortcodes & Header Bar: Built-in floating widget with corner placement controls and top navigation bar integration, plus the
[velox_currency_switcher]and[velox_price id="..."]shortcodes. - Automated Background Rate Sync: WordPress Cron background scheduler with configurable sync intervals, plus on-demand manual sync.
- 100% HPOS & Blocks Compatible: Fully compatible with High-Performance Order Storage (Custom Order Tables) and Cart/Checkout Blocks.
External Services
This plugin connects to an external foreign exchange rate service provided by the European Central Bank (ECB) to retrieve current foreign exchange reference rates. Rate synchronization runs either automatically via WordPress Cron according to your configured interval (e.g., every 24 hours) or manually when an administrator clicks “Sync Rates Now” in the plugin settings.
When synchronizing rates, the plugin transmits an HTTP GET request to download the public daily XML reference rates table (eurofxref-daily.xml). No user data, customer information, cookies, IP addresses, or sensitive store data are transmitted.
- Service Purpose: Provides daily Euro foreign exchange reference rates published by the European Central Bank.
- Data Sent: An HTTP GET request to download the public daily XML reference rates table. No user or store data is transmitted.
- Service Provider: European Central Bank.
- Terms of Use & Disclaimer: https://www.ecb.europa.eu/services/using-our-site/disclaimer/html/index.en.html
- Privacy Policy: https://www.ecb.europa.eu/services/data-protection/privacy-statements/html/ecb.privacy_statement_website.en.html
Screenshots








Installation
- Upload the
velox-multi-currencyfolder to your/wp-content/plugins/directory, or install directly through the WordPress Plugins dashboard. - Activate the plugin through the Plugins menu in WordPress.
- Navigate to WooCommerce -> VeloX to configure your currencies and set your dedicated gateway routing rules.
- Place the switcher on your storefront using the floating widget, header bar, or
[velox_currency_switcher]shortcode.
FAQ
-
Does VeloX work with modern WooCommerce Checkout Blocks?
-
Yes! VeloX integrates directly with the modern WooCommerce Store API to disable unsupported gateways and update settlement amounts reactively in the Checkout Block.
-
How does Dedicated Payment Gateway Routing work?
-
Under the Gateway Routing tab in WooCommerce -> VeloX, you can enable exclusive routing for any currency and select the specific gateways allowed for it. Any unselected gateways will be automatically hidden at checkout when that currency is active.
-
How does VeloX protect against static page caching?
-
VeloX injects immutable
data-velox-baseHTML attributes intowc_priceoutput and sendsVary: Cookieheaders. The frontend JavaScript reads the base attribute directly rather than reverse-dividing formatted text. -
How are exchange rates fetched?
-
Rates are fetched automatically via WordPress Cron or on-demand from the official European Central Bank reference rates feed with zero API keys required.
-
Can I set manual exchange rates?
-
Yes. You can edit the exchange rate and buffer markup percentage (e.g. +2.5%) for any currency directly in the settings table.
-
How many currencies can I configure?
-
You can configure and switch between unlimited active currencies across your store.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“VeloX – Multi-Currency & Payment Gateway for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “VeloX – Multi-Currency & Payment Gateway for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial public release.
- Support for unlimited configured currencies with zero fees.
- Dedicated Payment Gateway Routing (lock currency to allowed gateways; hide incompatible gateways).
- Deterministic ISO 4217 minor-unit integer money math with anti-zero rounding guard.
- Edge-cache safe price rendering via
data-velox-baseHTML attributes andVary: Cookieheader. - Real-time zero-reload AJAX currency switching.
- Floating switcher widget and top header bar switcher.
- Automated background exchange rate sync via WordPress Cron (12h & 24h).
- Declared full compatibility with High-Performance Order Storage (HPOS) and Checkout Blocks.
- 100% compliant with WordPress Plugin Check (PCP) across all static checks.
