# Obter pacote de moedas virtuais

Obtém o pacote de moedas virtuais dentro de um projeto para administração.

ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja.

Endpoint: GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Project ID. You can find this parameter in your Publisher Account next to the project name and in the browser address bar when working with a project. The URL has the following format: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `item_sku` (string, required)
    SKU do item.
    Example: "booster_mega_1"

## Response 200 fields (application/json):

  - `attributes` (array)
    Lista de atributos.
    Example: [{"external_id":"attribute_external_id","name":{"de":"Attributname","en":"Attribute name"},"values":[{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}]}]

  - `attributes.external_id` (string, required)
    ID de atributo exclusivo. O external_id só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados.
    Example: "attribute_external_id"

  - `attributes.name` (object)
    Objeto com localizações para o nome do atributo. As chaves são especificadas no formato ISO 3166-1.
    Example: {"de":"Attributname","en":"Attribute name"}

  - `attributes.values` (array, required)
    Example: [{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}]

  - `attributes.values.external_id` (string, required)
    ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.
    Example: "value_external_id"

  - `attributes.values.value` (object, required)
    Objeto com traduções do nome do valor. As chaves são especificadas no formato ISO 3166-1.

  - `bundle_type` (string)
    Example: "virtual_currency_package"

  - `content` (array)

  - `content.description` (object,null)
    Objeto com traduções para a descrição do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as opções para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na [documentação](/pt/doc/shop-builder/references/supported-languages/).

  - `content.image_url` (string)
    URL da imagem.

  - `content.name` (object,null)
    Objeto com traduções para o nome do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de idioma de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as opções para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na [documentação](/pt/doc/shop-builder/references/supported-languages/).

  - `content.quantity` (integer)

  - `content.sku` (string)
    ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados.

  - `content.type` (string)
    Tipo de item:virtual_good/virtual_currency/bundle/physical_good/unit.

  - `custom_attributes` (object)
    Um objeto JSON que contém atributos e valores de item. Os atributos permitem que você adicione mais informações a itens como o nível necessário do jogador para usar o item. Os atributos enriquecem a lógica interna do seu jogo e são acessíveis através de métodos GET e webhooks dedicados.

  - `groups` (array)
    Grupo aos quais o item pertence.

  - `groups.external_id` (string)
    Example: "horror"

  - `groups.name` (object)
    Nome do item. Deve conter pares chave/valor
onde chave é uma localização com o formato "^[a-z]{2}", e o valor é uma cadeia de caracteres.
    Example: {"de":"Horror","en":"Horror"}

  - `is_enabled` (boolean)
    Whether the item is available. If false, the item can't be purchased in the store or obtained as part of a bundle or within a marketing campaign. Refer to our [documentation](https://developers.xsolla.com/pt/items-catalog/catalog-features/items-availability/) for detailed information about item availability.

  - `is_free` (boolean)
    Se o item é gratuito ou não.

  - `is_paid_randomized_reward` (boolean)
    Se o item é uma recompensa paga randomizada, como uma loot box.

  - `is_show_in_store` (boolean)
    Whether the item is displayed in the catalog. If false and is_enabled: true, the item is not visible in the catalog but can be obtained as part of a bundle or within marketing campaigns. Refer to our [documentation](https://developers.xsolla.com/pt/items-catalog/catalog-features/items-availability/) for detailed information about item availability.

  - `limits` (object,null)
    Limites de itens.

  - `limits.per_item` (object,null)
    Limitação global de itens.

  - `limits.per_item.available` (integer)
    Quantidade restante de itens que todos os usuários podem comprar.

  - `limits.per_item.reserved` (integer)

  - `limits.per_item.sold` (integer)

  - `limits.per_item.total` (integer)
    Quantidade máxima de itens que todos os usuários podem comprar.

  - `limits.per_user` (object,null)
    Limitação de item para um usuário separado.

  - `limits.per_user.limit_exceeded_visibility` (string)
    Determines the visibility of the item in the catalog after the purchase limit is reached, until the next limit reset.

Applies to items for which recurring limit resets are configured in the recurrent_schedule array.

If limit resets are not configured, the item doesn't appear in the catalog after the purchase limit is reached,
regardless of the limit_exceeded_visibility value.

Possible values:
- show — The item is returned in catalog retrieval API calls after the purchase limit is reached. In client-side
catalog retrieval API calls, once the limit is reached, the item is returned with the can_be_bought: false flag. The
next reset date is returned in reset_next_date.
- hide — The item is not returned in catalog retrieval API calls after the purchase limit is reached, until the
limit is reset.
    Enum: "show", "hide"

  - `limits.per_user.total` (integer)
    Quantidade máxima de itens que o usuário atual pode comprar.

  - `limits.recurrent_schedule` (object,null)
    Limite o período de atualização.

  - `limits.recurrent_schedule.per_user` (object,null)
    Período de atualização do limite do usuário.

  - `long_description` (object,null)
    Objeto com traduções para a descrição longa do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as variantes para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na [documentação](/pt/doc/shop-builder/references/supported-languages/).

  - `media_list` (array)
    Recursos adicionais do item, como capturas de tela, vídeos de jogabilidade e assim por diante.

  - `media_list.type` (string)
    Tipo de mídia: image/video.
    Enum: "image", "video"

  - `media_list.url` (string)
    Arquivo de recurso.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `order` (integer)
    Item display order in the catalog. The higher the value, the lower the item appears in the list.
If the values are the same, items are sorted by creation date, with newer items displayed higher.

  - `periods` (array)
    Período de venda de itens.

  - `periods.date_from` (string,null)
    Data em que o item especificado estará disponível para venda.
    Example: "2020-08-11T10:00:00+03:00"

  - `periods.date_until` (string,null)
    Data em que o item especificado ficará indisponível para venda. Pode ser null.
    Example: "2020-08-11T20:00:00+03:00"

  - `prices` (array)
    Example: [{"amount":10.5,"country_iso":"US","currency":"USD","is_default":true,"is_enabled":true}]

  - `prices.amount` (number, required)
    Item price in real currency.
    Example: 10.5

  - `prices.country_iso` (string,null)
    País onde este preço está disponível. Código de duas letras de acordo com o padrão [ISO 3166-1 alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `prices.currency` (string, required)
    Moeda do preço do item. Código de três letras de acordo com [a ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consulte a documentação para obter informações detalhadas sobre [as moedas suportadas pelo Xsolla](https://developers.xsolla.com/pt/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `prices.is_default` (boolean)
    Whether it is the default price in real currency. Refer to our [documentation](https://developers.xsolla.com/pt/items-catalog/catalog-features/pricing-policy/#pricing_policy_country_determination) for detailed information on price settings.
    Example: true

  - `prices.is_enabled` (boolean)
    Whether this price is used for displaying in the catalog and for purchasing the item. If false, the price is not used and another price is applied. Refer to our [documentation](https://developers.xsolla.com/pt/items-catalog/catalog-features/pricing-policy/#pricing_policy_country_determination) for detailed information on price settings.
    Example: true

  - `regions` (array)
    Array of regions where the item is available. If the array is empty or not passed, the item is available in all regions.

  - `regions.id` (integer)
    Region ID within the project.

Refer to the [regional sale restriction documentation](https://developers.xsolla.com/pt/items-catalog/catalog-features/regional-restrictions/) and [region management API calls](https://developers.xsolla.com/pt/api/catalog/common-regions) for detailed information.
    Example: 1

  - `vc_prices` (array)
    Example: [{"amount":10,"is_default":true,"sku":"com.xsolla.gold_1"}]

  - `vc_prices.amount` (number, required)
    Quantidade.
    Example: 10

  - `vc_prices.is_default` (boolean)
    Example: true

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401