Regional prices

When you set up the item catalog, you can set up a pricing policy for players from different countries (country-based prices) for virtual currency and virtual items. The price for each item is in US dollars by default. You can set regional restrictions and country-based prices at the same time.

How it works

The user’s country is passed in the country parameter when requesting a catalog (Get virtual items list API call). If the country is not explicitly specified, it is determined based on the user’s IP address. Prices are then selected for the item catalog based on the user’s country.

Who can use it

Partners who want to increase sales in countries with low purchasing power by setting the store’s pricing policy for players from different countries.

Integration flow

You can add, edit, and delete country-based prices:

Note
When importing items from your catalog, Xsolla automatically applies country-based prices to predefined items, and allows you to edit the price of these items.

Create via Publisher Account

To create a virtual item with a country-based price:

  1. Open your project in Publisher Account.
  2. Click Store in the side menu.
  3. In the Virtual Items pane, click Configure.
  4. Click + and select Create item from the drop-down list.

  1. Specify item attributes.
  2. In the Price settings block, choose Paid item.
  3. Switch the Pricing in real currency toggle to On and specify the price. If you do not set country-based prices, the price of an item will be the same for all countries and in US dollars.

Note
You can change US dollars to another currency.
Notice
You can’t create an item with a zero price value.

  1. Set up prices:
    • If you want to set up the price of an item in different currencies, click + and specify the currency and price.
    • If you want to set special prices for countries, click Add pricing and specify the country, currency, and quantity. You can set the number of country-based prices you need.
  2. If you want to add the price in virtual currency, switch the Pricing in virtual currency toggle to On and specify the price.
  3. If you want to limit the availability of items to specific users, switch the Limit number of times one user can buy this item toggle to On and specify the number.
  4. If you want to show an item in the store, set the Show item in store toggle to On.
  5. Click Create item.

Setting examples

Note
If the payment is made via Pay Station, the price of an item is converted into the currency of the user’s country and includes taxes, if applicable.

In this example, the default currency for the item is in USD and the price is 5 USD. If you do not specify settings for different countries, users from all countries will see the same price.

In this example, two price options are set for the item — one in USD and the other in EUR, but special prices for different countries are not specified. In this case, users from countries that use USD as their currency will see a price of 5 USD, and EU users will see a price of 7 EUR.

If a separate price is set up for the user’s country, the user will see this price in the item catalog. For example, a user from Afghanistan will see a price of 2 USD, while a user from Germany will see 10 EUR.

Create via API calls

To set up country-based prices for virtual items, pass an array of objects with country-based price settings to the Create item or Update item API call.

Example of the request:

Copy
Full screen
Small screen

"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Rate this page
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!
Last updated: February 14, 2023

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!