{"id":399990,"date":"2026-11-19T05:52:52","date_gmt":"2026-11-19T05:52:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/velox-multi-currency-payment-gateway-for-woocommerce\/"},"modified":"2026-11-19T05:52:44","modified_gmt":"2026-11-19T05:52:44","slug":"velox-multi-currency","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/velox-multi-currency\/","author":15921283,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.5","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"VeloX - Multi-Currency & Payment Gateway for WooCommerce","header_author":"Vishwas R","header_description":"Cache-safe multi-currency switcher, automatic live exchange rates, and dedicated payment gateway routing for WooCommerce.","last_updated":"2026-11-19 05:52:44","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/vishwas-r\/velox-multi-currency","header_author_uri":"https:\/\/vishwas.me\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":34,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"vishwasr","date":"2026-11-19 05:52:44","revision":3810751}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3810751,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3810751,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3810751,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3810751,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3810751,"resolution":"1","location":"assets","locale":"","width":1600,"height":1000},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3810751,"resolution":"2","location":"assets","locale":"","width":1600,"height":1000},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3810751,"resolution":"3","location":"assets","locale":"","width":1600,"height":1000},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3810751,"resolution":"4","location":"assets","locale":"","width":1600,"height":1000},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3810751,"resolution":"5","location":"assets","locale":"","width":1600,"height":1000},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3810751,"resolution":"6","location":"assets","locale":"","width":1600,"height":1000},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3810751,"resolution":"7","location":"assets","locale":"","width":1600,"height":1000},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3810751,"resolution":"8","location":"assets","locale":"","width":1600,"height":1000}},"screenshots":{"1":"Currencies &amp; Rates \u2014 Manage unlimited currencies with live ECB exchange rates, auto-sync schedules, and custom rounding rules.","2":"Gateway Routing Matrix \u2014 Dedicated payment gateway routing restricting Razorpay, PayPal, and Stripe per active currency.","3":"Switcher &amp; Display \u2014 Customize floating currency switcher widgets, top header navigation bar, flag icons, and placement presets.","4":"Sales by Currency \u2014 Real-time multi-currency sales reports, converted revenue analytics, and currency share metrics.","5":"Product Pricing Overrides \u2014 Set fixed custom currency prices directly within WooCommerce product edit panels.","6":"Storefront Product Conversion \u2014 Instant live currency conversion on single product pages with interactive floating switcher.","7":"Multi-Currency Cart \u2014 Dynamic converted cart totals, shipping calculations, and currency-specific free shipping progress.","8":"Smart Reactive Checkout \u2014 Dynamically displays only compatible payment gateways for the customer's selected currency."}},"plugin_section":[],"plugin_tags":[8504,21294,24514,6593,286],"plugin_category":[45],"plugin_contributors":[238701],"plugin_business_model":[],"class_list":["post-399990","plugin","type-plugin","status-publish","hentry","plugin_tags-currency","plugin_tags-currency-switcher","plugin_tags-multi-currency","plugin_tags-payment-gateway","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-vishwasr","plugin_committers-vishwasr"],"banners":{"banner":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/banner-772x250.png?rev=3810751","banner_2x":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/banner-1544x500.png?rev=3810751","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/icon-128x128.png?rev=3810751","icon_2x":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/icon-256x256.png?rev=3810751","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/screenshot-1.png?rev=3810751","caption":"Currencies &amp; Rates \u2014 Manage unlimited currencies with live ECB exchange rates, auto-sync schedules, and custom rounding rules."},{"src":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/screenshot-2.png?rev=3810751","caption":"Gateway Routing Matrix \u2014 Dedicated payment gateway routing restricting Razorpay, PayPal, and Stripe per active currency."},{"src":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/screenshot-3.png?rev=3810751","caption":"Switcher &amp; Display \u2014 Customize floating currency switcher widgets, top header navigation bar, flag icons, and placement presets."},{"src":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/screenshot-4.png?rev=3810751","caption":"Sales by Currency \u2014 Real-time multi-currency sales reports, converted revenue analytics, and currency share metrics."},{"src":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/screenshot-5.png?rev=3810751","caption":"Product Pricing Overrides \u2014 Set fixed custom currency prices directly within WooCommerce product edit panels."},{"src":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/screenshot-6.png?rev=3810751","caption":"Storefront Product Conversion \u2014 Instant live currency conversion on single product pages with interactive floating switcher."},{"src":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/screenshot-7.png?rev=3810751","caption":"Multi-Currency Cart \u2014 Dynamic converted cart totals, shipping calculations, and currency-specific free shipping progress."},{"src":"https:\/\/ps.w.org\/velox-multi-currency\/assets\/screenshot-8.png?rev=3810751","caption":"Smart Reactive Checkout \u2014 Dynamically displays only compatible payment gateways for the customer's selected currency."}],"raw_content":"<!--section=description-->\n<p><strong>VeloX Multi-Currency<\/strong> is a high-performance, precision multi-currency switcher and payment gateway routing engine built natively for modern WooCommerce.<\/p>\n\n<p>Show prices in customer currencies, eliminate floating-point rounding errors with deterministic minor-unit integer math, and route checkouts exclusively through compatible payment gateways.<\/p>\n\n<h3>Architectural Highlights<\/h3>\n\n<ul>\n<li><strong>Dedicated Payment Gateway Routing:<\/strong> Restrict specific currencies to designated payment gateways (e.g., INR to Razorpay, USD to PayPal or Stripe) to prevent payment decline errors during checkout.<\/li>\n<li><strong>Cache-Safe Price Rendering:<\/strong> Leverages immutable <code>data-velox-base<\/code> HTML attributes and <code>Vary: Cookie<\/code> HTTP headers so page caches (WP Rocket, LiteSpeed, Cloudflare) never display frozen currency rates.<\/li>\n<li><strong>Deterministic Minor-Unit Integer Math:<\/strong> Eliminates IEEE 754 floating-point rounding issues with zero-fraction arithmetic and anti-zero rounding guard.<\/li>\n<li><strong>WooCommerce Store API &amp; Checkout Blocks:<\/strong> Full native compatibility with modern WooCommerce Cart &amp; Checkout Blocks as well as Classic Checkout and High-Performance Order Storage (HPOS).<\/li>\n<\/ul>\n\n<h3>Key Features<\/h3>\n\n<ul>\n<li><strong>Multi-Currency Support:<\/strong> Configure unlimited customer currencies with custom exchange rate markups and precision rounding rules.<\/li>\n<li><strong>Dedicated Payment Gateway Routing:<\/strong> Lock any currency exclusively to specific payment gateways (e.g. INR -&gt; Razorpay only, USD -&gt; PayPal only). Incompatible payment methods are automatically suppressed at checkout to prevent payment declines.<\/li>\n<li><strong>Cache-Safe Price Rendering:<\/strong> Automatically embeds <code>data-velox-base<\/code> HTML attributes and emits <code>Vary: Cookie<\/code> headers so caching engines never serve frozen currency prices.<\/li>\n<li><strong>Deterministic Integer Money Math:<\/strong> 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.<\/li>\n<li><strong>Real-Time AJAX Switching:<\/strong> Instant price updates across shop, single product, cart, and checkout without full page reloads.<\/li>\n<li><strong>Floating Switcher, Shortcodes &amp; Header Bar:<\/strong> Built-in floating widget with corner placement controls and top navigation bar integration, plus the <code>[velox_currency_switcher]<\/code> and <code>[velox_price id=\"...\"]<\/code> shortcodes.<\/li>\n<li><strong>Automated Background Rate Sync:<\/strong> WordPress Cron background scheduler with configurable sync intervals, plus on-demand manual sync.<\/li>\n<li><strong>100% HPOS &amp; Blocks Compatible:<\/strong> Fully compatible with High-Performance Order Storage (Custom Order Tables) and Cart\/Checkout Blocks.<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>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.<\/p>\n\n<p>When synchronizing rates, the plugin transmits an HTTP GET request to download the public daily XML reference rates table (<code>eurofxref-daily.xml<\/code>). No user data, customer information, cookies, IP addresses, or sensitive store data are transmitted.<\/p>\n\n<ul>\n<li><strong>Service Purpose:<\/strong> Provides daily Euro foreign exchange reference rates published by the European Central Bank.<\/li>\n<li><strong>Data Sent:<\/strong> An HTTP GET request to download the public daily XML reference rates table. No user or store data is transmitted.<\/li>\n<li><strong>Service Provider:<\/strong> European Central Bank.<\/li>\n<li><strong>Terms of Use &amp; Disclaimer:<\/strong> https:\/\/www.ecb.europa.eu\/services\/using-our-site\/disclaimer\/html\/index.en.html<\/li>\n<li><strong>Privacy Policy:<\/strong> https:\/\/www.ecb.europa.eu\/services\/data-protection\/privacy-statements\/html\/ecb.privacy_statement_website.en.html<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>velox-multi-currency<\/code> folder to your <code>\/wp-content\/plugins\/<\/code> directory, or install directly through the WordPress Plugins dashboard.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu in WordPress.<\/li>\n<li>Navigate to <strong>WooCommerce -&gt; VeloX<\/strong> to configure your currencies and set your dedicated gateway routing rules.<\/li>\n<li>Place the switcher on your storefront using the floating widget, header bar, or <code>[velox_currency_switcher]<\/code> shortcode.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20velox%20work%20with%20modern%20woocommerce%20checkout%20blocks%3F\"><h3>Does VeloX work with modern WooCommerce Checkout Blocks?<\/h3><\/dt>\n<dd><p>Yes! VeloX integrates directly with the modern WooCommerce Store API to disable unsupported gateways and update settlement amounts reactively in the Checkout Block.<\/p><\/dd>\n<dt id=\"how%20does%20dedicated%20payment%20gateway%20routing%20work%3F\"><h3>How does Dedicated Payment Gateway Routing work?<\/h3><\/dt>\n<dd><p>Under the Gateway Routing tab in <strong>WooCommerce -&gt; VeloX<\/strong>, 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.<\/p><\/dd>\n<dt id=\"how%20does%20velox%20protect%20against%20static%20page%20caching%3F\"><h3>How does VeloX protect against static page caching?<\/h3><\/dt>\n<dd><p>VeloX injects immutable <code>data-velox-base<\/code> HTML attributes into <code>wc_price<\/code> output and sends <code>Vary: Cookie<\/code> headers. The frontend JavaScript reads the base attribute directly rather than reverse-dividing formatted text.<\/p><\/dd>\n<dt id=\"how%20are%20exchange%20rates%20fetched%3F\"><h3>How are exchange rates fetched?<\/h3><\/dt>\n<dd><p>Rates are fetched automatically via WordPress Cron or on-demand from the official European Central Bank reference rates feed with zero API keys required.<\/p><\/dd>\n<dt id=\"can%20i%20set%20manual%20exchange%20rates%3F\"><h3>Can I set manual exchange rates?<\/h3><\/dt>\n<dd><p>Yes. You can edit the exchange rate and buffer markup percentage (e.g. +2.5%) for any currency directly in the settings table.<\/p><\/dd>\n<dt id=\"how%20many%20currencies%20can%20i%20configure%3F\"><h3>How many currencies can I configure?<\/h3><\/dt>\n<dd><p>You can configure and switch between unlimited active currencies across your store.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial public release.<\/li>\n<li>Support for unlimited configured currencies with zero fees.<\/li>\n<li>Dedicated Payment Gateway Routing (lock currency to allowed gateways; hide incompatible gateways).<\/li>\n<li>Deterministic ISO 4217 minor-unit integer money math with anti-zero rounding guard.<\/li>\n<li>Edge-cache safe price rendering via <code>data-velox-base<\/code> HTML attributes and <code>Vary: Cookie<\/code> header.<\/li>\n<li>Real-time zero-reload AJAX currency switching.<\/li>\n<li>Floating switcher widget and top header bar switcher.<\/li>\n<li>Automated background exchange rate sync via WordPress Cron (12h &amp; 24h).<\/li>\n<li>Declared full compatibility with High-Performance Order Storage (HPOS) and Checkout Blocks.<\/li>\n<li>100% compliant with WordPress Plugin Check (PCP) across all static checks.<\/li>\n<\/ul>","raw_excerpt":"Multi-currency switcher and dedicated payment gateway router for WooCommerce. Display local prices and route checkout gateways by currency.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/399990","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=399990"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/vishwasr"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=399990"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=399990"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=399990"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=399990"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=399990"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=399990"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}