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.

The system offers options for setting tax models (included or excluded) and applying rounding rules to prices. Using the CSV upload feature, users can update multiple countries at once, with clear formatting guidelines to ensure smooth imports.

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

5. Find the relevant country whose price you want to edit.
6. Under the price column, click the pencil symbol for that country.

7. Add the new price.
8. Click 'Save' at the top right of the page.
9. 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.

4. 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).
5. 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

• Unsupported Countries: If a country is not supported for price points in the CSV file, the prices will default to USD for that country.
• USD Requirement: The first column must list all of the price points in USD. If not, the file will not be uploaded, and an error will be displayed.

• Non-Existent Country Codes: Any non-existent country codes listed will be ignored, and default prices will be set.
• Empty Values: If only USD prices are provided, all other currencies will default to standard settings.
• Out of Range Values: If a price value is outside the supported range for its currency, an error will be returned including the incorrect input value and the supported range for that specific currency.

Currency Exchange Rates

Currency exchange rates are used to convert USD prices to local currencies. Appcharge automatically calculates the exchange rate based on the most current rates available. However, for accuracy and consistency, it's recommended to review our Currency Conversion documentation.

Pricing Settings

In this section, we discuss the toggles available during CSV uploads. Please note that these toggles may not apply in every case, even when turned on.

‘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’ Toggle

• Functionality: When turned on, default price points will be rounded to .00 or .99 to make prices more attractive.
• Exceptions: This rounding will not apply to manually uploaded or CSV-uploaded specific price conversions.
• Rules: This table outlines rounding rules for converting a currency to $1, based on the conversion's decimal ending. Review the rate ranges and corresponding decimal endings (.00-.49 or .50-.99) to determine the applicable rounding rule for each scenario.

Real-Life Examples for Tax and Rounding Rules

1. Paris, France (Tax Included)

• Tax Rate: 20% VAT
• Rounding: Nearest €.00
• Base Price: €10
• Final Price: €12.00 (after 20% tax and rounding)
• Player Sees: €12.00
• Explanation: Price shown includes VAT and is rounded for clarity. No additional tax at checkout.

2. New York, USA (Tax Excluded)

• Tax Rate: 8.875% (City and State tax)
• Rounding: Nearest $.99
• Base Price: $10
• Checkout Price: $10.99 (after adding tax and rounding)
• Customer Sees: $10.99
• Explanation: Base price displayed; tax added and total rounded at checkout for attractiveness.

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.