BunStackDocs

Prices & currencies

Base currency and more currencies

How prices are mastered in the base currency, how other currencies are derived, and what the customer sees.

Last updated · 2 min read · Suggest an edit

Base currency

The tenant has a base currency (for example SEK) in which all prices are maintained and all reports are summed. It is set at signup and changed under Settings.

Enable currencies per storefront

Under Storefronts › Pricing rules › Currencies:

SettingMeaning
EnableThe currency can be selected in the storefront and used in the checkout
Rate modeAuto: the ECB rate fetched twice per weekday. Manual: your own rate
MarkupPercentage on top of the rate, for example to cover exchange costs
RoundingNone, whole units, to 9 (249 → 249, 250 → 259), or to 99
Auto-pickVisitors get the currency of their country, if enabled
Sync ECB nowFetches today's rates immediately

The preview shows what a price becomes, for example 249 SEK → 23.99 EUR.

Explicit prices

On the product and variant you can set a fixed price per currency that takes precedence over conversion. Good for round price points on a market. CSV import supports columns such as price_EUR.

What the customer sees

The currency is chosen in this order: ?currency= in the link, then the saved choice (cookie, one year), then the visitor's country if auto-pick is on, finally the storefront default. The currency switcher in header and footer appears when at least two currencies are enabled; a switch reloads the page in the new currency and the cart is repriced.

The checkout locks the currency and sends it as the purchase currency to Kustom. See Kustom markets for which country and currency pairs must be allowed.

The order and the reports

Every order stores its currency, the rate to the base currency at purchase and totals in the base currency. Reports and OSS therefore always count in the base currency, whatever the customer paid in.