# Criar pacote de moedas virtuais

Cria um pacote de moedas virtuais.

Endpoint: POST /v2/project/{project_id}/admin/items/virtual_currency/package
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

## Request fields (application/json):

  - `attributes` (array)
    Lista de atributos.
Atenção. Não é possível especificar mais de 20 atributos para o item. Qualquer tentativa de exceder o limite resulta em um erro.

  - `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.

  - `attributes.name` (object)
    Objeto com localizações para o nome do atributo. As chaves são especificadas no formato ISO 3166-1.

  - `attributes.values` (array, required)
    Atenção. Não é possível criar mais de 6 valores para cada atributo. Qualquer tentativa de exceder o limite resulta em um erro.
    Example: [{"external_id":"strategy","value":{"de":"Strategie","en":"Strategy"}},{"external_id":"action","value":{"de":"Aktion","en":"Action"}}]

  - `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.

  - `content` (array, required)
    O pacote de moedas virtuais deve conter apenas 1 posição de moeda virtual.

  - `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.

  - `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.

  - `description` (object,null, required)
    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/).

  - `groups` (array)
    List of [group external IDs](/pt/api/catalog/item-groups-admin/admin-get-item-group-list/#!path=groups/external_id&t=response) the item belongs to.

Example: ["horror", "action"]

  - `image_url` (string)
    URL da imagem.

  - `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)
    Limites de itens.

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

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

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

  - `limits.recurrent_schedule.per_user` (any)
    Redefinição do limite de compra realizado no intervalo de tempo especificado em horas.

  - `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"

  - `name` (object,null, required)
    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/).

  - `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,null)
    Período de venda de itens.

  - `periods.date_from` (string)
    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,null)
    Array of virtual currency prices.
    Example: [{"amount":10,"is_default":true,"is_enabled":true,"sku":"com.xsolla.gold_1"}]

  - `vc_prices.amount` (integer, required)
    Preço do item em moeda virtual.
    Example: 10

  - `vc_prices.is_default` (boolean, required)
    Whether it is the default price in virtual currency.
    Example: true

  - `vc_prices.is_enabled` (boolean, required)
    Whether this price is used for displaying in the catalog and for purchasing the item. If false, the price is not used.
    Example: true

## Response 201 fields (application/json):

  - `sku` (string)
    Example: "com.xsolla.item_1"

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Example: 1102

  - `errorMessage` (string)
    Example: "[0401-1102]: Unprocessable Entity. The property `property_name` is required"

  - `errorMessageExtended` (array)

  - `statusCode` (integer)
    Example: 422

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"