> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appcharge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 cents, 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](/../../guides/checkout/price-localization/set-up-price-points) feature.

With the Price Localization API service, you can:

* [Create a price point](./create-price-point).
* [Retrieve a list of all price points](./get-all-price-points).
* [Retrieve a specific price point](./get-price-point) by price in USD cents.
* [Get price points for a country](./get-price-points-for-a-country).
* [Update a price point](./update-price-point).
* [Delete a price point](./delete-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: <br /><br />

   <AccordionGroup>
     <Accordion title="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.
     </Accordion>

     <Accordion title="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.
     </Accordion>
   </AccordionGroup>

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

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

   <Accordion title="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.
   </Accordion>