Multi-Currency Sites

The Salesforce B2C Commerce multi-currency sites feature enables you to sell products in multiple countries or regions. You use the feature so that your customers can browse products and checkout carts in their preferred purchase currencies.

You can sell in multiple countries using different currencies with a single site. A single multi-currency site can support up to 150 currencies.

Consider using this feature when:

Support for multi-currency sites is Limited to certain areas of B2C Commerce.

Session Currency

Multi-currency sites depend on Session Currency. Before Release 14.2, B2C Commerce used the site currency to perform functions such as price lookups, basket calculations, checkout operations, order placement, and calculations. Starting with Release 14.2, B2C Commerce can use the session currency instead.

When a customer first accesses your storefront, the customer's session currency is initialized with the default currency for your site. B2C Commerce uses the default currency as the session currency unless the customer selects a different preferred currency. You use custom business logic to give the customer this ability.

B2C Commerce always remembers and properly restores the session currency when a customer returns to the storefront. However, the session currency for a given customer can become invalid. For example, if the site administrator removes an allowed currency. In this and similar scenarios, B2C Commerce resets the session currency to the default site currency the next time the customer accesses the storefront.

The session currency must be one of the allowed currencies configured for the site. The customer can’t check out or create an order with an invalid currency.

Reports and Analytics

The following features that report revenue amounts support multi-currency sites:

Feature Comments
A/B Testing If the order is placed in the context of an A/B test, A/B test statistics reflect the converted monetary value.
Active Data Customer active data for the customer placing the order and product active data for the ordered products are changed to reflect the converted money values.
Reports & Dashboards You can change the realm currency setting so that aggregated realm data for all your sites shows in the selected currency.

These features use storefront purchase data to provide revenue metrics that you can view or use for search sorting or customer segmentation. When B2C Commerce records a revenue event, all monetary values are converted to the site's default currency. The conversion uses the exchange rate applicable for that day.

For example, a site's default currency is US Dollar (USD), but the site supports both USD and Euro (EUR). When a customer places an order using Euro for payment, the order values are converted from EUR to USD using that day's exchange rate.

B2C Commerce does not provide separate reporting for each currency. The exchange rate service is internal to B2C Commerce and not viewable in Business Manager or available through the B2C Commerce API. Because the values are based on an exchange rate service that is regularly updated, the metrics provided by these subsystems are appropriate in a multi-currency scenario.

Implementation Considerations

Consider the following implementation tasks when planning a multi-currency site:

Implementation task Description Who does it?
Configure allowed currencies for the site When a site is first created, a single default currency is specified. After the site is created, you can add allowed currencies for the site. Merchant
Create price books for each currency B2C Commerce looks up prices using the session currency, and each price book is specific to a single currency. If you want to support three currencies, you must create at least three price books, one for each currency. Merchant
Configure promotions to account for currency When you configure a promotion, you can optionally specify a currency. If the promotion applies to all currencies, for example, 10% off, you can either select a specific currency, for example, EURO, or 'All'. You can create a promotion for a specific currency. However, the promotion applies only when the customer selects the specified currency as the session currency. Merchant
Configure payment methods to specify a currency When you configure a payment method, you can optionally specify one or more allowed currencies. If you don't specify a currency, when you create a payment method, all allowed currencies are accepted by default. You can restrict the payment method to one or more currencies. However, the payment method only applies when the customer selects one of the specified currencies as the session currency. You also can specify minimum and maximum payment ranges for each allowed currency. Merchant
Configure shipping methods to specify a currency When you configure a shipping method, you can optionally specify an allowed currency. If you don't specify a currency, the default currency for the site is used instead. The shipping method applies only when the customer selects the specified currency as the session currency. Merchant
Customize your storefront to enable the customer to select a preferred currency

Your storefront must enable customers to select a preferred currency from a list of allowed currencies. You can use the dw.system.Session B2C Commerce Script API object to set the session currency. See APIs for Multi-Currency Sites later in this topic.

Modify your import process to account for changes related to multi-currency sites For more information, see Import and Export for Multiple-Currency Sites later in this topic. Developer

Import and Export for Multiple-Currency Sites

The following XML schemas elements support multi-currency sites:

APIs for Multi-Currency Sites

B2C Commerce Script API and Pipelet API support multi-currency sites as follows:

API Object Description


Provides a getAllowedCurrencies() method to obtain a list of allowed currencies for the site.


Provides getCurrency() and setCurrency(newCurrency : Currency) methods to get and set the session currency.


Provides getCurrencyMnemonic() to obtain the ISO 4217 mnemonic currency code for the shipping method.


The following methods filter by session currency:

  • getAllShippingMethods()
  • getDefaultShippingMethod()


Provides a getCurrency() method to obtain the currency for the promotion.


The following methods filter by session currency:

  • applyDiscounts(lineItemCtnr : LineItemCtnr)
  • getActiveCustomerPromotions()
  • getActiveCustomerPromotionsForCampaign(campaign : Campaign , from : Date, to : Date)
  • getDiscounts( lineItemCtnr : LineItemCtnr )
  • getDiscounts( lineItemCtnr : LineItemCtnr, promotionPlan : PromotionPlan )
  • getUpcomingCustomerPromotions( previewTime : int )


The isApplicable(customer : Customer, countryCode : String, paymentAmount : Number) filters payment methods by currencies and currency-specific price ranges.


The isApplicable(customer : Customer, countryCode : String, paymentAmount : Number) method filters payment methods by currencies and currency-specific price ranges.

GetBasket pipelet

When baskets are created, they are initialized with the current session currency. When fetching a basket, the pipelet compares the basket's currency to the session currency. If they differ, the pipelet changes the basket's currency to match the session currency; the pipelet also removes all payment instruments and shipping methods in the basket, because they are currency-specific.

SetSessionCurrency pipelet

Sets the session currency.

Feature Limitation to Be Addressed in Future Releases

Support for multiple currencies isn't yet available for all areas of B2C Commerce. Specifically, for Analytics, purchase reports are across all orders in all currencies. They do not differentiate by currency.

X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used. By continuing to use this site you are giving us your consent to do this. Privacy Policy.