Regional sale restrictions

How it works

Regional sale restrictions let you control which countries game keys can be sold and also help prevent abuse — for example, when a user purchases a key at a lower price in one region and activates it in another.

The user’s country is passed in the country parameter when requesting a catalog (Get game list API call). If this parameter is not provided, the country is determined based on the user’s IP address. The catalog is then generated based on the user’s country.

Who can use it

Partners who want to limit game key availability in certain regions.

Integration flow

To set up regional restrictions:

1. Create regions where the game’s SKU will be available by calling the Create region API call. The API returns the region ID, which you will need at the next step.

Example of creating a North America region that includes the USA and Canada:

1{
2  "name": {
3     "en-US": "North America",
4   },
5  "countries": ["US", "CA"]
6}

2. Pass the region ID to the regions array by calling the Admin category of the Game keys group when creating or updating a game.

Example of a regions array with IDs of regions where game keys can be sold:

1"regions": [
2  {
3     "id": 123
4  },
5  {
6     "id": 456
7  }
8]