# Shop Builder API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **Contact URL:** https://xsolla.com/ * **Required TLS version:** 1.2 Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart При продаже корзины с играми вы можете [вызвать соответствующий метод без авторизации](/ru/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Для этого: * Добавьте уникальный идентификатор к параметру `x-unauthorized-id` в хедере для игр. * Добавьте адрес электронной почты пользователя в параметр `x-user` (в кодировке Base64) в хедере для игр. По умолчанию для авторизации используется JWT пользователя Авторизации Иксолла (Bearer-токен). Вы можете попробовать вызвать этот метод с помощью тестового токена JWT пользователя Авторизации Иксолла: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. В качестве альтернативы вы можете использовать [Pay Station access token](https://developers.xsolla.com/ru/api/pay-station/operation/create-token/). Type: http Scheme: bearer ### XsollaLoginUserJWT По умолчанию для авторизации используется JWT пользователя Авторизации Иксолла (Bearer-токен). Вы можете попробовать вызвать этот метод с помощью тестового токена JWT пользователя Авторизации Иксолла: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. В качестве альтернативы вы можете использовать [Pay Station access token](https://developers.xsolla.com/ru/api/pay-station/operation/create-token/). Type: http Scheme: bearer Bearer Format: JWT ### basicAuth Xsolla API использует базовую аутентификацию. Все запросы к API должны содержать заголовок `Authorization: Basic `, где `your_authorization_basic_key` — пара `project_id:api_key`, закодированная по стандарту Base64. Вы можете использовать `merchant_id` вместо, `project_id` при необходимости. Это не влияет на функциональность. Значения параметров вы можете найти в [Личном кабинете](https://publisher.xsolla.com/): * `merchant_id` отображается: * В разделе **Настройки компании > Компания** * В URL-адресе в адресной строке браузера на любой странице учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/`. * `api_key` отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах: * **Настройки компании > Ключи API** * **Настройки проекта > Ключи API** * `project_id` отображается: * В Личном кабинете рядом с названием проекта. * В URL-адресе в адресной строке браузера при работе над проектом в учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com//projects/`. Подробная информация о работе с ключами API приведена в [справочнике API](https://developers.xsolla.com/ru/api/getting-started/#api_keys_overview). Type: http Scheme: basic ### basicMerchantAuth Xsolla API использует базовую аутентификацию. Все запросы к API должны содержать заголовок `Authorization: Basic `, где `your_authorization_basic_key` — пара `merchant_id:api_key`, закодированная по стандарту Base64. Значения параметров вы можете найти в [Личном кабинете](https://publisher.xsolla.com/): * `merchant_id` отображается: * В разделе **Настройки компании > Компания** * В URL-адресе в адресной строке браузера на любой странице учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/` * `api_key` отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах: * **Настройки компании > Ключи API** * **Настройки проекта > Ключи API** Подробная информация о работе с ключами API приведена в [справочнике API](https://developers.xsolla.com/ru/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [Shop Builder API](https://developers.xsolla.com/_bundle/@l10n/ru/api/shop-builder/index.yaml) ## Admin ### Получение списка атрибутов (admin) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/admin-get-attribute-list.md): Получает список атрибутов из проекта для администрирования. ### Создание атрибута - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/admin-create-attribute.md): Создает атрибут. ### Удаление атрибута - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/delete-attribute.md): Удаляет атрибут. ВниманиеЕсли вы удалите атрибут товара, все его данные и связи с товарами будут удалены. ### Получение указанного атрибута - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/admin-get-attribute.md): Получает указанный атрибут. ### Обновление атрибута - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/admin-update-attribute.md): Обновляет атрибут. ### Удаление всех значений атрибута - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/admin-delete-all-attribute-value.md): Удаляет все значения атрибута. ВниманиеЕсли вы удалите значение атрибута, связь атрибута с товарами будет потеряна. Чтобы изменить значение атрибута для товара, используйте метод Обновление значения атрибута вместо удаления значения и создания нового. ### Создание значения атрибута - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/admin-create-attribute-value.md): Создает значение атрибута. ВниманиеВсе проекты имеют ограничение на количество значений атрибута. Значение по умолчанию и максимальное значение — 20 значений для каждого атрибута. ### Удаление значения атрибута - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/admin-delete-attribute-value.md): Удаляет значение атрибута. ВниманиеЕсли вы удалите значение атрибута, связь атрибута с товарами будет потеряна. Чтобы изменить значение атрибута для товара, используйте метод Обновление значения атрибута вместо удаления значения и создания нового. ### Обновление значения атрибута - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ru/api/shop-builder/attribute-admin/admin-update-attribute-value.md): Обновляет значения атрибута. ## Персонализированный каталог Данный API позволяет задавать правила для пользовательских атрибутов. Если пользователь соответствует всем условиям для конкретного правила, будут показаны персонализированные товары. Узнать о персонализированных акциях можно в [подразделе "Скидки"](/ru/api/shop-builder/tag/promotions-discounts) раздела "Акции". Чтобы передать атрибуты перед покупкой, вы можете использовать [API Авторизации Иксолла](/ru/api/login/operation/update-users-attributes-from-server/) или передать их в [свойство user.attributes при генерации токена с помощью API Платежей Иксолла](/ru/api/pay-station/operation/create-token). ### Получение списка правил фильтрации каталога - [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ru/api/shop-builder/personalized-catalog/get-filter-rules.md): Получает все правила, применяемые к атрибутам пользователя. ### Создание правила фильтрации каталога - [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ru/api/shop-builder/personalized-catalog/create-filter-rule.md): Создает правило для пользовательских атрибутов. ### Получение всех правил каталога для поиска на стороне клиента - [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/ru/api/shop-builder/personalized-catalog/get-all-filter-rules.md): Получает список всех правил каталога для поиска на стороне клиента. ВниманиеВозвращает только ID правила, имя и is_enabled ### Удаление правила фильтрации каталога - [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ru/api/shop-builder/personalized-catalog/delete-filter-rule-by-id.md): Удаляет определенное правило. ### Получение правила фильтрации каталога - [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ru/api/shop-builder/personalized-catalog/get-filter-rule-by-id.md): Получает конкретное правило, применяемое к атрибутам пользователя. ### Корректировка правила фильтрации каталога - [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ru/api/shop-builder/personalized-catalog/patch-filter-rule-by-id.md): Обновляет определенное правило, применяемое к атрибутам пользователя. Для неуказанных свойств будет использоваться текущее значение. ### Обновление правила фильтрации каталога - [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ru/api/shop-builder/personalized-catalog/update-filter-rule-by-id.md): Обновляет определенное правило, применяемое к атрибутам пользователя. Для неуказанных свойств (при их необязательности) будет использоваться значение по умолчанию. ## Admin ### Получение списка бандлов - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-get-bundle-list.md): Получает список бандлов в рамках проекта для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Создание бандла - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-create-bundle.md): Создает бандл. ### Получение списка бандлов по указанному External ID группы - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Получает список бандлов в рамках группы для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Получение списка бандлов по указанному ID группы - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Получает список бандлов в рамках группы для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Удаление бандла - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-delete-bundle.md): Удаляет бандл. ### Получение бандла - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-get-bundle.md): Получает бандл в рамках проекта для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Обновление бандла - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-update-bundle.md): Обновляет бандл. ### Скрытие бандла в каталоге - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-hide-bundle.md): Скрывает бандл в каталоге. ### Отображение бандла в каталоге - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/ru/api/shop-builder/bundles-admin/admin-show-bundle.md): Показывает бандл в каталоге. ## Catalog ### Получение списка бандлов - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/ru/api/shop-builder/bundles-catalog/get-bundle-list.md): Получает список бандлов для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 элементов на ответ. ПримечаниеИспользование каталога товаров доступно без авторизации,но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение списка бандлов по указанной группе - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/bundles-catalog/get-bundle-list-in-group.md): Получает список бандлов в рамках группы для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 элементов на ответ. ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение указанного бандла - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/ru/api/shop-builder/bundles-catalog/get-bundle.md): Получает указанный бандл. ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ## Корзина (на стороне клиента) ### Получение корзины текущего пользователя - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/get-user-cart.md): Возвращает корзину текущего пользователя. ### Удаление всех товаров из текущей корзины - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/cart-clear.md): Удаляет все товары из корзины. ### Наполнение корзины товарами - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/cart-fill.md): Наполняет корзину товарами. Если в корзине уже есть товар с тем же артикулом, существующий товар будет заменен переданным значением. ### Удаление товара из текущей корзины - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/delete-item.md): Удаляет товар из корзины. ### Обновление товара из текущей корзины - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/put-item.md): Обновляет уже имеющийся в корзине товар или создает его в корзине. ### Получение корзины по ID корзины - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/get-cart-by-id.md): Возвращает корзину пользователя по ID корзины. ### Удаление всех товаров из корзины по ID корзины - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/cart-clear-by-id.md): Удаляет все товары из корзины. ### Наполнение определенной корзины товарами - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/cart-fill-by-id.md): Наполняет определенную корзину товарами. Если в корзине уже есть товар с тем же артикулом, существующая позиция товара будет заменен переданным значением. ### Удаление товара из корзины по ID корзины - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/delete-item-by-cart-id.md): Удаляет товар из корзины. ### Обновление товара в корзине по ID корзины - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/cart-client-side/put-item-by-cart-id.md): Обновляет уже имеющийся в корзине товар или создает его в корзине. ## Корзина (на стороне сервера) ### Наполнение корзины товарами - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/ru/api/shop-builder/cart-server-side/admin-cart-fill.md): Заполняет текущую корзину товарами. Если в корзине уже есть товар с таким же артикулом, существующий товар будет заменен на переданное значение. ### Наполнение корзины по ID корзины товарами - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ru/api/shop-builder/cart-server-side/admin-fill-cart-by-id.md): Заполняет корзину товарами по идентификатору корзины. Если в корзине уже есть товар с таким же артикулом, существующий товар будет заменен на переданное значение. ## Оплата (на стороне клиента) ### Создание заказа со всеми товарами из текущей корзины - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/ru/api/shop-builder/payment-client-side/create-order.md): Используется для интеграции клиент-сервер. Создает заказ со всеми товарами из корзины и генерирует для него токен оплаты. Созданный заказ получает new статус заказа. IP-адрес клиента используется для определения страны пользователя, которая затем используется для применения соответствующей валюты и доступных способов оплаты заказа. Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Внимание Поскольку этот метод использует IP-адрес для определения страны пользователя и валюты для заказа, важно использовать этот метод только на стороне клиента, а не на стороне сервера. Использование этого метода на стороне сервера может привести к неправильному определению валюты и повлиять на способы оплаты в Pay Station. ### Создание заказа со всеми товарами из определенной корзины - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/ru/api/shop-builder/payment-client-side/create-order-by-cart-id.md): Используется для интеграции клиент-сервер. Создает заказ со всеми товарами из конкретной корзины и генерирует для него токен оплаты. Созданный заказ получает статус заказа new. IP-адрес клиента используется для определения страны пользователя, которая затем используется для применения соответствующей валюты и доступных способов оплаты заказа. Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. ПримечаниеПоскольку этот метод использует IP-адрес для определения страны пользователя и выбора валюты для заказа, важно использовать этот метод только на стороне клиента, а не на стороне сервера. Использование этого метода на стороне сервера может привести к неправильному определению валюты и повлиять на способы оплаты в Pay Station. ### Создание заказа с указанным товаром - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/payment-client-side/create-order-with-item.md): Используется для интеграции клиент-сервер. Создает заказ с указанным товаром и генерирует для него токен оплаты. Созданный заказ получает статус заказа new. IP-адрес клиента используется для определения страны пользователя, которая затем используется для применения соответствующей валюты и доступных способов оплаты заказа. Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. ПримечаниеПоскольку этот метод использует IP-адрес для определения страны пользователя и выбора валюты для заказа, важно использовать этот метод только на стороне клиента, а не на стороне сервера. Использование этого метода на стороне сервера может привести к неправильному определению валюты и повлиять на способы оплаты в Pay Station. ### Создание заказа на награду за уровень цепочки предложений - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ru/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): Создает заказ на товар, связанный с указанным уровнем цепочки предложений. Полученный заказ получает статус new. Чтобы открыть платежный интерфейс в новом окне, используйте ссылку: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Внимание Используйте этот метод только на стороне клиента. Метод определяет страну пользователя по IP-адресу, чтобы применить соответствующую валюту и доступные способы оплаты. Вызов с сервера может привести к некорректному определению валюты и повлиять на способы оплаты в Pay Station. Внимание Используйте только для получения наград на платных уровнях цепочки предложений. Для платных используйте метод Получение награды за уровень цепочки предложений. ### Создание заказа на награду за уровень цепочки предложений - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): Создает заказ на товар, связанный с указанным уровнем цепочки предложений. Полученный заказ получает статус new. Чтобы открыть платежный интерфейс в новом окне, используйте ссылку: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Внимание Используйте этот метод только на стороне клиента. Метод определяет страну пользователя по IP-адресу, чтобы применить соответствующую валюту и доступные способы оплаты. Вызов с сервера может привести к некорректному определению валюты и повлиять на способы оплаты в Pay Station. Внимание Используйте только для получения наград на платных уровнях цепочки предложений. Для платных используйте метод Получение награды за уровень цепочки предложений. ## Клиент ### Создание заказа на награду за уровень цепочки предложений - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ru/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): Создает заказ на товар, связанный с указанным уровнем цепочки предложений. Полученный заказ получает статус new. Чтобы открыть платежный интерфейс в новом окне, используйте ссылку: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Внимание Используйте этот метод только на стороне клиента. Метод определяет страну пользователя по IP-адресу, чтобы применить соответствующую валюту и доступные способы оплаты. Вызов с сервера может привести к некорректному определению валюты и повлиять на способы оплаты в Pay Station. Внимание Используйте только для получения наград на платных уровнях цепочки предложений. Для платных используйте метод Получение награды за уровень цепочки предложений. ### Получение цепочек предложений для текущего пользователя - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-client/get-offer-chains-list.md): Возвращает цепочки предложений для текущего пользователя. Внимание Все проекты имеют ограничение на количество элементов, возвращаемых в одном ответе. Максимальное значение — 30 элементов на запрос. Чтобы получить больше данных, используйте параметры limit и offset для пагинации. ### Получение цепочки предложений по ее ID для текущего пользователя - [GET /v2/project/{project_id}/user/offer_chain/{offer_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-client/get-user-offer-chain-by-id.md): Возвращает цепочку предложений по ее ID для текущего пользователя. ### Получение награды за уровень цепочки предложений - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-client/claim-user-offer-chain-step-reward.md): Завершает прохождение текущим пользователем уровня цепочки предложений и выдает связанную с ним награду. Внимание Используйте этот метод только для бесплатных уровней. Для уровней, доступных за реальную валюту, используйте метод Создание заказа на награду за уровень цепочки предложений. ### Создание заказа на награду за уровень цепочки предложений - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): Создает заказ на товар, связанный с указанным уровнем цепочки предложений. Полученный заказ получает статус new. Чтобы открыть платежный интерфейс в новом окне, используйте ссылку: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Внимание Используйте этот метод только на стороне клиента. Метод определяет страну пользователя по IP-адресу, чтобы применить соответствующую валюту и доступные способы оплаты. Вызов с сервера может привести к некорректному определению валюты и повлиять на способы оплаты в Pay Station. Внимание Используйте только для получения наград на платных уровнях цепочки предложений. Для платных используйте метод Получение награды за уровень цепочки предложений. ## Оплата (на стороне сервера) ### Создание платежного токена для покупки - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/ru/api/shop-builder/payment-server-side/admin-create-payment-token.md): Генерирует заказ и платежный токен для него. Заказ генерируется на основе товаров, переданных в теле запроса. Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Внимание Параметр user.country.value используется для выбора валюты для заказа. Если страна пользователя неизвестна, альтернативным вариантом является указание IP-адреса пользователя в X-User-Ip заголовке. Для корректной работы метода требуется один из этих двух вариантов. Выбранная валюта используется для оплаты в Pay Station. ## Заказ ### Получение заказа - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/ru/api/shop-builder/order/get-order.md): Получает указанный заказ. ### Получение списка заказов за указанный период - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/ru/api/shop-builder/order/admin-order-search.md): Возвращает список заказов, упорядоченный по дате создания — от самой ранней до самой поздней. ## Бесплатные товары ### Создание заказа с помощью бесплатной корзины - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/ru/api/shop-builder/free-item/create-free-order.md): Создает заказ со всеми товарами из бесплатной корзины. Созданному заказу будет присвоен статус заказа done. ### Создание заказа с помощью определенной бесплатной корзины - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/ru/api/shop-builder/free-item/create-free-order-by-cart-id.md): Создает заказ со всеми товарами из определенной бесплатной корзины. Созданному заказу будет присвоен статус заказа done. ### Создание заказа с указанным бесплатным товаром - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/free-item/create-free-order-with-item.md): Создает заказ с указанным бесплатным товаром. Созданному заказу будет присвоен статус заказа done. ## Вебхуки ### Получение информации о настройках вебхуков - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ru/api/shop-builder/common-webhooks/get-webhook.md): Получает информацию о настройках вебхуков в Store. Подробная информация о настройке вебхуков приведена в документации. ### Обновление информации о настройках вебхуков - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ru/api/shop-builder/common-webhooks/update-webhook.md): Обновляет информацию о настройках вебхуков в Store. Подробная информация о настройке вебхуков приведена в документации. ## Предзаказы ### Уменьшение лимита предзаказа товара - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/common-pre-orders/remove-pre-order-limit.md): Удаляет ограничение на количество предзаказа товара. Pre-Order limit API позволяет продавать товар в ограниченном количестве. Для настройки самого предзаказа перейдите в раздел Admin желаемого товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы Алиасы для данного эндпоинта: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Получение информации о лимите предзаказа товара - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/common-pre-orders/get-pre-order-limit.md): Возвращает ограничение на предзаказ товара. Pre-Order limit API позволяет вам продавать товар в ограниченном количестве. Для настройки самого предварительного заказа перейдите в раздел администратора модуля нужного товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы Aliases для этой конечной точки: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Увеличение лимита предзаказа товара - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/common-pre-orders/add-pre-order-limit.md): Добавляет количество к ограничению на предзаказ товара. Pre-Order limit API позволяет вам продавать товар в ограниченном количестве. Для настройки самого предварительного заказа перейдите в раздел администратора модуля нужного товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы Aliases для этой конечной точки: */v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Установка/обновление лимита предзаказа товара - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/common-pre-orders/set-pre-order-limit.md): Устанавливает ограничение на количество товара для предварительного заказа. Pre-Order limit API позволяет вам продавать товар в ограниченном количестве. Для настройки самого предварительного заказа перейдите в раздел администратора модуля нужного товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы Aliases для этой конечной точки: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Обнуление лимита предзаказа товара - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ru/api/shop-builder/common-pre-orders/remove-all-pre-order-limit.md): Удаляет все ограничения по количеству товара, предусмотренные для предварительного заказа. Pre-Order limit API позволяет вам продавать товар в ограниченном количестве. Для настройки самого предварительного заказа перейдите в раздел администратора модуля нужного товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы Aliases для этой конечной точки: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all ### Включение/отключение лимита предзаказа товара - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/ru/api/shop-builder/common-pre-orders/toggle-pre-order-limit.md): Включает/отключает лимит предзаказа товара. API лимитов для предзаказов позволяет продавать товар в ограниченном количестве. Для настройки самого предзаказа перейдите в раздел Admin желаемого товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы Алиасы для данного метода: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle ## Продавец ### Получение проектов - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/ru/api/shop-builder/common-merchant/get-projects.md): Получает список проектов мерчанта. Внимание Этот метод API не включает в себя path-параметр project_id, поэтому для авторизации вам необходимо использовать ключ API, который действует во всех проектах. ## Catalog Данный API позволяет получать продаваемые товары любого вида или конкретный товар. ### Получение списка продаваемых товаров - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/ru/api/shop-builder/common-catalog/get-sellable-items.md): Получает список продаваемых товаров для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ.Чтобы получить больше данных постранично, используйте поля limit и offset. ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение списка продаваемых товаров по указанной группе - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/common-catalog/get-sellable-items-group.md): Получает список продаваемых товаров из указанной группы для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров. Чтобы получить больше данных постранично, используйте поля limit и offset. ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение продаваемого товара по ID - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/ru/api/shop-builder/common-catalog/get-sellable-item-by-id.md): Получает продаваемый товар по его ID. ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ### Получение продаваемого товара по артикулу - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/ru/api/shop-builder/common-catalog/get-sellable-item-by-sku.md): Получает продаваемый товар по артикулу для построения каталога. ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ## Общие регионы ### Получение списка регионов - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ru/api/shop-builder/common-regions/admin-get-regions.md): Получает список регионов. Вы можете использовать регион для управления вашими региональными ограничениями. ### Создание региона - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ru/api/shop-builder/common-regions/admin-create-region.md): Создает регион. Вы можете использовать регион для управления вашими региональными ограничениями. ### Удаление региона - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ru/api/shop-builder/common-regions/admin-delete-region.md): Удаляет определенный регион. ### Получение региона - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ru/api/shop-builder/common-regions/admin-get-region.md): Получает определенный регион. Вы можете использовать регион для управления вашими региональными ограничениями. ### Обновление региона - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ru/api/shop-builder/common-regions/admin-update-region.md): Обновляет определенный регион. Вы можете использовать регион для управления вашими региональными ограничениями. ## Catalog ### Получение списка игр - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/ru/api/shop-builder/game-keys-catalog/get-games-list.md): Получает список игр для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset. ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение списка платформ - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/ru/api/shop-builder/game-keys-catalog/get-drm-list.md): Получает список доступных платформ. ### Получение списка игр по указанной группе - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-catalog/get-games-group.md): Получает список игр из указанной группы для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров в ответе. Чтобы получить больше данных постранично, используйте поля limit и offset. ПримечаниеИспользование каталога товаров доступно без авторизации,но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение списка игровых ключей по указанной группе - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-catalog/get-game-keys-group.md): Получает список игровых ключей из указанной группы для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров в ответе. Чтобы получить больше данных постранично, используйте поля limit и offset. ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение игрового ключа для каталога - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-catalog/get-game-key-by-sku.md): Получает иговой ключ для каталога. ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ### Получение игры для каталога - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-catalog/get-game-by-sku.md): Получает игру для каталога. ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ## Владение играми ### Предоставление права владения (admin) - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/ru/api/shop-builder/game-keys-entitlement/grant-entitlement-admin.md): Дает пользователю право владения. ВниманиеМогут быть предоставлены только игровые ключи или игры для DRM-free-платформ. ### Отзыв права владения (admin) - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/ru/api/shop-builder/game-keys-entitlement/revoke-entitlement-admin.md): Отзывает право владения у пользователя. ВниманиеМогут быть отозваны только игровые ключи или игры для DRM-free-платформ. ### Получение списка игр, принадлежащих пользователю - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/ru/api/shop-builder/game-keys-entitlement/get-user-games.md): Получает список игр, принадлежащих пользователю. Ответ будет содержать массив игр, принадлежащих определенному пользователю. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ.Чтобы получить больше данных постранично, используйте поля limit и offset. ### Активация игрового ключа на стороне клиента - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/ru/api/shop-builder/game-keys-entitlement/redeem-game-pin-code.md): Дает право владения по предоставленному игровому коду. ВниманиеМогут быть погашены только игровые коды для DRM-free-платформ. ## Admin ### Получение списка игр (admin) - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-get-game-list.md): Получает список игр в рамках проекта для администрирования. Игра состоит из игровых ключей, которые могут быть приобретены пользователем. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Создание игры - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-create-game.md): Создает игру в проекте. ### Удаление игры по ID - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-delete-game-by-id.md): Удаляет игру в проекте по ID. ### Получение игры по ID (admin) - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-get-game-by-id.md): Получает игру для администрирования. Игра состоит из игровых ключей, которые могут быть приобретены пользователем. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Обновление игры по ID - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-update-game-by-id.md): Обновляет игру в проекте по ID. ### Удаление кодов по ID - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-delete-codes-by-id.md): Удаляет все коды по ID игрового ключа. ### Удаление кодов - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-delete-codes-by-sku.md): Удаляет все коды по артикулу игрового ключа. ### Получение кодов по ID - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-get-codes-by-id.md): Получает определенное количество кодов по ID игрового ключа. ### Получение кодов - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-get-codes-by-sku.md): Получает определенное количество кодов по артикулу игрового ключа. ### Загрузка кодов по ID - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-upload-codes-by-id.md): Загружает коды по ID игрового ключа. ### Получение информации о сеансе загрузки кодов - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-get-codes-session.md): Получает информацию о сеансе загрузки кодов. ### Загрузка кодов - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-upload-codes-by-sku.md): Загружает коды по артикулу игрового ключа. ### Удаление игры по артикулу - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-delete-game-by-sku.md): Удаляет игру в проекте по артикулу. ### Получение игры (admin) - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-get-game-by-sku.md): Получает игру для администрирования. Игра состоит из игровых ключей, которые могут быть приобретены пользователем. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Обновление игры по артикулу - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/game-keys-admin/admin-update-game-by-sku.md): Обновляет игру в проекте по артикулу. ## Общие ### Активация акции - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/ru/api/shop-builder/promotions-common/activate-promotion.md): Активирует акцию. ### Деактивация акции - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/ru/api/shop-builder/promotions-common/deactivate-promotion.md): Деактивирует акцию. ### Подтвердите промокод - [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/ru/api/shop-builder/promotions-common/verify-promotion-code.md): Определяет, является ли код промокодом или купоном и может ли пользователь его применить. ### Получение списка всех акций - [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/ru/api/shop-builder/promotions-common/get-promotion-list.md): Получает список акций проекта. ### Информация об акции с кодом - [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/ru/api/shop-builder/promotions-common/get-redeemable-promotion-by-code.md): Получение акции по промокоду или коду купона. ## Купоны Этот API позволяет вам управлять купонами. ### Получение ограничений для уникальных кодов купонов - [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/get-coupon-code-limit.md): Возвращает оставшееся количество применений кодов. Для фильтрации кодов используйте параметр запроса codes. Для настройки самого ограничения кода перейдите в раздел администратора: * Купоны ### Активация акции с купонами - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/activate-coupon.md): Активирует акцию с купонами. После создания акция с купонами по умолчанию отключена. Погашение по акции не будет доступно, пока вы ее не активируете. Используйте данный метод, чтобы включить и активировать акцию с купонами. ### Получение кодов купонов - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/get-coupon-codes.md): Получает коды купонов. ### Создание кода купона - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/create-coupon-code.md): Создает код купона. ### Генерация кодов купонов - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/generate-coupon-codes.md): Генерирует коды купонов. ### Деактивация акции с купонами - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/deactivate-coupon.md): Деактивирует акцию с купонами. После создания акция с купонами по умолчанию отключена. Погашение по акции не будет доступно, пока вы ее не активируете. Используйте данный метод, чтобы выключить и деактивировать акцию с купонами. ### Информация об ограничении на применение купонов для указанного пользователя - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/get-coupon-user-limit.md): Получает информацию об оставшемся количестве применений купона для указанного пользователя. API ограничений для пользователей позволяет ограничить доступное количество применений купона. Для настройки самого ограничения перейдите в раздел администратора: * Купоны ### Получение вознаграждений по купону - [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/get-coupon-rewards-by-code.md): Получает вознаграждения по купону по его коду. Может использоваться, чтобы дать пользователям возможность выбрать один предмет из множества в качестве бонуса. Обычным случаем, если купон содержит игру в качестве бонуса (тип unit), является выбор платформы. ### Погашение кода купона - [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/redeem-coupon.md): Погашает код купона. Пользователь получает бонус после погашения купона. ### Получение списка акций с купонами - [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/get-coupons.md): Получает список акций с купонами в рамках проекта. ### Создание акции с купонами - [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/admin-create-coupon.md): Создает акцию с купонами. ### Удаление акции с купонами - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/delete-coupon-promotion.md): Удаляет акцию с купонами. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров. Пользователь не сможет получить бонусные товары по этой акции. После удаления акция не может быть восстановлена. Коды купонов из удаленной акции могут быть добавлены в существующие акции. ### Получение акции с купонами - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/get-coupon.md): Получает указанную акцию с купонами. ### Обновление акции с купонами - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-coupons/update-coupon-promotion.md): Обновляет акцию с купонами. ## Промокоды Этот API позволяет вам управлять промокодами. ### Информация об ограничении на применение промокодов - [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/get-promo-code-code-limit.md): Возвращает оставшееся количество применений кодов. Для фильтрации кодов используйте codesпараметр запроса. Для настройки самого ограничения перейдите в раздел администратора: * Промокоды ### Активация акции с промокодами - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/activate-promo-code.md): Активирует акцию с промокодами. После создания акция с промокодами по умолчанию отключена. Погашение по акции не будет доступно, пока вы ее не активируете. Используйте данный метод, чтобы включить и активировать акцию с промокодами. ### Получение кодов акции с промокодами - [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/get-promocode-codes.md): Получает коды акции с промокодами. ### Создание кода для акции с промокодами - [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/create-promo-code-code.md): Создает код для акции с промокодами. ### Генерация кодов для акции с промокодами - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/generate-promo-code-codes.md): Генерирует коды для акции с промокодами. ### Деактивация акции с промокодами - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/deactivate-promo-code.md): Деактивирует акцию с промокодами. После создания акция с промокодами по умолчанию отключена. Погашение по акции не будет доступно, пока вы ее не активируете. Используйте данный метод, чтобы выключить и деактивировать акцию с промокодами. ### Информация об ограничении на применение промокодов для указанного пользователя - [GET /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/get-promo-code-user-limit.md): Получает информацию об оставшемся количестве применений промокода для указанного пользователя. API ограничений для пользователей позволяет ограничить доступное количество применений промокода. Для настройки самого ограничения перейдите в раздел администратора: * Промокоды ### Получение вознаграждения по промокоду - [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/get-promo-code-rewards-by-code.md): Получает вознаграждения по промокоду по его коду. Может использоваться, чтобы дать пользователям возможность выбрать один предмет из множества в качестве бонуса. Обычным случаем, если промокод содержит игру в качестве бонуса (тип unit), является выбор платформы. ### Погашение промокода - [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/redeem-promo-code.md): Использует код акции с промокодами. После погашения промокода пользователь получит бесплатные товары и/или цена корзины и/или отдельных товаров будет снижена. ### Удаление промокода из корзины - [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/remove-cart-promo-code.md): Удаляет промокод из корзины. После удаления промокода общая цена всех товаров в корзине будет пересчитана без учета бонусов и скидок, предоставляемых промокодом. ### Получение списка акций с промокодами - [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/get-promo-codes.md): Получает список промокодов проекта. ### Создание акции с промокодами - [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/create-promo-code.md): Создает акцию с промокодами. ### Удаление акции с промокодами - [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/delete-promo-code.md): Удаляет акцию с промокодами. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет получить бонусные товары или купить товары с применением этой акции. После удаления акция не может быть восстановлена. Промокоды из удаленной акции могут быть добавлены в существующие акции. ### Получение акции с промокодами - [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/get-promo-code.md): Получает указанную акцию с промокодами. ### Обновление акции с промокодами - [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-promo-codes/update-promo-code.md): Обновляет акцию с промокодами. ## Уникальный каталог предложений Этот API позволяет вам управлять уникальными предложениями каталога. ### Активация уникального акционного предложения по каталогу - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/activate-unique-catalog-offer.md): Активирует уникальное акционное предложение по каталогу. Созданное уникальное акционное предложение каталога по умолчанию отключено. Оно не может быть погашено до тех пор, пока вы его не активируете. Используйте этот эндпоинт для включения и активации акции с купонами. ### Получение уникальных кодов предложений по каталогу - [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): Получает уникальные коды предложений по каталогу. ### Создание уникального кода предложения по каталогу - [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): Создает уникальный код предложения по каталогу. ### Генерация уникальных кодов предложений по каталогу - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): Генерирует уникальные коды предложений по каталогу. ### Отключите уникальное акционное предложение по каталогу - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): Отключает уникальное акционное предложение по каталогу. Созданное уникальное акционное предложение по умолчанию отключено. Оно не может быть погашено, пока вы его не активируете. Используйте этот эндпоинт для отключения и деактивации акции с купонами. ### Получение списка уникальных акционных предложений каталога - [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offers.md): Получает список уникальных акционных предложений каталога проекта. ### Создание уникального акционного предложения по каталогу - [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): Создает уникальное акционное предложение по каталогу. ### Удаление уникального акционного предложения каталога - [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/delete-unique-catalog-offer-promotion.md): Удаляет уникальное акционное предложение каталога. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет купить товары с применением этой акции. После удаления акция не может быть восстановлена. ### Получение уникального акционного предложения по каталогу - [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer.md): Получает указанное уникальное акционное предложение по каталогу. ### Обновление уникального акционного предложения каталога - [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): Обновляет уникальное акционное предложение каталога. ## Скидки Этот API позволяет вам управлять скидочными акциями. ### Получение списка акций со скидками - [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ru/api/shop-builder/promotions-discounts/get-item-promotion-list.md): Получает список акций со скидками в рамках проекта. Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары. ### Создание акции со скидками для товара - [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ru/api/shop-builder/promotions-discounts/create-item-promotion.md): Создает акцию со скидками для товара. Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары. ### Удаление скидочной акции - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ru/api/shop-builder/promotions-discounts/delete-item-promotion.md): Удаляет скидочную акцию. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет купить товары с применением этой акции. После удаления акция не может быть восстановлена. ### Получение акции со скидками - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ru/api/shop-builder/promotions-discounts/get-item-promotion.md): Получает акцию, применяемую к определенным товарам. Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары. ### Обновление акции со скидками - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ru/api/shop-builder/promotions-discounts/update-item-promotion.md): Обновляет акцию. ПримечаниеНовые данные заменят старые. Если вы хотите обновить только часть акции, вам также следует передать в запросе все необходимые данные. Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары. ## Бонусы Этот API позволяет вам управлять бонусными акциями. ### Получение списка акций с бонусами - [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ru/api/shop-builder/promotions-bonuses/get-bonus-promotion-list.md): Получает список акций с бонусами в рамках проекта. Акция добавляет бесплатные бонусные товары к покупке, совершенной пользователем. Акция может быть применена к каждой покупке в рамках проекта или к покупке, включающей определенные товары. ### Создание акции с бонусами - [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ru/api/shop-builder/promotions-bonuses/create-bonus-promotion.md): Создает акцию с бонусами. Акция добавляет бесплатные бонусные товары к покупке, совершенной пользователем. Акция может быть применена к каждой покупке в рамках проекта или к покупке, включающей определенные товары. ### Удаление бонусной акции - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ru/api/shop-builder/promotions-bonuses/delete-bonus-promotion.md): Удаляет бонусную акцию. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет получить бонусные товары по этой акции. После удаления акция не может быть восстановлена. ### Получение акции с бонусами - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ru/api/shop-builder/promotions-bonuses/get-bonus-promotion.md): Получает акцию с бонусами. Акция добавляет бесплатные бонусные товары к покупке, совершенной пользователем. Акция может быть применена к каждой покупке в рамках проекта или к покупке, включающей определенные товары. ### Обновление акции с бонусами - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ru/api/shop-builder/promotions-bonuses/update-bonus-promotion.md): Обновляет акцию. ПримечаниеНовые данные заменят старые. Если вы хотите обновить только часть акции, вам также следует передать в запросе все необходимые данные. Акция добавляет бесплатные бонусные товары к покупке, совершенной пользователем. Акция может быть применена к каждой покупке в рамках проекта или к покупке, включающей определенные товары. ## Admin ### Получение списка виртуальных валют - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Получает список виртуальных валют в рамках проекта для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Создание виртуальной валюты - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency.md): Создает виртуальную валюту. ### Получение списка пакетов виртуальной валюты (admin) - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Получает список пакетов виртуальной валюты в рамках проекта для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Создание пакета виртуальной валюты - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Создает пакет виртуальной валюты. ### Удаление пакета виртуальной валюты - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Удаляет пакет виртуальной валюты. ### Получение пакета виртуальной валюты - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Получает пакет виртуальной валюты в рамках проекта для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Обновление пакета виртуальной валюты - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Обновляет пакет виртуальной валюты. ### Удаление виртуальной валюты - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency.md): Удаляет виртуальную валюту. ### Получение виртуальной валюты - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency.md): Получает виртуальную валюту в рамках проекта для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Обновление виртуальной валюты - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency.md): Обновляет виртуальную валюту. ### Получение списка виртуальных предметов - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list.md): Получает список виртуальных предметов в рамках проекта для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Создание виртуального предмета - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-item.md): Создает виртуальный предмет. ### Получение списка виртуальных предметов по указанному External ID группы - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Получает список виртуальных предметов в рамках группы для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Получение списка виртуальных предметов по указанному ID группы - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Получает список виртуальных предметов в рамках группы для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Удаление виртуального предмета - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-item.md): Удаляет виртуальный предмет. ### Получение виртуального предмета - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-item.md): Получает виртуальный предмет в рамках проекта для администрирования. ПримечаниеНе используйте данный метод для построения каталога магазина. ### Обновление виртуального предмета - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-item.md): Обновляет виртуальный предмет. ## Catalog ### Получение списка групп товаров - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-item-groups.md): Получает список групп товаров для создания каталога. ### Получение списка виртуальных валют - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency.md): Получает список виртуальных валют для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset. ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение списка пакетов виртуальной валюты - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package.md): Получает список пакетов виртуальной валюты для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset. ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение пакета виртуальной валюты по артикулу - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Получает пакет виртуальной валюты по артикулу для построения каталога. ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ### Получение виртуальной валюты по артукулу - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-sku.md): Получает виртуальную валюту по артикулу для построения каталога. ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ### Получение списка виртуальных предметов - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-virtual-items.md): Получает список виртуальных предметов для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset. ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization. ### Получение списка всех виртуальных предметов - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-all-virtual-items.md): Gets a list of all virtual items for searching on client-side. AttentionReturns only item SKU, name, groups and description NoteThe use of the item catalog API calls is available without authorization, but to get a personalized catalog, you must pass the user JWT in the Authorization header. ### Получение списка товаров по указанной группе - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-group.md): Получает список товаров из указанной группы для построения каталога. ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset.ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ### Получение виртуального предмета по артикулу - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-sku.md): Получает виртуальный предмет по артикулу для построения каталога. ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции. ## Виртуальная оплата ### Создание заказа с указанным товаром, приобретенным за виртуальную валюту - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/shop-builder/virtual-payment/create-order-with-item-for-virtual-currency.md): Создает покупку товара с использованием виртуальной валюты. ## Управление ### Обновление всех лимитов на покупку для пользователя - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/reset-all-user-items-limit.md): Обновляет все лимиты на покупку для всех товаров для указанного пользователя, чтобы он мог приобрести эти товары снова. API лимитов на покупку позволяет вам продавать товар в ограниченном количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin нужного типа товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы ### Уменьшение лимита доступных пользователю товаров - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/remove-user-item-limit.md): Уменьшает оставшееся количество товаров, доступных указанному пользователю в пределах установленного лимита. API лимитов на покупку позволяет вам продавать товар в ограниченном количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin нужного типа товара: * Игровые ключи *Виртуальные предметы и валюта * Бандлы ### Получение лимита доступных пользователю товаров - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/get-user-item-limit.md): Возвращает оставшееся количество товаров, доступных указанному пользователю, в пределах установленного ограничения. User limit API позволяет вам продавать товар в ограниченном количестве. Чтобы настроить ограничения на покупку, перейдите в раздел Admin нужного типа товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы ### Увеличение лимита доступных пользователю товаров - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/add-user-item-limit.md): Увеличивает оставшееся количество товаров, доступных указанному пользователю, в пределах установленного ограничения. User limit API позволяет продавать товар в ограниченном количестве. Чтобы настроить ограничения на покупку, перейдите в раздел Admin нужного типа товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы ### Настройка лимита доступных пользователю товаров - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/set-user-item-limit.md): Устанавливает количество товаров, которые указанный пользователь может купить в пределах ограничения, примененного после его увеличения или уменьшения. User limit API позволяет продавать товар в ограниченном количестве. Чтобы настроить ограничения покупку, перейдите в раздел Admin нужного типа товара: * Игровые ключи * Виртуальные предметы и валюта * Бандлы ### Обновление лимита на покупку - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/reset-user-item-limit.md): Обновляет лимит на покупку товара, чтобы пользователь мог купить его снова. Если параметр user равен null, этот метод обновляет лимит для всех пользователей. API лимитов на покупку позволяет вам продавать товар в ограниченном количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin нужного типа товара: * Игровые ключи *Виртуальные предметы и валюта * Бандлы ### Обновление лимитов акций для пользователя - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/reset-all-user-promotions-limit.md): Обновляет все лимиты по всем акциям для указанного пользователя, чтобы он мог снова использовать эти акции. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Уменьшение лимита акций для пользователя - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/remove-user-promotion-limit.md): Уменьшает оставшееся количество раз, когда указанный пользователь может воспользоваться рекламной акцией в пределах установленного лимита. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Получение лимита акций для пользователя - [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/get-user-promotion-limit.md): Возвращает оставшееся количество раз, когда указанный пользователь может воспользоваться акцией в пределах установленного лимита. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Увеличение лимита акций для пользователя - [POST /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/add-user-promotion-limit.md): Увеличивает оставшееся количество раз, когда указанный пользователь может воспользоваться акцией в пределах установленного лимита. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Настройка лимита акций для пользователя - [PUT /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/set-user-promotion-limit.md): Задает количество раз, когда указанный пользователь может воспользоваться рекламной акцией в пределах лимита, примененного после его увеличения или уменьшения. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Обновление лимита акций для пользователей - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/ru/api/shop-builder/user-limits-admin/reset-user-promotion-limit.md): Обновляет лимит акции, чтобы пользователь мог снова воспользоваться этой акцией. Если параметр user равен null, этот вызов обновляет это ограничение для всех пользователей. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ## Admin ### Получение списка призовых баллов - [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-get-value-points-list.md): Получает список призовых баллов для проекта администрирования. ### Создание призовых баллов - [POST /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-create-value-points.md): Создает призовые баллы, которые выдаются за покупку товаров в каталоге. ### Удаление призовых баллов - [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-delete-value-point.md): Удаляет призовые баллы, идентифицированные по артикулу товара. ### Получение призовых баллов - [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-get-value-point.md): Получает призовые баллы по артикулу для проекта администрирования. ### Обновление призовых баллов - [PUT /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-update-value-point.md): Обновляет призовые баллы, идентифицированные по артикулу. ### Удаление призовых баллов с товаров - [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): Удаляет призовые баллы со ВСЕХ товаров. ### Получение списка товаров с призовыми баллами - [GET /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-get-items-value-point-reward.md): Получает список всех товаров с призовыми баллами для проекта администрирования. ### Частичное обновление призовых баллов для товаров - [PATCH /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-patch-items-value-point-reward.md): Частично обновляет количество призовых баллов для одного или нескольких товаров по артикулам этих товаров. Пользователи получают призовые баллы после покупки этих товаров. Принципы обновления призовых баллов: * Если у товара еще нет призовых баллов, отправка ненулевого значения в поле amount создаст их. * Если у товара уже есть призовые баллы, отправка ненулевого значения в поле amount обновит их. * Если в поле amount передано значение 0, существующие призовые баллы для этого товара будут удалены. В отличие от метода PUT (Настройка призовых баллов для товаров), этот метод PATCH не перезаписывает все ранее установленные призовые баллы для товаров в проекте, а обновляет только указанные. В одном запросе можно обновить до 100 товаров. В одном запросе нельзя передавать одинаковые артикулы товаров. ### Настройка призовых баллов для товаров - [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-set-items-value-point-reward.md): Присваивает призовые баллы одному или нескольким товарам по артикулу. Пользователи получают призовые баллы после покупки этих товаров. Обратите внимание, что этот запрос PUT перезаписывает все ранее установленные призовые баллы для товаров в проекте. Чтобы избежать непреднамеренного удаления призовых баллов, включайте все товары и соответствующие им значения в каждый запрос PUT. Если вы хотите обновить призовые баллы только для определенного товара, сохранив значения призовых баллов для других товаров, вам следует получить текущий набор призовых баллов с помощью запроса GET, изменить значения призовых баллов для желаемого товара, а затем отправить измененный набор призовых баллов обратно с обновленными значениями призовых баллов для конкретного товара. ### Получение списка цепочек наград - [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chains.md): Получает список цепочек наград. Внимание! Все проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 10 товаров в ответе.Чтобы получить больше данных постранично, используйте поля limit и offset. ### Создание цепочек наград - [POST /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-create-reward-chain.md): Создает цепочку наград. ### Удаление цепочек наград - [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-delete-reward-chain.md): Удаляет определенную цепочку наград. ### Получение цепочек наград - [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chain.md): Получает определенную цепочку наград. ### Обновление цепочек наград - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-update-reward-chain.md): Обновляет определенную цепочку наград. ### Сброс цепочки наград - [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-reset-reward-chain.md): Сбрасывает призовые баллы и прогресс всех пользователей в цепочке наград.После сброса вы можете обновить срок действия цепочки наград и пользователи смогут снова продвигаться по ней. Внимание Не следует сбрасывать цепочку наград в период ее действия. В этом случае пользователи могут потерять заработанные очки до получения награды. ### Переключение цепочки наград - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-value-points-admin/admin-toggle-reward-chain.md): Включение/отключение цепочки наград. ## Клиент ### Получение цепочки наград текущего пользователя - [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-client/get-reward-chains-list.md): Метод клиента. Получает цепочки наград текущего пользователя. Внимание! Все проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров в ответе. Чтобы получить больше данных постранично, используйте поля limit и offset. ### Получение призовых баллов текущего пользователя - [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-client/get-user-reward-chain-balance.md): Метод клиента. Возвращает призовые баллы текущего пользователя. ### Получение награды на уровне - [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/ru/api/shop-builder/reward-chain-client/claim-user-reward-chain-step-reward.md): Метод клиента. Запрашивает награду на уровне для текущего пользователя в цепочке наград. ## Клиент кланов ### Получение 10 участников, внесших наибольший вклад в продвижение по клановой цепочке наград - [GET /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top](https://developers.xsolla.com/ru/api/shop-builder/clan-reward-chain-client/get-user-clan-top-contributors.md): Возвращает 10 участников, внесших наибольший вклад в определенную цепочку наград для текущего клана пользователя. Если пользователь не состоит в клане, в ответе вернется пустой массив. ### Обновление клана текущего пользователя - [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/ru/api/shop-builder/clan-reward-chain-client/user-clan-update.md): Обновляет текущий клан пользователя через атрибуты пользователя. Выдает пользователю награды, которые он не забрал из цепочки наград старого клана, и возвращает их в ответе. Если пользователь состоял в клане, а теперь нет — принадлежность к клану будет удалена. Если пользователь сменил клан, принадлежность к клану изменится и будет указан новый клан. ## Admin ### Получение списка цепочек предложений - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-admin/admin-get-offer-chains.md): Возвращает список цепочек предложений для администрирования. Внимание Все проекты имеют ограничение на количество элементов, возвращаемых в одном ответе. Максимальное значение — 10 элементов в ответе. Чтобы получить больше данных, используйте query-параметры limit и offset для пагинации. ### Создание цепочки предложений - [POST /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-admin/admin-create-offer-chain.md): Создает цепочку предложений. ### Удаление цепочки предложений - [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-admin/admin-delete-offer-chain.md): Удаляет конкретную цепочку предложений. После удаления цепочки:Все уже полученные пользователями награды сохраняются.Непройденные уровни становятся недоступны, и получить награды за них больше нельзя. Удаление цепочки необратимо и не сохраняет прогресс пользователя, в отличие от временного отключения цепочки с помощью метода Переключение цепочки предложений. ### Получение цепочки предложений - [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-admin/admin-get-offer-chain.md): Возвращает конкретную цепочку предложений для администрирования. ### Обновление цепочки предложений - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-admin/admin-update-offer-chain.md): Обновляет конкретную цепочку предложений. ### Переключение цепочки предложений - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/ru/api/shop-builder/offer-chain-admin/admin-toggle-offer-chain.md): Включает или отключает цепочку предложений. При отключении цепочки пользователи теряют доступ к ней, но их прогресс сохраняется. После повторного включения цепочки пользователь может продолжить прохождение с того уровня, на котором остановился. ## Admin ### Получение списка ежедневных наград - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-admin/admin-get-daily-chains.md): Получает список ежедневных наград для администрирования. ПримечаниеМетод возвращает список элементов с учетом пагинации. Максимальное количество элементов в ответе — 50 (установлено по умолчанию). Чтобы получить доступ к следующим элементам списка, используйте параметры limit и offset. Например, при вызове метода с параметрами limit = 25 и offset = 100 вернется 25 элементов, начиная со 101-го в общем списке. ### Создание ежедневной награды - [POST /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-admin/admin-create-daily-chain.md): Создает ежедневную награду. ### Удаление ежедневной награды - [DELETE /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-admin/admin-delete-daily-chain.md): Удаляет определенную ежедневную награду. ### Получение ежедневной награды - [GET /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-admin/admin-get-daily-chain.md): Возвращает определенную ежедневную награду для администрирования. ### Обновление ежедневной награды - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-admin/admin-update-daily-chain.md): Обновляет определенную ежедневную награду. ### Сброс ежедневной награды - [POST /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-admin/admin-reset-daily-chain.md): Сбрасывает прогресс для всех пользователей в ежедневной награде. Применяется только к ежедневным наградам с типом rolling. ### Переключение ежедневной награды - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-admin/admin-toggle-daily-chain.md): Включает или отключает ежедневную награду. ## Клиент ### Получение ежедневных наград для текущего пользователя - [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-client/get-daily-chains-list.md): Клиентский метод. Возвращает ежедневные награды для текущего пользователя. ПримечаниеМетод возвращает список элементов с учетом пагинации. Максимальное количество элементов в ответе — 50 (установлено по умолчанию). Чтобы получить доступ к следующим элементам списка, используйте параметры limit и offset. Например, при вызове метода с параметрами limit = 25 и offset = 100 вернется 25 элементов, начиная со 101-го в общем списке. ### Получение ежедневной награды по ее ID для текущего пользователя - [GET /v2/project/{project_id}/user/daily_chain/{daily_chain_id}](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-client/get-user-daily-chain-by-id.md): Клиентский метод. Возвращает ежедневную награду по ее ID для текущего пользователя. ### Получение ежедневной награды за уровень - [POST /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/ru/api/shop-builder/daily-chain-client/claim-user-daily-chain-step-reward.md): Клиентский метод. Возвращает награду на текущем уровне в цепочке ежедневных наград для текущего пользователя. Все уровни могут быть пройдены только в заданном порядке. Награду за пропущенный уровень нельзя получить за виртуальную или реальную валюту, или просмотр рекламного ролика. ## Admin ### Получение информации об апселле в проекте - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ru/api/shop-builder/upsell-admin/get-upsell-configurations-for-project-admin.md): Возвращает информацию об апселле в проекте: включен или выключен апселл, какой тип апселла используется, а также список товаров, используемых в апселле. ### Создание апселла - [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ru/api/shop-builder/upsell-admin/post-upsell.md): Создает апселл в проекте. ### Обновление апселла - [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ru/api/shop-builder/upsell-admin/put-upsell.md): Обновляет апселл в проекте. ### Активация/деактивация апселла в проекте - [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/ru/api/shop-builder/upsell-admin/put-upsell-toggle-active-inactive.md): Меняет статус апселла в проекте: активирует или деактивирует. ## Клиент ### Получение списка товаров для апселла в проекте - [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/ru/api/shop-builder/upsell-client/get-upsell-for-project-client.md): Получает список товаров для апселла в проекте, если они уже настроены. ## Admin ### Получение статуса импорта товаров - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/ru/api/shop-builder/connector-admin/get-items-import-status.md): Возвращает информацию о прогрессе импорта товаров в проект. Метод возвращает данные по последнему импорту,  выполненному через API или Личный кабинет. ### Импорт товаров из JSON-файла - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/ru/api/shop-builder/connector-admin/import-items-from-external-file.md): Импортирует товары в магазин из JSON-файла по указанному URL-адресу. Подробная информация об импорте из JSON-файла приведена в документации.