Checkout & Price Conversion

Three things happen when someone browses your store in a different currency: every price on the page converts instantly, checkout tells them what they'll actually be charged, and the order records what they saw. No surprises, no confused customers emailing you at 2am.

Automatic Price Conversion

The moment a visitor picks a currency, every price on the page updates — product cards, "From" prices, compare prices, cart totals, pricing tables, the lot. No page reload, no waiting. It just happens.

This works across your entire FluentCart storefront:

• Product pages — individual prices, variant prices, compare/strikethrough prices
• Shop page — all product cards, price range filters
• Cart — item prices, line totals, cart total
• Checkout — order summary, subtotal, estimated total
• Pricing tables — variant prices and compare prices

How It Handles Edge Cases

The conversion also picks up dynamic changes — when someone adds an item to cart, opens the cart drawer, or updates quantities, the new prices convert automatically. No stale numbers hanging around.

Checkout Disclosure

This is the notice that tells your customer the truth: "You're looking at prices in USD, but you'll be charged in PLN." It sits right below the order summary so they see it before paying.

Notice the ≈ before the total — that's the plugin reminding the customer this amount is approximate. The actual charge happens in your base currency.

Where It Shows Up

The disclosure appears in three places automatically:

1. Below the checkout order summary — right before the payment button
2. Inside the cart drawer — after the total
3. On the cart page — after the cart total

Customise the Message

You can write your own disclosure text in the Checkout settings. Use these placeholders:

For example:

Prices shown in {display_currency} are approximate.
Your payment will be processed in {base_currency} at the current rate of {rate}.

If you leave the text blank, a sensible default kicks in: "Prices shown in USD are approximate. You will be charged in PLN." — always clear, always honest.

When It Doesn't Appear

The notice hides itself when there's nothing to disclose:

• The visitor is already browsing in your base currency (no conversion happening)
• You've turned disclosure off in settings
• The plugin is disabled

Order Snapshots

Exchange rates change. The EUR/USD rate today won't be the same in three weeks. So when a customer pays, the plugin saves a snapshot to the order — which currency they were viewing, what your base currency was, and the exact exchange rate at that moment.

This means you can always answer:

• "What rate was I charged at?" — customer support sorted
• "What did the customer actually see?" — dispute resolution sorted
• "What was the FX rate on this order?" — reporting and compliance sorted

If the customer was browsing in your base currency (no conversion), the snapshot is skipped — there's nothing to record.

No Flash of Wrong Prices

You know that awkward moment where a page loads showing USD prices for half a second before switching to EUR? That doesn't happen here. The plugin hides price elements during the initial conversion pass and reveals them only after everything's been converted. If something goes wrong, a 2-second safety timeout unhides everything regardless — so your visitors are never staring at blank price tags.

For Your Own Theme or Plugin

Want to convert a price in your own custom template? Add one attribute:

<span data-fchub-mc-base="99.99">$99.99</span>

The conversion engine picks it up automatically and rewrites the content with the converted amount. No JavaScript, no API calls — just add the attribute and it works.

Technical Details