Currency Localization Models

We support two currency localization models to provide a seamless pricing experience for players across different regions. This ensures that players are charged in their local currency with appropriate tax handling and price rounding.

Localization via Price Points

This model uses pre-configured price points in USD as the base, which are then automatically localized to the player’s currency.

  1. Set up price points in the AppCharge Dashboard:
    • You define every price point in USD (the base price) in the AppCharge Dashboard.
  2. Automatic conversion to local currency:
    • AppCharge will automatically convert each price point to the player’s local currency based on their geolocation.
    • For "tax inclusive" countries, any applicable taxes will be included in the final price.
    • AppCharge will also apply rounding rules to ensure prices are cleanly formatted.
  3. Store presents localized prices:
    • Once price points are set up, the store will automatically display prices in the local currency when the player loads the store.
  4. Checkout opens with localized prices:
    • When the player proceeds to checkout, the localized price will be displayed, ensuring a consistent experience throughout the purchase flow.

High-Level Flow:

  • Configure the price points in USD in the AppCharge Dashboard (see Price Points Dashboard Setup Guide).
  • Execute the getPricePoints method during the store boot phase.
  • Retrieve and display the localized prices, formatted with the local currency and tax inclusive, on the store screen.
  • When an offer is selected, execute the createCheckoutSession function with the relevant price point.

Localization via Simple Localization

This model displays prices in USD during the store phase and converts them into the player's local currency at checkout.

  1. Present prices in USD during the store phase:
    • Initially, all prices are shown in USD to the player while they browse the store.
  2. Convert to local currency during checkout:
    • When the player initiates the checkout, AppCharge will convert the USD price to the local currency based on the player’s location.
    • Unlike the Price Points model, no pre-configured price points or rounding rules are applied.
  3. Handle taxes for 'tax inclusive' countries:
    • For tax-inclusive countries, the tax amount will be separated out from the total price.
    • The player will see the localized price with the tax breakdown in checkout, and the USD amount you receive will exclude the tax.
  4. Checkout opens with localized price:
    • After the conversion, the player will see the final price in their local currency, including taxes, before completing the purchase.

High-Level Flow

  • Set the price points in USD in the AppCharge Dashboard.
  • Present prices in USD in the store phase.
  • Convert the price to local currency, including tax breakdown, during the checkout phase.
  • Display the final localized price in checkout, before completing the transaction.

For more detailed technical documentation on how to integrate these localization models, see the Price Points Localization SDK API documentation.