# Obtener el paquete de moneda virtual

Obtiene el paquete de moneda virtual dentro de un proyecto para administración.
<div class="note"><b>Nota</b><br><br>No utilice este punto final para crear un catálogo de tienda.</div>

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)
    ID del proyecto. Encontrará este parámetro en su [Cuenta del editor](https://publisher.xsolla.com/0/projects/0/) junto al nombre del proyecto y en la barra de direcciones del navegador cuando se trabaja en un proyecto. La URL tiene el siguiente formato: `https://publisher.xsolla.com/<merchant_id>/projects/<project_id>`.

  - `item_sku` (string, required)
    SKU del artículo.

## Response 200 fields (application/json):

  - `sku` (string)
    ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: booster_mega_1

  - `name` (object | null)
    Objeto con traducciones para la descripción del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., `en`) o códigos de idioma de cinco caracteres (p. ej., `en-US`). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. `en` y `en-US`), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `name.en` (string | null)
    Inglés

  - `name.ar` (string | null)
    Árabe

  - `name.bg` (string | null)
    Búlgaro

  - `name.cn` (string | null)
    Chino (simplificado)

  - `name.cs` (string | null)
    Checo

  - `name.de` (string | null)
    Alemán

  - `name.es` (string | null)
    Español (España)

  - `name.fr` (string | null)
    Francés

  - `name.he` (string | null)
    Hebreo

  - `name.it` (string | null)
    Italiano

  - `name.ja` (string | null)
    Japonés

  - `name.ko` (string | null)
    Coreano

  - `name.pl` (string | null)
    Polaco

  - `name.pt` (string | null)
    Portugués

  - `name.ro` (string | null)
    Rumano

  - `name.ru` (string | null)
    Ruso

  - `name.th` (string | null)
    Tailandés

  - `name.tr` (string | null)
    Turco

  - `name.tw` (string | null)
    Chino (tradicional)

  - `name.vi` (string | null)
    Vietnamita

  - `name.km` (string | null)
    Jemer

  - `name.id` (string | null)
    Indonesio

  - `name.lo` (string | null)
    Laosiano

  - `name.my` (string | null)
    Birmano

  - `name.ph` (string | null)
    Filipino

  - `name.ne` (string | null)
    Nepalí

  - `name.en-US` (string | null)
    Inglés

  - `name.ar-AE` (string | null)
    Árabe

  - `name.bg-BG` (string | null)
    Búlgaro

  - `name.zh-CN` (string | null)
    Chino (simplificado)

  - `name.cs-CZ` (string | null)
    Checo

  - `name.de-DE` (string | null)
    Alemán

  - `name.es-ES` (string | null)
    Español (España)

  - `name.fr-FR` (string | null)
    Francés

  - `name.he-IL` (string | null)
    Hebreo

  - `name.it-IT` (string | null)
    Italiano

  - `name.ja-JP` (string | null)
    Japonés

  - `name.ko-KR` (string | null)
    Coreano

  - `name.pl-PL` (string | null)
    Polaco

  - `name.pt-BR` (string | null)
    Portugués (Brasil)

  - `name.ro-RO` (string | null)
    Rumano

  - `name.ru-RU` (string | null)
    Ruso

  - `name.th-TH` (string | null)
    Tailandés

  - `name.tr-TR` (string | null)
    Turco

  - `name.zh-TW` (string | null)
    Chino (tradicional)

  - `name.vi-VN` (string | null)
    Vietnamita

  - `name.km-KH` (string | null)
    Jemer

  - `name.id-ID` (string | null)
    Indonesio

  - `name.lo-LA` (string | null)
    Laosiano

  - `name.my-MM` (string | null)
    Birmano

  - `name.ph-PH` (string | null)
    Filipino

  - `name.ne-NP` (string | null)
    Nepalí

  - `description` (object | null)
    Objeto con traducciones para la descripción del artículo. Acepta valores en uno de dos formatos: códigos de idioma de dos letras en minúscula (p. ej., `en`) o códigos de configuración regional de cinco caracteres (p. ej., `en-US`). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. `en` y `en-US`), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `long_description` (object | null)
    Objeto con traducciones para la descripción larga del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., `en`) o códigos de configuración regional de cinco caracteres (p. ej., `en-US`). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. `en` y `en-US`), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `type` (string)
    Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.

  - `image_url` (string)
    URL de la imagen. Para que la imagen se visualice correctamente y se cargue con rapidez en la interfaz de pago, consulte nuestras directrices sobre imágenes y URL:Formatos compatibles: WebP (recomendado), PNG y JPG.Tamaño del archivo: ≤ 50 KB (para WebP) o ≤ 150 KB (para PNG y JPG).Tamaño de la imagen: 280 x 280 píxeles.Espacio de color: sRGB.Protocolo: HTTPS con almacenamiento en caché de larga duración para las URL versionadas.

  - `attributes` (array)
    Lista de atributos.

  - `attributes.external_id` (string, required)
    ID único del atributo. `external_id` solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.
    Example: attribute_1

  - `attributes.values` (array, required)
    Example: [{"external_id":"strategy","value":{"en":"Strategy","de":"Strategie"}},{"external_id":"action","value":{"en":"Action","de":"Aktion"}}]

  - `attributes.values.external_id` (string, required)
    ID del valor único para un atributo. `external_id` solo puede contener caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.
    Example: attribute_value

  - `is_free` (boolean)
    Si el artículo es gratuito.
    Example: false

  - `is_paid_randomized_reward` (boolean)
    Si el artículo es o no una recompensa de pago aleatoria, p. ej., una caja de botín.
    Example: false

  - `order` (integer)
    Orden de visualización de los artículos en el catálogo. Cuanto mayor sea el valor, más abajo aparecerá el artículo en la lista.
Si los valores son iguales, los artículos se ordenan por fecha de creación, y los más recientes aparecerán más arriba.
    Example: 1

  - `groups` (array)
    Grupos a los que pertenece el artículo.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

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

  - `prices` (array)

  - `prices.currency` (string, required)
    Divisa del precio del artículo. Código de tres letras según [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consulte la documentación para obtener información detallada sobre [monedas soportadas por Xsolla](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/).
    Example: USD

  - `prices.amount` (number, required)
    Precio del artículo en moneda real.
    Example: 10.5

  - `prices.is_default` (boolean)
    Si es o no el precio predeterminado en moneda real. Consulte nuestra [documentación](https://developers.xsolla.com/es/items-catalog/catalog-features/pricing-policy/#pricing_policy_country_determination) para obtener información detallada sobre la configuración de precios.

  - `prices.is_enabled` (boolean)
    Si este precio se utiliza o no para mostrarlo en el catálogo y para la compra del artículo. Si es `false`, no se utilizará este precio y se aplicará otro. Consulte nuestra [documentación](https://developers.xsolla.com/es/items-catalog/catalog-features/pricing-policy/#pricing_policy_country_determination) para obtener información detallada sobre la configuración de precios.
    Example: true

  - `prices.country_iso` (string | null)
    País en el que está disponible este precio. Código de dos letras según la norma [ISO 3166-1 alfa 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: US

  - `media_list` (array)
    Recursos adicionales del artículo como capturas de pantalla, vídeos de partidas del juego, etc.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `media_list.type` (string)
    Tipo de soporte multimedia: `image`/`video`.
    Enum: "image", "video"

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

  - `vc_prices` (array)

  - `vc_prices.sku` (string, required)
    ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: bundle_1

  - `vc_prices.amount` (number, required)
    Importe.

  - `vc_prices.is_default` (boolean)

  - `is_enabled` (boolean)
    Si el artículo está disponible. Si es `false`, el artículo no se puede comprar en la tienda ni obtener como parte de un lote o en el contexto de una campaña de marketing. Consulte nuestra [documentación](https://developers.xsolla.com/es/items-catalog/catalog-features/items-availability/) para obtener información detallada sobre la disponibilidad del artículo.
    Example: true

  - `bundle_type` (string)
    Example: virtual_currency_package

  - `content` (array)

  - `content.quantity` (integer)

  - `is_show_in_store` (boolean)
    Si el artículo aparece o no en el catálogo. Si es `false` y `is_enabled: true`, el artículo no es visible en el catálogo, pero puede obtenerse como parte de un lote o en el marco de campañas de marketing. Consulte nuestra [documentation](https://developers.xsolla.com/es/items-catalog/catalog-features/items-availability/) para obtener información detallada sobre la disponibilidad del artículo.
    Example: true

  - `regions` (array)
    Matriz de regiones en las que el artículo está disponible. Si la matriz está vacía o no se ha transmitido, el artículo está disponible en todas las regiones.

  - `regions.id` (integer)
    ID de región dentro del proyecto.
Consulte la [documentación sobre restricciones de venta regionales](https://developers.xsolla.com/es/items-catalog/catalog-features/regional-restrictions/) y las [llamadas API de gestión regional](https://developers.xsolla.com/es/api/catalog/common-regions) para obtener información detallada.
    Example: 1

  - `limits` (object | null)
    Límites del artículo.

  - `limits.per_user` (object | null)
    Limitación de artículos para un usuario independiente.

  - `limits.per_user.total` (integer)
    Número máximo de artículos que un mismo usuario puede comprar.

  - `limits.per_user.limit_exceeded_visibility` (string)
    Determina la visibilidad del artículo en el catálogo tras alcanzar el límite de compra, hasta el siguiente restablecimiento del límite.
Se aplica a los artículos para los que se han configurado restablecimientos periódicos del límite en la matriz `recurrent_schedule`.
Si no están configurados los restablecimientos del límite, el artículo no aparecerá en el catálogo cuando se haya alcanzado el límite de compra,
independientemente del valor de `limit_exceeded_visibility`.
Valores posibles:
- `show` — El artículo se devuelve en las llamadas API de recuperación del catálogo tras alcanzar el límite de compra. En las llamadas API
de recuperación del catálogo en el lado del cliente, tras alcanzar el límite, el artículo se devuelve con el indicador `can_be_bought: false`. La
La próxima fecha de restablecimiento se devuelve el día `reset_next_date`.
- `hide` — El artículo no se devuelve en las llamadas API de recuperación del catálogo tras alcanzar el límite de compra, hasta que
se restablezca ese límite.
    Enum: "show", "hide"

  - `limits.per_item` (object | null)
    Limitación global de artículos.

  - `limits.per_item.total` (integer)
    Número máximo de artículos que pueden comprar todos los usuarios.

  - `limits.per_item.available` (integer)
    Número restante de artículos que todos los usuarios pueden comprar.

  - `limits.per_item.reserved` (integer)

  - `limits.per_item.sold` (integer)

  - `limits.recurrent_schedule` (object | null)
    Periodo de actualización del límite.

  - `limits.recurrent_schedule.per_user` (any)
    Periodo de actualización del límite del usuario.

  - `limits.recurrent_schedule.per_user.interval_type` (string)
    Tipo de periodo de actualización recurrente.
    Enum: "daily"

  - `limits.recurrent_schedule.per_user.time` (string)
    Hora de actualización del límite en la zona horaria deseada (redondeo a horas).
    Example: 11:00:00+03:00

  - `limits.recurrent_schedule.per_user.reset_next_date` (integer)
    Fecha y hora de actualización de los límites (Marca de tiempo Unix).
    Example: 1677553200

  - `limits.recurrent_schedule.per_user.displayable_reset_start_date` (string)
    Fecha y hora de la primera actualización del límite (ISO 8601).
    Example: 2023-02-28T11:00:00+08:00

  - `limits.recurrent_schedule.per_user.displayable_reset_next_date` (string)
    Fecha y hora en que deben restablecerse los límites (ISO 8601).
    Example: 2023-02-28T11:00:00+08:00

  - `limits.recurrent_schedule.per_user.day_of_week` (integer | null)
    Día de la semana en que se actualizan los límites. En el cual 1 es lunes y 7 es domingo. No es `null` solo para el tipo de periodo de actualización del límite `weekly`.

  - `limits.recurrent_schedule.per_user.day_of_month` (integer | null)
    Día del mes en que se actualizan los límites. Si no hay ningún día del mes seleccionado porque el mes es más corto, la actualización se producirá el último día del mes. No es `null` solamente para el tipo de periodo de actualización del límite `monthly`.

  - `limits.recurrent_schedule.per_user.hours_interval` (integer)
    Intervalo en horas tras el cual se actualiza el límite.  La cuenta atrás comienza en el momento en que el artículo se muestra por primera vez en la tienda, tal y como se especifica en el parámetro date_from.  Por ejemplo, si `date_from = "2025-11-15T18:15:00+05:00"` y `hours_interval = 2`, el límite de compra para este artículo se actualizará cada 2 horas a partir de `"2025-11-15T20:15:00+05:00"`.

  - `periods` (array)
    Periodo de venta del artículo.

  - `periods.date_from` (string | null)
    Fecha en la que el artículo especificado estará disponible para la venta.
    Example: 2020-08-11T10:00:00+03:00

  - `periods.date_until` (string | null)
    Fecha en la que el artículo especificado dejará de estar disponible para la venta. Puede ser `null`.
    Example: 2020-08-11T20:00:00+03:00

  - `custom_attributes` (object)
    Un objeto JSON que contiene atributos y valores de artículos. Los artículos le permiten añadir más información a los artículos, tal como el nivel requerido del jugador para usar el artículo. Los atributos enriquecen la lógica interna del juego y son accesibles a través de métodos GET y webhooks específicos.

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

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