# Получение пакета виртуальной валюты по артикулу

Получает пакет виртуальной валюты по артикулу для построения каталога.
ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

Endpoint: GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
    Example: 44056

  - `virtual_currency_package_sku` (string, required)
    Артикул пакета виртуальной валюты.
    Example: "crystal-pack"

## Query parameters:

  - `locale` (string)
    Язык ответа. Двухбуквенный код языка в нижнем регистре в соответствии с ISO 639-1.

  - `country` (string)
    Двухбуквенное обозначение страны в верхнем регистре согласно стандарту ISO 3166-1 alpha-2. Ознакомьтесь со списком стран, поддерживаемых Xsolla, а также с процессом определения страны.
    Example: "US"

  - `show_inactive_time_limited_items` (integer)
    Отображает предметы с ограниченным сроком действия, которые недоступны пользователю. Срок действия таких предметов еще не начался или уже истек.
    Example: 1

  - `additional_fields[]` (array)
    Список дополнительных полей. Эти поля будут указаны в ответе, если вы отправите их в своем запросе.
    Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group"

## Response 200 fields (application/json):

  - `attributes` (array)
    Список атрибутов и их значений, соответствующих товару. Может использоваться для фильтрации каталога.
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

  - `attributes.external_id` (string)
    Уникальный ID атрибута. external_id может содержать только строчные и заглавные латинские буквы, цифры, тире и подчеркивания.
    Example: "attribute_1"

  - `attributes.name` (object)
    Название атрибута.
    Example: "Genre"

  - `attributes.values` (array)

  - `attributes.values.external_id` (string)
    Уникальный ID значения атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания.
    Example: "attribute_value"

  - `attributes.values.value` (string)
    Значение атрибута.
    Example: "Strategy"

  - `bundle_type` (string)
    Тип бандла: standard/virtual_currency_package.
    Example: "virtual_currency_package"

  - `can_be_bought` (boolean)
    Если true, пользователь может купить товар.
    Example: true

  - `content` (array)
    Содержимое пакета виртуальной валюты.
    Example: [{"description":"Crystal Pack - short description","image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","name":"Crystal Pack","quantity":100,"sku":"com.xsolla.crystal_pack_1","type":"virtual_currency"}]

  - `content.description` (string)
    Описание товара.
    Example: "Big Rocket - description"

  - `content.image_url` (string)
    URL-адрес изображения.
    Example: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"

  - `content.item_id` (integer)

  - `content.limits` (object,null)
    Ограничения на продажу товара.

  - `content.limits.per_item` (object,null)
    Ограничения на продажу для конкретного товара.

  - `content.limits.per_item.available` (integer)
    Оставшееся количество товара, которое могут приобрести все пользователи.
    Example: 3

  - `content.limits.per_item.total` (integer)
    Максимальное количество товара, которое могут приобрести все пользователи.
    Example: 5

  - `content.limits.per_user` (object,null)
    Ограничения на продажу товара для пользователя.

  - `content.limits.per_user.available` (integer)
    Оставшееся количество товара, которое может приобрести текущий пользователь.
    Example: 3

  - `content.limits.per_user.limit_exceeded_visibility` (string)
    Определяет видимость товара в каталоге после достижения лимита покупок до момента следующего обновления лимитов.

Применяется к товарам, для которых задано регулярное обновление лимитов в массиве recurrent_schedule.

Если обновление лимитов не задано, товар не отображается в каталоге после достижения лимита независимо от значения limit_exceeded_visibility.
    Enum: "show", "hide"

  - `content.limits.per_user.recurrent_schedule` (object)
    Период обновления ограничений на продажу товара для пользователя.

  - `content.limits.per_user.recurrent_schedule.interval_type` (string)
    Период обновления ограничения на продажу товара.
    Enum: "daily", "weekly", "monthly", "hourly"

  - `content.limits.per_user.recurrent_schedule.reset_next_date` (integer)
    Дата и время обновления ограничений (Unix Timestamp).
    Example: 1677553200

  - `content.limits.per_user.total` (integer)
    Максимальное количество товара, которое может приобрести один пользователь.
    Example: 5

  - `content.name` (string)
    Название товара.
    Example: "Big Rocket"

  - `content.quantity` (integer)
    Количество виртуальной валюты в пакете.
    Example: 250

  - `content.sku` (string)
    Уникальный ID товара. Артикул может содержать только строчные и заглавные латинские буквы, цифры, точки, тире и подчеркивания.
    Example: "com.xsolla.big_rocket_1"

  - `content.type` (string)
    Тип товара: virtual_good/virtual_currency/bundle.
    Example: "virtual_currency"

  - `custom_attributes` (object)
    JSON-объект, содержащий атрибуты товара и их значения.

  - `groups` (array)
    Группы, к которым принадлежит товар.
    Example: [{"external_id":"exclusive","name":"Exclusive"}]

  - `groups.external_id` (string)
    Уникальный ID группы. Используется для ссылок в запросах API или внешних системах.
    Example: "exclusive"

  - `groups.item_order_in_group` (integer)
    Позиция предмета внутри группы, определяющая порядок отображения.
Поле включается в ответ только при указании параметра в запросе additional_fields[].
    Example: 1

  - `groups.name` (string)
    Название группы.
    Example: "Exclusive"

  - `is_free` (boolean)
    Если true, товар бесплатный.

  - `periods` (array)
    Период продажи товара.

  - `periods.date_from` (string,null)
    Дата, когда указанный товар будет доступен для продажи.
    Example: "2020-08-11T10:00:00+03:00"

  - `periods.date_until` (string,null)
    Дата, когда указанный товар станет недоступен для продажи. Может быть null.
    Example: "2020-08-11T20:00:00+03:00"

  - `price` (object)
    Цены на товар.

  - `price.amount` (string)
    Цена товара со скидкой.
    Example: "100.99"

  - `price.amount_without_discount` (string)
    Цена товара.
    Example: "100.99"

  - `price.currency` (string)
    Валюта, в которой указана цена товара. Трехбуквенный код в соответствии с [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Подробную информацию о [валютах, поддерживаемых Xsolla, смотрите в документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `promotions` (array)
    Примененные акции для отдельных товаров в корзине. Массив возвращается, если:

* Скидочная акция настроена для отдельного товара.

* Используется промокод с настройкой Скидка на выбранные товары.

Если акции на уровне отдельных товаров не применялись, возвращается пустой массив.

  - `promotions.bonus` (array)

  - `promotions.bonus.bundle_type` (string)
    Тип товара бонусного бандла. Доступно только для бонусного товара типа bundle.
    Enum: "standard", "virtual_currency_package"

  - `promotions.bonus.image_url` (string)
    URL-адрес изображения бонусного бандла. Недоступно для типа бонусного товара physical_good.

  - `promotions.bonus.name` (string)
    Название бонусного товара. Недоступно для типа бонусного товара physical_good.

  - `promotions.bonus.quantity` (integer)

  - `promotions.bonus.sku` (string)

  - `promotions.bonus.type` (string)
    Тип бонусного товара.
    Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft"

  - `promotions.date_end` (string,null)

  - `promotions.date_start` (string,null)

  - `promotions.discount` (object,null)

  - `promotions.discount.percent` (string,null)

  - `promotions.discount.value` (string,null)

  - `promotions.limits` (object)

  - `promotions.limits.per_user` (object)

  - `promotions.limits.per_user.available` (integer)

  - `promotions.limits.per_user.total` (integer)

  - `promotions.name` (string)

  - `virtual_prices` (array)
    Виртуальные цены.

  - `virtual_prices.amount` (integer)
    Цена товара со скидкой в виртуальной валюте.
    Example: 100

  - `virtual_prices.description` (string)
    Описание виртуальной валюты.
    Example: "Big Rocket - description"

  - `virtual_prices.image_url` (string)
    Изображение виртуальной валюты.
    Example: "http://image.png"

  - `virtual_prices.is_default` (boolean)
    Является ли данная цена товара ценой по умолчанию.
    Example: true

  - `virtual_prices.name` (string)
    Название виртуальной валюты.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `virtual_prices.sku` (string)
    Артикул виртуальной валюты.
    Example: "vc_test"

  - `virtual_prices.type` (string)
    Тип виртуальной валюты.
    Example: "virtual_currency"

  - `vp_rewards` (array)