Региональные ограничения продаж

Как это работает

Региональные ограничения продаж позволяют регулировать, в каких странах можно продавать игровые ключи, и предотвратить злоупотребления — например, когда пользователь покупает ключ по заниженной цене в одном регионе, а активирует его в стране из другого региона.

Страна пользователя передается в параметре country при запросе каталога (метод API Получение списка игр). Если параметр не передан, страна будет определена на основе IP-адреса пользователя. Затем формируется каталог игр, доступных для страны пользователя.

Внимание
При настроенных региональных ограничениях продажа ключа в стране возможна только в том случае, если она входит хотя бы в один регион. Если страна не входит ни в один регион, продажа ключа в ней будет недоступна.

Для кого подходит

Для партнеров, которые хотят ограничить доступность игровых ключей в определенных регионах.

Сценарий интеграции

Чтобы настроить региональные ограничения:

  1. Создайте регионы, в которых будет доступен пакет игровых ключей, с помощью метода API Создание региона. В ответе вернется ID региона, который потребуется на следующем шаге.

Пример создания региона Северная Америка, включающего в себя США и Канаду:

Copy
Full screen
Small screen
1{
2  "name": {
3     "en-US": "North America",
4   },
5  "countries": ["US", "CA"]
6}
Примечание
Код страны указывается в формате ISO 3166-1 alpha-2. Перед созданием региона проверьте список поддерживаемых Xsolla стран.

  1. Передайте ID региона в массив regions в методах API категории Admin группы Игровые ключи во время создания или обновления игры.

Пример массива regions с ID регионов, где можно продавать игровые ключи:

Copy
Full screen
Small screen
1"regions": [
2  {
3     "id": 123
4  },
5  {
6     "id": 456
7  }
8]
Внимание
После создания регионов и добавления их к игре загрузить ключи можно только через метод API Загрузка кодов.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 8 октября 2025

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!
Не получилось отправить ваш комментарий
Попробуйте еще раз позже или напишите нам на doc_feedback@xsolla.com.