Regional sale restrictions

How it works

The Regional sale restrictions feature lets game developers:

• Set different game prices for individual countries or groups of countries.
• Prohibit the sales of game keys in certain countries.

You can control the sales of your game for specific countries and country groups.

How to get it

To enable the feature, contact your Customer Success Manager or email to csm@xsolla.com. We will need the following information for each platform that you want to be subject to regional restrictions:

• Restriction type:
  • Activation: a key can be activated in certain countries only.
  • Launch: a key can be activated in any country, but the game can be launched in certain countries only.
  • Activation and launch: a key can be activated and the game can be launched in certain countries only.
• List of country groups with different keys prices.
• Settings for each group of countries:
  • Group name.
  • SKU — a unique group identifier.
  • List of prices in different currencies. Make sure to indicate the price in the default currency. Detailed information on setting regional prices in real currency is provided in the documentation.
  • List of countries within each group. Detailed information on regional sales restrictions is provided in the documentation.
• List of countries where keys are disabled (if any).

For any single platform, a country can belong either to a different-price group or to the preorders-disabled group. If a country is not listed in any of the groups, keys can be sold without any restrictions, at the prices set in default settings.

Integration flow

To set up regional restrictions:

1. Create regions where the game’s SKU will be available by calling the Create region API method.

2. Add the region ID to the regions array by calling the API from the Admin category of the Game keys group when creating a game.

Example of the request:

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Example:

1. Create the North America region that includes the USA and Canada.

{
  "name": {
     "en-US": "North America",
   },
  "countries": ["US", "CA"]
}

2. Add the region ID to the regions array when updating the SKU of an existing game by calling the Update game by SKU API method.