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

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

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

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

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

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

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

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

  1. Создайте регионы, в которых будут доступны товары, с помощью метода API Cоздание региона. В ответе вернется 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]
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 17 сентября 2025

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

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