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:

• via Publisher Account
• via API calls

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.

5. Specify item attributes.
6. In the Price settings block, choose Paid item.
7. 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.

8. 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.
9. If you want to add the price in virtual currency, switch the Pricing in virtual currency toggle to On and specify the price.
10. 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.
11. If you want to show an item in the store, set the Show item in store toggle to On.
12. Click Create item.

Setting examples

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:

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

Rate this page

Is there anything we can improve? Send

Don’t want to answer

Thank you for your feedback!