Overview

Appcharge allows users to define and upload pricing points manually or in bulk using a CSV file. This feature is designed to streamline and simplify the process of managing pricing, making it faster and easier for users to update and maintain their price points.

Appcharge supports 80+ currencies, enabling global pricing adjustments. You can update price points for major tax or currency changes. It's best to do this quarterly to maintain stable pricing for users.

Navigation

To access and use the Price Points feature:

1. Navigate to the Appcharge dashboard.
2. Go to the 'Pricing' section.

Conditions

When uploading a CSV file, please note the following conditions:

• Country Codes: 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.
• Price Points: 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.
• Decimal Handling: 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.

Add Price Points Manually

Add price points manually by clicking on “Create New Pricing” at the top right of the dashboard.

Add Price Points via CSV

Download the CSV Template

Click 'Export' to download a pre-formatted CSV template.

This template will contain all current price point data already updated with Appcharge. If there are no existing price points, the template will be empty.

Import CSV

1. Fill in the exported CSV with the desired price points, ensuring all conditions are met.
2. Upload the completed CSV file via the ‘Import’ button.

Edit Existing Price Points

To edit existing price points:

To the right of each price point, there will be a three-dot menu.

1. Click the three dots.
2. 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 a price
2. Save at the top right of the page.
3. The status will be changed to 'Manually Updated' for the country that you edited.

Error Handling

• 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 Conversion documentation

Pricing Settings

In this section, we discuss the toggles available during CSV uploads. It's important to note that these toggles may not apply in every case, even when they are 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.