Introduction

The Price Localization API service allows you to localize prices across all supported currencies by creating and managing price points.

A price point represents the price at which a product or service is offered for sale. Each price point is defined by a base price in USD, from which Appcharge calculates localized prices in supported currencies. You can also override these generated prices for specific countries when needed.

Learn more about the Price Points feature.

With the Price Localization API service, you can:

• Create a price point.
• Retrieve a list of all price points.
• Retrieve a specific price point by price in USD cents.
• Update a price point.
• Delete a price point.

Currency configuration and display behavior

Appcharge generates localized prices for all supported currencies. These prices are displayed in the web store and checkout only if the currency is enabled in the Publisher Dashboard. By default, all currencies are enabled.

If a currency isn’t enabled:

• Prices aren’t converted to that country’s local currency, and the USD price is displayed instead.
• If you provide a country-specific override using priceOverrides, the override value is treated as a USD amount and displayed in USD. It is not converted.

To enable or disable currencies:

1. In the Publisher Dashboard, go to Management > Pricing.
2. In the Settings tab, scroll to Currencies to Localize.
3. Check the currencies you want to display, and uncheck the ones you don’t want to display.

How localized prices are calculated

For each supported currency, the localized price is calculated as follows:

1. The base USD price is multiplied by the current exchange rate.

2. Tax is applied by multiplying the converted price by the applicable tax rate only if both of the following conditions are met:
   
   

   The country’s tax model includes taxes in the price.

   To check whether a country’s tax model includes tax:

   1. In the Publisher Dashboard, go to Management > Pricing.
   2. Click Add new price point, or click the ellipses next to an existing price point and select Edit.
   3. Review the value in the Tax model column for each country.
   4. If the value is Included, the country’s tax is included in the price.

   The option to display taxes in the price is enabled in the Publisher Dashboard.

   To enable this option:

   1. Go to Management > Pricing.
   2. In the Settings tab, scroll to Display Tax-Inclusive Prices.
   3. Turn on the toggle.

If a country’s tax model excludes tax from the price, Appcharge adds the applicable tax during checkout.

3. Rounding rules are applied if enabled in the Publisher Dashboard.

   Enable rounding rules.

   To enable this option:

   1. Go to Management > Pricing.
   2. In the Settings tab, scroll to Rounding Rules.
   3. Turn on the toggle.