Skip to main content
The Price Localization API service allows you to create and manage price points for your Appcharge products across all supported currencies. A price point is a specific price at which a product or service is offered for sale. When you create a price point, you define a base price in USD. For each price point, Appcharge automatically generates corresponding localized prices in all supported currencies. You can override these generated localized prices for specific countries by providing custom values as needed. Learn more about the Price Points feature. With the Price Localization API service, you can:

​
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:

    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.
    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.
  1. Rounding rules are applied if enabled in the Publisher Dashboard.
    To enable this option:
    1. Go to Management > Pricing.
    2. In the Settings tab, scroll to Rounding Rules.
    3. Turn on the toggle.