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

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

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

Страна пользователя передается в параметре country при запросе каталога с использованием методов API подраздела Catalog из группы Игровые ключи и группы Виртуальные предметы и валюта. Если параметр не передан, страна будет определена на основе 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 Загрузка кодов.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 13 февраля 2026

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

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