LogoLogo
System Status
  • Digital River API
  • Getting started
  • Using our services
    • Local pricing
    • Item classification
    • Subscriptions
    • e-Invoicing
  • Integration options
    • Low-code checkouts
      • Implementing a Prebuilt Checkout
      • Implementing a Components checkout
      • Offering local pricing
      • Using a shipping endpoint
      • Processing subscription acquisitions
      • Adding custom fields
      • Offering store credit
      • Displaying policies and getting consent
      • Collecting e-invoice information
      • Handling completed checkout-sessions
    • Direct integrations
      • Standard flow
      • Building checkouts
        • Checking out guest and registered customers
        • Describing line items
          • Setting the price of an item
          • Managing items with shared SKU identifiers
        • Providing address information
        • Handling shipping choice
        • Tax identifiers
        • Applying a discount
        • Setting the customer type
        • Providing the IP address
        • Selecting a currency
        • Initiating a charge
        • Setting the purchase location
        • Configuring taxes
        • Accessing regulatory fee information
        • Localizing invoices and credit memos
        • Providing an upstream identifier
        • Applying store credit
        • Handling e-invoicing requirements
        • Landed cost
        • Tax calculation inputs
        • Selling entities
        • Payment sessions
        • Applying store credit (legacy)
        • Country specs
      • Building payment workflows
        • Handling redirect payment methods
        • Handling delayed payment methods
      • Subscription acquisitions
        • Handling subscription acquisitions
        • Handling external subscription acquisitions
        • Subscription information
      • Digital River coordinated fulfillments
        • Checking inventory levels
        • Using shipping quotes
        • Reserving inventory items
        • Managing a fulfillment order
        • Cancelling a fulfillment order
    • Connectors
  • Order management
    • Processing orders
    • Handling a rejected order
    • Accessing invoices and credit memos
    • Fulfilling goods and services
    • Capturing and cancelling charges
    • Payment reauthorizations
    • Handling reversals
      • Return basics
        • Digital River coordinated returns
        • Third party coordinated returns
      • Refund basics
        • Issuing refunds
        • Refunding asynchronous payment methods
      • Disputes and chargebacks
    • Customer notifications
    • Responding to events
      • Events
        • Key event types
        • All event types
      • Webhooks
        • Creating a webhook
        • Digital River API safelist
        • Digital River signature
      • Expanding events
      • Preventing webhooks from getting disabled
    • Distributor model
  • Subscription Management
    • Managing a subscription
    • Managing an external subscription
  • Payments
    • Payment solutions
      • Drop-in payments
        • How Drop-in payments work
        • Drop-in payments integration guide
      • DigitalRiver.js with Elements
        • Elements integration guide
        • Configuring payment methods
          • Configuring Afterpay
          • Configuring Alipay+ (cross-border)
          • Configuring Alipay (domestic)
          • Configuring Amazon Pay
          • Configuring Apple Pay
          • Configuring Bancontact
          • Configuring BNP Paribas
          • Configuring BLIK
          • Configuring CCAvenue
          • Configuring Clearpay
          • Configuring Credit Cards
          • Configuring FPX Online Banking
          • Configuring Google Pay
          • Configuring iDEAL
          • Configuring Klarna
          • Configuring Konbini
          • Configuring Online Banking (IBP)
          • Configuring Online Banking (Korea Bank Transfer)
          • Configuring PayCo
          • Configuring PayPal
          • Configuring SEPA Direct Debit
          • Configuring Trustly
          • Configuring Wire Transfer
          • Common payment sources
          • Common payment objects
    • Supported payment methods
      • Afterpay
      • Alipay (domestic)
      • Alipay+ (cross-border)
      • Amazon Pay
      • Apple Pay
      • Bancontact
      • BNP Paribas
      • BLIK
      • CCAvenue
      • Clearpay
      • Credit Cards
      • FPX Online Banking
      • Google Pay
      • iDEAL
      • Klarna
      • Konbini
      • Korea Bank Transfer (Online Banking)
      • Online Banking (IBP)
      • Pay with Installments France
      • PayCo
      • PayPal
      • PayPal Billing Agreement
      • PayPal Credit
      • PayPal Pay in 3
      • PayPal Pay in 4
      • PayPal RatenZahlung (Installment Payment)
      • SEPA Direct Debit
      • Trustly
      • Wire Transfer
    • Source basics
      • Managing sources
      • Handling credit card sources
      • Retrieving sources
    • Authorization declines
    • PSD2 and SCA
      • How to ensure SCA compliance
    • Payment testing scenarios
  • Product management
    • Product basics
    • Managing SKUs
    • Using product details
    • Grouping SKUs
    • SKU-inventory item pairs
    • Managing inventory items
    • Regulatory fees
      • What are regulatory fees?
        • Fees terminology
        • Regulatory fee management
        • European regulatory fees
        • Compliance obligations
        • WEEE directive requirements
        • Copyright directive requirements
        • Compliance challenges
      • Managing regulatory fees
  • Customer management
    • Customer basics
    • Creating and updating customers
    • Setting up tax exemptions
    • Recording a customer's request to be forgotten
  • Financial reporting
    • Financials basics
    • Sales transactions
      • Returning a list of sales transactions
      • Getting a sales transaction by ID
    • Sales summaries
      • Returning a list of sales summaries
      • Getting a sales summary by ID
    • Payouts
      • Returning a list of payouts
      • Getting a payout by ID
      • Get a list of transactions included in payout by ID
  • Developer resources
    • Digital River API reference
    • DigitalRiver.js reference
      • Including DigitalRiver.js
      • Initializing DigitalRiver.js
      • DigitalRiver object
      • Elements
        • Amazon Pay element
        • Apple Pay elements
        • Google Pay elements
        • IBAN element
        • iDEAL element
        • Konbini elements
        • Compliance element
        • Offline Refund elements
        • Online Banking elements
        • Tax Identifier element
        • Invoice attribute element
        • Delayed Payment Instructions element
        • PayPal elements
      • Guidelines for capturing payment details
      • Security
      • Digital River payment objects
      • Error types, codes, and objects
    • DigitalRiverCheckout.js reference
      • Including DigitalRiverCheckout.js
      • Initializing DigitalRiverCheckout.js
        • DigitalRiverCheckout configuration object
      • DigitalRiverCheckout object
        • Configuring Prebuilt Checkout
          • Performing actions
          • Defining experience
        • Components
          • Configuring components
          • Address component
          • Shipping component
          • Tax identifier component
          • Invoice component
          • Wallet component
          • Payment component
          • Compliance component
          • Order summary component
          • Thank you component
        • Rendering a checkout button
          • Performing actions on the checkout button
        • Determining the checkout's status
      • Accessing country and currency
    • DynamicPricing.js reference
    • Postman collection
  • administration
    • Sign in
    • Digital River Dashboard
      • Digital River Dashboard quick start guide
      • Key features
      • Reset your password
      • Test and production environments
      • Account
        • Adding an account
        • Switching accounts
        • Account access
      • Profile settings
        • Viewing your personal information
        • Changing your password
        • Updating your phone number
        • Enabling multi-factor authentication
      • Finance
        • Payouts
          • Viewing your payout details
          • Filtering your payouts
          • Exporting your payouts
        • Sales summaries
          • Viewing your sales summaries details
          • Filtering your sales summaries
          • Exporting your sales summaries
          • Exporting your sales summary details
        • Transactions
          • Viewing your transaction details
          • Filtering your transactions
          • Exporting your transactions
      • Order management
        • Orders
          • Searching for orders
          • Filtering your orders
          • Viewing the order details
          • Cancelling items
          • Fulfilling items
          • Downloading an invoice
          • Downloading a credit memo
          • Creating shipping labels
          • Recording a customer's request to be forgotten
          • Viewing returns and refunds
          • Creating a return
          • Accepting a return
          • Creating a refund
          • Viewing the order's timeline
        • Checkouts
          • Searching for checkouts
          • Filtering your checkouts
          • Viewing the checkout details
        • Prebuilt Checkout links
          • Generate Prebuilt Checkout links
          • View and work with Prebuilt Checkout link details
          • Add a customer during Prebuilt Checkout
          • Add a product during Prebuilt Checkout
      • Customers
        • Viewing customer details
        • Searching for customers
        • Filtering your customers
        • Editing account information
        • Adding a customer
        • Tax IDs and certificates
          • Adding a tax certificate
          • Adding a tax ID
          • Deleting a tax ID
        • Metadata
          • Adding metadata
          • Editing metadata
        • Manage subscriptions from the Customer Details page
        • Disabling a customer
        • Recording a customer's request to be forgotten
        • Deleting a customer
      • Catalog
        • SKUs
          • Viewing the SKU details
          • Searching for SKUs
          • Filtering your SKUs
          • Adding a SKU
          • Editing a SKU
          • Deleting a SKU
          • Adding a fee to a SKU
          • Editing a fee
          • Deleting a fee
          • Viewing product tariff codes
        • Managing customer subscriptions from Digital River Dashboard
      • Developers
        • API keys
          • Updating your API version
          • Getting your API keys
          • Changing the API version for your key
          • Creating a restricted key
          • Editing a restricted key
          • Deleting a restricted key
          • Rotating keys
        • Webhooks
          • Creating a webhook
          • Editing a webhook
          • Deleting a webhook
          • Rotating a webhook's secret
        • API logs
          • Filtering the API log
          • Viewing the API log details
        • Event logs
          • Filtering the events log
          • Viewing the event details
      • Settings
        • Users and roles
          • Roles
          • Searching for a user by name or email
          • Filtering your users and roles
          • Adding a user
          • Editing a user
          • Deleting a user
        • Prebuilt Checkout
        • Payment methods
          • Viewing your payment methods
          • Viewing payment method details
            • Enabling currencies
            • Managing countries
          • Enabling or disabling a payment method
  • General Resources
    • eCompass
    • eCompass documentation
    • Release notes
      • 2024
      • 2023
      • 2022
      • 2021
      • 2020
      • 2019
    • Standards and certifications
      • Certification process
      • Compliance requirements
      • Documentation requirements
      • Integration checklists
        • Admin portal
        • Products and SKUs
        • Customers and tax exemptions
        • Checkouts, payment sources, and orders
        • Disclosures, compliance statements, and emails
        • Fulfillments and cancellations
        • Customer portal
        • Order refund synchronization
        • Reversals
        • Error handling
      • Test and use cases
    • Commerce infrastructure
    • Versioning
    • Glossary
Powered by GitBook
On this page
  • Benefits of the service
  • Setting up your account
  • Base country and currency
  • Supported countries and currencies
  • Taxes
  • Fixed prices vs. variable prices
  • Rounding logic
  • Local pricing selector
  • Next steps
  1. Using our services

Local pricing

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

PreviousUsing our servicesNextItem classification

Last updated 3 months ago

Local pricing allows you to cater to a global audience by offering a tailored shopping experience on your storefront. By enabling customers to choose their preferred shopping country and currency, you can provide accurate, converted prices, enhancing customer satisfaction and potentially increasing sales.

On this page, you'll find information on:

Benefits of the service

Digital River's local pricing service offers several advantages that enhance operational efficiency and customer experience. By leveraging this service, you can streamline your pricing strategy across multiple regions, ensuring that your customers receive consistent and accurate pricing information. Below are the key benefits you can expect:

  • Maintains consistency between the prices customers see on your storefront, in your cart, and at the checkout.

  • It allows you to take advantage of frequently updated exchange rates.

Setting up your account

You must first configure your account to leverage Digital River's local pricing service. This setup includes essential steps and configurations to ensure smooth operation and accurate pricing across multiple regions. Follow these instructions to get started:

  1. Before deployment, you'll need to:

  2. 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

The base country and currency settings are fundamental to Digital River's local pricing service. Configuring these ensures that your customers see relevant pricing based on their location and preferred currency, enhancing their shopping experience and potentially increasing conversion rates. This section covers how to assign and manage your base country and currency to optimize the pricing service.

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

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 Italy as your base country and the euro as your base currency.

Each time Digital River performs a currency conversion, it converts your original prices from your designated base currency to the customer-selected target currency.

Supported countries and currencies

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

Taxes

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

Customers in EU nations typically expect prices to include the value-added tax (VAT), while US customers expect the taxes to be added at checkout.

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

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

Your Digital River representative can help determine your optimal tax setup based on your trading patterns.

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

Fixed prices vs. variable prices

Fixed prices

Fixed prices allow you to maintain a consistent product price, unaffected by currency exchange rate fluctuations. The product price displayed to customers remains the same, providing uniform pricing and simplifying budgeting for your customers.

Variable prices

Variable prices, on the other hand, adjust according to current exchange rates and local currency variations. It means that the prices customers see may change based on market conditions, allowing for more dynamic pricing that can reflect real-time economic changes.

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.

Local pricing selector

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

Next steps

For details on pairing one of our with local pricing, refer to .

It allows you to maintain a single price list in a fixed currency, assign that data to elements in your , and then make sales in multiple countries and currencies.

Allows customers to while shopping on your site and then shows the converted prices.

Employs to make your prices more consumer-friendly.

It uses .

It allows you to apply to your storefront prices.

It allows you to maintain for designated countries.

Digital River retrieves the original prices assigned to elements in your from a list associated with this base country-currency pair.

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

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

The lets customers choose from one of 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.

You can specify whether to include taxes in your storefront prices for each .

Suppose the values in your price elements are tax-exclusive, and the customer's selected country requires storefront prices to include taxes. You can configure the service to add the appropriate tax amount to your price values.

You can choose between fixed and variable pricing for each when setting up product pricing. Understanding the differences between these two approaches can help you decide which method best suits your business needs and market strategy. This section explores the benefits and considerations of each pricing model.

You can configure a unique pretty pricing rule for each .

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

When customers choose a different country, the currency drop-down in the selector defaults to that country's currency. Only that option will be available if you set up your account to conduct all transactions in the selected country's currency. Otherwise, all the will appear as options.

For details on pairing one of our with local pricing, refer to .

low-code checkout options
Offering local pricing
DOM
DOM
DynamicPricing.js
DOM
low-code checkout options
Offering local pricing
select various country-currency combinations
rounding logic
country-specific tax rates
fixed price lists
Specify a base country and currency
Provide a list of countries and currencies you want to support
Configure taxes
Set fixed prices
Select rounding rules
local pricing selector
supported country
supported country
supported currency
supported countries
currencies saved to your account
The benefits of the local pricing service
Setting up your account to use local pricing
data-dr-default-country
standardized rules to format a price's numeric amount and currency