Local pricing

Gain a better understanding of the local pricing service, its benefits, and your configuration options

With local pricing, you can build a storefront and checkout experience that allows customers to select their shopping country and the currency in which they want to conduct a transaction and then be presented with converted prices.

On this page, you'll find information on:

For details on pairing one of our low-code checkout options with local pricing, refer to Offering local pricing.

Benefits of the service

Digital River's local pricing service:

Setting up your account

Before deployment, you'll need to:

You also can:

Digital River then stores this data in your account, making it available to the local pricing service at run-time.

Base country and currency

Your local pricing account needs to be assigned a base country and currency.

The original prices you assign to elements in your DOM should be retrieved from a list associated with this base country-currency pair.

The values you designate are typically dependent on your trading patterns. For example, if most of your site's customers are in Italy, you'd likely want your base country to be Italy and your base currency to be the euro.

Each time Digital River performs a currency conversion, your original prices are converted from your designated base currency to the target currency selected by the customer.

Your base country may also affect how prices are displayed when your storefront loads. For details, refer to data-dr-default-country.

The data-dr-default-country attribute is only exposed if you're using the DynamicPricing.js library.

Supported countries and currencies

Before deploying, indicate which countries and currencies you want to support.

The local pricing selector allows customers to choose from your designated currencies. Alternatively, your account can be configured so customers shopping in a specific country are always restricted to using a single default currency.


The local pricing service gives you a variety of ways to configure taxes.

For each of your supported countries, you can specify whether taxes should be included in your storefront prices.

Customers in EU nations typically expect prices to be displayed with value-added tax (VAT) included, while US customers are accustomed to seeing taxes added at checkout time.

Suppose the values in your DOM price elements are tax exclusive, and a requirement exists in the customer's selected country that storefront prices include taxes. In that case, you can configure the service to add the appropriate tax amount to your price values.

Alternatively, if assign tax-inclusive values to your DOM price elements, but no such requirement exists in the customer's country, then the service can extract the tax portion of your prices and only display their product portion.

Finally, if your base prices include taxes, and customers select a country you've indicated should display tax-inclusive prices, then the service can subtract taxes from your values and add back the amount applicable to that selected country.

Based on your trading patterns, your Digital River representative can help determine your optimal tax setup.

You can also set country-specific tax rates or allow each country's default tax rate to be applied to your product prices.

Fixed prices

For each of your supported countries, you can indicate whether you want your product prices to be fixed or variable If you make them fixed, customers shopping in that country are restricted to using its default currency.

You might find this feature useful if you maintain a static price list for a specific country and don't want it modified by the local pricing service. In this case, the values you assign to your DOM price elements are what customers see on your storefront and in the Prebuilt Checkout modal.

Rounding logic

The local pricing service contains rounding logic that handles the aesthetically unappealing and inconsistent product prices that often result from currency conversions. Exchange rates fluctuate, but these rules help keep your storefront prices stable. For example, rather than presenting a conversion as $124.28, the service might render that price as $123.99 or $125.00.

You can configure a unique pretty pricing rule for each of your supported currencies.

Local pricing selector

The local pricing selector allows customers to select a country-currency combination while shopping on your site.

The selector's country drop-down displays all of your supported countries.

When customers choose a different country, the selector's currency drop-down defaults to that country's default currency. If you set up your account so that all transactions in the selected country must be conducted in that currency, then only that option is available. Otherwise, all the currencies saved to your account are presented as options.

Next steps

For details on pairing one of our low-code checkout options with local pricing, refer to Offering local pricing.

Last updated