Skip to main content

​
Overview

Appcharge allows users to manage pricing points by adding them manually or uploading them in bulk using a CSV file. With support for over 80 currencies, you can update price points to reflect changes in taxes or currency rates. It’s recommended to review and update prices quarterly to keep them consistent. For more details, see the Supported Countries for Price Points document.

​
Add Price Points Manually

  1. Navigate to the Appcharge dashboard.
  2. Go to the ‘Pricing’ section.
  3. Click on “Create New Pricing” at the top right of the dashboard.
  4. Enter a new Price Point in USD.
    Note: The price point cannot be lower than $0.8.
  5. Adjust the prices for the specific countries where you want to apply the new price point. Ensure the prices align with your desired currency and tax settings for each country.
  6. Click ‘Save’ at the top right corner to save the new Price Point.

​
Manually Edit Existing Price Points

  1. Navigate to the Appcharge dashboard.
  2. Go to the ‘Pricing’ section.
  3. Click the three dots to the right of the price point you wish to edit.
  4. Select “Edit.”
  1. Find the relevant country whose price you want to edit.
  2. Under the price column, click the pencil symbol for that country.
  1. Add the new price.
  2. Click ‘Save’ at the top right of the page.
  3. The status will change to ‘Manually Updated’ for the country you edited.

​
Add Price Points via CSV

  1. Navigate to the Appcharge dashboard.
  2. Go to the ‘Pricing’ section.
  3. Click ‘Export’ to download a pre-formatted CSV template. This template will contain all current price point data already updated in Appcharge. If no price points exist, the template will be empty.
  1. Once the CSV template is opened, fill it with the desired price points, ensuring all conditions are met (see the conditions and format rules below).
  2. Upload the completed CSV file by clicking the ‘Import’ button.

​
CSV Format Rules

  • Each column should represent a supported country. Countries must be listed using their Alpha-3 codes (not currency abbreviations). For example, the code for the United States is USA.
  • The first column should always contain the USD price for the price points you’re configuring.
  • Each row should represent a different USD price point that you want to convert to various supported currencies. The price points in USD will be converted to their corresponding values in the local currencies for the selected countries.
  • For each country (column), list the converted price in its local currency. If you choose to leave a country out, the conversion for that country will be left blank.
  • Note: If the country is not supported for price points or if the price point is not configured for a specific country, the price will default to USD.
Here’s an example of how the filled-out CSV should look:

​
CSV Conditions

When uploading a CSV file, please note the following conditions:
  • You can select any country supported by Appcharge for price point conversions and provide the appropriate currency values for each USD price point. To view the full list of supported countries for price point conversions, refer to this documentation.
  • The CSV should use the country’s Alpha-3 code, not currency abbreviations. A reference link to the correct Alpha-3 codes is provided here.
  • The base price values must be between 0.8 and 5000 (USD). View our Supported Currencies documentation to see the minimum and maximum charge amount for every currency.
  • For zero-decimal currencies only, if a decimal is included in the CSV, it will be ignored, and only the integer part will be used.

​
CSV Error Handling

  1. Unsupported or Non-Existent Country Codes:
    • If the country isn’t supported or if a wrong (non-existent) country code is used, the entire CSV will not be uploaded, and an error will be displayed.
  2. USD Requirement
    • The first column must list all of the price points in USD.
    • The title of the first column must explicitly be “USD price point.”
    • If these requirements are not met, the file will not be uploaded, and an error will be displayed.
  1. Non-Numeric Values
    • All rows (excluding the header row) must contain numeric values for price points.
    • If any of the cells (beyond the header row) contain non-numeric data, the CSV will not be uploaded, and an error will be displayed.
  2. Out of Range Values
    • If any price value is outside the supported range for its currency, an error will be returned.
    • The error will include the incorrect input value and the supported range for that specific currency.
    • Because the range for each currency can differ, please refer to our Supported Currencies documentation for the minimum and maximum values.
    • If any price point is invalid, the entire file will not be uploaded.

​
Price points settings

This section covers price configuration options available in the Pricing > Settings tab, including tax settings, rounding rules, currency exchange rate updates, and price guards.

​
Currency localization

The currency localization feature enables Publisher Dashboard admins to control how prices are displayed across different regions. To account for areas with high currency fluctuation, admins can select which currencies to localize from USD. If a currency is unchecked, prices for all countries using that currency will be displayed in USD instead of the local currency. For example, unchecking ARS will display prices in USD for players in Argentina. Prices are automatically calculated based on the set price point and, if the Display Tax-Inclusive Prices toggle is enabled, the applicable tax will also be included in the displayed price.

​
Select currencies to display

To select the currencies to display:
  1. In the Publisher Dashboard, go to Management > Pricing, and then click the Settings tab.
  2. In the Currencies to Localize section, click the Currencies drop-down menu.
  3. Select the currencies you want to display, and then click Apply.

​
Currency exchange rates

To keep localized prices in sync with current exchange rates, you can update exchange rates manually or schedule automatic updates. These updates directly affect how your prices are calculated across different currencies, ensuring accurate and regionally appropriate pricing. For more on how exchange rates are sourced and applied within Appcharge, see Currency Conversions.
Updating exchange rates doesn’t override currencies that are configured for localized pricing.

​
Update exchange rates manually

To manually update exchange rates:
  1. In the Publisher Dashboard, go to Management > Pricing, and then click the Settings tab.
  2. In the Update Exchange Rates section, click Update. The Update Exchange Rates dialog opens.
  3. Click the Currencies drop-down menu and select the currencies you want to update.
  4. Click Apply.
  5. Select Update Now, and then click Update.

​
Schedule automatic updates

To schedule automatic exchange rate updates:
You can create only one automatic update schedule, but it can include multiple currencies.
  1. In the Publisher Dashboard, go to Management > Pricing, and then click the Settings tab.
  2. In the Update Exchange Rates section, click Update. The Update Exchange Rates dialog opens.
  3. Click the Currencies drop-down menu and select the currencies you want to update.
  4. Click Apply.
  5. Select Schedule. The scheduling options appear.
  6. Click the Repeat drop-down menu, select the schedule that you want, and complete the relevant required fields below:
    • Does Not Repeat: Select this option to save the schedule as a draft or to pause an existing recurring schedule.
    • Every Day
      • Time: Select the time of day (UTC).
    • Every Week
      • Weekday: Select the day of the week.
      • Time: Select the time of day (UTC).
    • Every Month
      • Day of Month: Select the calendar day (1–31).
        If you schedule an update on a day that doesn’t occur in every month, such as the 31st, the update won’t run in those months.
      • Time: Select the time of day (UTC).
    • Quarterly: Updates every quarter of the year, on January 1, April 1, July 1, and October 1.
    • Semi-Annual: Updates twice a year, on January 1 and July 1.
    • Annual: Updates once a year, on July 1.
  7. Click Update to save your changes.

​
‘Add Tax’ Toggle

Users can view the tax details, including whether it is included or excluded and the applicable percentage. This information varies by country and will override the default tax setting if specific price points are provided.
  • Functionality: When turned on, tax will automatically be included in the price calculations.
  • Exceptions: If specific price conversions are uploaded manually or via CSV, the tax will not apply even if the toggle is turned on.

​
Rounding rules

When the Rounding Rules toggle is on, Appcharge applies rounding after it converts your USD price point to the local currency and adds the applicable tax. Rounding behavior depends on the currency type:
  • Decimal currencies: Currencies such as USD and EUR round to endings like .00, .09, .90, or .99. See Decimal currencies.
  • Zero-decimal currencies: Currencies such as JPY, KRW, and VND round to natural whole-number denominations. See Zero-decimal currencies.

​
Enable rounding rules

To enable rounding rules:
  1. In the Publisher Dashboard, go to Management > Pricing, and then click the Settings tab.
  2. Scroll to Rounding Rules.
  3. Turn on the toggle.
With the Rounding Rules toggle on, rounded prices apply to auto-calculated conversions going forward. Appcharge rounds auto-calculated prices to cleaner endings, such as $9.99 instead of $9.97. Rounding doesn’t apply in these cases:
  • Manual prices: Prices you enter manually or upload by CSV. Appcharge keeps the exact price you set.
  • Rounding disabled: Auto-calculated prices generated while the Rounding Rules toggle is off, or before you enable rounding.
  • Missing exchange rate: If Appcharge can’t find the current exchange rate for a currency, it uses the exact converted price after conversion and tax so the player can still pay.
  • No rounding rules: If Appcharge has no rounding rules configured for a currency, it leaves the price unchanged.
  • Price Guards: When Appcharge checks whether a localized price falls within your configured thresholds, it compares against the unrounded converted price. See Price Guards.

​
Decimal currencies

Currencies like USD and EUR use cents, so a converted price might land on an awkward number like €15.45. Appcharge adjusts it to a cleaner price, like €14.90, using the rules in the table below. Appcharge chooses the ending in two steps. It doesn’t use the mathematically nearest ending. It uses a fixed .50 cutoff on the decimal fraction.
  • Exchange rate: Appcharge looks up the USD-to-local exchange rate used for that currency’s conversion. This rate comes from your pricing settings. It is not the converted price. Appcharge matches that rate to a row in the table below.
  • Decimal fraction: Appcharge checks the digits after the decimal point in the converted price. If that fraction is .00 to .49, it uses the left-column ending. If that fraction is .50 to .99, it uses the right-column ending.
The following table shows how Appcharge selects the rounded ending based on the exchange rate and the converted price’s decimal fraction. In this table, xy is the whole-number part of the converted price. For a converted price of 15.45, xy is 15. In the > 200 row, xyz represents the integer digits before .00 in the ending xyz0.00. For example, xyz0.00 becomes 1230.00, where xyz is 123. In the Rate has ≥ 5 digits row, xxx works the same way in the ending xxx00.00. For example, with a USD → local exchange rate of 1.0, Appcharge selects the ≤ 2 row. For a converted price of 1.52, the decimal fraction .52 falls in the .50 to .99 range, so the price rounds to 1.99. With a USD → local exchange rate of 3.0, Appcharge selects the > 2 and ≤ 200 row. For a converted price of 15.45, the decimal fraction .45 falls in the .00 to .49 range, so the price rounds to 14.90.

​
Zero-decimal currencies

Zero-decimal currencies use whole numbers only, such as JPY, KRW, and VND. Appcharge rounds 16 of these currencies to the nearest configured denomination using round half up. Unlike decimal currencies, Appcharge picks the mathematically nearest denomination. It doesn’t use the .50 decimal-fraction ending lookup. Depending on the currency, Appcharge applies either tiered or fixed-unit rounding. Tiered rounding uses a larger denomination once the price crosses a threshold. Fixed-unit rounding always uses the same denomination. Tiered rounding JPY and KRW use different denominations below and above a price threshold. Fixed-unit rounding The other 14 zero-decimal currencies always round to the same denomination, regardless of price. For example, VND rounds to the nearest 1,000, so 12,450 becomes 12,000. The following table lists each currency and the denomination it rounds to.

​
Tax and rounding examples

The following examples show how tax display and rounding can appear together. Rounding endings still follow the decimal and zero-decimal rules above.
  1. Paris, France (tax included)
    • Tax rate: 20% VAT
    • Base price: €10
    • Final price: €12.00 (after 20% tax and rounding)
    • Player sees: €12.00
    • Explanation: The price shown includes VAT. No additional tax is added at checkout.
  2. New York, USA (tax excluded)
    • Tax rate: 8.875% (city and state tax)
    • Base price: $10
    • Checkout price: $10.99 (after adding tax and rounding)
    • Player sees: $10.99
    • Explanation: The base price is displayed. Tax is added at checkout, and the total is rounded.

​
Price Guards

Price Guards let you monitor localized prices and receive alerts when they fall outside expected ranges based on the latest market exchange rate. Appcharge uses the unrounded converted price for these comparisons so the threshold check is as accurate as possible. You can set percentage-based thresholds for different price ranges to define how much variation from the converted value is acceptable. When a localized price exceeds its threshold, Appcharge flags it in the Publisher Dashboard. To resolve the alert, simply update the localized price or adjust the relevant threshold.

​
Example

The following example shows how Appcharge detects and reports a threshold breach:
  • USD price point: $2,000
  • Current exchange rate (USD to EUR): 1.5
  • Converted price: €3,000
  • Threshold range: ±10%
If the market exchange rate changes and the converted price becomes €3,450 (a 15% increase), Appcharge detects that the localized price is now outside the allowed range and triggers an alert in the Publisher Dashboard.

​
Configure Price Guards

To configure price guards:
  1. Go to Pricing, and click the Settings tab.
  2. In the Create Price Guards section, add a price range and its percentage thresholds:
    • Specify the Price range start and Price range end.
    • Enter a negative number for the Negative threshold (%) and a positive number for the Positive threshold (%)
  3. Click Add.

​
Final Price Calculation

The final price for each item is calculated by first converting the USD price to the target currency, then adding the applicable tax, and finally applying the rounding rules. For more details, users can learn more in the tax section of the dashboard.