openapi: 3.1.0
info:
  description: "# Descripción general\n\n- **Versión:** 2.0.0\n- **Servidores:** `https://store.xsolla.com/api`\n- [Contacte con nosotros por correo electrónico](mailto:integration@xsolla.com)\n- **URL de contacto:** https://xsolla.com/\n- **Versión TLS requerida:** 1.2\n\nLa API de catálogo le permite configurar un catálogo de artículos de juego en el lado de Xsolla y mostrar dicho catálogo a los usuarios de su tienda.\n\nLa API le permite gestionar las siguientes entidades de catálogo:\n\n* **Artículos virtuales**: artículos de juego, como armas, apariencias o potenciadores.\n* **Moneda virtual**: dinero virtual que se utiliza para comprar productos virtuales.\n* **Paquetes de moneda virtual**: lotes predefinidos de moneda virtual.\n* **Lotes**: paquetes combinados de artículos virtuales, moneda o claves de juego que se venden como un único SKU.\n* **Claves de juego**: claves para juegos y DLC distribuidos a través de plataformas como Steam u otros proveedores de DRM.\n* **Grupos**: agrupaciones lógicas para organizar y clasificar artículos dentro del catálogo.\n\n## Llamadas API\n\nLa API se divide en los siguientes grupos:\n\n* **<nt>Admin</nt>**: llamadas para crear, actualizar, eliminar y configurar artículos de catálogo y grupos. La autenticación se realiza mediante [autenticación de acceso básica](https://developers.xsolla.com/es/payment-ui-and-flow/payment-ui/how-to-get-payment-token/#payments_solution_get_user_auth_token_basic_auth) con sus credenciales de comerciante o de proyecto. No está diseñado para uso en escaparates.\n* **<nt>Catalog</nt>**: llamadas para buscar artículos y crear escaparates personalizados para los usuarios finales. Diseñado para gestionar situaciones de alta carga. Admite la autorización JWT opcional de usuarios para devolver datos personalizados, como límites específicos para determinados usuarios y promociones activas.\n\n# Autenticación\n\nLas llamadas API requieren autenticación ya sea en nombre de un usuario o en nombre de un proyecto. El esquema de autenticación utilizado se especifica en la sección **Seguridad** en la descripción de cada llamada.\n\n## Autenticación mediante el JWT del usuario\n\nLa autenticación mediante el JWT del usuario se utiliza cuando se envía una solicitud desde un navegador, aplicación móvil o juego. Por defecto, se aplica el esquema `XsollaLoginUserJWT`. Para obtener más detalles sobre cómo crear un token, consulte la [documentación del API de Xsolla Login](/es/api/login/authentication-schemes#getting-user-token).\n\nEl token se transmite en el encabezado `Authorization` con el siguiente formato: `Authorization: Bearer <user_JWT>`, en el que `<user_JWT>` es el token de usuario. El token identifica al usuario y proporciona acceso a datos personalizados.\n\nTambién puede utilizar un [token para abrir la interfaz de pago](/es/api/pay-station/token/create-token).\n\n## Autenticación HTTP básica\n\nLa autenticación HTTP básica se utiliza para interacciones de servidor a servidor, cuando una llamada API se envía directamente desde tu servidor en lugar de desde el navegador de un usuario o aplicación móvil. Normalmente, se usa la autenticación HTTP básica con una [clave de API](/es/api/getting-started/#api_keys_overview).\n\n<div class=\"note\"><b>Nota:</b><br><br>La clave de API es confidencial y no debe almacenarse ni usarse en aplicaciones cliente.</div>\n\nCon la autenticación básica del lado del servidor, todas las solicitudes de API deben incluir el siguiente encabezado:\n\n- para `basicAuth` — `Authorization: Basic <your_authorization_basic_key>`, en las que `your_authorization_basic_key` es el par `project_id:api_key` codificado en Base64\n- para `basicMerchantAuth` — `Authorization: Basic <your_authorization_basic_key>`, en las que `your_authorization_basic_key` es el par `merchant_id:api_key` codificado en Base64\n\nPuede encontrar los valores de parámetro en [Cuenta del editor](https://publisher.xsolla.com/):\n\n- Se muestra `merchant_id`:\n  - En **Configuración de la empresa > Empresa**.\n  - En la URL en la barra de direcciones del navegador en cualquier página de Cuenta del editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/<merchant_id>`.\n- Se muestra `project_id`:\n  - Junto al nombre del proyecto en Cuenta del editor.\n  - En la URL en la barra de direcciones del navegador al trabajar en un proyecto en la Cuenta del editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/<merchant_id>/projects/<project_id>`.\n- `api_key` se muestra en Cuenta del editor solo en el momento de la creación y debe almacenarse de forma segura en su servidor. Puede crear una clave de API en las siguientes secciones:\n  - [Configuración de la empresa > Claves de API](https://publisher.xsolla.com/0/settings/api_key)\n  - [Configuración del proyecto > Clave de API](https://publisher.xsolla.com/0/projects/0/edit/api_key)\n\n<div class=\"notice\"><b>Aviso:</b><br><br>Si una llamada\_API requerida no incluye el parámetro de ruta <code>project_id</code>, utilice una clave de API que sea válida para todos los proyectos de la empresa para la autorización.</div>\n\nPara obtener más información sobre cómo trabajar con claves de API, consulte las [referencias de la API](/es/api/getting-started/#api_keys_overview).\n\n## Autenticación con compatibilidad con el acceso de invitado\n\nEl esquema de autenticación `AuthForCart` se utiliza para las compras con cesta y admite dos modos:\n\n1. **Autenticación mediante el JWT del usuario.** El token se transmite en el encabezado `Authorization` con el siguiente formato: `Authorization: Bearer <user_JWT>`, en el cual `<user_JWT>` es el token del usuario. El token identifica al usuario y proporciona acceso a datos personalizados.\nComo alternativa, puede utilizar un [token para abrir la interfaz de pago](/es/api/pay-station/token/create-token).\n\n2. **Modo simplificado sin encabezado \"Authorization\".** Este modo se utiliza solo para usuarios no autorizados y puede aplicarse solo para [ventas de claves de juego](/es/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). En lugar de un token, la solicitud debe incluir los siguientes encabezados:\n   - `x-unauthorized-id` con un ID de solicitud\n   - `x-user` con la dirección de correo electrónico del usuario codificada en Base64\n\n## Enlaces útiles\n\n- [Llamadas API por modelo de interacción](https://developers.xsolla.com/es/api/catalog/)\n- [Tipos de puntos finales](https://developers.xsolla.com/es/api/catalog/)\n- [Gestión de errores](https://developers.xsolla.com/es/api/catalog/)\n- [Claves de API](https://developers.xsolla.com/es/api/catalog/)\n\n# Estructura de la entidad principal\n\nLos artículos de todos los tipos (artículos virtuales, lotes, moneda virtual y claves) emplean una estructura de datos similar. Comprender la estructura básica simplifica el trabajo con la API y le ayuda a orientarse más fácilmente en la documentación.\n\n<div class=\"note\"><b>Nota:</b><br><br>Algunas llamadas pueden incluir campos adicionales, pero no cambian la estructura básica.</div>\n\n**Identificación**\n\n- `merchant_id` — ID de la empresa en [Cuenta del editor](https://publisher.xsolla.com/)\n- `project_id` — ID del proyecto en Cuenta del editor\n- `sku` — SKU del artículo, único dentro del proyecto\n\n**Visualización en la tienda**\n\n- `name` — nombre del artículo\n- `description` — descripción del artículo\n- `image_url` — URL de la imagen\n- `is_enabled` — disponibilidad del artículo\n- `is_show_in_store` — si el artículo se muestra o no en el catálogo\n\nPara obtener más información sobre la gestión de la disponibilidad de artículos en el catálogo, consulte la [documentación](/es/items-catalog/catalog-features/items-availability/).\n\n**Organización**\n\n- `type` — tipo de artículo, p.\_ej., un artículo virtual (`virtual_item`) o lote (`bundle`)\n- `groups` — grupos a los que pertenece el artículo\n- `order` — orden de visualización en el catálogo\n\n**Condiciones de venta**\n\n- `prices` — precios en moneda real o virtual\n- `limits` — límites de compra\n- `periods` — periodos de disponibilidad\n- `regions` — restricciones regionales\n\n**Ejemplo de estructura de entidad principal:**\n\n```json\n{\n  \"attributes\": [],\n  \"bundle_type\": \"virtual_currency_package\",\n  \"content\": [\n    {\n      \"description\": {\n        \"en\": \"Main in-game currency\"\n      },\n      \"image_url\": \"https://.../image.png\",\n      \"name\": {\n        \"en\": \"Crystals\",\n        \"de\": \"Kristalle\"\n      },\n      \"quantity\": 500,\n      \"sku\": \"com.xsolla.crystal_2\",\n      \"type\": \"virtual_currency\"\n    }\n  ],\n  \"description\": {\n    \"en\": \"Crystals x500\"\n  },\n  \"groups\": [],\n  \"image_url\": \"https://.../image.png\",\n  \"is_enabled\": true,\n  \"is_free\": false,\n  \"is_show_in_store\": true,\n  \"limits\": {\n    \"per_item\": null,\n    \"per_user\": null,\n    \"recurrent_schedule\": null\n  },\n  \"long_description\": null,\n  \"media_list\": [],\n  \"name\": {\n    \"en\": \"Medium crystal pack\"\n  },\n  \"order\": 1,\n  \"periods\": [\n    {\n      \"date_from\": null,\n      \"date_until\": \"2020-08-11T20:00:00+03:00\"\n    }\n  ],\n  \"prices\": [\n    {\n      \"amount\": 20,\n      \"country_iso\": \"US\",\n      \"currency\": \"USD\",\n      \"is_default\": true,\n      \"is_enabled\": true\n    }\n  ],\n  \"regions\": [],\n  \"sku\": \"com.xsolla.crystal_pack_2\",\n  \"type\": \"bundle\",\n  \"vc_prices\": []\n}\n```\n\n# Flujo de compra básico\n\nLa API de Xsolla le permite implementar la lógica de una tienda en el juego, incluyendo la recuperación del catálogo de artículos, la gestión de la cesta, la creación de pedidos y el seguimiento de su estado. Dependiendo del escenario de integración, las llamadas API se dividen en subsecciones de **Admin** y **Catálogo**, que usan diferentes [esquemas de autenticación](/es/api/catalog/section/authentication).\n\nEl siguiente ejemplo muestra un flujo básico para establecer y operar una tienda, desde la creación de artículos hasta la compra.\n\n## Crear artículos y grupos (Admin)\n\nCree un catálogo de artículos para su tienda, como artículos virtuales, lotes o moneda virtual.\n\nEjemplos de llamadas API:\n- [Crear artículo virtual](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-item)\n- [Crear lote](/es/api/catalog/bundles-admin/admin-create-bundle)\n- [Crear moneda virtual](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency)\n\n## Establecer promociones, cadenas y límites (Admin)\n\nConfigure herramientas de adquisición de usuarios y monetización, como descuentos, bonificaciones, recompensas diarias o cadenas de ofertas.\n\nEjemplos de llamadas API:\n- [Crear promoción de bonificación](/es/api/liveops/promotions-bonuses/create-bonus-promotion)\n- [Crear recompensa diaria](/es/api/liveops/daily-chain-admin/admin-create-daily-chain)\n- [Crear promoción de oferta única del catálogo](/es/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer)\n\n## Obtener información del artículo (cliente)\n\nConfigure la visualización de artículos en su aplicación.\n\n<div class=\"notice\">\n  <b>Aviso:</b><br><br>\n    No utilice llamadas API de la subsección Admin para crear un catálogo de usuarios. Estas llamadas API tienen <a href=\"https://developers.xsolla.com/es/api/getting-started/#api_rate_limits\" target=\"_blank\">límites de frecuencia</a> y no están destinadas para el tráfico de usuarios.\n</div>\n\n<br>\n\nEjemplos de llamadas a la API:\n- [Obtener lista de artículos virtuales](/es/api/catalog/virtual-items-currency-catalog/get-virtual-items)\n- [Obtener lista de grupos de artículos](/es/api/catalog/virtual-items-currency-catalog/get-item-groups)\n- [Obtener lista de lotes](/es/api/catalog/bundles-catalog/get-bundle-list)\n- [Obtener lista de artículos vendibles](/es/api/catalog/common-catalog/get-sellable-items)\n\n<div class=\"note\">\n  <b>Nota:</b><br><br>\n    Por defecto, las llamadas API del catálogo devuelven artículos que están actualmente disponibles en la tienda en el momento de la solicitud. Para recuperar artículos que aún no están disponibles o que ya no lo están, incluya el parámetro <code>\"show_inactive_time_limited_items\": 1</code> en la solicitud del catálogo.\n</div>\n\n## Vender artículos\n\nPuede vender artículos utilizando los siguientes métodos:\n- Compra rápida: venda un código de artículo (SKU) varias veces.\n- Compra con cesta: el usuario añade artículos a la cesta, elimina artículos y actualiza cantidades dentro de un solo pedido.\n\nSi un artículo se compra utilizando moneda virtual en lugar de dinero real, utilice la llamada API [Crear pedido con artículo especificado comprado con moneda virtual](/es/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency). La interfaz de pago no es necesaria, ya que el cargo se procesa cuando se ejecuta la llamada API.\n\nPara la compra de artículos gratuitos, utilice la llamada API [Crear pedido con artículo gratuito especificado](/es/api/catalog/free-item/create-free-order-with-item) o la llamada API [Crear pedido con cesta gratuita](/es/api/catalog/free-item/create-free-order). La interfaz de pago no es necesaria: el pedido se establece inmediatamente con el estado <code>done</code>.\n\n### Compra rápida\n\nUtilice la llamada API del lado del cliente para [crear un pedido con un artículo especificado](/es/api/catalog/payment-client-side/create-order-with-item). La llamada devuelve un token utilizado para abrir la interfaz de pago.\n\n<div class=\"note\">\n  <b>Nota:</b><br><br>\n    La información de descuento está disponible para el usuario únicamente en la interfaz de pago. Los códigos promocionales no son compatibles.\n</div>\n\n### Compra con cesta\n\nLa configuración y compra de la cesta se puede realizar en el cliente o en el lado del servidor.\n\n**Configurar y comprar una cesta en el cliente**\n\nImplemente la lógica de añadir y eliminar artículos por usted mismo. Antes de llamar a la API para establecer una cesta, no tendrá información sobre qué promociones se aplicarán a la compra. Esto implica que el coste total y los detalles de los artículos de bonificación añadidos no se conocerán.\n\nImplemente la siguiente lógica de cesta:\n1. Después de que el jugador haya llenado una cesta, utilice la llamada API [Llenar la cesta con artículos](/es/api/shop-builder/operation/cart-fill/). La llamada devuelve la información actual sobre los artículos seleccionados (precios antes y después de descuentos y artículos de bonificación).\n2. Actualice el contenido de la cesta basándose en las acciones de los usuarios:\n   - Para añadir un artículo o cambiar la cantidad del artículo, utilice la llamada API [Actualizar artículo de la cesta por ID de la cesta](/es/api/shop-builder/operation/put-item-by-cart-id/).\n   - Para eliminar un artículo, utilice la llamada API [Eliminar artículo de la cesta por ID de la cesta](/es/api/shop-builder/operation/delete-item-by-cart-id/).\n\n<div class=\"note\">\n  <b>Nota:</b><br><br>\n    Para obtener el estado actual de la cesta, utilice la llamada API Obtener la cesta del usuario actual.\n</div>\n\n3. Utilice la llamada API [Crear pedido con todos los artículos de la cesta actual](/es/api/shop-builder/operation/create-order/). La llamada devuelve el ID del pedido y el token de pago. El pedido recién creado se establece por defecto con el estado <code>new</code>.\n\n**Configurar y comprar una cesta en el servidor**\n\nEsta opción de configuración puede requerir más tiempo para configurar la cesta, ya que cada modificación que se realice en ella debe ir acompañada de llamadas API.\n\nImplemente la siguiente lógica de cesta:\n1. Después de que el jugador haya llenado una cesta, utilice la llamada API [Llenar la cesta con artículos](/es/api/catalog/cart-server-side). La llamada devuelve la información actual sobre los artículos seleccionados (precios antes y después de descuentos, y artículos de bonificación).\n2. Utilice la llamada API [Crear pedido con todos los artículos de la cesta actual](/es/api/shop-builder/operation/create-order/). La llamada devuelve el ID del pedido y el token de pago. El pedido recién creado se establece por defecto con el estado <code>new</code>.\n\n## Abrir interfaz de pago\n\nUtilice el token devuelto para abrir la interfaz de pago en una nueva ventana. Otras formas de abrir la interfaz de pago se describen en la [documentación](/es/payment-ui-and-flow/payment-ui/how-to-open-payment-ui/#open_payment_ui).\n\n| Acción                          | Punto final                                                                  |\n|:--------------------------------|:--------------------------------------------------------------------------|\n| Abrir en entorno de producción. | <code>https://secure.xsolla.com/paystation4/?token={token}</code>         |\n| Abrir en modo sandbox.          | <code>https://sandbox-secure.xsolla.com/paystation4/?token={token}</code> |\n\n<div class=\"note\">\n  <b>Nota:</b><br><br>\n    Utilice el modo sandbox durante el desarrollo y las pruebas. Las compras de prueba no hacen cargos en cuentas reales. Puede usar <a href=\"https://developers.xsolla.com/es/dev-resources/testing/test-cards/\">tarjetas bancarias de prueba</a>.\n\n    Tras realizar el primer pago real, se aplica una política estricta de pagos en aislador de proceso (sandbox). Un pago en modo sandbox está disponible solo para los usuarios especificados en [Cuenta del Editor > Configuración de la empresa > Usuarios](https://publisher.xsolla.com/0/settings/users).\n\n    Comprar moneda virtual y artículos con moneda real es posible solamente después de firmar un acuerdo de licencia con Xsolla. Para hacerlo, en [Cuenta del editor](https://publisher.xsolla.com/), vaya a **Acuerdos e impuestos > Acuerdos**, rellene el formulario de acuerdo y espere la confirmación. La revisión del acuerdo puede tardar hasta tres\_días laborables.\n</div>\n\nPara habilitar o deshabilitar el modo sandbox, cambie el valor del parámetro `sandbox` en la solicitud para compra rápida y compra con cesta. El modo sandbox está desactivado por defecto.\n\nPosibles estados del pedido:\n- `new`: pedido creado\n- `paid`: pago recibido\n- `done`: artículo entregado\n- `canceled`: pedido cancelado\n- `expired`: pedido expirado\n\nHaga un seguimiento del estado del pedido usando uno de los siguientes métodos:\n- [webhooks configurados en su servidor](/es/virtual-goods/own-ui/server-side-token-generation/set-up-order-tracking/#payments_integration_order_tracking)\n- [sondeo corto](/es/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_short_polling)\n- [API de WebSocket](/es/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_websocket_api)\n\n## Enlaces útiles\n\n- Autenticación\n- [Llamadas API por modelo de interacción](/es/api/catalog/section/authentication)\n- [Pruebas de pago](/es/dev-resources/testing/general-info/#general_overview)\n- [Establecer el seguimiento del estado del pedido](/es/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/?link=200-api#payments_integration_order_tracking)\n- [Webhooks](/es/webhooks/overview)\n- [Límites de frecuencia](/es/api/login/rate-limits)\n- [Gestión de errores](/es/api/getting-started/#api_errors_handling)\n- [Claves de API](/es/api/getting-started/#api_keys_overview)\n\n# Paginación\n\nLas llamadas API que devuelven grandes conjuntos de registros (p.\_ej., al crear un catálogo) devuelven datos en páginas. La paginación es un mecanismo que limita el número de artículos devueltos en una sola respuesta de API y le permite recuperar páginas posteriores de manera secuencial.\n\nUtilice los siguientes artículos para controlar el número de artículos devueltos:\n\n- `limit` — número de artículos por página\n- `offset` — índice del primer artículo de la página (la numeración comienza desde 0)\n- `has_more` — indica si hay otra página disponible\n- `total_items_count` — número total de artículos\n\nEjemplo de solicitud:\n\n```\nGET /items?limit=20&offset=40\n```\n\nEjemplo de respuesta:\n\n```json\n{\n  \"items\": [...],\n  \"has_more\": true,\n  \"total_items_count\": 135\n}\n```\n\nSe recomienda enviar solicitudes posteriores hasta que la respuesta devuelva `has_more = false`.\n\n# Formato de fecha y hora\n\nLas fechas y valores de tiempo se transmiten en el formato [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).\n\nSe admiten los siguientes:\n\n- Desfase UTC (tiempo universal coordinado)\n- Valor `null` cuando no hay restricción de tiempo para mostrar un artículo\n- [Marca de tiempo Unix](https://www.unixtimestamp.com/) (en segundos) utilizada en algunos campos\n\nFormato: `AAAA-MM-DDTHH:MM:SS±HH:MM`\n\nEjemplo: `2026-03-16T10:00:00+03:00`\n\n# Localización\n\nXsolla admite la localización de campos visibles por el usuario, como el nombre y la descripción del artículo. Los valores localizados se transmiten como un objeto en el que el código de idioma se utiliza como la clave. La lista completa de idiomas admitidos está disponible en la [documentación](/es/doc/shop-builder/references/supported-languages/).\n\n**Campos admitidos**\n\nLa localización puede especificarse para los siguientes parámetros:\n\n- `name`\n- `description`\n- `long_description`\n\n**Formato de configuración regional**\n\nLa clave de configuración regional puede especificarse en uno de los siguientes formatos:\n\n- Código de idioma de dos\_letras: `en`, `ru`\n- Código de idioma de cinco\_letras: `en-US`, `ru-RU`, `de-DE`\n\n**Ejemplos**\n\nEjemplo con un código de idioma de dos\_letras:\n\n```json\n{\n  \"name\": {\n    \"en\": \"Starter Pack\",\n    \"ru\": \"Стартовый набор\"\n  }\n}\n```\n\nEjemplo con un código de idioma de cinco\_letras:\n\n```json\n{\n  \"description\": {\n    \"en-US\": \"Premium bundle\",\n    \"de-DE\": \"Premium-Paket\"\n  }\n}\n```\n\n# Formato de respuesta de error\n\nSi ocurre un error, la API devuelve un estado HTTP y un cuerpo de respuesta JSON. La lista completa de errores relacionados con la tienda está disponible en la [documentación](/es/dev-resources/references/errors/store-errors/).\n\n**Ejemplo de respuesta:**\n\n```json\n{\n  \"errorCode\": 1102,\n  \"errorMessage\": \"Validation error\",\n  \"statusCode\": 422,\n  \"transactionId\": \"c9e1a...\"\n}\n```\n\n- `errorCode` — código de error.\n- `errorMessage` — descripción breve del error.\n- `statusCode` — estado de la respuesta HTTP.\n- `transactionId` — ID de la solicitud. Se devuelve solo en algunos casos.\n- `errorMessageExtended` — detalles adicionales del error, como los parámetros de la solicitud. Se devuelve solo en algunos casos.\n\n**Ejemplo de respuesta ampliada:**\n\n```json\n{\n  \"errorCode\": 7001,\n  \"errorMessage\": \"Chain not found\",\n  \"errorMessageExtended\": {\n    \"chain_id\": \"test_chain_id\",\n    \"project_id\": \"test_project_id\",\n    \"step_number\": 2\n  },\n  \"statusCode\": 404\n}\n```\n\n**Códigos de estado HTTP habituales**\n\n- `400` — solicitud no válida\n- `401` — error de autenticación\n- `403` — permisos insuficientes\n- `404` — recurso no encontrado\n- `422` — error de validación\n- `429` — límite de frecuencia excedido\n\n**Recomendaciones**\n\n- Gestione el estado HTTP y el cuerpo de la respuesta juntos.\n- Utilice `errorCode` para procesar errores relacionados con la lógica de la aplicación.\n- Utilice `transactionId` para identificar solicitudes más rápidamente al analizar errores."
  version: 2.0.0
  title: API de catálogo
servers:
  - url: https://store.xsolla.com/api
tags:
  - name: virtual-items-currency-overview
    x-displayName: Descripción general
    description: >-
      Puede usar artículos virtuales y moneda virtual para crear una tienda
      dentro del juego y configurar cómo se muestra a los usuarios. Los
      siguientes tipos de artículos están disponibles:


      * Artículos virtuales: productos dentro del juego como armas, apariencias
      o potenciadores. Pueden venderse por dinero real o moneda virtual.

      * Moneda virtual: moneda del juego utilizada para comprar artículos
      virtuales. Puede venderse por dinero real o moneda virtual.

      * Paquetes de moneda virtual: una cantidad fija de moneda virtual. Puede
      venderse por dinero real o moneda virtual.


      Los grupos sirven para organizar los artículos en el catálogo. Permiten
      agrupar de forma lógica los artículos y gestionar cómo se muestran.


      Utilice las llamadas API de la subsección <b>Admin</b> para crear,
      actualizar y eliminar artículos.


      Utilice las llamadas API de la subsección <b>Catálogo</b> para recuperar
      listas de artículos y mostrarlas a los usuarios.


      <div class="notice">
        <b>Aviso</b><br><br>
          No utilice las llamadas API de la subsección <b>Admin</b> para crear un catálogo de tienda.
      </div>


      <br>


      <div class="note">
        <b>Nota:</b><br><br>
          La llamada API <a href="https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-items" target="_blank">Obtener lista de artículos virtuales</a> devuelve datos detallados de los artículos, incluidos precios y atributos, y admite paginación. Utilícela para mostrar páginas de catálogo en la tienda.
          <br><br>
          La llamada API <a href="https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-all-virtual-items" target="_blank">Obtener lista de todos los artículos virtuales</a> devuelve SKU, nombre y descripción del artículo, así como ID de grupo y nombre sin paginación. Úsela para la búsqueda o indexación en el lado del cliente.
      </div>


      <br>


      Para hacer compras con moneda virtual, utilice la llamada API [Crear
      pedido con artículo especificado comprado mediante moneda
      virtual](/es/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency).
      La interfaz de pago no es necesaria: el cargo se procesa cuando se ejecuta
      la llamada API.


      <b>Ejemplo de un flujo de compra con moneda virtual:</b>


      ![Ejemplo de flujo de compra con moneda
      virtual](https://cdn.xsolla.net/developers/current/images/api_docs/virtual-items-currency-overview.png)
  - name: virtual-items-currency-admin
    x-displayName: Admin
  - name: virtual-items-currency-catalog
    x-displayName: Catálogo
  - name: virtual-payment
    x-displayName: Pago virtual
  - name: game-keys-overview
    x-displayName: Descripción general
    description: >-
      Las claves de juego son códigos alfanuméricos únicos de un solo uso que
      permiten a los usuarios acceder a un juego o a contenido descargable (DLC)
      en las plataformas de videojuegos. Puede vender claves de juego a través
      de un [enlace
      directo](/es/sell-games/set-up-selling-game-keys/#guides_game_sales_selling_game_keys_selling_via_direct_link),
      mediante la [interfaz de la
      tienda](/es/sell-games/set-up-selling-game-keys/#guides_game_sales_selling_game_keys_selling_via_store_ui)
      o mediante un
      [widget](/es/sell-games/set-up-selling-game-keys/#guides_game_sales_selling_items_develop_buttons).
      También puede [configurar restricciones
      regionales](/es/items-catalog/catalog-features/regional-restrictions/)
      para vender claves de juego en países específicos. Para obtener
      información detallada, consulte la sección [Paquetes de claves de
      juego](https://developers.xsolla.com/es/items-catalog/items-type/set-up-modules/).


      No es necesario autenticarse para vender claves de juego: las claves se
      envían a la dirección de correo electrónico que el usuario haya indicado
      al realizar la compra. Puede configurar la autenticación para habilitar
      otras opciones:
      [personalización](/es/liveops/liveops-management/personalization-tutorial/),
      [límites de
      compra](/es/items-catalog/catalog-features/items-catalog-number-limits/) o
      un [sistema de derechos](/es/sell-games/how-to/entitlement-system/). Para
      obtener información detallada, consulte la sección [Cómo establecer la
      autenticación al vender claves de
      juego](/es/sell-games/how-to/set-up-authentication/).


      Flujo de ventas de claves de juego:


      1. Cree un juego mediante la llamada API [Crear
      juego](/es/api/catalog/game-keys-admin/admin-create-game).

      2. Configure restricciones regionales.

      3. Suba las claves a un paquete de claves de juego mediante la llamada API
      [Cargar
      códigos](/es/api/catalog/game-keys-admin/admin-upload-codes-by-sku) para
      que estén disponibles para su compra.

      4. Muestre el catálogo de juegos con los precios correspondientes a la
      región del usuario mediante la llamada API [Obtener lista de
      juegos](/es/api/catalog/game-keys-catalog/get-games-list).

      5. Cree un pedido. Para una compra rápida, puede utilizar la llamada API
      [Crear pedido con todos los artículos de la cesta
      actual](/es/api/catalog/payment-client-side/create-order-with-item),
      transmitiendo el SKU de la clave de juego. La respuesta devuelve un token
      para abrir la interfaz de pago.

      6. Implemente la apertura de la interfaz de pago para pagar el pedido.


      Para recibir notificaciones inmediatas de los pagos completados y entregar
      los artículos al usuario, configure el seguimiento del estado de los
      pedidos, por ejemplo, mediante [webhooks](/es/webhooks). Las claves se
      envían al correo electrónico que el usuario ha indicado al realizar la
      compra y el pedido pasa al estado `done`.


      ![Claves de
      juego](https://cdn.xsolla.net/developers/current/images/api_docs/game-keys.svg)
  - name: game-keys-catalog
    x-displayName: Catálogo
  - name: game-keys-entitlement
    x-displayName: Derechos
  - name: game-keys-admin
    x-displayName: Admin
  - name: bundles-overview
    x-displayName: Descripción general
    description: >-
      Los lotes son conjuntos de artículos que se venden como una sola unidad.
      Un lote puede incluir artículos virtuales, moneda virtual, paquetes de
      moneda virtual, claves de juego y otros lotes. Utilice los lotes para
      crear paquetes de bienvenida, ofertas de temporada y promociones
      especiales.


      Utilice los siguientes grupos de llamadas API para trabajar con lotes:


      * Utilice las llamadas API de la subsección <b>Admin</b> para crear,
      actualizar y eliminar lotes, así como para gestionar su visibilidad.

      * Utilice las llamadas API de la subsección <b>Catalog</b> para obtener
      lotes.


      Los límites de compra se configuran a través del objeto `limits` al crear
      o actualizar un lote. Para obtener más información, consulte la
      descripción general de [Límites](/es/api/catalog/limits-overview). También
      puede configurar [restricciones
      regionales](https://developers.xsolla.com/es/items-catalog/catalog-features/regional-restrictions/)
      para vender artículos en países específicos.


      <div class="note">
        <b>Nota</b><br><br>
          Para obtener información detallada sobre la configuración de lotes, consulte la sección <a href="https://developers.xsolla.com/es/items-catalog/items-type/bundles/" target="_blank">Lotes</a>.
      </div>


      <br>


      <b>Gestión de lotes:</b>


      1. Cree un lote mediante la llamada API [Crear
      lote](/es/api/catalog/bundles-admin/admin-create-bundle). Para comprobar
      el lote creado, utilice la llamada API [Obtener
      lote](/es/api/catalog/bundles-admin/admin-get-bundle). Para obtener todos
      los lotes del proyecto, utilice la llamada API [Obtener lista de
      lotes](/es/api/catalog/bundles-admin/admin-get-bundle-list).

      2. Si es necesario, utilice la llamada API [Actualizar
      lote](/es/api/catalog/bundles-admin/admin-update-bundle)  para modificar
      el contenido o la configuración del lote.

      3. Implemente la lógica de visualización de los lotes en su escaparate
      utilizando la llamada API [Obtener lista de
      lotes](/es/api/catalog/bundles-catalog/get-bundle-list), [Obtener lote
      especificado](/es/api/catalog/bundles-catalog/get-bundle) u [Obtener lista
      de lotes por grupo
      especificado](/es/api/catalog/bundles-catalog/get-bundle-list-in-group).

      4. Cree un pedido utilizando la sección [Cesta y
      pago](/es/api/catalog/cart-and-payment-overview). Por ejemplo, para una
      compra rápida, puede utilizar la llamada API [Crear pedido con un artículo
      especificado](/es/api/catalog/payment-client-side/create-order-with-item),
      transmitiendo el SKU del lote. La respuesta contiene un token para abrir
      la interfaz de pago.

      5. Implemente la apertura de la interfaz de pago para pagar el pedido.

      6. Configure el seguimiento del estado del pedido, por ejemplo, utilizando
      [webhooks](https://developers.xsolla.com/es/webhooks/overview), para
      recibir rápidamente los datos sobre los artículos pagados y concedérselos
      al usuario.


      ![Gestión de
      lotes](https://cdn.xsolla.net/developers/current/images/api_docs/bundles.png)
  - name: bundles-admin
    x-displayName: Admin
  - name: bundles-catalog
    x-displayName: Catálogo
  - name: cart-and-payment-overview
    x-displayName: Descripción general
    description: "La cesta es un mecanismo de compra que permite combinar múltiples artículos en un solo pedido. Un usuario puede comprar artículos de cualquier tipo en cualquier cantidad con moneda real, así como usar [códigos promocionales](https://developers.xsolla.com/es/api/liveops/promotions-promo-codes).\n\nLa cesta se almacena en el lado de Xsolla. El almacenamiento de la cesta entre sesiones depende de si el usuario está autorizado:\n  * En el caso de los usuarios autorizados, la cesta está vinculada a un usuario concreto y se guarda entre sesiones siempre que las solicitudes se envíen en nombre del mismo usuario.\n\n  * Para los [usuarios no autorizados](/es/api/catalog/section/authentication/authentication-with-guest-access-support), guardar la cesta depende de que se transmita el encabezado `x-unauthorized-id`. Para guardar la cesta de un usuario no autorizado entre sesiones, transmita el mismo `x-unauthorized-id` en cada solicitud. Esta opción solo está disponible para la venta de claves de juego.\n\nPuede identificar la cesta de dos formas: automáticamente mediante el [JWT del usuario](https://developers.xsolla.com/es/api/catalog/section/authentication/authentication-using-user's-jwt) o mediante el ID de la cesta (`cart_id`).\n\nLa gestión de la cesta está disponible tanto en el lado del cliente como en el lado del servidor.\n\nEn el lado del servidor, puede llenar la cesta con artículos; p.\_ej., al restaurar una sesión de usuario. Las siguientes acciones están disponibles en el lado del cliente:\n\n* recuperar el carrito del usuario actual o una cesta mediante ID\n* llenar la cesta\n* actualizar artículos en la cesta\n* eliminar artículos de la cesta\n\nPara comprar artículos de la cesta, se usan llamadas del cliente y del servidor para la creación de pedidos.\n\nEl tiempo de vida (TTL) de la cesta es de 72 horas por defecto. Si su contenido cambia, por ejemplo, al añadir un artículo nuevo, el TTL se prolonga.\n\nUna vez realizado el pago correctamente, la cesta no se vacía automáticamente. Para vaciar la cesta, utilice las siguientes llamadas API del lado del cliente:\n  * [Eliminar todos los artículos de la cesta por el ID de la cesta](/es/api/catalog/cart-client-side/cart-clear-by-id).\n\n  * [Eliminar todos los artículos de la cesta actual](/es/api/catalog/cart-client-side/cart-clear).\n\n  * [Eliminar artículo de la cesta por ID de la cesta](/es/api/catalog/cart-client-side/delete-item-by-cart-id) y [Eliminar artículo de la cesta actual](/es/api/catalog/cart-client-side/delete-item): la cesta se vacía cuando se elimina el último artículo de la misma.\n\nEscenario de uso de la cesta:\n\n1. Implemente una interfaz de tienda en la que el usuario pueda seleccionar artículos.\n\n2. Cuando el usuario seleccione artículos en la tienda, añádalos a la cesta, por ejemplo, utilizando la llamada [Llenar la cesta con artículos](https://developers.xsolla.com/es/api/catalog/cart-client-side/cart-fill). En la matriz de artículos, debe transmitir los SKU y la cantidad requerida de artículos.\n\n3. Implemente la interfaz de visualización de la cesta. Cuando el usuario acceda a la cesta, muestre su contenido mediante la llamada [Obtener la cesta del usuario actual](https://developers.xsolla.com/es/api/catalog/cart-client-side/get-user-cart). La respuesta proporcionará información sobre el precio final de los artículos, incluidos los descuentos y las promociones aplicadas.\n\n4. Implemente la apertura de la interfaz de pago para abonar el pedido. Por ejemplo, puede utilizar la llamada [Crear pedido con todos los artículos de la cesta](https://developers.xsolla.com/es/api/catalog/payment-client-side/create-order-by-cart-id). La respuesta devuelve un token para abrir la interfaz de pago.\n\n5. Configure el seguimiento del estado de los pedidos, por ejemplo, mediante [webhooks](https://developers.xsolla.com/es/webhooks/), para recibir sin demora los datos sobre los artículos cuyo pago se ha completado correctamente y concedérselos al usuario.\n\n<div class=\"note\">\n  <p><b>Nota:</b></p>\n  <p>Para implementar la venta de artículos dentro del juego y en línea, consulte la <a href=\"https://developers.xsolla.com/es/virtual-goods/own-ui/\">guía de integración</a>.</p>\n</div>\n\n![Cesta y flujo de pago](https://cdn.xsolla.net/developers/current/images/api_docs/cart-payment-flow.svg)"
  - name: order-life-cycle
    x-displayName: Ciclo de vida del pedido
    description: "Comprender el ciclo de vida de un pedido le ayuda a [hacer un seguimiento de los pedidos](https://developers.xsolla.com/es/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/?tabs=100-trackOrderOnClient_200-api&_xm=4170963201673921623) y a aplicar correctamente la lógica posterior a la compra, como, p.\_ej., la entrega de los artículos.\n\nEl pedido atraviesa los siguientes estados:\n\n<table>\n  <thead>\n  <tr>\n     <td>Estado</td>\n     <td>Descripción</td>\n     <td>Notas</td>\n  </tr>\n  </thead>\n  <tbody>\n    <tr>\n     <td> <code>new</code> </td>\n     <td>Se creó el pedido. El sistema está a la espera de la confirmación del pago.</td>\n     <td>Las descripciones del estado de las transacciones pueden encontrarse en la <a href=\"https://developers.xsolla.com/es/api/pay-station/reports/find-transactions#reports/find-transactions/t=request&in=query&path=status\">documentación de la API de Pay Station</a>.</td>\n    </tr>\n    <tr>\n     <td> <code>paid</code> </td>\n     <td>El pedido se ha pagado (la transacción ha pasado al estado <code>done</code>), y ya se puede entregar el artículo al usuario. </td>\n     <td>El pedido seguirá en el estado <code>new</code> hasta que se confirme el pago. </td>\n    </tr>\n    <tr>\n     <td> <code>done</code> </td>\n     <td>El artículo se concede al usuario. </td>\n     <td> — </td>\n    </tr>\n    <tr>\n     <td> <code>canceled</code> </td>\n     <td>TSe reembolsó el pago. </td>\n     <td>El pedido pasa a este estado cuando el estado de la transacción <a href=\"https://developers.xsolla.com/es/api/pay-station/reports/find-transactions#reports/find-transactions/t=request&in=query&path=status\"> </a> cambia a <code>refunded</code>. </td>\n    </tr>\n    <tr>\n     <td> <code>expired</code> </td>\n     <td> Al crear un nuevo pedido que incluya un artículo <a href=\"https://developers.xsolla.com/es/api/catalog/limits-overview\">limitado</a>, un código promocional o una promoción, cualquier pedido anterior pendiente de pago que contenga dicho artículo pasará al estado <code>expired</code> status. Solo se podrá pagar el pedido más reciente. </td>\n     <td>Si un usuario intenta pagar un pedido expirado, la interfaz de pago mostrará un error <code>2002</code>, y el pago será rechazado. </td>\n    </tr>\n  </tbody>\n</table>\n\n![Ciclo de vida del pedido](https://cdn.xsolla.net/developers/current/images/api_docs/order-life-cycle.svg)\n\n<div class=\"note\">\n  <p><b>Nota:</b></p>\n  <p>Cuando el pedido pasa al estado <code>expired</code> mientras el usuario está realizando el pago, pero el pago se realiza correctamente, el pedido pasa de <code>expired</code> al estado <code>paid</code>. Esto solamente se aplica si, al realizar el pago, no se supera el límite de compra del artículo del pedido.</p>\n</div>"
  - name: cart-client-side
    x-displayName: Cesta (lado del cliente)
    description: >-
      Utilice las llamadas de esta sección para gestionar la cesta en el lado
      del cliente.
  - name: cart-server-side
    x-displayName: Cesta (lado del servidor)
    description: >-
      Utilice las llamadas de esta sección para gestionar la cesta en el lado
      del servidor.
  - name: payment-client-side
    x-displayName: Pago (lado del cliente)
    description: >-
      Utilice las llamadas de esta sección para crear un token de pago en el
      lado del cliente.
  - name: payment-server-side
    x-displayName: Pago (lado del servidor)
    description: >-
      Utilice las llamadas de esta sección para crear un token de pago en el
      lado del servidor.
  - name: order
    x-displayName: Pedido
    description: >-
      Utilice las llamadas de esta sección para obtener información sobre los
      pedidos.
  - name: free-item
    x-displayName: Artículos gratuitos
    description: >-
      Utilice las llamadas de esta sección para conceder <a
      href="https://developers.xsolla.com/es/items-catalog/catalog-features/free-items/">artículos
      gratuitos</a> a los usuarios.
  - name: limits-overview
    x-displayName: Descripción general
    description: >-
      Los límites de compra permiten restringir la cantidad de artículos
      disponibles para la compra por un solo usuario o por todos los usuarios.
      También puede configurar restablecimientos programados de límites.


      Los límites se almacenan en el lado de Xsolla y se configuran a nivel de
      artículo individual en la [Cuenta del
      editor](https://publisher.xsolla.com/0/projects/0/storefront/virtual-items)
      o a través del objeto `limits` en las siguientes llamadas API:

      * [Crear artículo
      virtual](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-item)

      * [Crear juego](/es/api/catalog/game-keys-admin/admin-create-game)

      * [Crear moneda
      virtual](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency)

      * [Crear paquete de moneda
      virtual](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency-package)

      * [Crear lote](/es/api/catalog/bundles-admin/admin-create-bundle)


      La información de los límites se devuelve en el objeto `items.limits` en
      las siguientes llamadas API para recuperar el catálogo de artículos:

      * [Obtener lista de artículos
      virtuales](/es/api/catalog/virtual-items-currency-catalog/get-virtual-items)

      * [Obtener lista de monedas
      virtuales](/es/api/catalog/virtual-items-currency-catalog/get-virtual-currency)

      * [Obtener lista de paquetes de moneda
      virtual](/es/api/catalog/virtual-items-currency-catalog/get-virtual-currency-packages)

      * [Obtener lista de
      lotes](/es/api/catalog/bundles-catalog/get-bundle-list)

      * [Obtener lista de
      juegos](/es/api/catalog/game-keys-catalog/get-games-list)


      Las llamadas de API en la subsección **Gestión** del grupo **Límites** le
      permiten recuperar el estado actual de los límites y actualizarlos para un
      usuario específico; por ejemplo, reiniciar el contador después de realizar
      una misión o ajustar manualmente la cantidad restante.


      <div class="note">
        <b>Nota:</b><br><br>
        Para obtener información detallada sobre cómo configurar límites en el catálogo, consulte la sección <a href="/es/items-catalog/catalog-features/items-catalog-number-limits/">Límites de compra de artículos</a>.
      </div>


      ## Tipos de límites


      Puede configurar los siguientes tipos de límites:

      *
      [limits.per_item](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-item#virtual-items-currency-admin/admin-create-virtual-item/t=request&path=limits/per_item):
      un límite global de compra de artículos. Define la cantidad máxima que
      todos los usuarios pueden comprar en total.

      *
      [limits.per_user](/es/api/catalog/virtual-items-currency-admin/admin-create-virtual-item#virtual-items-currency-admin/admin-create-virtual-item/t=request&path=limits/per_user):
      un límite de compra para un solo usuario:
          * Los usuarios no autenticados siempre ven la cantidad máxima de artículos que pueden comprar.
          * Los usuarios autenticados ven la cantidad restante con el límite activo aplicado.

      Las siguientes configuraciones adicionales están disponibles para
      `limits.per_user`:

      *
      [limits.recurrent_schedule](/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-currencies-list#virtual-items-currency-admin/admin-get-virtual-currencies-list/t=response&c=200&path=items/limits/recurrent_schedule):
      el periodo de restablecimiento programado del límite: diario, semanal o
      mensual.

      *
      [limits.per_user.limit_exceeded_visibility](/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-currencies-list#virtual-items-currency-admin/admin-get-virtual-currencies-list/t=response&c=200&path=items/limits/per_user/limit_exceeded_visibility):
      si el artículo permanece visible en el catálogo tras alcanzar el límite de
      compra. Disponible solo cuando `limits.recurrent_schedule` está
      configurado.


      ## Escenario de configuración y aplicación de límites


      El siguiente ejemplo describe un escenario para configurar un límite de
      compra para un usuario específico. El artículo está configurado con
      `limit_exceeded_visibility: ocultar` (una vez alcanzado el límite, el
      artículo ya no se devuelve en las llamadas API para recuperar el catálogo
      hasta el próximo restablecimiento programado).


      1. Crea artículos utilizando las llamadas API de la subsección **Admin**
      de los grupos [Artículos virtuales y
      moneda](/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/),
      [Lotes](/es/api/catalog/bundles-admin/admin-create-bundle) o [Claves del
      juego](/es/api/catalog/game-keys-admin) y transmite el objeto `limits`.


      ```json

      {
        "limits": {
          "per_user": {
            "total": 5,
            "limit_exceeded_visibility": "hide"
          },
          "recurrent_schedule": {
              "per_user": {
                "interval_type": "weekly",
                "time": "10:00:00+08:00",
                "day_of_week": 5
              }
          }
        }
      }

      ```


      2. Solicita el catálogo para un usuario no autenticado: la respuesta
      devuelve la cantidad máxima de artículos que puede comprar.

      3. El usuario inicia sesión.

      4. Solicita el catálogo con los datos de autorización del usuario: la
      respuesta devuelve la cantidad restante de artículos con el límite activo
      aplicado.

      5. El usuario selecciona un artículo y realiza una compra.

      6. Después del pago realizado correctamente, Xsolla actualiza el valor de
      `per_user`. Cuando `per_user` alcanza `0`, el artículo ya no se devuelve
      en las llamadas API para recuperar el catálogo para ese usuario.

      7. Puede actualizar el límite utilizando las llamadas API de la subsección
      **Gestión**: [Actualizar todos los límites de compra para el
      usuario](/es/api/catalog/user-limits-admin/reset-all-user-items-limit/),
      [Establecer un valor
      específico](/es/api/catalog/user-limits-admin/set-user-item-limit/),
      [Aumentar](/es/api/catalog/user-limits-admin/add-user-item-limit/), o
      [Disminuir la cantidad
      disponible](/es/api/catalog/user-limits-admin/remove-user-item-limit/).

      8. Recuperará el valor actualizado del límite en `items.limits` cuando se
      realice la siguiente solicitud de catálogo con los datos de autorización
      del usuario y se lo mostrará al usuario.


      ![Límites de
      artículos](https://cdn.xsolla.net/developers/current/images/api_docs/api-item-limits.png)
  - name: user-limits-admin
    x-displayName: Gestión
  - name: connector-admin
    x-displayName: Admin
  - name: common-pre-orders
    x-displayName: Pedidos anticipados
  - name: common-merchant
    x-displayName: Comerciante
  - name: common-catalog
    x-displayName: Catálogo
    description: >-
      Esta API permite obtener cualquier tipo de artículo vendible o artículo
      específico.
  - name: common-regions
    x-displayName: Regiones comunes
  - name: attribute-admin
    x-displayName: Admin
  - name: item-groups-admin
    x-displayName: Admin
  - name: item-groups-catalog
    x-displayName: Catálogo
  - name: common-webhooks
    x-displayName: Webhooks
paths:
  /v2/project/{project_id}/admin/items/virtual_items:
    get:
      summary: Obtener lista de artículos virtuales
      description: >-
        Obtiene la lista de artículos virtuales 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>
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - virtual-items-currency-admin
      operationId: admin-get-virtual-items-list
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-items
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
    post:
      summary: Crear artículo virtual
      description: Crea un artículo virtual.
      security:
        - basicAuth: []
      operationId: admin-create-virtual-item
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - virtual-items-currency-admin
      requestBody:
        description: |-
          <div class="note">
              <b>Nota:</b><br><br>
                El esquema del cuerpo de la solicitud incluye parámetros opcionales para casos de uso avanzados, como el establecimiento de precios regionales, límites de compra y disponibilidad por tiempo limitado. Para crear un artículo básico, facilite los parámetros <code>sku</code>, <code>name</code> y <code>description</code>. Para establecer precios en moneda real, proporcione el parámetro <code>prices</code> para moneda virtual,  <code>vc_prices</code>. Para que el artículo sea gratuito, establezca <code>is_free: true</code>.
          </div>

          <br>
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-item
      responses:
        '201':
          $ref: '#/components/responses/Virtual-Items-Currency_201-created'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
  /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}:
    get:
      summary: >-
        Obtener lista de artículos virtuales por ID externo del grupo
        especificado
      description: >-
        Obtiene la lista de artículos virtuales de un grupo para su
        administración.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - virtual-items-currency-admin
      operationId: admin-get-virtual-items-list-by-group-external-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-items-by-group
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}:
    get:
      summary: Obtener la lista de artículos virtuales por ID del grupo especificado
      description: >-
        Obtiene la lista de artículos virtuales de un grupo para su
        administración.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/group_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - virtual-items-currency-admin
      operationId: admin-get-virtual-items-list-by-group-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-items-by-group
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}:
    get:
      summary: Obtener artículo virtual
      description: >-
        Obtiene el artículo virtual dentro de un proyecto para su
        administración.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      operationId: admin-get-virtual-item
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - virtual-items-currency-admin
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-admin-get-item'
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
    put:
      summary: Actualizar artículo virtual
      description: Actualiza un artículo virtual.
      operationId: admin-update-virtual-item
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - virtual-items-currency-admin
      requestBody:
        description: |-
          <div class="note">
            <b>Nota:</b><br><br>
              El esquema del cuerpo de la solicitud incluye tanto parámetros obligatorios como opcionales para casos de uso avanzados, como el establecimiento de precios regionales, límites de compra y disponibilidad por tiempo limitado.
          </div>

          <br>

          <div class="notice">
            <b>Aviso:</b><br><br>
              Transmita todos los parámetros del artículo, incluidos aquellos que no requieren actualización. Los parámetros que se omitan en la solicitud serán eliminados.
          </div>

          <br>
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-item
      responses:
        '204':
          description: El artículo virtual se actualizó correctamente.
          content: {}
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
    delete:
      summary: Borrar artículo virtual
      description: Elimina un artículo virtual.
      operationId: admin-delete-virtual-item
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - virtual-items-currency-admin
      responses:
        '204':
          description: El artículo virtual se eliminó correctamente.
          content: {}
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/virtual_currency:
    get:
      summary: Obtener lista de monedas virtuales
      description: >-
        Obtiene la lista de monedas virtuales dentro de un proyecto para su
        administración.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - virtual-items-currency-admin
      operationId: admin-get-virtual-currencies-list
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-currencies
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
    post:
      summary: Crear moneda virtual
      operationId: admin-create-virtual-currency
      security:
        - basicAuth: []
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      description: Crea una moneda virtual.
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - virtual-items-currency-admin
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-currency
      responses:
        '201':
          $ref: '#/components/responses/Virtual-Items-Currency_201-created'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
  /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}:
    get:
      summary: Obtener moneda virtual
      description: >-
        Obtiene la 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>
      operationId: admin-get-virtual-currency
      security:
        - basicAuth: []
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - virtual-items-currency-admin
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-currency
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item'
    put:
      summary: Actualizar la moneda virtual
      description: Actualiza una moneda virtual.
      operationId: admin-update-virtual-currency
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
      tags:
        - virtual-items-currency-admin
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-currency
      responses:
        '204':
          description: La moneda virtual se actualizó correctamente.
          content: {}
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
    delete:
      summary: Eliminar moneda virtual
      description: Elimina una moneda virtual.
      operationId: admin-delete-virtual-currency
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
      tags:
        - virtual-items-currency-admin
      responses:
        '204':
          description: La moneda virtual se eliminó correctamente.
          content: {}
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/virtual_currency/package:
    get:
      summary: Obtener lista de paquetes de moneda virtual (admin)
      description: >-
        Obtiene la lista de paquetes de moneda virtual dentro de un proyecto
        para su administración.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - virtual-items-currency-admin
      operationId: admin-get-virtual-currency-packages-list
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-currency-packages
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
    post:
      summary: Crear un paquete de moneda virtual
      description: Crea un paquete de moneda virtual.
      security:
        - basicAuth: []
      operationId: admin-create-virtual-currency-package
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - virtual-items-currency-admin
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-currency-package
      responses:
        '201':
          $ref: '#/components/responses/Virtual-Items-Currency_201-created'
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
  /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}:
    put:
      summary: Actualizar el paquete de moneda virtual
      description: Actualiza un paquete de moneda virtual.
      operationId: admin-update-virtual-currency-package
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - virtual-items-currency-admin
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-currency-package
      responses:
        '204':
          description: El artículo virtual se actualizó correctamente.
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
    delete:
      summary: Eliminar el paquete de moneda virtual
      description: Elimina un paquete de moneda virtual.
      operationId: admin-delete-virtual-currency-package
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - virtual-items-currency-admin
      responses:
        '204':
          description: El paquete de moneda virtual se actualizó correctamente.
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
    get:
      summary: Obtener el paquete de moneda virtual
      description: >-
        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>
      operationId: admin-get-virtual-currency-package
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - virtual-items-currency-admin
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-currency-package
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
  /v2/project/{project_id}/items/virtual_items:
    get:
      summary: Obtener lista de artículos virtuales
      description: "Obtiene una lista de artículos virtuales para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Aviso:</strong><br><br>\n    Todos los proyectos tienen la limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>límite</b>\n    y <b>offset</b>.\n</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>\n\n<br> <b>Ver también:</b> La llamada API <a href=\"https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-all-virtual-items\" target=\"_blank\">Obtener la lista de todos los artículos virtuales</a> para búsqueda o indexación en el lado del cliente."
      security:
        - XsollaLoginUserJWT: []
      operationId: get-virtual-items
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-get-items-list'
  /v2/project/{project_id}/items/virtual_items/sku/{item_sku}:
    get:
      summary: Obtener artículo virtual por SKU
      description: |-
        Obtiene un artículo virtual por SKU para crear un catálogo.

        <div class="note">
          <strong>Aviso:</strong><br><br>
            Esta llamada API devuelve datos genéricos del
            catálogo de artículos cuando se usa sin autorización. Utilice la autorización para recuperar
            datos de usuario <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">personalizados</a>, como límites y promociones asociadas al artículo.
            Para hacerlo, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el <b>bloque de Seguridad</b>
            para esta llamada.
        </div>
      operationId: get-virtual-items-sku
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-get-item-by-sku'
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item'
  /v2/project/{project_id}/items/virtual_items/all:
    get:
      summary: Obtener la lista de todos los artículos virtuales
      description: >-
        Obtiene una lista de todos los artículos virtuales para hacer búsquedas
        en el lado del cliente.


        <div class="notice">
          <strong>Aviso:</strong><br><br>
            Devuelve solo el SKU del artículo, nombre, grupos y descripción.
        </div>


        <br>


        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>

        <br> <b>Vea también:</b> La llamada API <a
        href="https://developers.xsolla.com/es/api/catalog/virtual-items-currency-catalog/get-virtual-items"
        target="_blank">Obtener lista de artículos virtuales</a> para recuperar
        datos detallados del artículo con paginación.
      security:
        - XsollaLoginUserJWT: []
      operationId: get-all-virtual-items
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-get-all-items-list'
  /v2/project/{project_id}/items/virtual_currency:
    get:
      summary: Obtener lista de monedas virtuales
      description: "Obtiene una lista de monedas virtuales para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      operationId: get-virtual-currency
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency-list
  /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}:
    get:
      summary: Obtener moneda virtual por SKU
      description: |-
        Obtiene una moneda virtual por SKU para crear un catálogo.

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      operationId: get-virtual-currency-sku
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency
  /v2/project/{project_id}/items/virtual_currency/package:
    get:
      summary: Obtener la lista de paquetes de moneda virtual
      description: "Obtiene una lista de paquetes de moneda virtual para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      operationId: get-virtual-currency-package
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency-packages-list
  /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}:
    get:
      summary: Obtener paquete de moneda virtual por SKU
      description: |-
        Obtiene paquetes de moneda virtual por SKU para crear un catálogo.

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      operationId: get-virtual-currency-package-sku
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_package_sku-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency-package
  /v2/project/{project_id}/items/virtual_items/group/{external_id}:
    get:
      summary: Obtener lista de artículos por grupo especificado
      description: "Obtiene una lista de artículos del grupo especificado para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      operationId: get-virtual-items-group
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-items-by-group-id
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item-group'
  /v2/project/{project_id}/items/virtual_currency/group/{external_id}:
    get:
      summary: Obtener lista de moneda virtual por grupo especificado
      description: "Obtiene una lista de monedas virtuales del grupo especificado para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      operationId: get-virtual-currency-group
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency-by-group-id
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item-group'
  /v2/project/{project_id}/items/virtual_currency/package/group/{external_id}:
    get:
      summary: Obtener lista de paquetes de moneda virtual por grupo especificado
      description: "Obtiene una lista de paquetes de moneda virtual del grupo especificado para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      operationId: get-virtual-currency-package-group
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - virtual-items-currency-catalog
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency-packages-by-group-id
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item-group'
  /v2/project/{project_id}/items/groups:
    get:
      summary: Obtener lista de grupos de artículos
      description: >-
        Recupera una lista de grupos de artículos para crear un catálogo sin
        paginación.


        <div class="note"><b>Nota:</b><br><br>El uso de las llamadas API del
        catálogo de artículos está disponible sin autorización, pero para
        obtener un <a
        href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/"
        target="_blank">catálogo personalizado</a> debe transmitir el JWT del
        usuario en el encabezado Authorization.</div>
      operationId: get-item-groups
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/with_geo-query-param'
      tags:
        - item-groups-catalog
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-get-items-groups'
  /v2/project/{project_id}/admin/items/groups:
    get:
      summary: Obtener lista de grupos de artículos
      description: >-
        Recupera la lista completa de grupos de artículos dentro de un proyecto
        sin paginación. Para fines administrativos.


        <div class="note"><b>Nota:</b><br><br>No utilice este punto final para
        crear un catálogo de tienda. Use, en su lugar, el punto final del lado
        del cliente <a
        href="/es/api/catalog/item-groups-catalog/get-item-groups">Obtener lista
        de grupos de artículos</a>.</div>
      operationId: admin-get-item-group-list
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - item-groups-admin
      responses:
        '200':
          $ref: '#/components/responses/ItemGroup_200-admin-get-group-list'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
    post:
      summary: Crear grupo de artículos
      description: >-
        Crea un grupo de artículos dentro de un proyecto.

        Para recuperar grupos de artículos para crear un catálogo, utilice el
        punto final del lado del cliente <a
        href="/es/api/catalog/item-groups-catalog/get-item-groups">Obtener lista
        de grupos de artículos</a>.
      operationId: admin-create-item-group
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - item-groups-admin
      requestBody:
        $ref: '#/components/requestBodies/ItemGroup_create'
      responses:
        '201':
          $ref: '#/components/responses/ItemGroup_201-admin-create-group'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/ItemGroup_422-create-update'
  /v2/project/{project_id}/admin/items/groups/{external_id}:
    get:
      summary: Obtener grupo de artículos por ID externo
      description: >-
        Recupera un grupo de artículos por su ID externo para fines
        administrativos.


        <div class="note"><b>Nota:</b><br><br>No utilice este punto final para
        crear un catálogo de tienda. Use, en su lugar, el punto final del lado
        del cliente <a
        href="/es/api/catalog/item-groups-catalog/get-item-groups">Obtener lista
        de grupos de artículos</a>.</div>
      operationId: admin-get-item-group
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
      tags:
        - item-groups-admin
      responses:
        '200':
          $ref: '#/components/responses/ItemGroup_200-admin-get-group'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/ItemGroup_404-group-not-found'
    put:
      summary: Actualizar grupo de artículos
      description: Actualiza un grupo de artículos por su ID externo.
      operationId: admin-update-item-group
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
      tags:
        - item-groups-admin
      requestBody:
        $ref: '#/components/requestBodies/ItemGroup_update'
      responses:
        '204':
          $ref: '#/components/responses/ItemGroup_204-admin-update-group'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/ItemGroup_404-group-not-found'
        '422':
          $ref: '#/components/responses/ItemGroup_422-create-update'
    delete:
      summary: Eliminar grupo de artículos
      description: Elimina un grupo de artículos por su ID externo.
      operationId: admin-delete-item-group
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
      tags:
        - item-groups-admin
      responses:
        '204':
          $ref: '#/components/responses/ItemGroup_204-admin-delete-group'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/ItemGroup_404-group-not-found'
        '422':
          $ref: '#/components/responses/ItemGroup_422-delete'
  /v2/project/{project_id}/admin/items/{item_type}/groups:
    get:
      summary: Obtener lista de grupos de artículos filtrada por tipo de artículo
      description: >-
        Recupera la lista de grupos de artículos filtrada por tipo de artículo.
        Solo se tienen en cuenta para el grupo los artículos del tipo
        especificado. Esta operación es similar al punto final [Obtener lista de
        grupos de
        artículos](/es/api/catalog/item-groups-admin/admin-get-item-group-list),
        pero con un filtrado adicional de los artículos por tipo a la hora de
        contabilizarlos.
      operationId: admin-get-item-group-list-by-item-type
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_type-group-path-param'
      tags:
        - item-groups-admin
      responses:
        '200':
          $ref: >-
            #/components/responses/ItemGroup_200-admin-get-group-list-by-item-type
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/{item_type}/groups/{external_id}:
    get:
      summary: Obtener grupo de artículos por ID externo filtrado por tipo de artículo
      description: >-
        Retrieves an item group by external ID. Only items of the specified type
        are counted for the group. This is similar to the [Get item group by
        external ID](/es/api/catalog/item-groups-admin/admin-get-item-group)
        endpoint, with additional filtering of items by type when counting them.
      operationId: admin-get-item-group-by-item-type
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_type-group-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
      tags:
        - item-groups-admin
      responses:
        '200':
          $ref: '#/components/responses/ItemGroup_200-admin-get-group-by-item-type'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/ItemGroup_404-group-not-found'
  /v2/project/{project_id}/admin/group/order:
    put:
      summary: Reordenar grupos de artículos
      description: >-
        Establece el orden de visualización para grupos de artículos dentro de
        un proyecto. Transmita una matriz de grupos con sus nuevos valores de
        orden.
      operationId: admin-reorder-item-groups
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - item-groups-admin
      requestBody:
        $ref: '#/components/requestBodies/ItemGroup_order'
      responses:
        '204':
          $ref: '#/components/responses/ItemGroup_204-admin-reorder-groups'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/ItemGroup_404-reorder-groups-not-found'
        '422':
          $ref: '#/components/responses/ItemGroup_422-ordering'
  /v2/project/{project_id}/admin/group/{external_id}/order/item:
    put:
      summary: Reordenar artículos dentro de un grupo (por ID externo)
      description: >-
        Establece el orden de visualización de los artículos dentro de un grupo
        identificado por su ID externo. Transmita una matriz de artículos con
        sus nuevos valores de orden.
      operationId: admin-reorder-items-in-group
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
      tags:
        - item-groups-admin
      requestBody:
        $ref: '#/components/requestBodies/ItemGroup_item_order'
      responses:
        '204':
          $ref: '#/components/responses/ItemGroup_204-admin-reorder-items'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
        '404':
          $ref: >-
            #/components/responses/ItemGroup_404-reorder-items-by-external-id-not-found
        '422':
          $ref: '#/components/responses/ItemGroup_422-ordering'
  /v2/project/{project_id}/admin/group/id/{id}/order/item:
    put:
      summary: Reordenar artículos dentro de un grupo (por ID)
      description: >-
        Establece el orden de visualización de los artículos dentro de un grupo
        identificado por su ID numérico interno. Transmita una matriz de
        artículos con sus nuevos valores de orden.
      operationId: admin-reorder-items-in-group-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/id-group-path-param'
      tags:
        - item-groups-admin
      requestBody:
        $ref: '#/components/requestBodies/ItemGroup_item_order'
      responses:
        '204':
          $ref: '#/components/responses/ItemGroup_204-admin-reorder-items'
        '401':
          $ref: '#/components/responses/ItemGroup_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/ItemGroup_404-reorder-items-by-id-not-found'
        '422':
          $ref: '#/components/responses/ItemGroup_422-ordering'
  /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}:
    post:
      summary: Crear pedido con artículo especificado comprado mediante moneda virtual
      description: |-
        Crea la compra de un artículo usando moneda virtual. <br>

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      operationId: create-order-with-item-for-virtual-currency
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
        - $ref: '#/components/parameters/platform-query-param'
      tags:
        - virtual-payment
      security:
        - XsollaLoginUserJWT: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                custom_parameters:
                  $ref: '#/components/schemas/Cart-Payment_custom_parameters'
            example:
              custom_parameters:
                array_param:
                  - object1:
                      param: https://xsolla.com
                    property:
                      int_property: 112
                      string_property: xsolla
                  - object2:
                      param: https://developers.xsolla.com/es
                    property:
                      int_property: 112
                      string_property: email@example.com
                object_param:
                  key: value
                bool_param: true
                int_param: 100
                null_param: null
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-quick-purchase'
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item'
        '422':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_422-not-enough-virtual-currency
  /v2/project/{project_id}/items/game:
    get:
      summary: Obtener lista de juegos
      description: "Obtiene una lista de juegos para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      tags:
        - game-keys-catalog
      operationId: get-games-list
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-games-catalog'
  /v2/project/{project_id}/items/game/group/{external_id}:
    get:
      summary: Obtener lista de juegos por grupo especificado
      description: "Obtiene una lista de juegos del grupo especificado para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      tags:
        - game-keys-catalog
      operationId: get-games-group
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-games-catalog'
  /v2/project/{project_id}/items/game/sku/{item_sku}:
    get:
      summary: Obtener juego para el catálogo
      description: |-
        Obtiene un juego para el catálogo.

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      tags:
        - game-keys-catalog
      operationId: get-game-by-sku
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - name: item_sku
          in: path
          required: true
          description: SKU del artículo.
          schema:
            type: string
            default: full_game_1
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          description: El juego se recibió correctamente.
          content:
            application/json:
              schema:
                type: object
                description: Objeto con información del juego.
                properties:
                  sku:
                    type: string
                    example: game_01
                    description: >-
                      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.
                  name:
                    type: string
                    example: Game name
                    description: Nombre del artículo.
                  groups:
                    $ref: '#/components/schemas/items_client_groups_response'
                  attributes:
                    $ref: '#/components/schemas/Game-Keys_schemas-client-attributes'
                  type:
                    type: string
                    example: unit
                    description: >-
                      Tipo de artículo:
                      `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
                  unit_type:
                    type: string
                    example: game
                    description: 'Tipo de unidad: `game`.'
                  description:
                    type: string
                    example: Game description
                    description: Descripción del artículo.
                  image_url:
                    type: string
                    example: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    description: URL de la imagen.
                  promotions:
                    $ref: '#/components/schemas/Catalog_item_promotions'
                  unit_items:
                    type: array
                    items:
                      type: object
                      properties:
                        sku:
                          type: string
                          example: game_01
                          description: >-
                            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.
                        type:
                          type: string
                          example: game_key
                          description: 'Tipo de artículo: `game_key`.'
                        is_free:
                          $ref: '#/components/schemas/value-is_free'
                        price:
                          type: object
                          description: Precios de artículos.
                          properties:
                            amount:
                              type: string
                              example: '2.9900'
                              description: Precio del artículo con descuento.
                            amount_without_discount:
                              type: string
                              example: '2.9900'
                              description: Precio del artículo.
                            currency:
                              type: string
                              example: USD
                              description: >-
                                Divisa del precio del artículo. Código de tres
                                letras según [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217).
                        virtual_prices:
                          $ref: '#/components/schemas/client_virtual_prices_response'
                        can_be_bought:
                          $ref: '#/components/schemas/Can_be_bought'
                        drm_name:
                          type: string
                          example: Steam
                          description: Nombre del DRM (gestión de derechos digitales).
                        drm_sku:
                          type: string
                          example: steam
                          description: >-
                            ID único de DRM. El SKU solo puede contener
                            caracteres alfanuméricos latinos en minúsculas y
                            mayúsculas, puntos, guiones y guiones bajos.
                        has_keys:
                          type: boolean
                          example: false
                          description: >-
                            Si es `true`, la clave del juego tiene claves para
                            la venta.
                        is_pre_order:
                          type: boolean
                          example: true
                          description: >-
                            Si es `true`, la clave del juego está reservada y la
                            fecha de lanzamiento no ha pasado.
                        release_date:
                          type:
                            - string
                            - 'null'
                          example: '2020-08-11T10:00:00+03:00'
                          description: >-
                            Fecha de lanzamiento de la clave del juego en
                            formato ISO 8601.
                        promotions:
                          $ref: '#/components/schemas/Catalog_item_promotions'
                        limits:
                          $ref: '#/components/schemas/Catalog_item_limits'
                        periods:
                          $ref: '#/components/schemas/item-periods'
                        vp_rewards:
                          $ref: '#/components/schemas/client-item-value-point-reward'
              examples:
                response:
                  value:
                    sku: com.xsolla.game_1
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                        item_order_in_group: 2
                      - external_id: Xsolla
                        name: Xsolla games
                        item_order_in_group: 1
                    type: unit
                    unit_type: game
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 9c5774997fc072b973bd5c231075c13841413f62
                            value: Casual, Logic
                    promotions: []
                    unit_items:
                      - sku: com.xsolla.game_key_01
                        type: game_key
                        is_free: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_1
                        has_keys: true
                        is_pre_order: true
                        release_date: '2020-08-11T10:00:00+03:00'
                        promotions: []
                        limits: null
                        periods:
                          - date_from: '2020-08-11T10:00:00+03:00'
                            date_until: '2020-08-11T20:00:00+03:00'
                        vp_rewards:
                          - item_id: 175232
                            sku: com.xsolla.value_point_1
                            amount: 130
                            name: Value point
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                          - item_id: 186321
                            sku: com.xsolla.clan_value_point_1
                            amount: 50
                            name: Clan Reward VP 1
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                            is_clan: true
                      - sku: com.xsolla.game_key_02
                        type: game_key
                        is_free: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        drm_name: Origin
                        drm_sku: origin_key_1
                        has_keys: false
                        is_pre_order: false
                        release_date: null
                        promotions: []
                        limits: null
                        periods: []
                        vp_rewards: []
        '404':
          description: Juego no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
  /v2/project/{project_id}/items/game/key/sku/{item_sku}:
    get:
      summary: Obtener clave del juego para el catálogo
      description: |-
        Obtiene una clave de juego para el catálogo.

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      tags:
        - game-keys-catalog
      operationId: get-game-key-by-sku
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - name: item_sku
          in: path
          required: true
          description: SKU del artículo.
          schema:
            type: string
            default: xsollus_basic_edition_steam
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          description: La clave del juego se recibió correctamente.
          content:
            application/json:
              schema:
                type: object
                description: Object with game key information.
                example:
                  sku: com.xsolla.game_1
                  name: Game name
                  groups:
                    - external_id: all
                      name: All games
                      item_order_in_group: 2
                    - external_id: Xsolla
                      name: Xsolla games
                      item_order_in_group: 1
                  type: game_key
                  description: Game description
                  image_url: >-
                    https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                  attributes:
                    - external_id: OS
                      name: OS
                      values:
                        - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                          value: Windows
                    - external_id: genre
                      name: Genre
                      values:
                        - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                          value: Horror
                  is_free: false
                  price:
                    amount: '30.5'
                    amount_without_discount: '30.5'
                    currency: USD
                  virtual_prices: []
                  can_be_bought: true
                  drm_name: Steam
                  drm_sku: steam_key_1
                  has_keys: true
                  is_pre_order: true
                  release_date: '2020-08-11T10:00:00+03:00'
                  promotions: []
                  limits: null
                  periods:
                    - date_from: '2020-08-11T10:00:00+03:00'
                      date_until: '2020-08-11T20:00:00+03:00'
                properties:
                  sku:
                    type: string
                    example: com.xsolla.game_01
                    description: >-
                      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.
                  name:
                    type: string
                    example: Game name
                    description: Nombre del artículo.
                  groups:
                    $ref: '#/components/schemas/items_client_groups_response'
                  attributes:
                    $ref: '#/components/schemas/Game-Keys_schemas-client-attributes'
                  type:
                    type: string
                    example: game_key
                    description: 'Tipo de artículo: `game_key`.'
                  description:
                    type: string
                    example: Game description
                    description: Descripción del artículo.
                  image_url:
                    type: string
                    example: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    description: URL de la imagen.
                  is_free:
                    $ref: '#/components/schemas/value-is_free'
                  price:
                    type: object
                    description: Precios de artículos.
                    properties:
                      amount:
                        type: string
                        example: '2.9900'
                        description: Precio del artículo con descuento.
                      amount_without_discount:
                        type: string
                        example: '2.9900'
                        description: Precio del artículo.
                      currency:
                        type: string
                        example: USD
                        description: >-
                          Divisa del precio del artículo. Código de tres letras
                          según [ISO
                          4217](https://en.wikipedia.org/wiki/ISO_4217).
                  virtual_prices:
                    $ref: '#/components/schemas/client_virtual_prices_response'
                  can_be_bought:
                    $ref: '#/components/schemas/Can_be_bought'
                  drm_name:
                    type: string
                    example: Steam
                    description: Nombre del DRM (gestión de derechos digitales).
                  drm_sku:
                    type: string
                    example: steam_key_1
                    description: >-
                      ID único de DRM. El SKU solo puede contener caracteres
                      alfanuméricos latinos en minúsculas y mayúsculas, puntos,
                      guiones y guiones bajos.
                  has_keys:
                    type: boolean
                    example: false
                    description: >-
                      Si es `true`, la clave del juego tiene claves para la
                      venta.
                  is_pre_order:
                    type: boolean
                    example: true
                    description: >-
                      Si es `true`, la clave del juego está reservada y la fecha
                      de lanzamiento no ha pasado.
                  release_date:
                    type: string
                    example: '2020-08-11T10:00:00+03:00'
                    description: >-
                      Fecha de lanzamiento de la clave del juego en formato ISO
                      8601.
                  promotions:
                    $ref: '#/components/schemas/Catalog_item_promotions'
                  limits:
                    $ref: '#/components/schemas/Catalog_item_limits'
                  periods:
                    $ref: '#/components/schemas/item-periods'
              examples:
                response:
                  value:
                    sku: com.xsolla.game_1
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                      - external_id: Xsolla
                        name: Xsolla games
                    type: game_key
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    is_free: false
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    drm_name: Steam
                    drm_sku: steam_key_1
                    has_keys: true
                    is_pre_order: true
                    release_date: '2020-08-11T10:00:00+03:00'
                    promotions: []
                    limits: null
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
        '404':
          description: Clave del juego no encontrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_key_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_key_1'' not found'
  /v2/project/{project_id}/items/game/key/group/{external_id}:
    get:
      summary: Obtener la lista de claves de juego por grupo especificado
      description: "Obtiene una lista de claves de juego del grupo especificado para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      tags:
        - game-keys-catalog
      operationId: get-game-keys-group
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-game-keys-by-group-catalog'
  /v2/project/{project_id}/items/game/drm:
    get:
      summary: Obtener lista de sistemas de DRM
      description: >-
        Obtiene la lista de sistemas de DRM (gestión de derechos digitales)
        disponibles.
      tags:
        - game-keys-catalog
      operationId: get-drm-list
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-drm-list'
  /v2/project/{project_id}/admin/items/game:
    post:
      summary: Crear juego
      description: Crea un juego en el proyecto.
      operationId: admin-create-game
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Game-Keys_create-update-game-model'
      responses:
        '201':
          description: El juego se creó correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  item_id:
                    type: integer
                    example: 101
                  sku:
                    type: string
                    example: com.xsolla.game_1
              examples:
                response:
                  value:
                    item_id: 101
                    sku: com.xsolla.game_1
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Game-Keys_422-invalid-request'
    get:
      summary: Obtener lista de juegos (admin)
      description: >-
        Obtiene la lista de juegos dentro de un proyecto para su administración.

        El juego se compone de claves del juego que podrían ser compradas por un
        usuario.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      operationId: admin-get-game-list
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-admin-get-games-list'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/game/sku/{item_sku}:
    get:
      summary: Obtener juego (admin)
      description: >-
        Obtiene un juego para administración.

        El juego se compone de claves del juego que podrían ser compradas por un
        usuario.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      operationId: admin-get-game-by-sku
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-admin-get-game-by-sku'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Juego no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
    put:
      summary: Actualizar juego por SKU
      description: Actualiza un juego en el proyecto por SKU.
      operationId: admin-update-game-by-sku
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Game-Keys_create-update-game-model'
      responses:
        '201':
          description: El juego se actualizó correctamente.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Juego no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
        '422':
          $ref: '#/components/responses/Game-Keys_422-invalid-request'
    delete:
      summary: Eliminar juego por SKU
      description: Elimina un juego del proyecto por SKU.
      operationId: admin-delete-game-by-sku
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      responses:
        '204':
          description: El juego se eliminó correctamente.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/game/id/{item_id}:
    get:
      summary: Obtener juego por ID (admin)
      description: >-
        Obtiene un juego para administración.

        El juego se compone de claves del juego que podrían ser compradas por un
        usuario.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      operationId: admin-get-game-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-admin-get-game-by-sku'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Juego no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with id = 1 not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with id = 1 not found'
    put:
      summary: Actualizar juego por su ID
      description: Actualiza un juego en el proyecto por su ID.
      operationId: admin-update-game-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Game-Keys_create-update-game-model'
      responses:
        '201':
          description: El juego se actualizó correctamente.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Juego no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with id = 1 not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with id = 1 not found'
        '422':
          $ref: '#/components/responses/Game-Keys_422-invalid-request'
    delete:
      summary: Eliminar un juego por su ID
      description: Elimina un juego del proyecto por su ID.
      operationId: admin-delete-game-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      responses:
        '204':
          description: El juego se eliminó correctamente.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}:
    post:
      summary: Cargar códigos
      description: Carga códigos por SKU de clave de juego.
      operationId: admin-upload-codes-by-sku
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: File with codes.
                region_id:
                  type: integer
                  description: ID de la región.
              required:
                - file
              example:
                file: keys.txt
                region_id: 1
        required: true
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-session-information'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Clave del juego o región no encontrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
  /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}:
    post:
      summary: Cargar códigos por ID
      description: Carga códigos por la ID de la clave del juego.
      operationId: admin-upload-codes-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: File with codes.
                region_id:
                  type: integer
                  description: ID de la región.
              required:
                - file
              example:
                file: keys.txt
                region_id: 1
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-session-information'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Clave del juego o región no encontrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
  /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}:
    get:
      summary: Obtener información de la sesión de carga de códigos
      description: Obtiene información de la sesión de carga de códigos.
      operationId: admin-get-codes-session
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - name: session_id
          in: path
          required: true
          description: ID de sesión.
          schema:
            type: string
            default: fc7105b6e8ee01339582970b37697242
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-session-information'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Sesión de carga de códigos no encontrada.
  /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}:
    get:
      summary: Obtener códigos
      description: Obtiene un determinado número de códigos por SKU de clave de juego.
      operationId: admin-get-codes-by-sku
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/user_email-query-param'
        - $ref: '#/components/parameters/quantity-query-param'
        - $ref: '#/components/parameters/reason-query-param'
        - $ref: '#/components/parameters/region_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-codes'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Clave del juego o región no encontrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
  /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}:
    get:
      summary: Obtener códigos por ID
      description: >-
        Obtiene un determinado número de códigos por la ID de la clave del
        juego.
      operationId: admin-get-codes-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
        - $ref: '#/components/parameters/user_email-query-param'
        - $ref: '#/components/parameters/quantity-query-param'
        - $ref: '#/components/parameters/reason-query-param'
        - $ref: '#/components/parameters/region_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-codes'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Clave del juego o región no encontrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
  /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}:
    delete:
      summary: Eliminar códigos
      description: Elimina todos los códigos por SKU de clave de juego.
      operationId: admin-delete-codes-by-sku
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/user_email-query-param'
        - $ref: '#/components/parameters/reason-query-param'
        - $ref: '#/components/parameters/region_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-codes'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Clave del juego o región no encontrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
  /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}:
    delete:
      summary: Borrar códigos por ID
      description: Elimina todos los códigos por ID de la clave del juego.
      operationId: admin-delete-codes-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - game-keys-admin
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
        - $ref: '#/components/parameters/user_email-query-param'
        - $ref: '#/components/parameters/reason-query-param'
        - $ref: '#/components/parameters/region_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-codes'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Clave del juego o región no encontrada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4001
                  errorMessage:
                    type: string
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
              examples:
                response:
                  value:
                    statusCode: 404
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
  /v2/project/{project_id}/entitlement:
    get:
      tags:
        - game-keys-entitlement
      operationId: get-user-games
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/sandbox-query-param'
        - $ref: '#/components/parameters/additional_fields-entitlement-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-user-entitlement-list'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
      summary: Obtener la lista de juegos propiedad del usuario
      description: "Obtiene la lista de juegos propiedad del usuario. La respuesta contendrá una matriz de juegos propiedad de un usuario concreto.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
  /v2/project/{project_id}/entitlement/redeem:
    post:
      tags:
        - game-keys-entitlement
      operationId: redeem-game-pin-code
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '201':
          description: Canje realizado correctamente.
        '403':
          $ref: '#/components/responses/Game-Keys_403-auth-header-not-sent'
        '404':
          description: >-
            Código de juego no encontrado. Asegúrese de que el `code` y el
            `project_id` sean correctos.
          content:
            application/json:
              schema:
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4603
                  errorMessage:
                    type: string
                    example: '[0401-4603]: Game code not found.'
                  transactionId:
                    type: string
                    example: x-x-x-x-transactionId-mock-x-x-x
                type: object
              examples:
                Game code not found:
                  $ref: '#/components/examples/404-game-code-not-found'
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                properties:
                  statusCode:
                    type: integer
                    example: 422
                  errorCode:
                    type: integer
                    example: 5103
                  errorMessage:
                    type: string
                    example: '[0401-5103]: Selected drm is not drmfree.'
                  transactionId:
                    type: string
                    example: x-x-x-x-transactionId-mock-x-x-x
                type: object
              examples:
                DRM is not DRM free:
                  $ref: '#/components/examples/422-drm-is-not-drm-free'
                User already has entitlement:
                  $ref: '#/components/examples/422-user-already-has-entitlement'
                Game is in pre-order state:
                  value:
                    statusCode: 422
                    errorCode: 5106
                    errorMessage: >-
                      [0401-5106]: Item: game_sku is in pre-order state and can
                      not be redeemed
                    transactionId: transaction id
                Game code is already activated:
                  value:
                    statusCode: 422
                    errorCode: 5107
                    errorMessage: '[0401-5107]: Game code has been already activated'
                    transactionId: transaction id
      summary: Canjear código del juego por cliente
      description: |-
        Concede el derecho mediante un código de juego suministrado.

        <div class="notice">
          <strong>Aviso:</strong><br><br>
            Solamente puede canjear códigos para la plataforma sin DRM.
        </div>

        <br>

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      security:
        - XsollaLoginUserJWT: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - code
              properties:
                code:
                  type: string
                  example: AAAA-BBBB-CCCC-DDDD
                  description: Game code.
                sandbox:
                  type: boolean
                  example: false
                  default: false
                  description: >-
                    Redeem game code in the sandbox mode. The option is
                    available for those users who are specified in the list of
                    company users.
        required: true
  /v2/project/{project_id}/admin/entitlement/grant:
    post:
      tags:
        - game-keys-entitlement
      operationId: grant-entitlement-admin
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          description: Se concedió el derecho.
        '403':
          $ref: '#/components/responses/Game-Keys_403-auth-header-not-sent'
        '404':
          description: >-
            Código de juego no encontrado. Asegúrese de que el `code` y el
            `project_id` sean correctos.
          content:
            application/json:
              schema:
                properties:
                  statusCode:
                    type: integer
                    example: 404
                  errorCode:
                    type: integer
                    example: 4603
                  errorMessage:
                    type: string
                    example: '[0401-4603]: Game code not found.'
                  transactionId:
                    type: string
                    example: x-x-x-x-transactionId-mock-x-x-x
                type: object
              examples:
                Game code not found:
                  $ref: '#/components/examples/404-game-code-not-found'
                Game not found:
                  value:
                    statusCode: 404
                    errorCode: 4604
                    errorMessage: '[0401-4604]: Game not found.'
                    transactionId: transaction id
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                properties:
                  statusCode:
                    type: integer
                    example: 422
                  errorCode:
                    type: integer
                    example: 5103
                  errorMessage:
                    type: string
                    example: '[0401-5103]: Selected drm is not drmfree.'
                  transactionId:
                    type: string
                    example: x-x-x-x-transactionId-mock-x-x-x
                type: object
              examples:
                DRM is not DRM free:
                  $ref: '#/components/examples/422-drm-is-not-drm-free'
                User already has entitlement:
                  $ref: '#/components/examples/422-user-already-has-entitlement'
      summary: Conceder derecho (admin)
      description: >-
        Concede el derecho al usuario.


        <div class="notice"><strong>Atención</strong><br><br>Solo se pueden
        conceder códigos de juego o juegos para plataformas sin DRM (gestión de
        derechos digitales).</div>
      security:
        - basicAuth: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - user_external_id
                - game
                - drm
                - mode
              properties:
                user_external_id:
                  type: string
                  example: user-external-id
                  description: Unique user identifier.
                game:
                  type: object
                  required:
                    - sku
                  properties:
                    sku:
                      $ref: '#/components/schemas/Game-Keys_game_sku'
                  example:
                    game:
                      sku: com.xsolla.game_1
                  description: Object with game properties.
                drm:
                  type: object
                  required:
                    - sku
                  properties:
                    sku:
                      $ref: '#/components/schemas/Game-Keys_drm_sku'
                  example:
                    drm:
                      sku: com.xsolla.key_1
                  description: Object with DRM properties.
                code:
                  type:
                    - string
                    - 'null'
                  example: AAAA-BBBB-CCCC-DDDD
                  description: Game code of the game.
                mode:
                  type: string
                  enum:
                    - default
                    - sandbox
                  example: default
                  description: >-
                    What type of entitlements should be granted. If the
                    parameter is set to `sandbox`, the entitlement will be
                    granted to the user in the sandbox mode. If the parameter is
                    set to `default`, the entitlement will be granted to the
                    user in the live mode.
                user_country:
                  type:
                    - string
                    - 'null'
                  example: US
                  description: User's country.
              example:
                user_external_id: user-external-id
                game:
                  sku: com.xsolla.game_1
                drm:
                  sku: com.xsolla.key_1
                code: AAAA-BBBB-CCCC-DDDD
                mode: default
                user_country: US
        required: true
  /v2/project/{project_id}/admin/entitlement/revoke:
    post:
      tags:
        - game-keys-entitlement
      operationId: revoke-entitlement-admin
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '204':
          description: Revocación realizada correctamente.
        '403':
          $ref: '#/components/responses/Game-Keys_403-auth-header-not-sent'
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                properties:
                  statusCode:
                    type: integer
                    example: 422
                  errorCode:
                    type: integer
                    example: 5103
                  errorMessage:
                    type: string
                    example: '[0401-5103]: Selected drm is not drmfree.'
                  transactionId:
                    type: string
                    example: x-x-x-x-transactionId-mock-x-x-x
                type: object
              examples:
                DRM is not DRM free:
                  value:
                    statusCode: 422
                    errorCode: 5103
                    errorMessage: '[0401-5103]: Selected drm is not drmfree.'
                    transactionId: transaction id
      summary: Revocar el derecho (admin)
      description: >-
        Revoca el derecho del usuario.


        <div class="notice"><strong>Atención</strong><br><br>Solo se pueden
        conceder códigos de juego o juegos para plataformas sin DRM (gestión de
        derechos digitales).</div>
      security:
        - basicAuth: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - user_external_id
                - game
                - drm
                - mode
              properties:
                user_external_id:
                  type: string
                  example: user-external-id
                  description: Unique user identifier.
                game:
                  type: object
                  required:
                    - sku
                  properties:
                    sku:
                      $ref: '#/components/schemas/Game-Keys_game_sku'
                  example:
                    game:
                      sku: com.xsolla.game_1
                  description: Object with game properties.
                drm:
                  type: object
                  required:
                    - sku
                  properties:
                    sku:
                      $ref: '#/components/schemas/Game-Keys_drm_sku'
                  example:
                    drm:
                      sku: com.xsolla.key_1
                  description: Object with DRM properties.
                mode:
                  type: string
                  enum:
                    - default
                    - sandbox
                  example: default
                  description: >-
                    What type of entitlements should be revoked. If the
                    parameter is set to `sandbox`, the entitlement will be
                    revoked from the user in the sandbox mode. If the parameter
                    is set to `default`, the entitlement will be revoked from
                    the user in the live mode.
              example:
                user_external_id: user-external-id
                game:
                  sku: com.xsolla.game_1
                drm:
                  sku: com.xsolla.key_1
                mode: default
        required: true
  /v2/project/{project_id}/admin/items/bundle:
    get:
      summary: Obtener lista de lotes
      description: >-
        Obtiene la lista de lotes 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>
      operationId: admin-get-bundle-list
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - bundles-admin
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-admin-get-bundle-list'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
    post:
      summary: Crear lote
      description: >-
        Crea un lote: un conjunto de artículos que se venden como una sola
        unidad. Un lote puede contener artículos virtuales, paquetes de moneda
        virtual, claves de juego y otros lotes. Para obtener más información,
        consulte la sección
        [Lotes](https://developers.xsolla.com/es/items-catalog/items-type/bundles/).


        <div class="notice"><b>Aviso</b><br><br>Todos los artículos de la matriz
        <code>content</code> deben estar creados previamente en su proyecto. El
        sistema devuelve un error si el SKU indicado no existe.</div>
      security:
        - basicAuth: []
      operationId: admin-create-bundle
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - bundles-admin
      requestBody:
        $ref: '#/components/requestBodies/Bundles_bundle'
      responses:
        '201':
          $ref: '#/components/responses/Bundles_201-admin-create-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Bundles_422-invalid-request'
  /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}:
    get:
      summary: Obtener lista de lotes por ID de grupo especificado
      description: >-
        Obtiene la lista de lotes dentro de un grupo para administración.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      operationId: admin-get-bundle-list-in-group-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/group_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - bundles-admin
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-admin-get-bundle-list-in-group'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}:
    get:
      summary: Obtener lista de lotes por ID externo del grupo especificado
      description: >-
        Obtiene la lista de lotes dentro de un grupo para administración.


        <div class="note"><b>Nota</b><br><br>No utilice este punto final para
        crear un catálogo de tienda.</div>
      operationId: admin-get-bundle-list-in-group-by-external-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - bundles-admin
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-admin-get-bundle-list-in-group'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/bundle/sku/{sku}:
    put:
      summary: Actualizar lote
      description: >-
        Actualiza un lote. Esta llamada sustituye por completo el lote:
        transmita todos los campos obligatorios en el cuerpo de la solicitud, no
        solo los campos que quiera cambiar. Para obtener más información,
        consulte la sección
        [Lotes](https://developers.xsolla.com/es/items-catalog/items-type/bundles/).


        <div class="notice"><b>Aviso</b><br><br>Todos los artículos de la matriz
        <code>content</code> deben estar creados previamente en su proyecto. El
        sistema devuelve un error si el SKU indicado no existe.</div>
      operationId: admin-update-bundle
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      tags:
        - bundles-admin
      requestBody:
        $ref: '#/components/requestBodies/Bundles_bundle'
      responses:
        '204':
          $ref: '#/components/responses/Bundles_204-admin-update-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Bundles_422-invalid-request'
    delete:
      summary: Eliminar lote
      description: Elimina un lote.
      operationId: admin-delete-bundle
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      tags:
        - bundles-admin
      responses:
        '204':
          $ref: '#/components/responses/Bundles_204-admin-delete-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
    get:
      summary: Obtener lote
      description: >-
        Obtiene el lote 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>
      operationId: admin-get-bundle
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      tags:
        - bundles-admin
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-admin-get-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show:
    put:
      summary: Mostrar lote en el catálogo
      description: Muestra un lote en un catálogo.
      operationId: admin-show-bundle
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      tags:
        - bundles-admin
      responses:
        '204':
          $ref: '#/components/responses/Bundles_204-admin-show-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
  /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide:
    put:
      summary: Ocultar lote en el catálogo
      description: Oculta un lote en un catálogo.
      operationId: admin-hide-bundle
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      tags:
        - bundles-admin
      responses:
        '204':
          $ref: '#/components/responses/Bundles_204-admin-hide-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
  /v2/project/{project_id}/items/bundle:
    get:
      summary: Obtener lista de lotes
      description: "Obtiene una lista de lotes para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      operationId: get-bundle-list
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - bundles-catalog
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-get-bundle-list'
  /v2/project/{project_id}/items/bundle/sku/{sku}:
    get:
      summary: Obtener el lote especificado
      description: |-
        Obtiene un paquete especificado.

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      operationId: get-bundle
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      tags:
        - bundles-catalog
      responses:
        '200':
          description: El lote especificado se recibió correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundles_client_bundle'
              examples:
                response:
                  $ref: '#/components/examples/Bundles_200-get-bundle'
  /v2/project/{project_id}/items/bundle/group/{external_id}:
    get:
      summary: Obtener la lista de lotes por grupo especificado
      description: "Obtiene una lista de lotes dentro de un grupo para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      operationId: get-bundle-list-in-group
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - bundles-catalog
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-get-bundle-list'
  /v2/project/{project_id}/cart/{cart_id}:
    get:
      summary: Obtener cesta por el ID de la cesta
      description: Devuelve la cesta del usuario por el ID de la cesta.
      operationId: get-cart-by-id
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
        - $ref: '#/components/parameters/currency-query-param'
        - $ref: '#/components/parameters/locale-query-param'
      tags:
        - cart-client-side
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-get-cart-json-model'
      security:
        - AuthForCart: []
  /v2/project/{project_id}/cart:
    get:
      summary: Obtener la cesta del usuario actual
      description: Devuelve la cesta del usuario actual.
      operationId: get-user-cart
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/currency-query-param'
        - $ref: '#/components/parameters/locale-query-param'
      tags:
        - cart-client-side
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-get-cart-json-model'
      security:
        - AuthForCart: []
  /v2/project/{project_id}/cart/{cart_id}/clear:
    put:
      summary: Eliminar todos los artículos de la cesta por el ID de la cesta
      description: Elimina todos los artículos de la cesta.
      operationId: cart-clear-by-id
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
      tags:
        - cart-client-side
      responses:
        '204':
          description: La cesta se vació correctamente.
      security:
        - AuthForCart: []
  /v2/project/{project_id}/cart/clear:
    put:
      summary: Eliminar todos los artículos de la cesta actual
      description: Elimina todos los artículos de la cesta.
      operationId: cart-clear
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - cart-client-side
      responses:
        '204':
          description: La cesta se vació correctamente.
      security:
        - AuthForCart: []
  /v2/project/{project_id}/cart/fill:
    put:
      summary: Llenar la cesta con artículos
      description: >-
        Llena la cesta con artículos. Si la cesta ya tiene un artículo con el
        mismo SKU, el artículo existente se sustituirá por el valor transmitido.
      operationId: cart-fill
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - cart-client-side
      security:
        - AuthForCart: []
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_fill-cart-json-model'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-fill-cart-json-model'
  /v2/project/{project_id}/cart/{cart_id}/fill:
    put:
      summary: Llenar la cesta específica con artículos
      description: >-
        Llena la cesta específica con artículos. Si la cesta ya contiene un
        artículo con el mismo SKU, la posición del artículo existente se
        sustituirá por el valor transmitido.
      operationId: cart-fill-by-id
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
      tags:
        - cart-client-side
      security:
        - AuthForCart: []
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_fill-cart-json-model'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-fill-cart-json-model'
  /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}:
    put:
      summary: Actualizar artículo de la cesta por ID de la cesta
      description: Actualiza un artículo de la cesta existente o crea el de la cesta.
      operationId: put-item-by-cart-id
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - cart-client-side
      security:
        - AuthForCart: []
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_put-item-by-cart-idJsonModel'
      responses:
        '204':
          description: La cesta se actualizó correctamente.
        '404':
          $ref: '#/components/responses/Cart-Payment_404-item'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-non-negative-quantity'
    delete:
      summary: Eliminar artículo de la cesta por ID de la cesta
      description: Elimina un artículo de la cesta.
      operationId: delete-item-by-cart-id
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - cart-client-side
      security:
        - AuthForCart: []
      responses:
        '204':
          description: El artículo de la cesta se eliminó correctamente.
        '404':
          $ref: '#/components/responses/Cart-Payment_404-item'
  /v2/project/{project_id}/cart/item/{item_sku}:
    put:
      summary: Actualizar artículo de la cesta actual
      description: Actualiza un artículo de la cesta existente o crea el de la cesta.
      operationId: put-item
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - cart-client-side
      security:
        - AuthForCart: []
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_put-item-by-cart-idJsonModel'
      responses:
        '204':
          description: La cesta se actualizó correctamente.
        '404':
          $ref: '#/components/responses/Cart-Payment_404-item'
        '422':
          $ref: >-
            #/components/responses/Cart-Payment_422-can-put-only-virtual-good-to-cart
    delete:
      summary: Eliminar artículo de la cesta actual
      description: Elimina un artículo de la cesta.
      operationId: delete-item
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - cart-client-side
      security:
        - AuthForCart: []
      responses:
        '204':
          description: El artículo de la cesta se eliminó correctamente.
        '404':
          $ref: '#/components/responses/Cart-Payment_404-item'
  /v2/project/{project_id}/payment/cart/{cart_id}:
    post:
      summary: Crear pedido con todos los artículos de la cesta
      description: >-
        Se utiliza para la integración cliente-servidor. Crea un pedido con
        todos los artículos de la cesta concreta y genera un token de pago para
        esta. El pedido creado obtiene el estado de pedido `new`.


        La IP del cliente se utiliza para determinar el país del usuario, que a
        su vez se utiliza para aplicar la moneda correspondiente y los métodos
        de pago disponibles para el pedido.


        Para abrir la interfaz de pago en una nueva ventana, utilice el
        siguiente enlace:
        `https://secure.xsolla.com/paystation4/?token={token}`, en el cual
        `{token}` es el token recibido.


        Para realizar pruebas, utilice esta URL:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice"><strong>Aviso</strong> <br><br> Como este método
        utiliza la IP para determinar el país del usuario y seleccionar una
        moneda para el pedido, es importante utilizar este método solamente
        desde el lado del cliente y no desde el lado del servidor. El uso de
        este método desde el lado del servidor puede causar una determinación
        incorrecta de la moneda y afectar a los métodos de pago en <a
        href="https://developers.xsolla.com/es/doc/pay-station/">Pay
        Station</a>. </div>
      operationId: create-order-by-cart-id
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
      tags:
        - payment-client-side
      security:
        - AuthForCart: []
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-by-cart-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
  /v2/project/{project_id}/payment/cart:
    post:
      summary: Crear pedido con todos los artículos de la cesta actual
      description: >-
        Se utiliza para la integración cliente-servidor. Crea un pedido con
        todos los artículos de la cesta y genera un token de pago para esta. El
        pedido creado obtiene el estado de pedido `new`.


        La IP del cliente se utiliza para determinar el país del usuario, que a
        su vez se utiliza para aplicar la moneda correspondiente y los métodos
        de pago disponibles para el pedido.


        Para abrir la interfaz de pago en una nueva ventana, utilice el
        siguiente enlace:
        `https://secure.xsolla.com/paystation4/?token={token}`, en el cual
        `{token}` es el token recibido.


        Para realizar pruebas, utilice esta URL:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice"><strong>Aviso</strong> <br><br> Como este método
        utiliza la IP para determinar el país del usuario y seleccionar una
        moneda para el pedido, es importante utilizar este método solamente
        desde el lado del cliente y no desde el lado del servidor. El uso de
        este método desde el lado del servidor puede causar una determinación
        incorrecta de la moneda y afectar a los métodos de pago en <a
        href="https://developers.xsolla.com/es/doc/pay-station/">Pay
        Station</a>. </div>
      operationId: create-order
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - payment-client-side
      security:
        - AuthForCart: []
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-by-cart-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
  /v2/project/{project_id}/payment/item/{item_sku}:
    post:
      summary: Crear pedido con un artículo especificado
      description: >-
        Se utiliza para la integración cliente-servidor. Crea un pedido con un
        artículo especificado y genera un token de pago para ese pedido. El
        pedido creado obtiene el estado de pedido `new`.


        La IP del cliente se utiliza para determinar el país del usuario, que a
        su vez se utiliza para aplicar la moneda correspondiente y los métodos
        de pago disponibles para el pedido.


        Para abrir la interfaz de pago en una nueva ventana, utilice el
        siguiente enlace:
        `https://secure.xsolla.com/paystation4/?token={token}`, en el cual
        `{token}` es el token recibido.


        Para realizar pruebas, utilice esta URL:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice"><strong>Aviso</strong> <br><br> Como este método
        utiliza la IP para determinar el país del usuario y seleccionar una
        moneda para el pedido, es importante utilizar este método solamente
        desde el lado del cliente y no desde el lado del servidor. El uso de
        este método desde el lado del servidor puede causar una determinación
        incorrecta de la moneda y afectar a los métodos de pago en <a
        href="https://developers.xsolla.com/es/doc/pay-station/">Pay
        Station</a>. </div>


        <br>


        <div class="notice">
          <strong>Aviso</strong><br><br>
            Esta llamada API utiliza un JWT de usuario para autorización.<br><br>
            Incluya el token en el encabezado <code>Authorization</code> con el siguiente formato: <code>Bearer &lt;user_JWT&gt;</code>. Para obtener más información sobre el JWT de usuario, consulte el bloque <strong>Seguridad</strong> para esta llamada.
        </div>
      operationId: create-order-with-item
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - payment-client-side
      security:
        - XsollaLoginUserJWT: []
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-with-specified-item-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-order-created'
        '404':
          $ref: >-
            #/components/responses/Cart-Payment_404-create-order-with-item-not-found-errors
        '422':
          $ref: >-
            #/components/responses/Cart-Payment_422-create-order-with-item-invalid
  /v2/project/{project_id}/free/cart:
    post:
      summary: Crear pedido con cesta gratuita
      description: >-
        Crea un pedido con todos los artículos de la cesta gratuita. El pedido
        creado obtendrá el estado de pedido `done`.
      operationId: create-free-order
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - free-item
      security:
        - AuthForCart: []
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-by-cart-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Free_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
  /v2/project/{project_id}/free/cart/{cart_id}:
    post:
      summary: Crear pedido con una cesta gratuita concreta
      description: >-
        Crea un pedido con todos los artículos de la cesta gratuita concreta. El
        pedido creado obtendrá el estado de pedido `done`.
      operationId: create-free-order-by-cart-id
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
      tags:
        - free-item
      security:
        - AuthForCart: []
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-by-cart-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Free_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
  /v2/project/{project_id}/free/item/{item_sku}:
    post:
      summary: Crear pedido con un artículo gratuito especificado
      description: >-
        Crea un pedido con un artículo gratuito especificado. El pedido creado
        obtendrá un estado de pedido `done`. <br>


        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      operationId: create-free-order-with-item
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      tags:
        - free-item
      security:
        - XsollaLoginUserJWT: []
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-with-specified-item-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Free_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-item'
  /v2/project/{project_id}/order/{order_id}:
    get:
      summary: Obtener pedido
      description: Recupera un pedido especificado.
      operationId: get-order
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/order_id-path-param'
      tags:
        - order
      security:
        - AuthForCart: []
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-get-order'
        '404':
          $ref: '#/components/responses/Cart-Payment_404-get-order'
  /v3/project/{project_id}/admin/order/search:
    post:
      summary: Obtener la lista de pedidos del periodo especificado
      description: >-
        Recupera la lista de pedidos, ordenados de la fecha de creación más
        antigua a la más reciente.
      operationId: admin-order-search
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      tags:
        - order
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/admin-order-search'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-order-search'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
  /v3/project/{project_id}/admin/payment/token:
    post:
      operationId: admin-create-payment-token
      x-badges:
        - name: Server-side
          color: '#95ff80'
      summary: Crear token de pago para la compra
      description: >-
        Genera un pedido y un token de pago para el mismo. El pedido se genera
        en función de los artículos transmitidos en el cuerpo de la solicitud.


        Para abrir la interfaz de pago en una nueva ventana, utilice el
        siguiente enlace:
        `https://secure.xsolla.com/paystation4/?token={token}`, en el cual
        `{token}` es el token recibido.


        Para realizar pruebas, utilice esta URL:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice"><strong>Aviso </strong>
           <br><br>
        El parámetro <code>user.country.value</code> se usa para seleccionar una
        moneda para el pedido.

        Si se desconoce el país del usuario, otra opción es proporcionar la IP
        del usuario en el encabezado <code>X-User-Ip</code>. <br> Se requiere
        una de estas dos opciones para el correcto funcionamiento de este
        método. <br> La moneda seleccionada se usa para los métodos de pago en
        <a href="https://developers.xsolla.com/es/doc/pay-station/">Pay
        Station</a></b>.
           </div>
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - payment-server-side
      security:
        - basicAuth: []
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_admin-create-payment-token'
      responses:
        '201':
          $ref: '#/components/responses/Cart-Payment_201-admin-create-payment-token'
        '401':
          $ref: '#/components/responses/Cart-Payment_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-admin-create-payment-token'
  /v2/admin/project/{project_id}/cart/fill:
    put:
      summary: Llenar la cesta con artículos
      description: >-
        Rellena la cesta actual con artículos. Si la cesta ya tiene un artículo
        con el mismo SKU, el artículo existente se sustituirá por el valor
        transmitido.
      operationId: admin-cart-fill
      x-badges:
        - name: Server-side
          color: '#95ff80'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/x-user-for-header'
        - $ref: '#/components/parameters/x-user-id-header'
      tags:
        - cart-server-side
      security:
        - basicAuth: []
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_admin-fill-cart-json-model'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-admin-fill-cart-json-model'
        '401':
          $ref: '#/components/responses/Cart-Payment_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Cart-Payment_404-user'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
  /v2/admin/project/{project_id}/cart/{cart_id}/fill:
    put:
      summary: Llenar la cesta con artículos por el ID de la cesta
      description: >-
        Rellena la cesta con artículos por ID de la cesta. Si la cesta ya tiene
        un artículo con el mismo SKU, el artículo existente se sustituirá por el
        valor transmitido.
      operationId: admin-fill-cart-by-id
      x-badges:
        - name: Server-side
          color: '#95ff80'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/x-user-for-header'
        - $ref: '#/components/parameters/x-user-id-header'
      tags:
        - cart-server-side
      security:
        - basicAuth: []
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_admin-fill-cart-json-model'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-admin-fill-cart-json-model'
        '401':
          $ref: '#/components/responses/Cart-Payment_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Cart-Payment_404-user'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
  /v2/project/{project_id}/admin/user/limit/item/all:
    delete:
      tags:
        - user-limits-admin
      security:
        - basicAuth: []
      operationId: reset-all-user-items-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      summary: Actualizar todos los límites de compra para un usuario especificado
      description: >-
        Actualiza todos los límites de compra de todos los artículos para un
        usuario especificado para que pueda comprar estos artículos de nuevo.


        La API de límite del usuario le permite vender un artículo en una
        cantidad limitada. Para configurar los límites de compra, vaya a Admin
        del módulo del tipo de artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)
      responses:
        '200':
          description: El límite se actualizó correctamente.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  transactionId:
                    type: string
              examples:
                User not found:
                  value:
                    statusCode: 404
                    errorCode: 5008
                    errorMessage: '[0401-5008]: Could not find User'
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                    items:
                      type: object
                      properties:
                        property:
                          type: string
                        message:
                          type: string
                  transactionId:
                    type: string
              examples:
                Invalid user_external_id:
                  value:
                    statusCode: 404
                    errorCode: 1102
                    errorMessage: '[0401-1102]: Unprocessable Entity'
                    errorMessageExtended:
                      - property: user_external_id
                        message: Must be at least 1 characters long
                      - property: user_external_id
                        message: Does not match the regex pattern ^\S+$
      requestBody:
        $ref: '#/components/requestBodies/reset-user-limits'
  /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all:
    delete:
      tags:
        - user-limits-admin
      security:
        - basicAuth: []
      operationId: reset-user-item-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: Actualizar límite de compra
      description: >-
        Actualiza el límite de compra de un artículo para que un usuario pueda
        volver a comprarlo. Si el parámetro *user* es `null`, esta llamada
        actualiza este límite para todos los usuarios.


        La API de límite del usuario le permite vender un artículo en una
        cantidad limitada. Para configurar los límites de compra, vaya a Admin
        del módulo del tipo de artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)
      responses:
        '200':
          description: El límite se actualizó correctamente.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  transactionId:
                    type: string
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  transactionId:
                    type: string
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
      requestBody:
        $ref: '#/components/requestBodies/reset-user-limits-flexible'
  /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}:
    get:
      tags:
        - user-limits-admin
      security:
        - basicAuth: []
      operationId: get-user-item-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/user_external_id-query-param'
      summary: Obtener el número de artículos disponibles para un usuario especificado
      description: >-
        Obtiene el número restante de artículos disponibles para el usuario
        especificado dentro del límite aplicado.


        La API de límite del usuario le permite vender un artículo en una
        cantidad limitada. Para configurar los límites de compra, vaya a Admin
        del módulo del tipo de artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-item-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  transactionId:
                    type: string
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  transactionId:
                    type: string
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
    post:
      tags:
        - user-limits-admin
      security:
        - basicAuth: []
      operationId: add-user-item-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: Aumentar el número de artículos disponibles para el usuario especificado
      description: >-
        Aumenta el número restante de artículos disponibles para el usuario
        especificado dentro del límite aplicado.


        La API de límite del usuario le permite vender un artículo en una
        cantidad limitada. Para configurar los límites de compra, vaya a Admin
        del módulo del tipo de artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-item-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  transactionId:
                    type: string
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  transactionId:
                    type: string
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
                Available item limit is out of range:
                  $ref: >-
                    #/components/examples/422-item-out-of-range-available-user-limit
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-strict'
    put:
      tags:
        - user-limits-admin
      security:
        - basicAuth: []
      operationId: set-user-item-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: >-
        Establecer el número de artículos disponibles para el usuario
        especificado
      description: >-
        Establece el número de artículos que el usuario especificado puede
        comprar dentro del límite aplicado después de que se haya aumentado o
        reducido.


        La API de límite del usuario le permite vender un artículo en una
        cantidad limitada. Para configurar los límites de compra, vaya a Admin
        del módulo del tipo de artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-item-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  transactionId:
                    type: string
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  transactionId:
                    type: string
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-flexible'
    delete:
      tags:
        - user-limits-admin
      security:
        - basicAuth: []
      operationId: remove-user-item-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: Reducir el número de artículos disponibles para un usuario especificado
      description: >-
        Reduce el número restante de artículos disponibles para el usuario
        especificado dentro del límite aplicado.


        La API de límite del usuario le permite vender un artículo en una
        cantidad limitada. Para configurar los límites de compra, vaya a Admin
        del módulo del tipo de artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-item-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  transactionId:
                    type: string
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
        '422':
          description: Solicitud no válida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  transactionId:
                    type: string
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
                Available item limit is out of range:
                  $ref: >-
                    #/components/examples/422-item-out-of-range-available-user-limit
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-strict'
  /v1/projects/{project_id}/import/from_external_file:
    post:
      tags:
        - connector-admin
      operationId: import-items-from-external-file
      summary: Importar artículos mediante un archivo JSON
      description: >-
        Importa artículos a la tienda desde un archivo JSON mediante la URL
        especificada. Consulte la
        [documentación](https://developers.xsolla.com/es/doc/shop-builder/how-to/json-import/)
        para obtener más información sobre la importación desde un archivo JSON.
      servers:
        - url: https://connector.xsolla.com
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      responses:
        '201':
          description: El archivo se ha importado correctamente y se está procesando.
          content:
            application/json:
              schema:
                type: object
                properties:
                  import_id:
                    type: string
                    example: af9f3638a16e11ef880da2cd677d2d24
                    description: >-
                      Import operation ID. If you encounter difficulties
                      importing the JSON file, report this ID to your Customer
                      Success Manager or send an email to csm@xsolla.com.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/connector-422-validation-failed'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/connector-import-items-body'
  /v1/admin/projects/{project_id}/connectors/import_items/import/status:
    get:
      tags:
        - connector-admin
      operationId: get-items-import-status
      summary: Obtener el estado de la importación de artículos
      description: >-
        Recupera información sobre el progreso de la importación de artículos al
        proyecto. Esta llamada API recupera datos sobre la última importación
        realizada mediante la API o mediante Cuenta del editor.
      servers:
        - url: https://connector.xsolla.com
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      responses:
        '200':
          $ref: '#/components/responses/200-items-import-status-model'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
  /v2/project/{project_id}/admin/webhook/version:
    put:
      tags:
        - common-webhooks
      security:
        - basicAuth: []
      operationId: update-webhook-version
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      summary: Update webhook version
      description: >-
        Updates the webhook version for the project. In version 2, additional
        parameters are included in the `items` array.


        For more information about webhooks, see the  [Set up order status
        tracking](https://developers.xsolla.com/es/doc/shop-builder/integration-guide/set-up-webhooks/).
      responses:
        '204':
          description: Webhook version is successfully updated.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '422':
          description: Request validation error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/422-invalid-request-extended'
              examples:
                response:
                  value:
                    statusCode: 422
                    errorCode: 1102
                    errorMessage: '[0401-1102]: Unprocessable Entity'
                    errorMessageExtended:
                      - property: version
                        message: Must have a minimum value of 1
                    transactionId: da145238620011eb8e24fe6913ff226a
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                version:
                  type: integer
                  description: >-
                    Webhook version. Version 1 is used by default. In version 2,
                    the `items` array includes the following parameters:
                    `is_free`, `is_bonus`, and `is_bundle_content` parameters.
                  enum:
                    - 1
                    - 2
                  example: 2
              required:
                - version
            example:
              version: 2
  /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}:
    get:
      tags:
        - common-pre-orders
      security:
        - basicAuth: []
      operationId: get-pre-order-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: >-
        Obtener información sobre el límite de pedidos por anticipado del
        artículo
      description: >-
        Obtenga el límite de pedido por anticipado del artículo.


        La API de límite de pedido por anticipado le permite vender un artículo
        en una cantidad limitada. Para configurar el pedido por anticipado, vaya
        a Admin del módulo del artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)


        Alias para este punto final:

        * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}
      responses:
        '200':
          description: >-
            La información sobre el límite de pedido por anticipado se recibió
            correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  item_id:
                    type: integer
                    example: 1
                  sku:
                    type: string
                    example: com.xsolla.item_1
                  is_pre_order_limit_enabled:
                    type: boolean
                    example: true
                  available:
                    type: integer
                    example: 431
                  reserved:
                    type: integer
                    example: 13
                  sold:
                    type: integer
                    example: 556
              examples:
                response:
                  value:
                    item_id: 1
                    sku: com.xsolla.item_1
                    is_pre_order_limit_enabled: true
                    available: 431
                    reserved: 13
                    sold: 556
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
    post:
      tags:
        - common-pre-orders
      security:
        - basicAuth: []
      operationId: add-pre-order-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: Agregar cantidad al límite de pedidos por anticipado del artículo
      description: >-
        Añada la cantidad del límite de pedido por anticipado del artículo.


        La API de límite de pedido por anticipado le permite vender un artículo
        en una cantidad limitada. Para configurar el pedido por anticipado, vaya
        a Admin del módulo del artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)


        Alias para este punto final:

        * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}
      responses:
        '201':
          description: La cantidad que se debe limitar se agregó correctamente.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                quantity:
                  type: integer
                  description: Quantity to add.
              required:
                - quantity
            example:
              quantity: 100000
    put:
      tags:
        - common-pre-orders
      security:
        - basicAuth: []
      operationId: set-pre-order-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: >-
        Establecer el límite de cantidad de artículos para pedidos por
        anticipado
      description: >-
        Establezca la cantidad del límite de pedido por anticipado del artículo.


        La API de límite de pedido por anticipado le permite vender un artículo
        en una cantidad limitada. Para configurar el pedido por anticipado, vaya
        a Admin del módulo del artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)


        Alias para este punto final:

        * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}
      responses:
        '204':
          description: La cantidad que se debe limitar se estableció correctamente.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                quantity:
                  type: integer
                  description: Quantity to set.
              required:
                - quantity
            example:
              quantity: 100000
    delete:
      tags:
        - common-pre-orders
      security:
        - basicAuth: []
      operationId: remove-pre-order-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: Eliminar el límite de cantidad de artículos para pedidos por anticipado
      description: >-
        Elimina la cantidad del límite de pedido por anticipado del artículo.


        La API de límite de pedido por anticipado le permite vender un artículo
        en una cantidad limitada. Para configurar el pedido por anticipado, vaya
        a Admin del módulo del artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)


        Alias para este punto final:

        * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}
      responses:
        '204':
          description: La cantidad que se debe limitar se eliminó correctamente.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                quantity:
                  type: integer
                  description: Quantity to remove.
              required:
                - quantity
            example:
              quantity: 100000
  /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle:
    put:
      tags:
        - common-pre-orders
      security:
        - basicAuth: []
      operationId: toggle-pre-order-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: Cambiar el límite para los pedidos por anticipado del artículo
      description: >-
        Habilitar/deshabilitar el límite de pedido por anticipado del artículo.


        La API de límite de pedido por anticipado le permite vender un artículo
        en una cantidad limitada. Para configurar el pedido por anticipado, vaya
        a Admin del módulo del artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)


        Alias para este punto final:

        *
        /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle
      responses:
        '204':
          description: Se ha deshabilitado/habilitado el límite.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                is_pre_order_limit_enabled:
                  type: boolean
              required:
                - is_pre_order_limit_enabled
            example:
              is_pre_order_limit_enabled: true
  /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all:
    delete:
      tags:
        - common-pre-orders
      security:
        - basicAuth: []
      operationId: remove-all-pre-order-limit
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      summary: >-
        Eliminar todo el límite de cantidad de artículos para pedidos por
        anticipado
      description: >-
        Elimine toda la cantidad de límite de pedido por anticipado del
        artículo.


        La API de límite de pedido por anticipado le permite vender un artículo
        en una cantidad limitada. Para configurar el pedido por anticipado, vaya
        a Admin del módulo del artículo deseado:

        * [Game
        Keys](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-game/)

        * [Virtual Items &
        Currency](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Bundles](https://developers.xsolla.com/es/api/shop-builder/operation/admin-get-bundle-list/)


        Alias para este punto final:

        *
        /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all
      responses:
        '204':
          description: El límite se eliminó correctamente.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Artículo no encontrado.
  /v2/merchant/{merchant_id}/projects:
    get:
      tags:
        - common-merchant
      operationId: get-projects
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicMerchantAuth: []
      parameters:
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/merchant_id-path-param'
      summary: Obtener proyectos
      description: |-
        Obtiene la lista de proyectos del comerciante.

        <div class="notice">
          <p><strong>Aviso</strong></p><p>Esta llamada API no contiene el parámetro de ruta <code>project_id</code>, para que no tenga que utilizar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.</p>
        </div>
      responses:
        '200':
          description: La información sobre los proyectos se recibió correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  total_items_count:
                    type: integer
                    example: 3
                  has_more:
                    type: boolean
                    example: true
                  items:
                    type: array
                    properties:
                      project_id:
                        type: integer
                        example: 17558
              examples:
                response:
                  value:
                    total_items_count: 2
                    has_more: false
                    items:
                      - project_id: 17558
                      - project_id: 17559
        '401':
          description: >-
            Autenticación básica no superada o errónea. Asegúrese de haber
            utilizado la autenticación básica o las credenciales correctas.
        '422':
          description: Parámetros de consulta de `limit` u `offset` no válidos.
  /v2/project/{project_id}/items:
    get:
      summary: Obtener lista de artículos vendibles
      description: "Obtiene una lista de artículos vendibles para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      operationId: get-sellable-items
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id_59080-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - common-catalog
      responses:
        '200':
          $ref: '#/components/responses/sellable_items_200-get-items-list'
  /v2/project/{project_id}/items/id/{item_id}:
    get:
      summary: Obtener artículo vendible por ID
      description: |-
        Obtiene un artículo vendible por su ID.

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      operationId: get-sellable-item-by-id
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id_59080-path-param'
        - $ref: '#/components/parameters/item_id_59080-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      tags:
        - common-catalog
      responses:
        '200':
          $ref: '#/components/responses/sellable_items_200-get-item-by-id'
        '404':
          $ref: '#/components/responses/sellable-item-by-id_404'
  /v2/project/{project_id}/items/sku/{sku}:
    get:
      summary: Obtener artículo vendible por SKU
      description: |-
        Obtiene un artículo vendible por SKU para crear un catálogo.

        <div class="note">
          <strong>Nota:</strong><br><br>
            Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
            autorización. Usa la autorización para recuperar
            <a href="https://developers.xsolla.com/es/doc/shop-builder/features/personalization/" target="_blank">datos personalizados</a>
            del usuario, como límites y promociones asociadas con el artículo.
            Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.
            Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>
            para esta llamada.</div>
      operationId: get-sellable-item-by-sku
      x-badges:
        - name: Client-side
          color: '#80eaff'
      security:
        - XsollaLoginUserJWT: []
      parameters:
        - $ref: '#/components/parameters/project_id_59080-path-param'
        - $ref: '#/components/parameters/item_sku_59080-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      tags:
        - common-catalog
      responses:
        '200':
          $ref: '#/components/responses/sellable_items_200-get-item-by-id'
        '404':
          $ref: '#/components/responses/sellable-item-by-sku_404'
  /v2/project/{project_id}/items/group/{external_id}:
    get:
      summary: Obtener lista de artículos vendibles por grupo especificado
      description: "Obtiene una lista de artículos vendibles del grupo especificado para crear un catálogo.\n\n<div class=\"notice\">\n  <strong>Atención:</strong><br><br>\n    Todos los proyectos tienen una limitación en el número de artículos que puede\n    obtener en la respuesta. El valor predeterminado y máximo es de <strong>50\_artículos\n    por cada respuesta.</strong> Para obtener más datos página por página, utilice los campos <b>limit</b>\n    y <b>offset</b>.</div>\n\n<br>\n\n<div class=\"note\">\n  <strong>Nota:</strong><br><br>\n    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin\n    autorización. Usa la autorización para recuperar\n    <a href=\"https://developers.xsolla.com/es/doc/shop-builder/features/personalization/\" target=\"_blank\">datos personalizados</a>\n    del usuario, como límites y promociones asociadas con el artículo.\n    Para hacer esto, transmita el JWT del usuario en el encabezado <code>Authorization</code>.\n    Para obtener más información sobre el JWT del usuario, consulte el bloque <b>Security</b>\n    para esta llamada.</div>"
      security:
        - XsollaLoginUserJWT: []
      operationId: get-sellable-items-group
      x-badges:
        - name: Client-side
          color: '#80eaff'
      parameters:
        - $ref: '#/components/parameters/project_id_59080-path-param'
        - $ref: '#/components/parameters/external_id_59080-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      tags:
        - common-catalog
      responses:
        '200':
          $ref: '#/components/responses/sellable_items_200-get-items-by-group-id'
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item-group'
  /v2/project/{project_id}/admin/region:
    get:
      summary: Obtener lista de regiones
      description: |-
        Obtiene la lista de regiones.

        Puede utilizar una región para gestionar sus restricciones regionales.
      operationId: admin-get-regions
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - common-regions
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-regions-list'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
    post:
      summary: Crear región
      description: |-
        Crea una región.

        Puede utilizar una región para gestionar sus restricciones regionales.
      security:
        - basicAuth: []
      operationId: admin-create-region
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - common-regions
      requestBody:
        $ref: '#/components/requestBodies/create-update-region'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-region'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
  /v2/project/{project_id}/admin/region/{region_id}:
    get:
      summary: Obtener región
      description: |-
        Obtiene una región concreta.

        Puede utilizar una región para gestionar sus restricciones regionales.
      operationId: admin-get-region
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/region_id-path-param'
      tags:
        - common-regions
      security:
        - basicAuth: []
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-region'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-region-not-found'
    put:
      summary: Actualizar región
      description: |-
        Actualiza una región concreta.

        Puede utilizar una región para gestionar sus restricciones regionales.
      security:
        - basicAuth: []
      operationId: admin-update-region
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/region_id-path-param'
      tags:
        - common-regions
      requestBody:
        $ref: '#/components/requestBodies/create-update-region'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-update-region'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-region-not-found'
    delete:
      summary: Eliminar región
      description: Elimina una región concreta.
      security:
        - basicAuth: []
      operationId: admin-delete-region
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/region_id-path-param'
      tags:
        - common-regions
      responses:
        '204':
          $ref: '#/components/responses/204-admin-delete-region'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-region-not-found'
  /v2/project/{project_id}/admin/attribute:
    get:
      summary: Obtener lista de atributos (admin)
      description: Obtiene la lista de atributos de un proyecto para su administración.
      operationId: admin-get-attribute-list
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      tags:
        - attribute-admin
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-attribute-list-response'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
    post:
      summary: Crear atributo
      description: Crea un atributo.
      security:
        - basicAuth: []
      operationId: admin-create-attribute
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      tags:
        - attribute-admin
      requestBody:
        $ref: '#/components/requestBodies/create-update-attribute'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-attribute'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-validation-failed'
  /v2/project/{project_id}/admin/attribute/{external_id}:
    put:
      summary: Actualizar atributo
      description: Actualiza un atributo.
      operationId: admin-update-attribute
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      tags:
        - attribute-admin
      requestBody:
        $ref: '#/components/requestBodies/create-update-attribute'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-update-attribute'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-validation-failed'
    get:
      summary: Obtener atributo especificado
      description: Obtiene un atributo especificado.
      operationId: admin-get-attribute
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      security:
        - basicAuth: []
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      tags:
        - attribute-admin
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-attribute'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-attribute-not-found'
    delete:
      summary: Eliminar atributo
      description: >-
        Elimina un atributo.


        <div class="notice"><strong>Aviso</strong><br><br>Si elimina un atributo
        de artículo, se perderán todos sus datos y conexiones con los
        artículos.</div>
      operationId: delete-attribute
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      tags:
        - attribute-admin
      security:
        - basicAuth: []
      responses:
        '204':
          description: El atributo se eliminó correctamente.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
  /v2/project/{project_id}/admin/attribute/{external_id}/value:
    post:
      summary: Crear valor de atributo
      description: >-
        Crea un valor de atributo.


        <div class="notice"><strong>Atención</strong><br><br>Todos los proyectos
        tienen limitación del número de valores de atributo. El valor por
        defecto y máximo es <strong>20 valores por atributo.</strong></div>
      operationId: admin-create-attribute-value
      security:
        - basicAuth: []
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-update-attribute-value'
      tags:
        - attribute-admin
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-attribute-value'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
        '404':
          $ref: '#/components/responses/404-attribute-not-found'
        '422':
          $ref: '#/components/responses/422-create-update-attribute-value'
    delete:
      summary: Borrar todos los valores del atributo
      description: >-
        Elimina todos los valores del atributo.


        <div class="notice"><strong>Aviso</strong><br><br>Si elimina el valor de
        un atributo, se perderán todas las conexiones entre el atributo y los
        artículos. Para cambiar el valor de atributo de un artículo, utilice la
        llamada API <a
        href="https://developers.xsolla.com/es/api/shop-builder/operation/admin-update-attribute-value/"
        target="_blank">Actualizar valor de atributo</a> en vez de eliminar el
        valor y crear uno nuevo.</div>
      operationId: admin-delete-all-attribute-value
      security:
        - basicAuth: []
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      tags:
        - attribute-admin
      responses:
        '204':
          description: Los valores de los atributos se eliminaron correctamente.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
  /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}:
    put:
      summary: Actualizar valor de atributo
      description: Actualiza los valores de un atributo.
      operationId: admin-update-attribute-value
      security:
        - basicAuth: []
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/value_external_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-update-attribute-value'
      tags:
        - attribute-admin
      responses:
        '204':
          description: El valor de atributo actualizó correctamente.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
        '404':
          $ref: '#/components/responses/404-attribute-value-not-found'
        '422':
          $ref: '#/components/responses/422-create-update-attribute-value'
    delete:
      summary: Eliminar valor de atributo
      description: >-
        Elimina un valor de atributo.


        <div class="notice"><strong>Aviso</strong><br><br>Si elimina el valor de
        un atributo, se perderán todas las conexiones entre el atributo y los
        artículos. Para cambiar el valor de atributo de un artículo, utilice la
        llamada API <a
        href="https://developers.xsolla.com/es/api/shop-builder/operation/admin-update-attribute-value/"
        target="_blank">Actualizar valor de atributo</a> en vez de eliminar el
        valor y crear uno nuevo.</div>
      operationId: admin-delete-attribute-value
      security:
        - basicAuth: []
      x-badges:
        - name: Server-side
          color: '#95ff80'
        - name: Admin
          color: '#d7dee0'
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/value_external_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      tags:
        - attribute-admin
      responses:
        '204':
          description: El valor de atributo se eliminó correctamente.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
components:
  securitySchemes:
    basicAuth:
      type: http
      description: >-
        Las llamadas del lado del servidor utilizan el esquema de autenticación
        `basicAuth`. Todas las solicitudes a la API deben

        contener el encabezado `Authorization: Basic
        <your_authorization_basic_key>`,

        donde `your_authorization_basic_key` es el par `project_id:api_key`

        codificado según el estándar Base64.


        Puede utilizar `merchant_id` en lugar de `project_id` si lo necesita. No
        afecta a la funcionalidad.


        Vaya a [Cuenta de editor](https://publisher.xsolla.com/) para encontrar
        los valores de los parámetros:


        * Se muestra `merchant_id`:
          * En la sección **Configuración de la empresa > Empresa**
          * En la URL en la barra de direcciones del navegador en cualquier página de Cuenta del editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/<merchant_id>`.
        * `api_key` se muestra en Cuenta del Editor solo una vez cuando se crea
        y debe almacenarse en su servidor. Puede crear una nueva clave en la
        siguiente sección:
          * [Configuración de la empresa > Claves API](https://publisher.xsolla.com/0/settings/api_key)
          * [Configuración del proyecto > Claves API](https://publisher.xsolla.com/0/projects/0/edit/api_key)

        {% html name="div" attrs={"class": "notice"} %}

        **Aviso**


        Si una llamada API requerida no incluye el parámetro de ruta
        `project_id`, utilice una clave API que sea válida para todos los
        proyectos de la empresa para la autorización.

        {% /html %}


        * Se muestra `project_id`:
          * En Cuenta del Editor junto al nombre del proyecto.
          * En la URL de la barra de direcciones del navegador cuando se trabaja en el proyecto en Cuenta del Editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/<merchant_id>/projects/<project_id>`.

        Para más información sobre cómo trabajar con claves API, consulte la
        [referencia
        API](https://developers.xsolla.com/es/api/getting-started/#api_keys_overview).
      scheme: basic
    XsollaLoginUserJWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Las llamadas del lado del cliente utilizan el esquema de autenticación
        `XsollaLoginUserJWT`. a solicitud debe incluir el JWT del usuario en el
        encabezado `Authorization` con el siguiente formato: Bearer
        `<user_JWT>`. El token identifica al usuario y permite acceder a datos
        personalizados. Para obtener más información sobre cómo crear un token,
        consulte la [documentación de la API de Xsolla
        Login](/es/api/login/authentication-schemes#getting-user-token).


        También puede utilizar un [token para abrir la interfaz de
        pago](/es/api/pay-station/token/create-token).
    AuthForCart:
      type: http
      scheme: bearer
      description: >-
        El esquema de autenticación `AuthForCart` se utiliza para las compras
        con cesta y admite dos modos:


        1. Autenticación con el JWT de un usuario. El token se transmite en el
        encabezado Authorization con el siguiente formato: `Authorization:
        Bearer <user_JWT>`, en el que `<user_JWT>` es el token del usuario. El
        token identifica al usuario y proporciona acceso a datos personalizados.


        También puede utilizar un [token para abrir la interfaz de
        pago](/es/api/pay-station/token/create-token).


        2. Modo simplificado sin el encabezado `Authorization`. Este modo se
        utiliza únicamente para usuarios no autorizados y solo se puede aplicar
        a la [venta de claves de
        juegos](/es/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users).
        En lugar de un token, la solicitud debe incluir los siguientes
        encabezados:

        * `x-unauthorized-id` con un ID de solicitud

        * `x-user` con la dirección de correo electrónico del usuario codificada
        en Base64.
    basicMerchantAuth:
      type: http
      description: >-
        Las llamadas del lado del servidor emplean el esquema de autenticación
        `basicMerchantAuth`. Todas las solicitudes a la API deben

        contener el encabezado `Authorization: Basic
        <your_authorization_basic_key>`,

        en el que `your_authorization_basic_key` es el par `merchant_id:api_key`

        codificado según el estándar Base64.


        Vaya a [Cuenta de editor](https://publisher.xsolla.com/) para encontrar
        los valores de los parámetros:


        * `merchant_id` se muestra:
          * En la sección **Configuración de la empresa > Empresa**
          * En la URL en la barra de direcciones del navegador en cualquier página de Cuenta del editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/<merchant_id>`
        * `api_key` se muestra en Cuenta del editor solo una vez cuando se crea
        y debe almacenarse en su servidor. Puede crear una nueva clave en la
        sección [Configuración de la empresa > Claves de
        API](https://publisher.xsolla.com/0/settings/api_key).


        Para más información sobre cómo trabajar con claves API, consulte la
        [referencia
        API](https://developers.xsolla.com/es/api/getting-started/#api_keys_overview).
      scheme: basic
  parameters:
    project_id-path-param:
      name: project_id
      in: path
      required: true
      description: >-
        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>`.
      schema:
        type: integer
        example: 44056
    limit-query-param:
      name: limit
      in: query
      example: 50
      required: false
      description: Límite para el número de elementos presentes en la página.
      schema:
        type: integer
        example: 50
        minimum: 1
    offset-query-param:
      name: offset
      in: query
      required: false
      example: 0
      description: >-
        Número del elemento a partir del cual se genera la lista (el conteo
        empieza desde el 0).
      schema:
        type: integer
        example: 0
        minimum: 0
    external_id-group-path-param:
      name: external_id
      in: path
      required: true
      description: >-
        [ID de grupo de artículos
        externo](/es/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id)
        especificado durante la creación.
      schema:
        type: string
        example: weapons
    group_id-path-param:
      name: group_id
      in: path
      required: true
      description: ID del grupo.
      schema:
        type: integer
        example: 10
    item_sku-path-param:
      name: item_sku
      in: path
      required: true
      description: SKU del artículo.
      schema:
        type: string
        example: booster_mega_1
    virtual_currency_sku-path-param:
      name: virtual_currency_sku
      in: path
      required: true
      description: SKU de la moneda virtual.
      schema:
        type: string
        example: crystal
    locale-query-param:
      name: locale
      in: query
      required: false
      description: "Idioma de respuesta. Código de idioma de dos letras minúsculas según la norma ISO 639-1. (p.\_ej., `en`). Los códigos de configuración regional de cinco\_caracteres (p.\_ej., `en-US`) se admiten en campos de localización como `name` y `description`, pero se normalizan como códigos de dos letras en las respuestas. Puede consultar la lista completa de idiomas admitidos en la [documentación](https://developers.xsolla.com/es/doc/shop-builder/references/supported-languages/)."
      schema:
        type: string
        default: en
    additional_fields-query-param:
      name: additional_fields[]
      in: query
      required: false
      description: >-
        Campos adicionales para incluir en la respuesta. Por defecto, estos
        campos no se devuelven. Para incluirlos, hay que transmitir los valores
        necesarios.
      schema:
        type: array
        items:
          type: string
          enum:
            - media_list
            - order
            - long_description
            - custom_attributes
            - item_order_in_group
    country-query-param:
      name: country
      in: query
      required: false
      description: >-
        Código de país de dos letras mayúsculas de conformidad con la norma [ISO
        3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
        Consulte la documentación para obtener información detallada sobre los
        [países admitidos por
        Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/)
        y el [proceso de determinación del
        país](https://developers.xsolla.com/es/doc/shop-builder/features/pricing-policy/#pricing_policy_country_determination).
      schema:
        type: string
        example: US
    promo_code-query-param:
      name: promo_code
      in: query
      required: false
      description: >-
        Código único que distingue entre mayúsculas y minúsculas. Contiene
        letras y números.
      schema:
        type: string
        example: WINTER2021
        minLength: 1
        maxLength: 128
    show_inactive_time_limited_items-query-param:
      name: show_inactive_time_limited_items
      in: query
      required: false
      description: >-
        Muestra los artículos de duración limitada que no están disponibles para
        el usuario. El periodo de validez de dichos artículos no ha comenzado o
        ya ha expirado.
      schema:
        type: integer
        example: 1
        default: 0
    virtual_currency_package_sku-path-param:
      name: virtual_currency_package_sku
      in: path
      required: true
      description: SKU del paquete de moneda virtual.
      schema:
        type: string
        example: crystal-pack
    with_geo-query-param:
      name: with_geo
      in: query
      required: false
      description: >-
        Si se debe devolver o no la información sobre la configuración regional
        y del país del usuario en los encabezados de la respuesta. Si se
        establece como `true`, la respuesta incluye los encabezados
        `X-User-Locale-Code` y `X-User-Country-Code`.
      schema:
        type: boolean
        default: false
    item_type-group-path-param:
      name: item_type
      in: path
      required: true
      description: "Tipo de artículo usado para filtrar grupos. Determina qué artículos se incluyen en `items_count`. Los valores que contengan `/` (p.\_ej., `virtual_currency/package` o `game/key`) deben codificarse según el formato URL (p.\_ej., `virtual_currency%2Fpackage`)."
      schema:
        type: string
        enum:
          - virtual_items
          - virtual_currency
          - virtual_currency/package
          - game/key
          - bundle
          - game
          - value_points
          - subscription_plans
        example: virtual_items
    id-group-path-param:
      name: id
      in: path
      required: true
      description: ID del grupo de artículos asignado por Xsolla.
      schema:
        type: integer
        example: 1
    platform-query-param:
      name: platform
      in: query
      required: false
      description: >-
        Plataforma de publicación en la que juega el usuario: `xsolla` (por
        defecto), `playstation_network`, `xbox_live`, `pc_standalone`,
        `nintendo_shop`, `google_play`, `app_store_ios`, `android_standalone`,
        `ios_standalone`, `android_other`, `ios_other` y `pc_other`.
      schema:
        type: string
        enum:
          - playstation_network
          - xbox_live
          - xsolla
          - pc_standalone
          - nintendo_shop
          - google_play
          - app_store_ios
          - android_standalone
          - ios_standalone
          - android_other
          - ios_other
          - pc_other
        default: xsolla
    item_id-path-param:
      name: item_id
      in: path
      required: true
      description: ID del artículo.
      schema:
        type: string
        example: '656'
    user_email-query-param:
      name: user_email
      in: query
      required: true
      description: Correo del usuario.
      schema:
        type: string
        example: email@email.com
    quantity-query-param:
      name: quantity
      in: query
      required: true
      description: Cantidad de códigos.
      schema:
        type: integer
        example: 100
    reason-query-param:
      name: reason
      in: query
      required: true
      description: Motivo de recepción de códigos.
      schema:
        type: string
        example: Very important
    region_id-query-param:
      name: region_id
      in: query
      required: false
      description: ID de la región.
      schema:
        type: integer
        default: 1
    sandbox-query-param:
      name: sandbox
      in: query
      required: false
      description: >-
        Qué tipo de asignación de derechos deben devolverse. Si el parámetro se
        establece en 1, solo se devolverán los derechos recibidos por el usuario
        en el modo aislador de proceso (sandbox). Si el parámetro no se
        transmite o se establece en 0, solo se devolverán los derechos recibidos
        por el usuario en el modo real.
      schema:
        type: integer
        default: 0
    additional_fields-entitlement-query-param:
      name: additional_fields[]
      in: query
      required: false
      description: >-
        Lista de campos adicionales. Estos campos estarán en la respuesta si los
        envía en su solicitud. `attributes` de campos disponibles.
      schema:
        type: array
        items:
          type: string
    sku-path-param:
      name: sku
      in: path
      required: true
      description: SKU del lote.
      schema:
        type: string
        example: kg_1
    cart_id-path-param:
      name: cart_id
      in: path
      required: true
      description: ID de la cesta.
      schema:
        type: string
        example: custom_id
    currency-query-param:
      name: currency
      in: query
      required: false
      description: >-
        Moneda en la que se muestra el precio del artículo en la cesta. Código
        de moneda 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/).
      schema:
        type: string
        default: USD
    order_id-path-param:
      name: order_id
      in: path
      required: true
      description: ID del pedido.
      schema:
        type: string
        example: '656'
    x-user-for-header:
      in: header
      name: x-user-for
      example: ACCESS_TOKEN/LOGIN_JWT
      schema:
        type: string
      required: false
      description: >-
        El identificador de usuario puede transferirse utilizando el JWT de
        usuario de Xsolla Login o el [token de acceso a Pay
        Station](https://developers.xsolla.com/es/pay-station-api/current/token/create-token).
    x-user-id-header:
      in: header
      name: x-user-id
      example: UNIQUE_ID
      schema:
        maxLength: 32
        type: string
      required: false
      description: Puede utilizar su propio ID de usuario para vender una cesta con juegos.
    user_external_id-query-param:
      name: user_external_id
      in: query
      required: true
      description: ID externo del usuario
      schema:
        type: string
        example: d342dad2-9d59-11e9-a384-42010aa8003f
    merchant_id-path-param:
      name: merchant_id
      in: path
      required: true
      description: ID de comerciante.
      schema:
        type: integer
        example: 121212
    project_id_59080-path-param:
      name: project_id
      in: path
      required: true
      description: >-
        ID del proyecto. Encontrará este parámetro en su [Cuenta del
        editor](https://publisher.xsolla.com/) junto al nombre del proyecto.
      schema:
        type: integer
        example: 59080
    item_id_59080-path-param:
      name: item_id
      in: path
      required: true
      description: ID del artículo.
      schema:
        type: string
        example: '259774'
    item_sku_59080-path-param:
      name: sku
      in: path
      required: true
      description: SKU del artículo.
      schema:
        type: string
        example: electric_shield
    external_id_59080-group-path-param:
      name: external_id
      in: path
      required: true
      description: ID externo del grupo.
      schema:
        type: string
        default: armour
    region_id-path-param:
      name: region_id
      in: path
      required: true
      description: ID de región. Identificador único de región dentro del proyecto.
      schema:
        type: integer
        example: 42
    external_id-attr-path-param:
      name: external_id
      in: path
      required: true
      description: ID externo del atributo.
      schema:
        type: string
        example: attribute_id
    value_external_id-path-param:
      name: value_external_id
      in: path
      required: true
      description: ID externo del valor de atributo.
      schema:
        type: string
        pattern: ^[-_\.\d\w]+$
        example: value_id
  schemas:
    Virtual-Items-Currency_sku:
      type: string
      minLength: 1
      maxLength: 255
      pattern: ^[a-zA-Z0-9_\-–.]*$
      example: booster_mega_1
      description: >-
        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.
    admin-attribute-external_id:
      type: string
      minLength: 1
      maxLength: 255
      pattern: ^[a-zA-Z0-9-_]+$
      example: attribute_1
      description: >-
        ID único del atributo. `external_id` solo puede contener caracteres
        alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones
        bajos.
    admin-attribute-name:
      type: object
      description: >-
        Objeto con traducciones para el nombre del atributo. Las claves se
        especifican en la norma ISO 3166-1.
      additionalProperties:
        type: string
      example:
        en: Genre
        de: Genre
      default:
        en: Genre
        de: Genre
    value-external_id:
      type: string
      minLength: 1
      maxLength: 255
      pattern: ^[-_.\d\w]+$
      example: attribute_value
      description: >-
        ID del valor único para un atributo. `external_id` solo puede contener
        caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.
    value-name:
      type: object
      description: >-
        Objeto con traducciones del nombre del valor. Las claves se especifican
        en la norma ISO 3166-1.
      additionalProperties:
        type: string
      example:
        en: Strategy
        de: Strategie
      default:
        en: Strategy
        de: Strategie
    attribute-value:
      type: object
      required:
        - value
        - external_id
      properties:
        external_id:
          $ref: '#/components/schemas/value-external_id'
        value:
          $ref: '#/components/schemas/value-name'
      example:
        external_id: value_external_id
        name:
          en: Value 1
          de: Wert 1
    attribute:
      type: object
      required:
        - external_id
        - values
      properties:
        external_id:
          $ref: '#/components/schemas/admin-attribute-external_id'
        name:
          $ref: '#/components/schemas/admin-attribute-name'
        values:
          type: array
          items:
            $ref: '#/components/schemas/attribute-value'
          example:
            - external_id: strategy
              value:
                en: Strategy
                de: Strategie
            - external_id: action
              value:
                en: Action
                de: Aktion
      example:
        external_id: attribute_external_id
        name:
          en: Attribute name
          de: Attributname
        values:
          - external_id: value_1
            name:
              en: value 1
              de: wert 1
          - external_id: value_2
            name:
              en: value 2
              de: wert 2
    Virtual-Items-Currency_schemas-admin-attributes:
      type: array
      description: Lista de atributos.
      items:
        $ref: '#/components/schemas/attribute'
    Virtual-Items-Currency_admin-attributes:
      allOf:
        - $ref: '#/components/schemas/Virtual-Items-Currency_schemas-admin-attributes'
        - description: Lista de atributos.
    two-letter-locale:
      type:
        - object
        - 'null'
      description: Códigos lingüísticos de dos letras minúsculas.
      title: de dos letras
      properties:
        en:
          type:
            - string
            - 'null'
          description: Inglés
        ar:
          type:
            - string
            - 'null'
          description: Árabe
        bg:
          type:
            - string
            - 'null'
          description: Búlgaro
        cn:
          type:
            - string
            - 'null'
          description: Chino (simplificado)
        cs:
          type:
            - string
            - 'null'
          description: Checo
        de:
          type:
            - string
            - 'null'
          description: Alemán
        es:
          type:
            - string
            - 'null'
          description: Español (España)
        fr:
          type:
            - string
            - 'null'
          description: Francés
        he:
          type:
            - string
            - 'null'
          description: Hebreo
        it:
          type:
            - string
            - 'null'
          description: Italiano
        ja:
          type:
            - string
            - 'null'
          description: Japonés
        ko:
          type:
            - string
            - 'null'
          description: Coreano
        pl:
          type:
            - string
            - 'null'
          description: Polaco
        pt:
          type:
            - string
            - 'null'
          description: Portugués
        ro:
          type:
            - string
            - 'null'
          description: Rumano
        ru:
          type:
            - string
            - 'null'
          description: Ruso
        th:
          type:
            - string
            - 'null'
          description: Tailandés
        tr:
          type:
            - string
            - 'null'
          description: Turco
        tw:
          type:
            - string
            - 'null'
          description: Chino (tradicional)
        vi:
          type:
            - string
            - 'null'
          description: Vietnamita
        km:
          type:
            - string
            - 'null'
          description: Jemer
        id:
          type:
            - string
            - 'null'
          description: Indonesio
        lo:
          type:
            - string
            - 'null'
          description: Laosiano
        my:
          type:
            - string
            - 'null'
          description: Birmano
        ph:
          type:
            - string
            - 'null'
          description: Filipino
        ne:
          type:
            - string
            - 'null'
          description: Nepalí
    five-letter-locale:
      type:
        - object
        - 'null'
      description: "Códigos de configuración regional de cinco\_caracteres."
      title: cinco letras
      properties:
        en-US:
          type:
            - string
            - 'null'
          description: Inglés
        ar-AE:
          type:
            - string
            - 'null'
          description: Árabe
        bg-BG:
          type:
            - string
            - 'null'
          description: Búlgaro
        zh-CN:
          type:
            - string
            - 'null'
          description: Chino (simplificado)
        cs-CZ:
          type:
            - string
            - 'null'
          description: Checo
        de-DE:
          type:
            - string
            - 'null'
          description: Alemán
        es-ES:
          type:
            - string
            - 'null'
          description: Español (España)
        fr-FR:
          type:
            - string
            - 'null'
          description: Francés
        he-IL:
          type:
            - string
            - 'null'
          description: Hebreo
        it-IT:
          type:
            - string
            - 'null'
          description: Italiano
        ja-JP:
          type:
            - string
            - 'null'
          description: Japonés
        ko-KR:
          type:
            - string
            - 'null'
          description: Coreano
        pl-PL:
          type:
            - string
            - 'null'
          description: Polaco
        pt-BR:
          type:
            - string
            - 'null'
          description: Portugués (Brasil)
        ro-RO:
          type:
            - string
            - 'null'
          description: Rumano
        ru-RU:
          type:
            - string
            - 'null'
          description: Ruso
        th-TH:
          type:
            - string
            - 'null'
          description: Tailandés
        tr-TR:
          type:
            - string
            - 'null'
          description: Turco
        zh-TW:
          type:
            - string
            - 'null'
          description: Chino (tradicional)
        vi-VN:
          type:
            - string
            - 'null'
          description: Vietnamita
        km-KH:
          type:
            - string
            - 'null'
          description: Jemer
        id-ID:
          type:
            - string
            - 'null'
          description: Indonesio
        lo-LA:
          type:
            - string
            - 'null'
          description: Laosiano
        my-MM:
          type:
            - string
            - 'null'
          description: Birmano
        ph-PH:
          type:
            - string
            - 'null'
          description: Filipino
        ne-NP:
          type:
            - string
            - 'null'
          description: Nepalí
    name-localization-object:
      type:
        - object
        - 'null'
      description: "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/)."
      anyOf:
        - $ref: '#/components/schemas/two-letter-locale'
        - $ref: '#/components/schemas/five-letter-locale'
    description-localization-object:
      type:
        - object
        - 'null'
      description: "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/)."
      anyOf:
        - $ref: '#/components/schemas/two-letter-locale'
        - $ref: '#/components/schemas/five-letter-locale'
    long-description-localization-object:
      type:
        - object
        - 'null'
      description: "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/)."
      anyOf:
        - $ref: '#/components/schemas/two-letter-locale'
        - $ref: '#/components/schemas/five-letter-locale'
    Virtual-Items-Currency_admin-groups-response:
      type: array
      example:
        - external_id: horror
          name:
            en: Horror
      default: []
      description: Grupos a los que pertenece el artículo.
      items:
        type: object
        properties:
          external_id:
            type: string
            example: horror
          name:
            type: object
            description: >-
              Nombre del artículo. Debe contener pares clave/valor

              en los cuales clave es una configuración regional con formato
              "^[a-z]{2}", valor es una cadena (string).
            example:
              en: Horror
              de: Horror
            default:
              en: Horror
            additionalProperties:
              type: string
    Virtual-Items-Currency_admin-media_list:
      type: array
      example:
        - type: image
          url: >-
            https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
      description: >-
        Recursos adicionales del artículo como capturas de pantalla, vídeos de
        partidas del juego, etc.
      items:
        type: object
        properties:
          type:
            type: string
            enum:
              - image
              - video
            example: image
            description: 'Tipo de soporte multimedia: `image`/`video`.'
          url:
            type: string
            example: >-
              https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
            description: Archivo de recurso.
    Virtual-Items-Currency_type:
      type: string
      description: >-
        Tipo de artículo:
        `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
    Virtual-Items_admin-prices:
      type: array
      items:
        type: object
        required:
          - amount
          - currency
        properties:
          amount:
            description: Importe.
            type: number
            exclusiveMinimum: 0
          currency:
            type: string
            example: USD
            description: >-
              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/).
          country_iso:
            type: string
            description: >-
              Código de país de dos letras mayúsculas de conformidad con la
              norma [ISO 3166-1
              alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
              Consulte la documentación para obtener información detallada sobre
              los [países admitidos por
              Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/).
              <br>Ejemplo: `country=US`
            example: US
          is_default:
            type: boolean
            default: false
          is_enabled:
            type: boolean
            default: true
        example:
          currency: USD
          amount: 10.5
          is_default: true
          is_enabled: true
    Virtual-Items-Currency_schemas-sku:
      type: string
      example: bundle_1
      description: >-
        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.
    Virtual-Items-Currency_admin-get-vc_prices:
      type: array
      items:
        type: object
        required:
          - sku
          - amount
        properties:
          sku:
            $ref: '#/components/schemas/Virtual-Items-Currency_schemas-sku'
          amount:
            description: Importe.
            type: number
            exclusiveMinimum: 0
          is_default:
            type: boolean
            default: false
        example:
          sku: com.xsolla.gold_1
          amount: 10
          is_default: true
    Virtual-Items-Currency_admin-image_url:
      type: string
      description: "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:<ul><li>Formatos compatibles: WebP (recomendado), PNG y JPG.</li><li>Tamaño del archivo: ≤\_50\_KB (para WebP) o ≤\_150\_KB (para PNG y JPG).</li><li>Tamaño de la imagen: 280\_x\_280\_píxeles.</li><li>Espacio de color: sRGB.</li><li>Protocolo: HTTPS con almacenamiento en caché de larga duración para las URL versionadas.</li></ul>"
    value-is_free:
      type: boolean
      example: false
      default: false
      description: Si el artículo es gratuito.
    value-is_paid_randomized_reward:
      type: boolean
      example: false
      default: false
      description: "Si el artículo es o no una recompensa de pago aleatoria, p.\_ej., una caja de botín."
    Virtual-Items-Currency_order:
      type: integer
      example: 1
      default: 1
      description: >-
        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.
    Virtual-Items-Currency_is_enabled:
      type: boolean
      example: true
      default: true
      description: >-
        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.
    Virtual-Items-Currency_is_show_in_store:
      type: boolean
      example: true
      default: false
      description: >-
        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.
    Virtual-Items-Currency_admin-regions:
      description: >-
        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.
      type: array
      items:
        type: object
        properties:
          id:
            type: integer
            minimum: 1
            example: 1
            description: >-
              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.
    limit_exceeded_visibility:
      type: string
      example: show
      enum:
        - show
        - hide
      description: >-
        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.
      default: show
    admin_recurrent_schedule_response:
      type:
        - object
        - 'null'
      description: Periodo de actualización del límite.
      properties:
        per_user:
          type:
            - object
            - 'null'
          description: Periodo de actualización del límite del usuario.
          oneOf:
            - type: object
              title: interval_type = daily
              description: Tipo diario de actualización del límite del usuario.
              properties:
                interval_type:
                  type: string
                  description: Tipo de periodo de actualización recurrente.
                  enum:
                    - daily
                time:
                  type: string
                  description: >-
                    Hora de actualización del límite en la zona horaria deseada
                    (redondeo a horas).
                  format: full-time
                  example: 11:00:00+03:00
                reset_next_date:
                  type: integer
                  description: >-
                    Fecha y hora de actualización de los límites (Marca de
                    tiempo Unix).
                  example: 1677553200
                displayable_reset_start_date:
                  description: >-
                    Fecha y hora de la primera actualización del límite (ISO
                    8601).
                  type: string
                  format: date-time
                  example: '2023-02-28T11:00:00+08:00'
                displayable_reset_next_date:
                  description: >-
                    Fecha y hora en que deben restablecerse los límites (ISO
                    8601).
                  type: string
                  format: date-time
                  example: '2023-02-28T11:00:00+08:00'
            - type: object
              title: interval_type = weekly
              description: Tipo semanal de actualización de los límites del usuario.
              properties:
                interval_type:
                  type: string
                  description: Tipo de periodo de actualización recurrente.
                  enum:
                    - weekly
                day_of_week:
                  type:
                    - integer
                    - 'null'
                  description: >-
                    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`.
                  minimum: 1
                  maximum: 7
                time:
                  type: string
                  description: >-
                    Hora de actualización del límite en la zona horaria deseada
                    (redondeo a horas).
                  format: full-time
                  example: 11:00:00+03:00
                reset_next_date:
                  type: integer
                  description: >-
                    Fecha y hora de actualización de los límites (Marca de
                    tiempo Unix).
                  example: 1677553200
                displayable_reset_start_date:
                  description: >-
                    Fecha y hora de la primera actualización del límite (ISO
                    8601).
                  type: string
                  format: date-time
                  example: '2023-02-28T11:00:00+08:00'
                displayable_reset_next_date:
                  description: >-
                    Fecha y hora en que deben restablecerse los límites (ISO
                    8601).
                  type: string
                  format: date-time
                  example: '2023-02-28T11:00:00+08:00'
            - type: object
              title: interval_type = monthly
              description: Tipo mensual de actualización de los límites del usuario.
              properties:
                interval_type:
                  type: string
                  description: Tipo de periodo de actualización recurrente.
                  enum:
                    - monthly
                day_of_month:
                  type:
                    - integer
                    - 'null'
                  description: >-
                    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`.
                  minimum: 1
                  maximum: 31
                time:
                  type: string
                  description: >-
                    Hora de actualización del límite en la zona horaria deseada
                    (redondeo a horas).
                  format: full-time
                  example: 11:00:00+03:00
                reset_next_date:
                  type: integer
                  description: >-
                    Fecha y hora de actualización de los límites (Marca de
                    tiempo Unix).
                  example: 1677553200
                displayable_reset_start_date:
                  description: >-
                    Fecha y hora de la primera actualización del límite (ISO
                    8601).
                  type: string
                  format: date-time
                  example: '2023-02-28T11:00:00+08:00'
                displayable_reset_next_date:
                  description: >-
                    Fecha y hora en que deben restablecerse los límites (ISO
                    8601).
                  type: string
                  format: date-time
                  example: '2023-02-28T11:00:00+08:00'
            - type: object
              title: interval_type = hourly
              description: >-
                Restablecimiento del límite de usuarios que se realiza cada
                intervalo especificado en horas.
              properties:
                interval_type:
                  type: string
                  description: Tipo de periodo de actualización recurrente.
                  enum:
                    - hourly
                hours_interval:
                  type: integer
                  description: "Intervalo en horas tras el cual se actualiza el límite. <br><br> 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 <a href=\"https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-virtual-item/#!path=periods/date_from&t=request\">date_from</a>. <br><br> 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\"`."
                  minimum: 1
                  maximum: 10000
                reset_next_date:
                  type: integer
                  description: >-
                    Fecha y hora de actualización de los límites (Marca de
                    tiempo Unix).
                  example: 1677553200
                displayable_reset_start_date:
                  description: >-
                    Fecha y hora de la primera actualización del límite (ISO
                    8601).
                  type: string
                  format: date-time
                  example: '2023-02-28T11:00:00+08:00'
                displayable_reset_next_date:
                  description: >-
                    Fecha y hora en que deben restablecerse los límites (ISO
                    8601).
                  type: string
                  format: date-time
                  example: '2023-02-28T11:00:00+08:00'
    admin-item-limit-response:
      type:
        - object
        - 'null'
      description: Límites del artículo.
      properties:
        per_user:
          type:
            - object
            - 'null'
          description: Limitación de artículos para un usuario independiente.
          properties:
            total:
              type: integer
              description: Número máximo de artículos que un mismo usuario puede comprar.
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
        per_item:
          type:
            - object
            - 'null'
          description: Limitación global de artículos.
          properties:
            total:
              type: integer
              description: >-
                Número máximo de artículos que pueden comprar todos los
                usuarios.
            available:
              type: integer
              description: >-
                Número restante de artículos que todos los usuarios pueden
                comprar.
            reserved:
              type: integer
            sold:
              type: integer
        recurrent_schedule:
          $ref: '#/components/schemas/admin_recurrent_schedule_response'
    item-periods-response:
      type: array
      description: Periodo de venta del artículo.
      items:
        type: object
        properties:
          date_from:
            type:
              - string
              - 'null'
            format: date-time
            example: '2020-08-11T10:00:00+03:00'
            description: >-
              Fecha en la que el artículo especificado estará disponible para la
              venta.
          date_until:
            type:
              - string
              - 'null'
            format: date-time
            example: '2020-08-11T20:00:00+03:00'
            description: >-
              Fecha en la que el artículo especificado dejará de estar
              disponible para la venta. Puede ser `null`.
    item-custom-attributes-response:
      type: object
      description: Un objeto JSON que contiene los atributos y valores del artículo.
      format: json
    Virtual-Items-Currency_admin-virtual-item:
      type: object
      properties:
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-attributes'
        name:
          $ref: '#/components/schemas/name-localization-object'
        description:
          $ref: '#/components/schemas/description-localization-object'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-response'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        type:
          $ref: '#/components/schemas/Virtual-Items-Currency_type'
        prices:
          $ref: '#/components/schemas/Virtual-Items_admin-prices'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-get-vc_prices'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_paid_randomized_reward:
          $ref: '#/components/schemas/value-is_paid_randomized_reward'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        limits:
          $ref: '#/components/schemas/admin-item-limit-response'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
    Virtual-Items-Currency_schemas-admin-image_url:
      type: string
      example: https://image.example.com
      description: "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:<ul><li>Formatos compatibles: WebP (recomendado), PNG y JPG.</li><li>Tamaño del archivo: ≤\_50\_KB (para WebP) o ≤\_150\_KB (para PNG y JPG).</li><li>Tamaño de la imagen: 280\_x\_280\_píxeles.</li><li>Espacio de color: sRGB.</li><li>Protocolo: HTTPS con almacenamiento en caché de larga duración para las URL versionadas.</li></ul>"
    Virtual-Items-Currency_admin-groups-create:
      type: array
      description: >-
        Lista de los [ID externo del
        grupo](/es/api/catalog/item-groups-admin/admin-get-item-group-list/#!path=groups/external_id&t=response)
        a los que pertenece el artículo.


        Ejemplo: ["horror", "action"]
      items:
        type: string
        properties:
          external_id:
            type: string
            example: accessory
          name:
            type: string
            example: Accessory
    admin-post-put-attribute-item:
      type: object
      required:
        - external_id
        - values
      maxItems: 6
      properties:
        external_id:
          $ref: '#/components/schemas/admin-attribute-external_id'
        name:
          $ref: '#/components/schemas/admin-attribute-name'
        values:
          type: array
          description: >-
            <div class="notice"><strong>Atención.</strong> No puede
            <strong>crear más de 6 valores</strong> para cada atributo.
            Cualquier intento de exceder el límite resultará en un error.</div>
          items:
            $ref: '#/components/schemas/attribute-value'
          example:
            - external_id: strategy
              value:
                en: Strategy
                de: Strategie
            - external_id: action
              value:
                en: Action
                de: Aktion
    Virtual-Items-Currency_admin-post-put-attributes:
      type: array
      maxItems: 20
      description: >-
        Lista de atributos.


        <div class="notice"><strong>Atención.</strong> No <strong>puede
        especificar más de 20 atributos</strong> para el artículo. Cualquier
        intento de superar el límite provocará un error.</div>
      items:
        $ref: '#/components/schemas/admin-post-put-attribute-item'
    Virtual-Items-Currency_admin-create-vc_prices:
      description: Matriz de precios en moneda virtual.
      type:
        - array
        - 'null'
      items:
        type: object
        properties:
          sku:
            $ref: '#/components/schemas/Virtual-Items-Currency_schemas-sku'
          amount:
            type: integer
            description: Precio del artículo en moneda virtual.
          is_default:
            type: boolean
            default: false
            description: Si es o no el precio predeterminado en moneda virtual.
          is_enabled:
            type: boolean
            default: true
            description: >-
              Si este precio se utiliza o no para la visualización en el
              catálogo y para comprar el artículo. Si es `false`, no se utiliza
              ese precio.
        required:
          - amount
          - sku
          - is_default
          - is_enabled
        example:
          sku: com.xsolla.gold_1
          amount: 10
          is_default: true
          is_enabled: true
    limit_per_user:
      description: Limitación de artículos para un usuario independiente.
      anyOf:
        - type: 'null'
          description: No hay límite de compra de artículos por usuario.
        - type: integer
          description: Número máximo de artículos que un mismo usuario puede comprar.
          example: 5
        - type: object
          description: Configuración detallada del límite de compra.
          properties:
            total:
              type: integer
              description: Número máximo de artículos que un mismo usuario puede comprar.
              example: 5
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
    limit_per_item:
      type:
        - integer
        - 'null'
      description: Limitación global de artículos.
      example: 10
    per_user_daily:
      type: object
      title: interval_type = daily
      description: Tipo diario de actualización del límite del usuario.
      properties:
        interval_type:
          type: string
          description: Periodo de actualización recurrente.
          enum:
            - daily
        time:
          type: string
          description: >-
            Hora de actualización del límite en la zona horaria deseada
            (redondeo a horas).
          pattern: >-
            ((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])
          example: 02:00:00+03:00
      required:
        - interval_type
        - time
    per_user_weekly:
      type: object
      title: interval_type = weekly
      description: Tipo semanal de actualización de los límites del usuario.
      properties:
        interval_type:
          type: string
          description: Periodo de actualización recurrente.
          enum:
            - weekly
        day_of_week:
          type: integer
          description: >-
            Día de la semana en que se actualizan los límites. En el cual el 1
            es lunes y el 7 es domingo.
          minimum: 1
          maximum: 7
        time:
          type: string
          description: >-
            Hora de actualización del límite en la zona horaria deseada
            (redondeo a horas).
          pattern: >-
            ((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])
          example: 11:00:00+03:00
    per_user_monthly:
      type: object
      title: interval_type = monthly
      description: Tipo mensual de actualización de los límites del usuario.
      properties:
        interval_type:
          type: string
          description: Periodo de actualización recurrente.
          enum:
            - monthly
        day_of_month:
          type: integer
          description: >-
            Día del mes en que se actualizan los límites. Si no hay ningún día
            seleccionado en el mes por que es más corto, la actualización se
            producirá el último día del mes.
          minimum: 1
          maximum: 31
        time:
          type: string
          description: >-
            Hora de actualización del límite en la zona horaria deseada
            (redondeo a horas).
          pattern: >-
            ((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])
          example: 23:00:00+03:00
      required:
        - interval_type
        - time
        - day_of_month
    interval_type_hourly:
      type: string
      description: Periodo de actualización recurrente.
      enum:
        - hourly
    hours_interval:
      type: integer
      minimum: 1
      maximum: 10000
    per_user_hourly_vi:
      type: object
      title: interval_type = hourly
      properties:
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: "Intervalo en horas, tras el cual se restablece el límite. <br><br> La cuenta atrás comienza a partir del parámetro <a href=\"https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-virtual-item/#!path=periods/date_from&t=request\">date_from</a>. <br><br> Por ejemplo, si `date_start = \"2025-11-15T18:15:00+05:00\"` y `hours_interval = 2`, el límite de compra para este artículo se restablecerá cada 2\_horas a partir de `\"2025-11-15T20:15:00+05:00\"`."
      required:
        - interval_type
        - hours_interval
    virtual_item_recurrent_schedule:
      type:
        - object
        - 'null'
      description: Periodo de actualización del límite.
      properties:
        per_user:
          description: Reinicio del límite de compra en el intervalo especificado en horas.
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
            - $ref: '#/components/schemas/per_user_hourly_vi'
    Virtual-Item-item-limit:
      type: object
      description: Límites del artículo.
      properties:
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        recurrent_schedule:
          $ref: '#/components/schemas/virtual_item_recurrent_schedule'
    item-periods:
      type:
        - array
        - 'null'
      description: Periodo de venta del artículo.
      items:
        type: object
        properties:
          date_from:
            type: string
            format: date-time
            example: '2020-08-11T10:00:00+03:00'
            description: >-
              Fecha en la que el artículo especificado estará disponible para la
              venta.
          date_until:
            type:
              - string
              - 'null'
            format: date-time
            example: '2020-08-11T20:00:00+03:00'
            description: >-
              Fecha en la que el artículo especificado dejará de estar
              disponible para la venta. Puede ser `null`.
    item-custom-attributes:
      type: object
      description: >-
        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.
      format: json
      maxLength: 500
    Virtual-Items-Currency_admin-create-virtual-item:
      type: object
      properties:
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        description:
          $ref: '#/components/schemas/description-localization-object'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_schemas-admin-image_url'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-create'
        attributes:
          $ref: >-
            #/components/schemas/Virtual-Items-Currency_admin-post-put-attributes
        prices:
          $ref: '#/components/schemas/Virtual-Items_admin-prices'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-create-vc_prices'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_paid_randomized_reward:
          $ref: '#/components/schemas/value-is_paid_randomized_reward'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        limits:
          $ref: '#/components/schemas/Virtual-Item-item-limit'
        periods:
          $ref: '#/components/schemas/item-periods'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
    Virtual-Items-Currency_422-invalid-request:
      type: object
      properties:
        statusCode:
          type: integer
          example: 422
        errorCode:
          type: integer
          example: 1102
        errorMessage:
          type: string
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
        transactionId:
          type: string
          example: x-x-x-x-transactionId-mock-x-x-x
        errorMessageExtended:
          type: array
    Virtual-Items-Currency_admin-prices:
      type: array
      items:
        type: object
        required:
          - amount
          - currency
        properties:
          currency:
            type: string
            example: USD
            description: >-
              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/).
          amount:
            type: number
            exclusiveMinimum: 0
            example: 10.5
            description: Precio del artículo en moneda real.
          is_default:
            type: boolean
            default: false
            description: >-
              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.
          is_enabled:
            type: boolean
            default: true
            example: true
            description: >-
              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.
          country_iso:
            type:
              - string
              - 'null'
            example: US
            description: >-
              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:
          currency: USD
          amount: 10.5
          is_default: true
          is_enabled: true
          country_iso: US
    Virtual-Items-Currency_admin-virtual-currency:
      type: object
      properties:
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        description:
          $ref: '#/components/schemas/description-localization-object'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-response'
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-attributes'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        type:
          $ref: '#/components/schemas/Virtual-Items-Currency_type'
        prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-prices'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-get-vc_prices'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_paid_randomized_reward:
          $ref: '#/components/schemas/value-is_paid_randomized_reward'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        limits:
          $ref: '#/components/schemas/admin-item-limit-response'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
    per_user_hourly_vc:
      type: object
      title: interval_type = hourly
      properties:
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: "Intervalo en horas, tras el cual se restablece el límite. <br><br> La cuenta atrás comienza a partir del parámetro <a href=\"https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-virtual-currency/#!path=periods/date_from&t=request\">date_from</a>. <br><br> Por ejemplo, si `date_start = \"2025-11-15T18:15:00+05:00\"` y `hours_interval = 2`, el límite de compra para este artículo se restablecerá cada 2\_horas a partir de `\"2025-11-15T20:15:00+05:00\"`."
      required:
        - interval_type
        - hours_interval
    virtual_currency_recurrent_schedule:
      type:
        - object
        - 'null'
      description: Periodo de actualización del límite.
      properties:
        per_user:
          description: Reinicio del límite de compra en el intervalo especificado en horas.
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
            - $ref: '#/components/schemas/per_user_hourly_vc'
    Virtual-Currency-item-limit:
      type: object
      description: Límites del artículo.
      properties:
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        recurrent_schedule:
          $ref: '#/components/schemas/virtual_currency_recurrent_schedule'
    Virtual-Items-Currency_admin-create-virtual-currency:
      type: object
      required:
        - sku
        - name
      properties:
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        description:
          $ref: '#/components/schemas/description-localization-object'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-create'
        attributes:
          $ref: >-
            #/components/schemas/Virtual-Items-Currency_admin-post-put-attributes
        prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-prices'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-create-vc_prices'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_paid_randomized_reward:
          $ref: '#/components/schemas/value-is_paid_randomized_reward'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        limits:
          $ref: '#/components/schemas/Virtual-Currency-item-limit'
        periods:
          $ref: '#/components/schemas/item-periods'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
    Virtual-Items-Currency_admin-virtual-currency-package:
      type: object
      properties:
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        description:
          $ref: '#/components/schemas/description-localization-object'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        type:
          $ref: '#/components/schemas/Virtual-Items-Currency_type'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-attributes'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_paid_randomized_reward:
          $ref: '#/components/schemas/value-is_paid_randomized_reward'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-response'
        prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-prices'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-get-vc_prices'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        bundle_type:
          type: string
          default: virtual_currency_package
          example: virtual_currency_package
        content:
          type: array
          items:
            type: object
            properties:
              sku:
                $ref: '#/components/schemas/Virtual-Items-Currency_sku'
              name:
                $ref: '#/components/schemas/name-localization-object'
              description:
                $ref: '#/components/schemas/description-localization-object'
              image_url:
                $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
              type:
                $ref: '#/components/schemas/Virtual-Items-Currency_type'
              quantity:
                type: integer
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        limits:
          $ref: '#/components/schemas/admin-item-limit-response'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
    per_user_hourly_vcp:
      type: object
      title: interval_type = hourly
      properties:
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: "Intervalo en horas, tras el cual se restablece el límite. <br><br> La cuenta atrás comienza a partir del parámetro <a href=\"https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-virtual-currency-package/#!path=0/periods/date_from&t=request\">date_from</a>. <br><br> Por ejemplo, si `date_start = \"2025-11-15T18:15:00+05:00\"` y `hours_interval = 2`, el límite de compra para este artículo se restablecerá cada 2\_horas a partir de `\"2025-11-15T20:15:00+05:00\"`."
      required:
        - interval_type
        - hours_interval
    virtual_currency_package_recurrent_schedule:
      type:
        - object
        - 'null'
      description: Periodo de actualización del límite.
      properties:
        per_user:
          description: Reinicio del límite de compra en el intervalo especificado en horas.
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
            - $ref: '#/components/schemas/per_user_hourly_vcp'
    Virtual-Currency-Package-item-limit:
      type: object
      description: Límites del artículo.
      properties:
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        recurrent_schedule:
          $ref: '#/components/schemas/virtual_currency_package_recurrent_schedule'
    Virtual-Items-Currency_admin-create-virtual-currency-package:
      type: object
      required:
        - sku
        - name
        - description
        - content
      anyOf:
        - required:
            - prices
        - required:
            - vc_prices
      properties:
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        description:
          $ref: '#/components/schemas/description-localization-object'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-create'
        attributes:
          $ref: >-
            #/components/schemas/Virtual-Items-Currency_admin-post-put-attributes
        prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-prices'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-create-vc_prices'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_paid_randomized_reward:
          $ref: '#/components/schemas/value-is_paid_randomized_reward'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        content:
          type: array
          minLength: 1
          maxLength: 1
          description: >-
            El paquete de moneda virtual debe contener sólo 1 posición de moneda
            virtual.
          items:
            type: object
            properties:
              sku:
                $ref: '#/components/schemas/Virtual-Items-Currency_sku'
              quantity:
                type: integer
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        limits:
          $ref: '#/components/schemas/Virtual-Currency-Package-item-limit'
        periods:
          $ref: '#/components/schemas/item-periods'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
    Pagination_has-more:
      type: boolean
      example: true
      description: Se utiliza como indicador de que hay más páginas.
    items_client_groups_response:
      type: array
      example:
        - external_id: exclusive
          name: Exclusive
      default: []
      description: Grupos a los que pertenece el artículo.
      items:
        type: object
        properties:
          external_id:
            type: string
            description: >-
              [ID de grupo de artículos
              externo](/es/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id)
              especificado durante la creación.
            example: exclusive
          name:
            type: string
            description: Nombre del grupo.
            example: Exclusive
          item_order_in_group:
            type: integer
            description: >-
              La posición del artículo dentro del grupo que determina su orden
              de visualización.

              Solo se devuelve si se solicita mediante el parámetro de consulta
              `additional_fields[]`.
            example: 1
    Virtual-Items-Currency_client-attributes:
      type: array
      description: >-
        Lista de atributos y sus valores correspondientes al artículo. Puede
        utilizarse para filtrar el catálogo.
      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
      default: []
      items:
        type: object
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            type: object
            description: Nombre del atributo.
            example: Genre
            additionalProperties:
              type:
                - string
                - 'null'
          values:
            type: array
            items:
              type: object
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  type: string
                  description: Valor del atributo.
                  example: Strategy
    client_virtual_prices_response:
      type: array
      description: Precios virtuales.
      items:
        type: object
        description: Precio virtual.
        properties:
          amount:
            type: integer
            example: 100
            description: Precio del artículo en moneda virtual.
          amount_without_discount:
            type: integer
            example: 200
            description: >-
              Precio del artículo en moneda virtual sin descuento. Siempre es
              igual a `amount`, ya que los descuentos no se aplican a los
              precios en moneda virtual.
          sku:
            type: string
            example: vc_gold
            description: SKU de la moneda virtual.
          is_default:
            type: boolean
            example: true
            description: Si es o no el precio predeterminado en moneda virtual.
          image_url:
            type:
              - string
              - 'null'
            example: http://image.png
            description: URL de imagen de la moneda virtual.
          name:
            type: string
            example: Gold
            description: Nombre de la moneda virtual.
          type:
            type: string
            example: virtual_currency
            description: Tipo de artículo. Para la moneda virtual, es `virtual_currency`.
          description:
            type:
              - string
              - 'null'
            example: In-game currency used to purchase weapons and upgrades
            description: Virtual currency description.
    Can_be_bought:
      type: boolean
      example: true
      description: Si es `true`, el usuario puede comprar un artículo.
    Catalog_item_promotions:
      type: array
      description: >-
        Promociones aplicadas para artículos específicos de la cesta. La matriz
        se devuelve en los siguientes casos:


        * Se configura un descuento promocional para un artículo específico.


        * Se aplica un código promocional con el parámetro **Descuento en
        artículos seleccionados**.


        Si no se aplican promociones a nivel de artículo, se devuelve una matriz
        vacía.
      items:
        type: object
        properties:
          name:
            type: string
          date_start:
            type:
              - string
              - 'null'
            format: date-time
          date_end:
            type:
              - string
              - 'null'
            format: date-time
          discount:
            type:
              - object
              - 'null'
            properties:
              percent:
                type:
                  - string
                  - 'null'
              value:
                type:
                  - string
                  - 'null'
          bonus:
            type: array
            items:
              type: object
              properties:
                sku:
                  type: string
                quantity:
                  type: integer
                type:
                  type: string
                  description: Tipo de artículo de bonificación.
                  enum:
                    - virtual_good
                    - virtual_currency
                    - bundle
                    - physical_good
                    - game_key
                    - nft
                name:
                  type: string
                  description: >-
                    Nombre del artículo de bonificación. No disponible para el
                    tipo de artículo de bonificación `physical_good`.
                image_url:
                  type: string
                  description: >-
                    URL de la imagen del artículo de bonificación. No disponible
                    para el tipo de artículo de bonificación `physical_good`.
                bundle_type:
                  type: string
                  description: >-
                    Tipo de artículo del lote de bonificación. Disponible solo
                    para el tipo de artículo de bonificación `bundle`.
                  enum:
                    - standard
                    - virtual_currency_package
          limits:
            type: object
            properties:
              per_user:
                type: object
                properties:
                  available:
                    type: integer
                  total:
                    type: integer
    catalog_recurrent_schedule_client_response:
      type:
        - object
        - 'null'
      description: >-
        Periodo de actualización recurrente de los límites del artículo para un
        usuario.
      oneOf:
        - type: object
          title: interval_type = daily
          description: Tipo diario de actualización del límite del usuario.
          properties:
            interval_type:
              type: string
              description: Tipo de periodo de actualización recurrente.
              enum:
                - daily
            reset_next_date:
              type: integer
              description: >-
                Fecha y hora en que se restablecen los límites (Marca de tiempo
                Unix).
              example: 1677553200
        - type: object
          title: interval_type = weekly
          description: Tipo semanal de actualización de los límites del usuario.
          properties:
            interval_type:
              type: string
              description: Tipo de periodo de actualización recurrente.
              enum:
                - weekly
            reset_next_date:
              type: integer
              description: >-
                Fecha y hora en que se restablecen los límites (Marca de tiempo
                Unix).
              example: 1677553200
        - type: object
          title: interval_type = monthly
          description: Tipo mensual de actualización de los límites del usuario.
          properties:
            interval_type:
              type: string
              description: Tipo de periodo de actualización recurrente.
              enum:
                - monthly
            reset_next_date:
              type: integer
              description: >-
                Fecha y hora en que se restablecen los límites (Marca de tiempo
                Unix).
              example: 1677553200
        - type: object
          title: interval_type = hourly
          description: >-
            Restablecimiento del límite de usuarios que se realiza cada
            intervalo especificado en horas.
          properties:
            interval_type:
              type: string
              description: Tipo de periodo de actualización recurrente.
              enum:
                - hourly
            reset_next_date:
              type: integer
              description: >-
                Fecha y hora en que se restablecen los límites (Marca de tiempo
                Unix).
              example: 1677553200
    client-item-limit-response:
      type:
        - object
        - 'null'
      description: Límites del artículo.
      properties:
        per_user:
          type:
            - object
            - 'null'
          description: Limitación de artículos para un usuario independiente.
          properties:
            total:
              type: integer
              description: Número máximo de artículos que un mismo usuario puede comprar.
            available:
              type: integer
              description: >-
                Número restante de artículos que el usuario actual puede
                comprar.
            recurrent_schedule:
              $ref: '#/components/schemas/catalog_recurrent_schedule_client_response'
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
        per_item:
          type:
            - object
            - 'null'
          description: Limitación global de artículos.
          properties:
            total:
              type: integer
              description: >-
                Número máximo de artículos que pueden comprar todos los
                usuarios.
            available:
              type: integer
              description: >-
                Número restante de artículos que todos los usuarios pueden
                comprar.
    item_id:
      type: integer
      example: 1
      description: ID único interno del artículo.
    value-point-sku:
      type: string
      description: ID único del punto de valor.
    value-point-amount:
      type: integer
      description: Cantidad de puntos de valor.
    value-point-name:
      type: string
      description: Nombre del punto de valor.
    Common_admin-image_url:
      type: string
      example: https://image.example.com
      description: URL de la imagen.
    is_clan:
      type: boolean
      description: Si el punto de valor se utiliza en las cadenas de recompensas de clanes.
      example: true
    client-item-value-point-reward:
      type: array
      description: Lista de recompensas de puntos de valor para este artículo.
      items:
        type: object
        properties:
          item_id:
            $ref: '#/components/schemas/item_id'
          sku:
            $ref: '#/components/schemas/value-point-sku'
          amount:
            $ref: '#/components/schemas/value-point-amount'
          name:
            $ref: '#/components/schemas/value-point-name'
          image_url:
            $ref: '#/components/schemas/Common_admin-image_url'
          is_clan:
            $ref: '#/components/schemas/is_clan'
    Virtual-Items-Currency_item:
      type: object
      properties:
        item_id:
          type: number
          description: ID del artículo.
        sku:
          type: string
          example: big_rocket
          description: >-
            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.
        name:
          type: object
          example: Big Rocket
          description: Nombre del artículo.
          additionalProperties:
            type:
              - string
              - 'null'
        groups:
          $ref: '#/components/schemas/items_client_groups_response'
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
        type:
          type: string
          example: virtual_good
          description: 'Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.'
        description:
          type: object
          example: Big Rocket - description
          description: Descripción del artículo.
          additionalProperties:
            type:
              - string
              - 'null'
        image_url:
          type: string
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          description: URL de la imagen.
        is_free:
          $ref: '#/components/schemas/value-is_free'
        price:
          type:
            - object
            - 'null'
          description: Precios de artículos.
          properties:
            amount:
              type: string
              example: '100.99'
              description: Precio del artículo con descuento.
            amount_without_discount:
              type: string
              example: '100.99'
              description: Precio del artículo.
            currency:
              type: string
              example: USD
              description: >-
                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/).
        virtual_prices:
          $ref: '#/components/schemas/client_virtual_prices_response'
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        virtual_item_type:
          type: string
          example: non-consumable
          description: >-
            Tipo de artículo virtual.


            Valores posibles:

            - `consumable`: Un objeto que desaparece del inventario tras su
            utilización (p. ej., munición).

            - `non_consumable`: Un objeto que permanece en el inventario durante
            un tiempo ilimitado.

            - `non_renewing_subscription`: Objeto de duración limitada que puede
            representar el acceso a servicios o contenidos durante un periodo
            limitado.
          enum:
            - consumable
            - non_consumable
            - non_renewing_subscription
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        limits:
          $ref: '#/components/schemas/client-item-limit-response'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        vp_rewards:
          $ref: '#/components/schemas/client-item-value-point-reward'
    Virtual-Items-Currency_item-list:
      type: object
      properties:
        has_more:
          $ref: '#/components/schemas/Pagination_has-more'
        items:
          type: array
          items:
            $ref: '#/components/schemas/Virtual-Items-Currency_item'
    Catalog_item_limits:
      description: Límites del artículo.
      properties:
        per_user:
          type:
            - object
            - 'null'
          description: Límites de artículos para un usuario.
          properties:
            total:
              type: integer
              description: Número máximo de artículos que un mismo usuario puede comprar.
              example: 5
            available:
              type: integer
              description: >-
                Número restante de artículos que el usuario actual puede
                comprar.
              example: 3
            recurrent_schedule:
              $ref: '#/components/schemas/catalog_recurrent_schedule_client_response'
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
        per_item:
          type:
            - object
            - 'null'
          description: Límites de artículos para un artículo.
          properties:
            total:
              type: integer
              description: >-
                Número máximo de artículos que pueden comprar todos los
                usuarios.
              example: 5
            available:
              type: integer
              description: >-
                Número restante de artículos que todos los usuarios pueden
                comprar.
              example: 3
      type:
        - object
        - 'null'
    Virtual-Items-Currency_virtual-currency:
      type: object
      properties:
        item_id:
          type: integer
          description: ID único del artículo asignado por Xsolla.
        sku:
          type: string
          example: crystal
          description: >-
            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.
        name:
          type: string
          example: Crystals
          description: Nombre del artículo.
        groups:
          $ref: '#/components/schemas/items_client_groups_response'
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
        type:
          type: string
          example: virtual_currency
          description: 'Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.'
        description:
          type: string
          example: Crystals - description
          description: Descripción del artículo.
        image_url:
          type: string
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          description: URL de la imagen.
        is_free:
          $ref: '#/components/schemas/value-is_free'
        price:
          type:
            - object
            - 'null'
          description: Precios de artículos.
          properties:
            amount:
              type: string
              example: '100.99'
              description: Precio del artículo con descuento.
            amount_without_discount:
              type: string
              example: '100.99'
              description: Precio del artículo.
            currency:
              type: string
              example: USD
              description: >-
                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/).
        virtual_prices:
          $ref: '#/components/schemas/client_virtual_prices_response'
          example:
            - amount: 100
              sku: com.xsolla.crystals_1
              is_default: true
              amount_without_discount: 100
              image_url: http://image.png
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        limits:
          $ref: '#/components/schemas/Catalog_item_limits'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        vp_rewards:
          $ref: '#/components/schemas/client-item-value-point-reward'
    Virtual-Items-Currency_virtual-currency-list:
      type: object
      properties:
        has_more:
          $ref: '#/components/schemas/Pagination_has-more'
        items:
          type: array
          items:
            $ref: '#/components/schemas/Virtual-Items-Currency_virtual-currency'
    Virtual-Items-Currency_virtual-currency-package:
      type: object
      properties:
        item_id:
          type: integer
          description: ID único del artículo asignado por Xsolla.
        sku:
          type: string
          example: crystal-pack
          description: >-
            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.
        name:
          type: string
          example: Crystal Pack
          description: Nombre del artículo.
        groups:
          $ref: '#/components/schemas/items_client_groups_response'
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
        type:
          type: string
          example: bundle
          description: 'Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.'
        bundle_type:
          type: string
          example: virtual_currency_package
          description: >-
            Tipo de lote. Siempre `virtual_currency_package` para los paquetes
            de moneda virtual.
        description:
          type: string
          example: Crystal Pack Description
          description: Descripción del artículo.
        image_url:
          type: string
          example: https://cdn.xsolla.net/items/crystal-pack.png
          description: URL de la imagen.
        is_free:
          $ref: '#/components/schemas/value-is_free'
        price:
          type: object
          description: Precios de artículos.
          properties:
            amount:
              type: string
              example: '100.99'
              description: Precio del artículo con descuento.
            amount_without_discount:
              type: string
              example: '100.99'
              description: Precio del artículo sin descuento.
            currency:
              type: string
              example: USD
              description: >-
                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/).
        virtual_prices:
          $ref: '#/components/schemas/client_virtual_prices_response'
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        content:
          type: array
          example:
            - description: Crystal - short description
              image_url: https://cdn.xsolla.net/items/crystal-pack.png
              sku: com.xsolla.crystal_1
              name: Crystals
              type: virtual_currency
              quantity: 100
          description: Contenido del paquete de moneda virtual.
          items:
            type: object
            description: Moneda virtual en un paquete.
            properties:
              item_id:
                type: integer
                description: ID único del artículo asignado por Xsolla.
              sku:
                type: string
                example: com.xsolla.crystal_1
                description: >-
                  ID único del artículo. El SKU solo puede contener caracteres
                  alfanuméricos latinos en minúsculas y mayúsculas, guiones y
                  guiones bajos.
              name:
                type: string
                example: Crystals
                description: Nombre del artículo.
              type:
                type: string
                example: virtual_currency
                description: >-
                  Tipo de artículo. Para la moneda virtual, es
                  `virtual_currency`.
              description:
                type: string
                example: Crystals - description
                description: Descripción del artículo.
              image_url:
                type: string
                example: https://cdn.xsolla.net/items/crystal-pack.png
                description: URL de la imagen.
              quantity:
                type: integer
                example: 250
                description: Cantidad de moneda virtual en el paquete.
              limits:
                $ref: '#/components/schemas/Catalog_item_limits'
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        limits:
          $ref: '#/components/schemas/Catalog_item_limits'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        vp_rewards:
          $ref: '#/components/schemas/client-item-value-point-reward'
    Virtual-Items-Currency_virtual-currency-packages:
      type: object
      properties:
        has_more:
          $ref: '#/components/schemas/Pagination_has-more'
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_virtual-currency-package
    group-name-localization-object:
      type:
        - object
        - 'null'
      description: "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/)."
      anyOf:
        - $ref: '#/components/schemas/two-letter-locale'
        - $ref: '#/components/schemas/five-letter-locale'
    group-description-localization-object:
      type:
        - object
        - 'null'
      description: "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/)."
      anyOf:
        - $ref: '#/components/schemas/two-letter-locale'
        - $ref: '#/components/schemas/five-letter-locale'
    group-image-url:
      type:
        - string
        - 'null'
      description: URL de la imagen del grupo de artículos.
      example: https://example.com/weapons.png
    group-display-order:
      type: integer
      description: >-
        Orden de visualización de los grupos de artículos que hay en el
        catálogo. Cuanto mayor sea el valor, más abajo aparecerá el grupo en la
        lista. Si los valores son iguales, los grupos se ordenan por fecha de
        creación, y los más recientes aparecerán más arriba.
      default: 1
      example: 1
    group-is-enabled:
      type: boolean
      description: Si el grupo de artículos está habilitado en el catálogo.
      example: true
      default: true
    admin-group-response-base:
      type: object
      properties:
        id:
          type: integer
          description: ID del grupo de artículos asignado por Xsolla.
          example: 1
        external_id:
          type: string
          description: ID externo del grupo de artículos especificado durante la creación.
          example: weapons
        name:
          $ref: '#/components/schemas/group-name-localization-object'
        description:
          $ref: '#/components/schemas/group-description-localization-object'
        image_url:
          $ref: '#/components/schemas/group-image-url'
        order:
          $ref: '#/components/schemas/group-display-order'
        is_enabled:
          $ref: '#/components/schemas/group-is-enabled'
        items_count:
          type: integer
          description: Número total de artículos presentes en el grupo.
          example: 5
      required:
        - id
        - external_id
        - name
        - is_enabled
    error-response-base:
      type: object
      properties:
        statusCode:
          type: integer
          description: Estado de la respuesta HTTP.
        errorCode:
          type: integer
          description: Código de error.
        errorMessage:
          type: string
          description: Breve descripción del error.
        transactionId:
          type: string
          description: >-
            ID de solicitud. El ID empleado para hacer un seguimiento y asociar
            las entradas de registro relacionadas con esta solicitud u operación
            específica. Este ID puede resultar útil para la resolución de
            problemas, la depuración y la auditoría.
    admin-group-create-request:
      type: object
      properties:
        external_id:
          type: string
          description: >-
            ID externo del grupo de artículos. Solamente puede contener
            caracteres alfanuméricos, guiones y guiones bajos.
          pattern: ^[A-Za-z0-9_\-]+$
          example: weapons
        name:
          $ref: '#/components/schemas/group-name-localization-object'
        description:
          $ref: '#/components/schemas/group-description-localization-object'
        iconUrl:
          $ref: '#/components/schemas/group-image-url'
        isEnabled:
          allOf:
            - $ref: '#/components/schemas/group-is-enabled'
          default: true
        order:
          allOf:
            - $ref: '#/components/schemas/group-display-order'
      description: Datos del grupo de artículos.
      required:
        - external_id
        - name
    error-message-extended-validation:
      type: array
      description: >-
        Detalles del error de validación. Contiene una matriz de errores a nivel
        de propiedad que describe qué campos no superaron la validación y por
        qué.
      items:
        type: object
        properties:
          property:
            type: string
            description: Nombre del campo que no superó la validación.
            example: external_id
          message:
            type: string
            description: Mensaje de error de validación para el campo.
            example: The property external_id is required
    ItemGroup_422-invalid-request:
      type: object
      required:
        - statusCode
        - errorCode
        - errorMessage
        - transactionId
      properties:
        statusCode:
          type: integer
          description: Estado de la respuesta HTTP.
          example: 422
        errorCode:
          type: integer
          description: Código de error.
          example: 1102
        errorMessage:
          type: string
          description: Breve descripción del error.
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
        transactionId:
          type: string
          description: >-
            ID de solicitud. El ID empleado para hacer un seguimiento y asociar
            las entradas de registro relacionadas con esta solicitud u operación
            específica. Este ID puede resultar útil para la resolución de
            problemas, la depuración y la auditoría.
          example: x-x-x-x-transactionId-mock-x-x-x
        errorMessageExtended:
          $ref: '#/components/schemas/error-message-extended-validation'
    admin-group-update-request:
      type: object
      properties:
        name:
          $ref: '#/components/schemas/group-name-localization-object'
        description:
          $ref: '#/components/schemas/group-description-localization-object'
        external_id:
          type: string
          description: >-
            ID externo único del grupo. Solo puede contener caracteres
            alfanuméricos, guiones y guiones bajos. Puede utilizarse para
            cambiar el nombre del ID externo del grupo.
          pattern: ^[A-Za-z0-9_\-]+$
          example: weapons
        iconUrl:
          $ref: '#/components/schemas/group-image-url'
        isEnabled:
          allOf:
            - $ref: '#/components/schemas/group-is-enabled'
        order:
          allOf:
            - $ref: '#/components/schemas/group-display-order'
      description: >-
        Datos del grupo de artículos que se van a actualizar. Los campos
        `external_id` y `name` son obligatorios en todas las solicitudes. El
        resto de campos son opcionales: los campos que se omitan conservarán sus
        valores actuales.
      required:
        - external_id
        - name
    group-is-contains-any-items:
      type: boolean
      description: >-
        Independientemente de si el grupo contiene algún elemento o no, y con
        independencia del `item_type` especificado. Un grupo puede tener
        `items_count: 0` para el tipo especificado, cuando
        `is_contains_any_items` es `true` si el grupo contiene artículos de
        otros tipos.
      example: true
    admin-group-response-by-item-type:
      allOf:
        - $ref: '#/components/schemas/admin-group-response-base'
        - type: object
          properties:
            is_contains_any_items:
              $ref: '#/components/schemas/group-is-contains-any-items'
    admin-group-detail-response-by-item-type:
      allOf:
        - $ref: '#/components/schemas/admin-group-response-base'
        - type: object
          properties:
            is_contains_any_items:
              $ref: '#/components/schemas/group-is-contains-any-items'
    item-in-group-order-request-item:
      type: object
      properties:
        item_id:
          type: integer
          description: >-
            ID interno del artículo asignado por Xsolla. Use el ID del artículo
            que se devuelve en las respuestas de la [llamada API del catálogo de
            artículos](/es/api/catalog/common-catalog).
          minimum: 0
          example: 101
        order:
          type: integer
          description: Nuevo valor del orden de visualización.
          minimum: 0
          example: 1
      required:
        - item_id
        - order
      additionalProperties: false
    Cart-Payment_custom_parameters:
      description: >-
        Sus parámetros personalizados representados como un conjunto JSON válido
        de pares clave-valor.<br>

        Puede transmitir parámetros adicionales a través de este campo para
        configurar filtros antifraude. [Consulte la documentación de Pay
        Station](https://developers.xsolla.com/es/doc/pay-station/features/antifraud/).
      type:
        - object
        - 'null'
      minProperties: 1
      maxProperties: 200
      additionalProperties:
        oneOf:
          - type: string
          - type: integer
          - type: number
          - type: boolean
          - type: array
          - type: object
      example:
        custom_parameters:
          string_param: example
          bool_param: true
          int_param: 100
          null_param: null
    Game-Keys_schemas-client-attributes:
      type: array
      description: >-
        Lista de atributos y sus valores correspondientes al artículo. Puede
        utilizarse para filtrar el catálogo.
      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
      default: []
      items:
        type: object
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            type: string
            description: Nombre del atributo.
            example: Genre
          values:
            type: array
            items:
              type: object
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  type: string
                  description: Valor del atributo.
                  example: Strategy
    Game-Keys_admin-attributes:
      type: array
      description: Lista de atributos.
      items:
        $ref: '#/components/schemas/attribute'
    Game-Keys_regions:
      type: array
      items:
        type: object
        properties:
          id:
            type: integer
            example: 1
    Game-Keys_admin-post-put-attributes:
      type: array
      maxItems: 20
      description: >-
        Lista de atributos.


        <div class="notice"><strong>Atención.</strong> No <strong>puede
        especificar más de 20 atributos</strong> para el artículo. Cualquier
        intento de superar el límite provocará un error.</div>
      items:
        $ref: '#/components/schemas/admin-post-put-attribute-item'
    game_key_recurrent_schedule:
      type:
        - object
        - 'null'
      description: Periodo de actualización del límite.
      properties:
        per_user:
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
    Game-key-item-limit:
      type: object
      description: Límites del artículo.
      properties:
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        recurrent_schedule:
          $ref: '#/components/schemas/game_key_recurrent_schedule'
    Game-Keys_422-invalid-request:
      type: object
      properties:
        statusCode:
          type: integer
          example: 422
        errorCode:
          type: integer
          example: 1102
        errorMessage:
          type: string
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
        transactionId:
          type: string
          example: x-x-x-x-transactionId-mock-x-x-x
    Pagination_total-items-count:
      type: integer
      example: 10
      description: Número total de artículos presentes en el sistema.
    Game-Keys_client_name:
      type: string
      example: The Greatest Game in the World
      description: Nombre del paquete del juego.
    Game-Keys_description:
      type: string
      example: Description of the greatest game in the world.
      description: Descripción del paquete de juegos.
    Game-Keys_project_id:
      type: integer
      example: 44056
      description: >-
        ID del proyecto. Encontrará este parámetro en su [Cuenta del
        editor](https://publisher.xsolla.com/) junto al nombre del proyecto.
    Game-Keys_game_sku:
      type: string
      minLength: 1
      maxLength: 255
      pattern: ^[a-zA-Z0-9_\-–.]*$
      example: theGreatestGameSku
      description: ID único del paquete de claves.
    Game-Keys_drm_sku:
      type: string
      example: steam
      description: ID único de DRM.
      enum:
        - steam
        - playstation
        - xbox
        - uplay
        - origin
        - drmfree
        - gog
        - epicgames
        - nintendo_eshop
        - discord_game_store
        - oculus
        - rockstar
        - viveport
        - stadia
    Game-Keys_image_url:
      type: string
      example: https://image.example.com
      description: "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:<ul><li>Formatos compatibles: WebP (recomendado), PNG y JPG.</li><li>Tamaño del archivo: ≤\_50\_KB (para WebP) o ≤\_150\_KB (para PNG y JPG).</li><li>Tamaño de la imagen: 280\_x\_280\_píxeles.</li><li>Espacio de color: sRGB.</li><li>Protocolo: HTTPS con almacenamiento en caché de larga duración para las URL versionadas.</li></ul>"
    Game-Keys_admin-attribute-external_id:
      type: string
      minLength: 1
      maxLength: 255
      pattern: ^[a-zA-Z0-9-_]+$
      example: attribute_1
      description: >-
        ID único del atributo. `external_id` solo puede contener caracteres
        alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones
        bajos.
    Game-Keys_value-external_id:
      type: string
      minLength: 1
      maxLength: 255
      pattern: ^[-_.\d\w]+$
      example: attribute_value
      description: >-
        ID del valor único para un atributo. `external_id` solo puede contener
        caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.
    Game-Keys_client-attributes:
      type: array
      description: >-
        Lista de atributos y sus valores correspondientes al juego.


        <div class="notice"><strong>Atención.</strong> Esta parte de la
        respuesta solo está disponible si envía el parámetro de consulta
        `additional_fields[]=attributes`.</div>
      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
      default: []
      items:
        type: object
        properties:
          external_id:
            $ref: '#/components/schemas/Game-Keys_admin-attribute-external_id'
          name:
            type: string
            description: Nombre del atributo.
            example: Genre
          values:
            type: array
            items:
              type: object
              properties:
                external_id:
                  $ref: '#/components/schemas/Game-Keys_value-external_id'
                value:
                  type: string
                  description: Valor del atributo.
                  example: Strategy
    Game-Keys_entitlement_item:
      type: object
      properties:
        name:
          $ref: '#/components/schemas/Game-Keys_client_name'
        description:
          $ref: '#/components/schemas/Game-Keys_description'
        project_id:
          $ref: '#/components/schemas/Game-Keys_project_id'
        game_sku:
          $ref: '#/components/schemas/Game-Keys_game_sku'
        drm:
          $ref: '#/components/schemas/Game-Keys_drm_sku'
        image_url:
          $ref: '#/components/schemas/Game-Keys_image_url'
        is_pre_order:
          type: boolean
          example: false
          description: Si el juego está o no en estado de pedido por anticipado.
        attributes:
          $ref: '#/components/schemas/Game-Keys_client-attributes'
    Bundles_item_id:
      type: integer
      example: 1
      minLength: 1
      maxLength: 255
      description: ID único interno del artículo.
    Bundles_sku:
      type: string
      example: bundle_1
      minLength: 1
      maxLength: 255
      pattern: ^[a-zA-Z0-9_\-–.]*$
      description: >-
        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.
    Bundles_admin-attributes:
      type: array
      description: Lista de atributos.
      items:
        $ref: '#/components/schemas/attribute'
    Bundles_type:
      type: string
      example: bundle
      description: Tipo de artículo.
    bundle_type:
      type: string
      description: Tipo de lote. Se devuelve si el tipo de artículo es un lote.
      enum:
        - standard
        - virtual_currency_package
        - partner_side_content
    Bundles_image_url:
      type:
        - string
        - 'null'
      example: https://image.example.com
      description: "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:<ul><li>Formatos compatibles: WebP (recomendado), PNG y JPG.</li><li>Tamaño del archivo: ≤\_50\_KB (para WebP) o ≤\_150\_KB (para PNG y JPG).</li><li>Tamaño de la imagen: 280\_x\_280\_píxeles.</li><li>Espacio de color: sRGB.</li><li>Protocolo: HTTPS con almacenamiento en caché de larga duración para las URL versionadas.</li></ul>"
    Bundles_groups_response:
      type: array
      example:
        - external_id: horror
          name:
            en: Horror
      default: []
      description: Grupos a los que pertenece el artículo.
      items:
        type: object
        properties:
          external_id:
            type: string
            example: horror
          name:
            type: object
            description: >-
              Nombre del artículo. Debe contener pares clave/valor

              en los cuales clave es una configuración regional con formato
              "^[a-z]{2}", valor es una cadena (string).
            example:
              en: Horror
              de: Horror
            default:
              en: Horror
            additionalProperties:
              type: string
    Bundles_amount_without_discount:
      type: string
      example: '100.99'
      description: Precio del artículo.
      pattern: ^\d*\.?\d*$
    Bundles_currency:
      type: string
      example: USD
      description: >-
        Divisa del precio del artículo. Código de tres letras según [ISO
        4217](https://en.wikipedia.org/wiki/ISO_4217).
    Bundles_prices:
      type: array
      description: Precios en monedas reales.
      items:
        type: object
        properties:
          amount:
            $ref: '#/components/schemas/Bundles_amount_without_discount'
          currency:
            $ref: '#/components/schemas/Bundles_currency'
          is_default:
            type: boolean
            description: >-
              El precio por defecto se usa para crear un catálogo si no se
              especifica un precio en la moneda del usuario.
          is_enabled:
            type: boolean
            description: El precio está habilitado.
          country_iso:
            type:
              - string
              - 'null'
            example: US
            description: >-
              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).
        required:
          - amount
          - currency
          - is_default
          - is_enabled
    Bundles_vc-type:
      type: string
      example: virtual_currency
      description: Tipo de moneda virtual.
    Bundles_amount:
      type: string
      example: '100.99'
      description: Precio del artículo con descuento.
      pattern: ^\d*\.?\d*$
    Bundles_currency-is_default:
      type: boolean
      example: true
      description: Si el precio está predeterminado para un artículo.
    Bundles_admin-response-virtual_price:
      type: object
      properties:
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        type:
          $ref: '#/components/schemas/Bundles_vc-type'
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        amount:
          $ref: '#/components/schemas/Bundles_amount'
        is_default:
          $ref: '#/components/schemas/Bundles_currency-is_default'
    Bundles_media_list:
      type: array
      example:
        - type: image
          url: >-
            https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
      description: Recursos adicionales del lote.
      items:
        type: object
        properties:
          type:
            type: string
            enum:
              - image
              - video
            example: image
            description: 'Tipo de soporte multimedia: `image`/`video`.'
          url:
            type: string
            example: >-
              https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
            description: Archivo de recurso.
    Bundles_order:
      type: integer
      example: 1
      default: 1
      description: Prioridad de orden del lote en la lista.
    Bundles_is_enabled:
      type: boolean
      example: true
      default: true
      description: Si está deshabilitado, el artículo no se puede encontrar ni comprar.
    Bundles_is_show_in_store:
      type: boolean
      example: true
      default: false
      description: El artículo está disponible para la compra.
    Bundles_admin-regions:
      type: array
      items:
        type: object
        properties:
          id:
            type: integer
            minimum: 1
            example: 1
    Bundles_admin_content_response:
      type: object
      properties:
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        type:
          $ref: '#/components/schemas/Bundles_type'
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        quantity:
          type: integer
          description: Cantidad del tipo de artículo que contiene el lote.
          default: 1
          minimum: 1
    Bundles_total_content_price:
      type:
        - object
        - 'null'
      description: Suma de los precios del contenido del lote.
      properties:
        amount:
          type: string
          example: '100.99'
          description: Suma de los precios de los contenidos del lote con un descuento.
        amount_without_discount:
          type: string
          example: '100.99'
          description: Suma de los precios del contenido del lote.
        currency:
          $ref: '#/components/schemas/Bundles_currency'
    Bundles_admin_bundle_response:
      type: object
      properties:
        item_id:
          $ref: '#/components/schemas/Bundles_item_id'
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        attributes:
          $ref: '#/components/schemas/Bundles_admin-attributes'
        type:
          $ref: '#/components/schemas/Bundles_type'
        bundle_type:
          $ref: '#/components/schemas/bundle_type'
        description:
          $ref: '#/components/schemas/description-localization-object'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_paid_randomized_reward:
          $ref: '#/components/schemas/value-is_paid_randomized_reward'
        groups:
          $ref: '#/components/schemas/Bundles_groups_response'
        prices:
          $ref: '#/components/schemas/Bundles_prices'
        virtual_prices:
          type: array
          items:
            $ref: '#/components/schemas/Bundles_admin-response-virtual_price'
        media_list:
          anyOf:
            - $ref: '#/components/schemas/Bundles_media_list'
            - type: 'null'
        order:
          $ref: '#/components/schemas/Bundles_order'
        is_enabled:
          $ref: '#/components/schemas/Bundles_is_enabled'
        is_show_in_store:
          $ref: '#/components/schemas/Bundles_is_show_in_store'
        regions:
          $ref: '#/components/schemas/Bundles_admin-regions'
        content:
          type: array
          items:
            $ref: '#/components/schemas/Bundles_admin_content_response'
        limits:
          $ref: '#/components/schemas/admin-item-limit-response'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        total_content_price:
          $ref: '#/components/schemas/Bundles_total_content_price'
      description: El lote especificado.
    Bundles_groups_request:
      type: array
      example:
        - honor
      default: []
      description: "Grupos a los que pertenece el artículo.\n\n<div class=\"note\"><strong>Nota.</strong> El valor de la cadena\_(string) se refiere al grupo `external_id`.</div>"
      items:
        type: string
    Bundles_admin-post-put-attributes:
      type: array
      maxItems: 20
      description: >-
        Lista de atributos.


        <div class="notice"><strong>Atención.</strong> No <strong>puede
        especificar más de 20 atributos</strong> para el artículo. Cualquier
        intento de superar el límite provocará un error.</div>
      items:
        $ref: '#/components/schemas/admin-post-put-attribute-item'
    Bundles_vc_prices:
      type: array
      items:
        type: object
        properties:
          sku:
            type: string
            example: gold
            description: >-
              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.
          amount:
            type: integer
          is_default:
            type: boolean
          is_enabled:
            type: boolean
        required:
          - amount
          - currency
          - is_default
          - is_enabled
    Bundles_bundle_type:
      type: string
      example: standard
      enum:
        - standard
        - partner_side_content
      description: >-
        Tipo de lote. Utilice `standard` para crear un lote con artículos y
        especifique los SKU de los artículos incluidos en el lote.

        Utilice `partner_side_content` para crear un lote vacío y añadir
        artículos en su lado utilizando un
        [webhook](https://developers.xsolla.com/es/webhooks/operation/personalized-partner-catalog/).
        Este tipo solo se utiliza para la [Personalización del catálogo en el
        lado del
        socio](https://developers.xsolla.com/es/doc/shop-builder/features/personalization/#guides_personalization_on_partner_side).
      default: standard
    Bundles_admin_content_request:
      type: array
      minItems: 1
      description: >-
        Matriz de artículos incluidos en el lote. Cada entrada especifica el SKU
        y la cantidad del artículo. Todos los artículos deben haberse creado
        previamente en su proyecto. El sistema devuelve un error si el SKU
        especificado no existe.
      items:
        type: object
        properties:
          sku:
            type: string
            minLength: 1
            maxLength: 255
            pattern: ^[a-zA-Z0-9_\-–.]*$
            example: com.xsolla.kg_1
            description: >-
              SKU de un artículo que se va a incluir en el lote. El artículo
              debe haberse creado previamente en su proyecto. El sistema
              devuelve un error si el SKU especificado no existe. Caracteres
              permitidos: a–z, A–Z, 0–9, punto (.), guión (-), guión bajo (_).
          quantity:
            type: integer
            description: Cantidad de los artículos seleccionados en el lote.
            default: 1
            minimum: 1
        required:
          - sku
        example:
          sku: com.xsolla.kg_1
          quantity: 1
    per_user_hourly_bundle:
      type: object
      title: interval_type = hourly
      properties:
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                Intervalo en horas, tras el cual se reinicia el límite. <br><br>
                La cuenta atrás comienza a partir del parámetro <a
                href="https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-bundle/#!path=periods/date_from&t=request">date_from</a>.
                <br><br> Por ejemplo, si `date_start =
                "2025-11-15T18:15:00+05:00"` y `hours_interval = 2`, el límite
                de compra para este artículo se reiniciará cada 2 horas a partir
                de `"2025-11-15T20:15:00+05:00"`.
      required:
        - interval_type
        - hours_interval
    bundle_recurrent_schedule:
      type:
        - object
        - 'null'
      description: Periodo de actualización del límite.
      properties:
        per_user:
          description: Reinicio del límite de compra en el intervalo especificado en horas.
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
            - $ref: '#/components/schemas/per_user_hourly_bundle'
    bundle-item-limit:
      type: object
      description: Límites del artículo.
      properties:
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        recurrent_schedule:
          $ref: '#/components/schemas/bundle_recurrent_schedule'
    Bundles_admin_bundle_request:
      type: object
      properties:
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        name:
          $ref: '#/components/schemas/name-localization-object'
        groups:
          $ref: '#/components/schemas/Bundles_groups_request'
        attributes:
          $ref: '#/components/schemas/Bundles_admin-post-put-attributes'
        description:
          $ref: '#/components/schemas/description-localization-object'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        prices:
          $ref: '#/components/schemas/Bundles_prices'
        vc_prices:
          anyOf:
            - $ref: '#/components/schemas/Bundles_vc_prices'
            - type: 'null'
        bundle_type:
          $ref: '#/components/schemas/Bundles_bundle_type'
        content:
          $ref: '#/components/schemas/Bundles_admin_content_request'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_paid_randomized_reward:
          $ref: '#/components/schemas/value-is_paid_randomized_reward'
        is_enabled:
          $ref: '#/components/schemas/Bundles_is_enabled'
        is_show_in_store:
          $ref: '#/components/schemas/Bundles_is_show_in_store'
        media_list:
          anyOf:
            - $ref: '#/components/schemas/Bundles_media_list'
            - type: 'null'
        order:
          $ref: '#/components/schemas/Bundles_order'
        regions:
          $ref: '#/components/schemas/Bundles_admin-regions'
        limits:
          $ref: '#/components/schemas/bundle-item-limit'
        periods:
          $ref: '#/components/schemas/item-periods'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
      description: El lote especificado.
      required:
        - sku
        - name
        - description
    Bundles_422-invalid-request:
      type: object
      properties:
        statusCode:
          type: integer
          example: 422
        errorCode:
          type: integer
          example: 1102
        errorMessage:
          type: string
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
        transactionId:
          type: string
          example: x-x-x-x-transactionId-mock-x-x-x
        errorMessageExtended:
          type: array
    Bundles_client_name:
      type: string
      example: Big Rocket
      description: Nombre del artículo.
    Bundles_client_description:
      type:
        - string
        - 'null'
      example: Big Rocket - description.
      description: Descripción del artículo.
    Bundles_client-attributes:
      type: array
      description: >-
        Lista de atributos y sus valores correspondientes al artículo. Puede
        utilizarse para filtrar el catálogo.
      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
      default: []
      items:
        type: object
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            type: string
            description: Nombre del atributo.
            example: Genre
          values:
            type: array
            items:
              type: object
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  type: string
                  description: Valor del atributo.
                  example: Strategy
    Bundles_price:
      type:
        - object
        - 'null'
      description: Precio del artículo.
      required:
        - amount
        - amount_without_discount
        - currency
      properties:
        amount:
          $ref: '#/components/schemas/Bundles_amount'
        amount_without_discount:
          $ref: '#/components/schemas/Bundles_amount_without_discount'
        currency:
          $ref: '#/components/schemas/Bundles_currency'
    Catalog_item_limits_with_hourly:
      description: Límites del artículo.
      properties:
        per_user:
          type:
            - object
            - 'null'
          description: Límites de artículos para un usuario.
          properties:
            total:
              type: integer
              description: Número máximo de artículos que un mismo usuario puede comprar.
              example: 5
            available:
              type: integer
              description: >-
                Número restante de artículos que el usuario actual puede
                comprar.
              example: 3
            recurrent_schedule:
              $ref: '#/components/schemas/catalog_recurrent_schedule_client_response'
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
        per_item:
          type:
            - object
            - 'null'
          description: Límites de artículos para un artículo.
          properties:
            total:
              type: integer
              description: >-
                Número máximo de artículos que pueden comprar todos los
                usuarios.
              example: 5
            available:
              type: integer
              description: >-
                Número restante de artículos que todos los usuarios pueden
                comprar.
              example: 3
      type:
        - object
        - 'null'
    Bundles_client_content:
      type: array
      example:
        - description: Big Rocket - short description.
          image_url: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          sku: com.xsolla.big_rocket_1
          name: Big Rocket
          type: virtual_currency
          quantity: 100
          attributes: []
          is_free: false
          groups: []
          price:
            amount: '10.99'
            currency: USD
            amount_without_discount: '10.99'
      description: Contenido del paquete del lote.
      items:
        type: object
        description: Artículo en un paquete.
        properties:
          sku:
            type: string
            example: com.xsolla.big_rocket_1
            description: >-
              ID único del artículo. El SKU solo puede contener caracteres
              alfanuméricos latinos en minúsculas y mayúsculas, guiones y
              guiones bajos.
          name:
            type: string
            example: Big Rocket
            description: Nombre del artículo.
          type:
            type: string
            example: virtual_currency
            description: 'Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.'
          description:
            type: string
            example: Big Rocket - description
            description: Descripción del artículo.
          image_url:
            type: string
            example: >-
              https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
            description: URL de la imagen.
          quantity:
            type: integer
            example: 250
            description: Cantidad de artículos que contiene un paquete.
          virtual_item_type:
            type: string
            example: non-consumable
            description: >-
              Tipo de artículo virtual.


              Valores posibles:

              - `consumable`: Un objeto que desaparece del inventario tras su
              utilización (p. ej., munición).

              - `non_consumable`: Un objeto que permanece en el inventario
              durante un tiempo ilimitado.

              - `non_renewing_subscription`: Objeto de duración limitada que
              puede representar el acceso a servicios o contenidos durante un
              periodo limitado.
            enum:
              - consumable
              - non_consumable
              - non_renewing_subscription
          attributes:
            $ref: '#/components/schemas/Bundles_client-attributes'
          price:
            type:
              - object
              - 'null'
            description: Precios de artículos.
            properties:
              amount:
                type: string
                example: '100.99'
                description: Precio del artículo con descuento.
              amount_without_discount:
                type: string
                example: '100.99'
                description: Precio del artículo.
              currency:
                type: string
                example: USD
                description: >-
                  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/).
          virtual_prices:
            $ref: '#/components/schemas/client_virtual_prices_response'
          limits:
            $ref: '#/components/schemas/Catalog_item_limits_with_hourly'
          is_free:
            $ref: '#/components/schemas/value-is_free'
          groups:
            $ref: '#/components/schemas/Bundles_groups_response'
    Bundles_client_bundle:
      type: object
      properties:
        item_id:
          $ref: '#/components/schemas/Bundles_item_id'
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        name:
          $ref: '#/components/schemas/Bundles_client_name'
        groups:
          $ref: '#/components/schemas/items_client_groups_response'
        description:
          $ref: '#/components/schemas/Bundles_client_description'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        attributes:
          $ref: '#/components/schemas/Bundles_client-attributes'
        type:
          $ref: '#/components/schemas/Bundles_type'
        bundle_type:
          $ref: '#/components/schemas/Bundles_bundle_type'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        price:
          $ref: '#/components/schemas/Bundles_price'
        total_content_price:
          $ref: '#/components/schemas/Bundles_total_content_price'
        virtual_prices:
          $ref: '#/components/schemas/client_virtual_prices_response'
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        content:
          $ref: '#/components/schemas/Bundles_client_content'
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        limits:
          $ref: '#/components/schemas/Catalog_item_limits_with_hourly'
        periods:
          $ref: '#/components/schemas/item-periods'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        vp_rewards:
          $ref: '#/components/schemas/client-item-value-point-reward'
        order:
          $ref: '#/components/schemas/Bundles_order'
        media_list:
          $ref: '#/components/schemas/Bundles_media_list'
      description: El lote especificado.
    value-cart_is_free:
      type: boolean
      example: false
      default: false
      description: Si `true`, la cesta es gratuita.
    Cart-Payment_client-attributes:
      type: array
      description: >-
        Lista de atributos y sus valores correspondientes al artículo. Puede
        utilizarse para filtrar el catálogo.
      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
      default: []
      items:
        type: object
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            type: string
            description: Nombre del atributo.
            example: Genre
          values:
            type: array
            items:
              type: object
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  type: string
                  description: Valor del atributo.
                  example: Strategy
    Catalog_cart_promotions:
      type: array
      description: >-
        Promociones aplicadas a toda la cesta. La matriz se devuelve en los
        siguientes casos:


        * Una promoción afecta al importe total de la cesta, como un código
        promocional con el parámetro **Descuento en la compra**.


        * Una promoción añade artículos de bonificación a la cesta.


        Si no se aplican promociones a nivel de pedido, se devuelve una matriz
        vacía.
      items:
        type: object
        properties:
          name:
            type: string
          date_start:
            type:
              - string
              - 'null'
            format: date-time
          date_end:
            type:
              - string
              - 'null'
            format: date-time
          discount:
            type:
              - object
              - 'null'
            properties:
              percent:
                type:
                  - string
                  - 'null'
              value:
                type:
                  - string
                  - 'null'
          bonus:
            type: array
            items:
              type: object
              properties:
                sku:
                  type: string
                quantity:
                  type: integer
                type:
                  type: string
                  description: Tipo de artículo de bonificación.
                  enum:
                    - virtual_good
                    - virtual_currency
                    - bundle
                    - physical_good
                    - game_key
                    - nft
                name:
                  type: string
                  description: >-
                    Nombre del artículo de bonificación. No disponible para el
                    tipo de artículo de bonificación `physical_good`.
                image_url:
                  type: string
                  description: >-
                    URL de la imagen del artículo de bonificación. No disponible
                    para el tipo de artículo de bonificación `physical_good`.
                bundle_type:
                  type: string
                  description: >-
                    Tipo de artículo del lote de bonificación. Disponible solo
                    para el tipo de artículo de bonificación `bundle`.
                  enum:
                    - standard
                    - virtual_currency_package
          limits:
            type: object
            properties:
              per_user:
                type: object
                properties:
                  available:
                    type: integer
                  total:
                    type: integer
    Cart-Payment_settings_ui:
      description: Ajustes de la interfaz.
      type: object
      additionalProperties: false
      properties:
        theme:
          description: >-
            Tema de interfaz de pago. Puede ser `63295a9a2e47fab76f7708e1` para
            el tema claro (por defecto) o `63295aab2e47fab76f7708e3` para el
            tema oscuro. También puede [crear un tema
            personalizado](https://developers.xsolla.com/es/doc/pay-station/features/ui-theme-customization/#pay_station_ui_theme_customization_in_token)
            y transmitir el ID del tema en este parámetro.
          type: string
          default: 63295a9a2e47fab76f7708e1
          enum:
            - 63295a9a2e47fab76f7708e1
            - 63295aab2e47fab76f7708e3
        desktop:
          type: object
          additionalProperties: false
          description: Ajustes de la interfaz para la versión de escritorio.
          properties:
            header:
              type: object
              additionalProperties: false
              description: Ajustes del encabezado.
              properties:
                is_visible:
                  type: boolean
                  description: Si se muestra o no el encabezado en la interfaz de pago.
                visible_logo:
                  type: boolean
                  description: >-
                    Si `true`, el logotipo aparece en la cabecera. Para cargar
                    la imagen, abra su proyecto en [Cuenta de
                    editor](https://publisher.xsolla.com/) y vaya a la sección
                    <b>Pay Station > Configuración</b>.
                visible_name:
                  type: boolean
                  description: Si se muestra o no el nombre del proyecto en el encabezado.
                visible_purchase:
                  type: boolean
                  description: >-
                    Si se muestra o no la descripción de la compra
                    (`purchase.description.value`) en el encabezado. Por defecto
                    es `true`.
                  default: true
                type:
                  type: string
                  description: >-
                    Cómo mostrar el encabezado. Puede ser `compact` (oculta el
                    nombre del proyecto y el ID del usuario) o `normal` (por
                    defecto).
                  default: normal
                  enum:
                    - compact
                    - normal
                close_button:
                  type: boolean
                  description: >-
                    Si se muestra o no un botón **Close** en la interfaz de pago
                    de escritorio. El botón cierra la interfaz de pago y
                    redirige al usuario a la URL especificada en el parámetro
                    `settings.return_url`. `false` por defecto.
                  default: false
        mode:
          type: string
          enum:
            - user_account
          description: >-
            Modo de interfaz en la interfaz de pago. Solo puede ser
            `user_account`. El encabezado solo contiene el menú de navegación de
            la cuenta, y el usuario no puede seleccionar un producto ni hacer un
            pago. Este modo únicamente está disponible en la versión de
            escritorio.
        user_account:
          type: object
          additionalProperties: false
          description: Datos de la cuenta del usuario.
          properties:
            payment_accounts:
              type: object
              additionalProperties: false
              description: Submenú **Mis cuentas de pago**.
              properties:
                enable:
                  type: boolean
                  default: false
                  description: Si se muestra o no el submenú. `false` por defecto.
              required:
                - enable
            info:
              type: object
              additionalProperties: false
              description: Página **Mi cuenta**.
              properties:
                enable:
                  type: boolean
                  default: false
                  description: Si se muestra o no el submenú. `false` por defecto.
                order:
                  type: integer
                  minimum: 1
                  description: Posición del submenú en el menú.
              required:
                - enable
                - order
            subscriptions:
              type: object
              additionalProperties: false
              description: Submenú **Gestionar suscripciones**.
              properties:
                enable:
                  type: boolean
                  default: false
                  description: Si se muestra o no el submenú. `false` por defecto.
                order:
                  type: integer
                  minimum: 1
                  description: Posición del submenú en el menú.
              required:
                - enable
                - order
        header:
          type: object
          properties:
            visible_virtual_currency_balance:
              type: boolean
              additionalProperties: false
              description: Si este elemento puede ocultarse o no en la interfaz de pago.
              default: true
        mobile:
          type: object
          properties:
            header:
              type: object
              additionalProperties: false
              properties:
                close_button:
                  type: boolean
                  description: >-
                    Si se muestra o no un botón **Close** en la interfaz de pago
                    móvil. El botón cierra la interfaz de pago y redirige al
                    usuario a la URL especificada en el parámetro
                    `settings.return_url`.
                  default: false
        is_prevent_external_link_open:
          type: boolean
          description: >-
            Si se deshabilita o no el redireccionamiento de enlaces a un recurso
            externo. Al hacer clic en un enlace externo, se envía el evento
            `external-link-open` a través del mecanismo `postMessage`. La
            dirección del enlace redirigido se transmite en el parámetro `url`.
          default: false
        is_payment_methods_list_mode:
          type: boolean
          description: >-
            Si se muestra la lista de métodos de pago disponibles en el país del
            usuario al abrir la interfaz de pago. Si es `false` (opción por
            defecto), se muestra el método de pago transmitido en el parámetro
            `settings.payment_method` o el método seleccionado por el [algoritmo
            de
            PayRank](https://developers.xsolla.com/es/solutions/payments/payment-ui-management/top-payment-methods-management/).
          default: false
        is_independent_windows:
          type: boolean
          description: >-
            Si se redirige o no a los usuarios desde el navegador del lanzador
            incrustado (WebView) a su navegador predeterminado para realizar una
            compra.
          default: false
        currency_format:
          type: string
          description: >-
            Establecer en `code` para mostrar un código de moneda [ISO
            4217](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/)
            de tres letras en la interfaz de pago. Por defecto, se muestra el
            símbolo de moneda en lugar del código de moneda de tres letras.
        is_show_close_widget_warning:
          type: boolean
          description: >-
            Si se muestra una advertencia sobre el procesamiento de la
            transacción al pasar el ratón por encima del icono **×** antes de
            cerrar la página de pago. Si se transmite `false` o no se transmite
            el parámetro, no se mostrará la advertencia.
          default: true
        layout:
          type: string
          description: >-
            Ubicación de los principales elementos de la interfaz de pago. Puede
            abrir la interfaz de pago dentro de su juego o intercambiar las
            columnas con información sobre un pedido y los métodos de pago.
            Consulte las [instrucciones de
            personalización](https://developers.xsolla.com/es/doc/pay-station/features/ui-theme-customization/#pay_station_ui_theme_customization_layout)
            para obtener información detallada.
          enum:
            - embed
            - column_reverse
            - embed_column_reverse
        is_three_ds_independent_windows:
          type: boolean
          description: >-
            Si se abre o no la verificación de 3D Secure en una nueva ventana
            del navegador. Si su configuración aplica una Política de seguridad
            de contenidos (CSP), establézcala como `true`.
          default: false
        is_cart_open_by_default:
          type: boolean
          description: >-
            La visualización de la lista de artículos en la cesta cuando se abre
            la versión móvil de la interfaz de pago. Si es `true`, la lista se
            muestra en una vista ampliada. Si es `false` (por defecto) o no se
            transmiten los parámetros, la lista se muestra en una vista
            contraída.
          default: false
    Cart-Payment_settings_payment_method:
      type: integer
      description: >-
        ID del método de pago. Determina la visualización de la moneda en la
        interfaz de pago, ya que algunos métodos de pago solamente admiten
        determinadas monedas.
      minimum: 1
    Cart-Payment_settings_return_url:
      type: string
      format: uri
      description: >-
        Página a la que se redirige al usuario tras el pago. Los parámetros
        `user_id`, `foreigninvoice`, `invoice_id` y `status` se agregarán
        automáticamente al enlace.
      maxLength: 1000
    Cart-Payment_redirect_policy:
      type: object
      properties:
        redirect_conditions:
          description: >-
            Estado del pago que activa el redireccionamiento del usuario a la
            URL de retorno.
          type: string
          example: none
          enum:
            - none
            - successful
            - successful_or_canceled
            - any
        delay:
          description: >-
            Retraso tras el cual el usuario será redirigido automáticamente a la
            URL de retorno.
          type: integer
          example: 0
        status_for_manual_redirection:
          description: >-
            Estado del pago que desencadena la visualización de la pulsación de
            un botón que redirige al usuario a la URL de retorno.
          type: string
          example: none
          enum:
            - none
            - successful
            - successful_or_canceled
            - any
        redirect_button_caption:
          description: Subtítulos localizados de los botones de redireccionamiento.
          type: string
          example: Text button
    Cart-Payment_settings_sandbox:
      type: boolean
      description: >-
        Seleccione `true` para probar el proceso de pago. En este caso, utilice
        https://sandbox-secure.xsolla.com para acceder a la interfaz de pago de
        prueba.
      default: false
    Cart-Payment_admin-user-request-body:
      type: object
      required:
        - id
      additionalProperties: false
      properties:
        id:
          type: object
          properties:
            value:
              description: >-
                ID de usuario. Para realizar pruebas, puede transmitir cualquier
                valor. Para aceptar pagos reales, debe usar el valor de ID de
                usuario de su sistema. Este ID se transmite en el webhook
                [Validación del
                usuario](https://developers.xsolla.com/es/webhooks/operation/user-validation/).
              type: string
              minLength: 1
              maxLength: 255
        name:
          type: object
          properties:
            value:
              type: string
              minLength: 1
              maxLength: 255
              description: Nombre de pantalla del usuario.
        email:
          type: object
          properties:
            value:
              type: string
              minLength: 3
              maxLength: 255
              format: email
              description: >-
                Correo electrónico del usuario. Debe ser válido según el
                protocolo RFC 822.
        country:
          type: object
          properties:
            value:
              type: string
              description: >-
                Código de país de dos letras en mayúsculas de conformidad con la
                norma [ISO 3166-1
                alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Se
                requiere si no se transmite una dirección IP en el encabezado
                `X-User-Ip`. Consulte la documentación para obtener información
                detallada sobre los [países admitidos por
                Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/).
                <br>Ejemplo: `country=US`
              example: US
            allow_modify:
              type: boolean
              description: Si el usuario puede o no cambiar el país en la interfaz de pago.
              default: false
              example: false
        age:
          type: integer
          description: Edad del usuario.
        phone:
          type: object
          required:
            - value
          properties:
            value:
              type: string
              description: Número de teléfono del usuario.
            allow_modify:
              type: boolean
              description: >-
                Si el usuario puede o no cambiar el teléfono en la interfaz de
                pago. Si se transmite `phone.value` en el token, el valor es
                `false` por defecto.
              default: false
              example: false
            hidden:
              type: boolean
              default: true
              example: false
        tracking_id:
          type: object
          required:
            - value
          properties:
            value:
              type: string
              minLength: 32
              maxLength: 32
              pattern: ^[A-Za-z0-9]{32}$
              description: ID único de seguimiento (utilizado en campañas de marketing).
        steam_id:
          type: object
          required:
            - value
          properties:
            value:
              type: string
              minLength: 17
              maxLength: 17
              pattern: ^\d{17}$
              description: ID de Steam.
        is_legal:
          type: boolean
          description: Si el usuario es una entidad jurídica.
        legal:
          type: object
          description: >-
            Objeto con datos de la entidad jurídica. El objeto y todos sus
            parámetros son obligatorios si `user.is_legal` es `true`.
          properties:
            name:
              type: string
              description: Nombre legal completo.
            address:
              type: string
              description: Dirección legal completa.
            vat_id:
              type: string
              description: Identificador del contribuyente individual.
            country:
              type: string
              description: >-
                País de constitución. Código de país de dos letras mayúsculas de
                conformidad con la norma [ISO 3166-1
                alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Cart_admin_payment:
      type: object
      additionalProperties: false
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              sku:
                type: string
                minLength: 1
                description: >-
                  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.


                  <div class="notice"><strong>Atención:</strong><br><br>Para
                  vender un código de artículo (SKU) varias veces, especifique
                  la cantidad deseada en el parámetro
                  <code>purchase.items[].quantity</code>. No se admiten los SKU
                  duplicados dentro de la matriz; solo se usa la primera vez que
                  aparece al crear el token. En este caso, no se devuelve ningún
                  error.</div>
                example: t-shirt
              quantity:
                type: number
                minimum: 1
                example: 2
                description: Cantidad del artículo.
            required:
              - sku
              - quantity
          minItems: 1
      required:
        - items
    Promotions_coupon_code:
      type: string
      description: >-
        Código único que distingue entre mayúsculas y minúsculas. Contiene
        letras y números.
      minLength: 1
      maxLength: 128
      example: WINTER2021
      default: WINTER2021
      pattern: ^[a-zA-Z0-9]+$
    Cart-Payment_settings_currency:
      type: string
      description: >-
        Moneda de compra preferida. Código de moneda de tres letras de
        conformidad con la norma [ISO
        4217](https://en.wikipedia.org/wiki/ISO_4217). Consulte la documentación
        para obtener información detallada sobre las [monedas admitidas por
        Xsolla](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/).
    Cart-Payment_settings_locale:
      type: string
      description: >-
        Idioma de la interfaz. [Código de
        idioma](https://developers.xsolla.com/es/doc/pay-station/features/localization/)
        de dos letras minúsculas.
    Cart-Payment_settings_external_id:
      type: string
      minLength: 1
      maxLength: 255
      description: ID externo de la transacción.
    Cart-Payment_custom_parameters_token:
      description: >-
        Sus parámetros personalizados representados como un conjunto JSON válido
        de pares clave-valor.<br>

        Puede transmitir parámetros adicionales a través de este campo para
        configurar filtros antifraude. [Consulte la documentación de Pay
        Station](https://developers.xsolla.com/es/doc/pay-station/features/antifraud/).
      type:
        - object
        - 'null'
      minProperties: 1
      maxProperties: 200
      additionalProperties:
        oneOf:
          - type: string
          - type: integer
          - type: number
          - type: boolean
          - type: 'null'
      example:
        custom_parameters:
          string_param: example
          bool_param: true
          int_param: 100
          number_param: 12.5
          null_param: null
    422-invalid-request:
      type: object
      properties:
        statusCode:
          type: number
          description: Código de estado de la respuesta.
          example: 422
        errorCode:
          type: number
          description: Código de error.
          example: 1102
        errorMessage:
          type: string
          description: Mensaje de error legible.
          example: >-
            [0401-1102]: Unprocessable Entity. The property `external_id` is
            required
        transactionId:
          type: string
          description: ID único de la solicitud.
          example: da145238620011eb8e24fe6913ff226a
    Cart:
      type: object
      additionalProperties: false
      properties:
        country:
          type: string
          minLength: 2
          maxLength: 2
          example: US
          description: >-
            Código de país de dos letras mayúsculas de conformidad con la norma
            [ISO 3166-1
            alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Consulte
            la documentación para obtener información detallada sobre los
            [países admitidos por
            Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/).
            <br>Ejemplo: `country=US`
        currency:
          type: string
          minLength: 3
          maxLength: 3
          example: USD
          description: >-
            La moneda del precio del artículo que aparece en la cesta. 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/).
        items:
          type: array
          items:
            type: object
            properties:
              sku:
                type: string
                minLength: 1
                description: >-
                  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: t-shirt
              quantity:
                type: number
                minimum: 1
                example: 2
                description: Cantidad del artículo.
            required:
              - sku
              - quantity
          minItems: 1
      required:
        - items
    User-limit_user-external-id:
      description: ID externo del usuario.
      type: string
      minLength: 1
      pattern: ^\S+$
    User-limit_user:
      type: object
      properties:
        user_external_id:
          $ref: '#/components/schemas/User-limit_user-external-id'
      required:
        - user_external_id
    User-limit_user_flexible:
      type:
        - object
        - 'null'
      properties:
        user_external_id:
          $ref: '#/components/schemas/User-limit_user-external-id'
    User-limit-item:
      type: object
      properties:
        per_user:
          type: object
          properties:
            total:
              type: integer
              example: 10
              description: Número máximo de artículos que puede comprar un usuario.
            available:
              type: integer
              example: 9
              description: >-
                El número restante de artículos disponibles para que el usuario
                los compre.
    User-limit_available_flexible:
      type: integer
      minimum: 0
      description: >-
        Número restante de artículos o usos de la promoción disponibles para el
        usuario dentro del límite aplicado.
    User-limit_available:
      type: integer
      minimum: 1
      description: >-
        Número restante de artículos o usos de la promoción disponibles para el
        usuario dentro del límite aplicado.
    422-invalid-request-extended:
      type: object
      properties:
        statusCode:
          type: number
          description: Código de estado de la respuesta.
          example: 422
        errorCode:
          type: number
          description: Código de error.
          example: 1102
        errorMessage:
          type: string
          description: Mensaje de error legible.
          example: '[0401-1102]: Unprocessable Entity'
        errorMessageExtended:
          $ref: '#/components/schemas/error-message-extended-validation'
        transactionId:
          type: string
          description: ID único de la solicitud.
          example: da145238620011eb8e24fe6913ff226a
    client_virtual_prices_with_calculated_price_response:
      type: array
      description: Precios virtuales.
      items:
        type: object
        description: Precio virtual.
        properties:
          amount:
            type: integer
            example: 100
            description: Precio del artículo en moneda virtual.
          amount_without_discount:
            type: integer
            example: 200
            description: >-
              Precio del artículo en moneda virtual sin descuento. Siempre es
              igual a `amount`, ya que los descuentos no se aplican a los
              precios en moneda virtual.
          calculated_price:
            type: object
            properties:
              amount:
                type: string
              amount_without_discount:
                type: string
          sku:
            type: string
            example: vc_gold
            description: SKU de la moneda virtual.
          is_default:
            type: boolean
            example: true
            description: Si es o no el precio predeterminado en moneda virtual.
          image_url:
            type:
              - string
              - 'null'
            example: http://image.png
            description: URL de imagen de la moneda virtual.
          item_id:
            type: integer
            example: 259774
            description: ID único del artículo asignado por Xsolla.
          name:
            type: string
            example: Gold
            description: Nombre de la moneda virtual.
          type:
            type: string
            example: virtual_currency
            description: Tipo de artículo. Para la moneda virtual, es virtual_currency.
          description:
            type:
              - string
              - 'null'
            example: In-game currency used to purchase weapons and upgrades
            description: Virtual currency description.
    Regions_region_id:
      type: integer
      description: ID de región. Identificador único de región dentro del proyecto.
      example: 42
    Regions_name:
      type: object
      description: >-
        Nombre de la región. Debe contener pares clave/valor en los cuales la
        clave es una configuración regional con el formato
        "^[a-z]{2}-[A-Z]{2}$", el valor es una cadena (string).
      additionalProperties:
        type: string
      example:
        en-US: Asia
        de-DE: Asien
      default:
        en-US: Asia
        de-DE: Asien
    Regions_200-region-short-model:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Regions_region_id'
        name:
          $ref: '#/components/schemas/Regions_name'
    Regions_countries:
      type: array
      description: >-
        Lista de países que se añadirán en una región.

        <br>Código de país de dos letras en mayúscula de conformidad con la
        norma [ISO 3166-1
        alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

        Consulte la documentación para obtener información detallada sobre los
        [países admitidos por
        Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/).

        <br>Ejemplo: `["JP", "CN", "VN"]`
      items:
        type: string
    Regions_200-region-model:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Regions_region_id'
        name:
          $ref: '#/components/schemas/Regions_name'
        countries:
          $ref: '#/components/schemas/Regions_countries'
      example:
        value:
          id: 44
          name:
            en-US: Asia
            de-DE: Asien
          countries:
            - JP
            - CN
            - VN
    admin_attribute_response:
      type: object
      properties:
        external_id:
          $ref: '#/components/schemas/admin-attribute-external_id'
        name:
          $ref: '#/components/schemas/admin-attribute-name'
      example:
        value:
          - external_id: genre
            name:
              en: Genre
              de: Genre
    schemas-422-invalid-request:
      type: object
      properties:
        statusCode:
          type: integer
          example: 422
        errorCode:
          type: integer
          example: 1102
        errorMessage:
          type: string
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
        transactionId:
          type: string
          example: x-x-x-x-transactionId-mock-x-x-x
    request-attribute-value:
      type: object
      required:
        - external_id
        - value
      properties:
        external_id:
          $ref: '#/components/schemas/value-external_id'
        value:
          $ref: '#/components/schemas/value-name'
      example:
        external_id: value_id
        value:
          en: Value
          de: Wert
    404-not-found:
      type: object
      properties:
        statusCode:
          type: integer
          example: 422
        errorCode:
          type: integer
          example: 1102
        errorMessage:
          type: string
          example: '[0000-0000]: Entity not found'
        transactionId:
          type: string
          example: x-x-x-x-transactionId-mock-x-x-x
  responses:
    Virtual-Items-Currency_200-admin-get-virtual-items:
      description: La lista de artículos virtuales se recibió correctamente.
      content:
        application/json:
          example:
            items:
              - sku: com.xsolla.armor_max_1
                name:
                  en: Maximum Armor Xsolla  Skin
                type: virtual_good
                description:
                  en: Suit up with flair showcasing your allegiance to Xsolla
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                long_description:
                  en: >-
                    The metal coverings formerly worn by soldiers or warriors to
                    protect the body in battle.
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups:
                  - external_id: featured
                    name:
                      en: featured
                  - external_id: Xsolla
                    name:
                      en: Xsolla
                  - external_id: Premium
                    name:
                      en: Premium
                  - external_id: NonConsumableGroupCode
                    name:
                      en: Non-consumable
                prices:
                  - amount: 12.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    country_iso: CZ
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods: []
                custom_attributes:
                  purchased: 0
                  attr: value
              - sku: com.xsolla.armor_max_2
                name:
                  en: Empire Maximum Armor
                type: virtual_good
                description:
                  en: A strong armor forged to withstand heavy attacks.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/67d647ad4f4e9a905bd552b0408db8a8.png
                long_description: null
                attributes: []
                is_free: false
                order: 1
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                  - external_id: equipment
                    name:
                      en: Nice Equipment
                  - external_id: Empire
                    name:
                      en: Empire
                prices:
                  - amount: 12.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    country_iso: CZ
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user:
                    total: 5
                    limit_exceeded_visibility: show
                  per_item: null
                  recurrent_schedule:
                    per_user:
                      interval_type: daily
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
              - sku: com.xsolla.armor_med_1
                name:
                  en: Xsolla Medium Armor
                type: virtual_good
                description:
                  en: >-
                    Moderately protect yourself against the Empires barrage of
                    attacks
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/7f6e216f8fcc3c1796162897c2b0db01.png
                long_description:
                  en: >-
                    Armor is a security-as-a-service company that provides cloud
                    security and compliance solutions for small businesses and
                    enterprises.
                attributes: []
                is_free: false
                order: 1
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                  - external_id: Xsolla
                    name:
                      en: Xsolla
                  - external_id: equipment
                    name:
                      en: Nice Equipment
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    country_iso: CZ
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: false
                regions: []
                limits:
                  per_user:
                    total: 5
                    limit_exceeded_visibility: show
                  per_item: null
                  recurrent_schedule:
                    per_user:
                      interval_type: daily
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods:
                  - date_from: null
                    date_until: '2020-08-11T20:00:00+03:00'
              - sku: com.xsolla.armor_med_2
                name:
                  en: Empire Medium Armor
                type: virtual_good
                description:
                  en: Provides moderate protection in battle.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png
                long_description:
                  en: A strong armor forged to withstand heavy attacks.
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                  - external_id: equipment
                    name:
                      en: Nice Equipment
                  - external_id: Empire
                    name:
                      en: Empire
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user:
                    total: 5
                  per_item:
                    total: 500
                    available: 455
                    reserved: 5
                    sold: 40
                  recurrent_schedule:
                    per_user:
                      interval_type: daily
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods: []
              - sku: com.xsolla.armor_large_3
                name:
                  en: Empire Large Armor
                type: virtual_good
                description:
                  en: Provides moderate protection in battle.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png
                long_description: null
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                  - external_id: equipment
                    name:
                      en: Nice Equipment
                  - external_id: Empire
                    name:
                      en: Empire
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user:
                    total: 5
                  per_item:
                    total: 500
                    available: 455
                    reserved: 5
                    sold: 40
                  recurrent_schedule:
                    per_user:
                      interval_type: hourly
                      hours_interval: 8
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods: []
          schema:
            type: object
            properties:
              items:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Virtual-Items-Currency_admin-virtual-item
    Virtual-Items-Currency_401-invalid-basic-auth:
      description: >-
        Autenticación básica no superada o errónea. Asegúrese de haber utilizado
        la autenticación básica o las credenciales correctas.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 401
              errorCode:
                type: integer
                example: 1020
              errorMessage:
                type: string
                example: '[0401-1020]: Error in Authentication method occurred'
          examples:
            response:
              value:
                statusCode: 401
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
    Virtual-Items-Currency_201-created:
      description: El artículo virtual se creó correctamente.
      content:
        application/json:
          examples:
            response:
              value:
                sku: com.xsolla.item_1
          schema:
            type: object
            example:
              sku: com.xsolla.item_1
            properties:
              sku:
                type: string
                example: new-sku
    Virtual-Items-Currency_422-invalid-request:
      description: Solicitud no válida.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_422-invalid-request'
          examples:
            The property `sku` is required:
              $ref: '#/components/examples/422-property-sku-is-required'
            Numbers of attribute values per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attribute-values-per-item-exceeded
            Numbers of attributes per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attributes-per-item-exceeded
            Value limit exceeded:
              $ref: '#/components/examples/422-value-limit-exceeded'
            Custom attributes JSON can’t exceed 500 characters:
              $ref: '#/components/examples/422-custom-attributes-size-exceeded'
    Virtual-Items-Currency_200-admin-get-virtual-items-by-group:
      description: La lista de artículos virtuales se recibió correctamente.
      content:
        application/json:
          example:
            items:
              - sku: com.xsolla.armor_max_2
                name:
                  en: Empire Maximum Armor
                type: virtual_good
                description:
                  en: A strong armor forged to withstand heavy attacks
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/67d647ad4f4e9a905bd552b0408db8a8.png
                long_description: null
                attributes: []
                is_free: false
                order: 1
                groups:
                  - external_id: weapons
                    name:
                      en: Weapons
                  - external_id: accessory
                    name:
                      en: Accessory
                prices:
                  - amount: 12.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    country_iso: CZ
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user:
                    total: 5
                    limit_exceeded_visibility: show
                  per_item: null
                  recurrent_schedule:
                    per_user:
                      interval_type: monthly
                      day_of_week: null
                      day_of_month: 28
                      time: 11:00:00+08:00
                      reset_next_date: 1679972400
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-03-28T11:00:00+08:00'
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                custom_attributes:
                  purchased: 0
                  attr: value
              - sku: com.xsolla.armor_med_1
                name:
                  en: Xsolla Medium Armor
                type: virtual_good
                description:
                  en: >-
                    Moderately protect yourself against the Empires barrage of
                    attacks
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/7f6e216f8fcc3c1796162897c2b0db01.png
                long_description:
                  en: >-
                    Armor is a security-as-a-service company that provides cloud
                    security and compliance solutions for small businesses and
                    enterprises.
                attributes: []
                is_free: false
                order: 1
                groups:
                  - external_id: weapons
                    name:
                      en: Weapons
                  - external_id: accessory
                    name:
                      en: Accessory
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    country_iso: CZ
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: false
                regions: []
                limits:
                  per_user:
                    total: 5
                    limit_exceeded_visibility: show
                  per_item: null
                  recurrent_schedule:
                    per_user:
                      interval_type: daily
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods:
                  - date_from: null
                    date_until: '2020-08-11T20:00:00+03:00'
              - sku: com.xsolla.armor_med_2
                name:
                  en: Empire Medium Armor
                type: virtual_good
                description:
                  en: Provides moderate protection in battle.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png
                long_description:
                  en: A strong armor forged to withstand heavy attacks.
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups:
                  - external_id: weapons
                    name:
                      en: Weapons
                  - external_id: accessory
                    name:
                      en: Accessory
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user:
                    total: 5
                    limit_exceeded_visibility: show
                  per_item:
                    total: 500
                    available: 455
                    reserved: 5
                    sold: 40
                  recurrent_schedule:
                    per_user:
                      interval_type: daily
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods: []
              - sku: com.xsolla.armor_lrg_2
                name:
                  en: Empire Large Armor
                type: virtual_good
                description:
                  en: Provides moderate protection in battle.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png
                long_description:
                  en: A strong armor forged to withstand heavy attacks.
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups:
                  - external_id: weapons
                    name:
                      en: Weapons
                  - external_id: accessory
                    name:
                      en: Accessory
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    is_default: false
                    is_enabled: true
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user:
                    total: 5
                    limit_exceeded_visibility: show
                  per_item:
                    total: 500
                    available: 455
                    reserved: 5
                    sold: 40
                  recurrent_schedule:
                    per_user:
                      interval_type: hourly
                      hours_interval: 8
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods: []
          schema:
            type: object
            properties:
              items:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Virtual-Items-Currency_admin-virtual-item
    Virtual-Items-Currency_200-admin-get-item:
      description: El artículo virtual especificado se recibió correctamente.
      content:
        application/json:
          example:
            sku: com.xsolla.swords_1
            name:
              en: Sword Xsolla Skin
            type: virtual_good
            description:
              en: >-
                Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword
                - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional,
                Battle Ready - Black TPR, Steel Guard and Pommel
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/8ab44fe99038a56de01950ba4a971b77.png
            long_description:
              en: >-
                Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword
                - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional,
                Battle Ready - Black TPR, Steel Guard and Pommel
            attributes:
              - external_id: attr_1
                name:
                  en-US: OK
                values:
                  - external_id: val1
                    value:
                      en-US: VALUE
                  - external_id: val2
                    value:
                      en-US: VALUE2
            is_free: false
            is_paid_randomized_reward: true
            order: 1
            groups:
              - external_id: accessory
                name:
                  en: accessory
              - external_id: weapon
                name:
                  en: weapon
            prices:
              - amount: 4.99
                currency: USD
                is_default: true
                is_enabled: true
                country_iso: US
            media_list: []
            vc_prices: []
            is_enabled: true
            is_show_in_store: true
            regions: []
            limits:
              per_user:
                total: 5
                limit_exceeded_visibility: show
              per_item: null
              recurrent_schedule:
                per_user:
                  interval_type: daily
                  time: 11:00:00+08:00
                  reset_next_date: 1677553200
                  displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                  displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            custom_attributes:
              purchased: 0
              attr: value
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_admin-virtual-item'
    Virtual-Items-Currency_200-admin-get-virtual-currencies:
      description: La lista de monedas virtuales se recibió correctamente.
      content:
        application/json:
          example:
            items:
              - sku: com.xsolla.crystal_1
                name:
                  en: Crystals
                  ru: Crystals
                type: virtual_currency
                description:
                  en: Main in-game currency
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                long_description: null
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups: []
                prices:
                  - amount: 1
                    currency: USD
                    is_default: true
                    is_enabled: true
                    country_iso: US
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user:
                    total: 5
                    limit_exceeded_visibility: show
                  per_item: null
                  recurrent_schedule:
                    per_user:
                      interval_type: daily
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                custom_attributes:
                  purchased: 0
                  attr: value
              - sku: com.xsolla.gold_1
                name:
                  en: Gold
                  ru: Gold
                type: virtual_currency
                description:
                  en: Money for in-store purchases
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/bc1bf2bdeca78515d5d15e545d6884be.png
                long_description: null
                attributes: []
                is_free: false
                order: 1
                groups: []
                prices:
                  - amount: 1
                    currency: USD
                    is_default: true
                    is_enabled: true
                    country_iso: US
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods: []
          schema:
            type: object
            properties:
              items:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Virtual-Items-Currency_admin-virtual-currency
    Virtual-Items-Currency_200-admin-get-virtual-currency:
      description: La moneda virtual especificada se recibió correctamente.
      content:
        application/json:
          example:
            sku: com.xsolla.crystal_1
            name:
              en: Crystals
              ru: Crystals
            type: virtual_currency
            description:
              en: Main in-game currency
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
            long_description: null
            attributes:
              - external_id: attr_1
                name:
                  en-US: OK
                values:
                  - external_id: val1
                    value:
                      en-US: VALUE
                  - external_id: val2
                    value:
                      en-US: VALUE2
            is_free: false
            is_paid_randomized_reward: false
            order: 1
            groups: []
            prices:
              - amount: 1
                currency: USD
                is_default: true
                is_enabled: true
                country_iso: US
            media_list: []
            vc_prices: []
            is_enabled: true
            is_show_in_store: true
            regions: []
            limits:
              per_user: null
              per_item: null
              recurrent_schedule: null
            periods: []
            custom_attributes:
              purchased: 0
              attr: value
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_admin-virtual-currency'
    Virtual-Items-Currency_404-item:
      description: >-
        No se encontró el artículo. Asegúrese de que el `project_id` y el
        `item_sku` son correctos.
      content:
        application/json:
          schema:
            properties:
              statusCode:
                type: integer
                example: 404
              errorCode:
                type: integer
                example: 4001
              errorMessage:
                type: string
                example: >-
                  [0401-4001]: Item with Project Id = 44056 and Sku =
                  booster_mega_12222 not found
            type: object
    Virtual-Items-Currency_200-admin-get-virtual-currency-packages:
      description: La lista de paquetes de moneda virtual se recibió correctamente.
      content:
        application/json:
          example:
            items:
              - sku: com.xsolla.crystal_pack_1
                name:
                  en: Small crystal pack
                type: bundle
                description:
                  en: Crystals x100
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/a8682cea328afda0bd127d59eb5b9077.png
                long_description: null
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups: []
                prices:
                  - amount: 5
                    currency: USD
                    is_default: true
                    is_enabled: true
                    country_iso: US
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    sku: com.xsolla.crystal_1
                    name:
                      en: Crystals
                      ru: Crystals
                    type: virtual_currency
                    quantity: 100
                limits:
                  per_user:
                    total: 5
                    limit_exceeded_visibility: show
                  per_item: null
                  recurrent_schedule:
                    per_user:
                      interval_type: daily
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                custom_attributes:
                  purchased: 0
                  attr: value
              - sku: com.xsolla.crystal_pack_2
                name:
                  en: Medium crystal pack
                type: bundle
                description:
                  en: Crystals x500
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/431a40dd8c99290dd761508964ddbacf.png
                long_description: null
                attributes: []
                is_free: false
                order: 1
                groups: []
                prices:
                  - amount: 20
                    currency: USD
                    is_default: true
                    is_enabled: true
                    country_iso: US
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    sku: com.xsolla.crystal_2
                    name:
                      en: Crystals
                      ru: Crystals
                    type: virtual_currency
                    quantity: 500
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods:
                  - date_from: null
                    date_until: '2020-08-11T20:00:00+03:00'
              - sku: com.xsolla.crystal_pack_3
                name:
                  en: Massive crystal pack
                type: bundle
                description:
                  en: Crystals x1500
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/1d67a1d2f92d69e021a97effa692dff3.png
                long_description: null
                attributes: []
                is_free: false
                order: 1
                groups: []
                prices:
                  - amount: 50
                    currency: USD
                    is_default: true
                    is_enabled: true
                    country_iso: US
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    sku: com.xsolla.crystal_3
                    name:
                      en: Crystals
                      ru: Crystals
                    type: virtual_currency
                    quantity: 1500
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods: []
              - sku: com.xsolla.gold_pack_1
                name:
                  en: Small gold pack
                type: bundle
                description:
                  en: Gold x100
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/09984ff0a3ae6b367c9c886b31366950.png
                long_description: null
                attributes: []
                is_free: false
                order: 1
                groups: []
                prices:
                  - amount: 5
                    currency: USD
                    is_default: true
                    is_enabled: true
                    country_iso: US
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Money for in-store purchases
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/bc1bf2bdeca78515d5d15e545d6884be.png
                    sku: com.xsolla.gold_1
                    name:
                      en: Gold
                      ru: Gold
                    type: virtual_currency
                    quantity: 100
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods: []
              - sku: com.xsolla.gold_pack_2
                name:
                  en: Medium gold pack
                type: bundle
                description:
                  en: Gold x500
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/b5d8130bdaf28aa55c43a68aa3ca0ef4.png
                long_description: null
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups: []
                prices:
                  - amount: 20
                    currency: USD
                    is_default: true
                    is_enabled: true
                    country_iso: US
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Money for in-store purchases
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/bc1bf2bdeca78515d5d15e545d6884be.png
                    sku: com.xsolla.gold_2
                    name:
                      en: Gold
                      ru: Gold
                    type: virtual_currency
                    quantity: 500
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods: []
              - sku: com.xsolla.gold_pack_3
                name:
                  en: Large gold pack
                type: bundle
                description:
                  en: Gold x1500
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/dea74a3667807d5502a4acb8f4c879ca.png
                long_description: null
                attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                is_free: false
                order: 1
                groups: []
                prices:
                  - amount: 50
                    currency: USD
                    is_default: true
                    is_enabled: true
                    country_iso: US
                media_list: []
                vc_prices: []
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Money for in-store purchases
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/bc1bf2bdeca78515d5d15e545d6884be.png
                    sku: com.xsolla.gold_3
                    name:
                      en: Gold
                      ru: Gold
                    type: virtual_currency
                    quantity: 1500
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods: []
          schema:
            type: object
            properties:
              items:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Virtual-Items-Currency_admin-virtual-currency-package
    Virtual-Items-Currency_200-admin-get-virtual-currency-package:
      description: El paquete de moneda virtual especificado se recibió correctamente.
      content:
        application/json:
          example:
            sku: com.xsolla.crystal_pack_1
            name:
              en: Small crystal pack
            type: bundle
            description:
              en: Crystals x100
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/a8682cea328afda0bd127d59eb5b9077.png
            long_description: null
            attributes:
              - external_id: attr_1
                name:
                  en-US: OK
                values:
                  - external_id: val1
                    value:
                      en-US: VALUE
                  - external_id: val2
                    value:
                      en-US: VALUE2
            is_free: false
            is_paid_randomized_reward: true
            order: 1
            groups: []
            prices:
              - amount: 5
                currency: USD
                is_default: true
                is_enabled: true
                country_iso: US
            media_list: []
            vc_prices: []
            is_enabled: true
            is_show_in_store: true
            regions: []
            bundle_type: virtual_currency_package
            content:
              - description:
                  en: Main in-game currency
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                sku: com.xsolla.crystal_1
                name:
                  en: Crystals
                  ru: Crystals
                type: virtual_currency
                quantity: 100
            limits:
              per_user: null
              per_item: null
              recurrent_schedule: null
            periods: []
            custom_attributes:
              purchased: 0
              attr: value
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_admin-virtual-currency-package
    Virtual-Items-Currency_200-get-items-list:
      description: La lista de artículos virtuales se recibió correctamente.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_item-list'
          examples:
            response:
              value:
                has_more: true
                items:
                  - sku: com.xsolla.big_rocket_1
                    name:
                      en: Big Rocket
                    groups:
                      - external_id: accessory
                        name: accessory
                        item_order_in_group: 1
                    attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                    type: virtual_good
                    description:
                      en: Big Rocket - description
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                    is_free: false
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    virtual_prices:
                      - amount: 100
                        sku: com.xsolla.vc_1
                        is_default: true
                        amount_without_discount: 100
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                    can_be_bought: true
                    virtual_item_type: non_renewing_subscription
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount: null
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                          - quantity: 1
                            sku: com.xsolla.phys_good_1
                            type: physical_good
                          - quantity: 1
                            name: Super Lootbox with items
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/9676f06265375087e607cb79c5283688.png
                            sku: com.xsolla.SuperLootboxBundle_1
                            type: bundle
                            bundle_type: standard
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    custom_attributes:
                      purchased: 0
                      attr: value
                    vp_rewards: []
                  - sku: com.xsolla.shotgun_raider_1
                    name:
                      en: SHOTGUN FOR TRUE RAIDERS
                    groups:
                      - external_id: weapons
                        name: Weapons
                        item_order_in_group: 1
                    attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                      - external_id: rating
                        name:
                          en: Rating
                        values:
                          - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '3.9'
                    type: virtual_good
                    description:
                      en: description
                    image_url: http://image.png
                    is_free: false
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    virtual_prices:
                      - amount: 100
                        sku: com.xsolla.vc_1
                        is_default: true
                        amount_without_discount: 100
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                      - amount: 200
                        sku: com.xsolla.vc_2
                        is_default: false
                        amount_without_discount: 200
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                    can_be_bought: true
                    virtual_item_type: non_renewing_subscription
                    promotions: []
                    limits: null
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    vp_rewards: []
                  - sku: com.xsolla.shotgun_raider_2
                    name:
                      en: SHOTGUN FOR TRUE RAIDERS
                    groups: []
                    attributes: []
                    type: virtual_good
                    description:
                      en: description
                    image_url: http://image.png
                    is_free: true
                    price: null
                    virtual_prices: []
                    can_be_bought: true
                    virtual_item_type: non_renewing_subscription
                    promotions: []
                    limits: null
                    periods: []
                    vp_rewards: []
    Virtual-Items-Currency_200-get-item-by-sku:
      description: El artículo virtual se recibió correctamente.
      content:
        application/json:
          example:
            item_id: 488833
            sku: com.xsolla.swords_1
            type: virtual_good
            name:
              en: Sword Xsolla Skin
            description:
              en: >-
                Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword
                - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional,
                Battle Ready - Black TPR, Steel Guard and Pommel
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/8ab44fe99038a56de01950ba4a971b77.png
            price:
              amount: '4.99'
              amount_without_discount: '4.99'
              currency: USD
            virtual_prices: []
            can_be_bought: true
            promotions: []
            limits:
              per_user:
                total: 3
                available: 1
                recurrent_schedule:
                  interval_type: weekly
                  reset_next_date: 1761840000
                limit_exceeded_visibility: show
              per_item: null
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            attributes:
              - external_id: attr_1
                name:
                  en-US: OK
                values:
                  - external_id: val1
                    value: VALUE
                  - external_id: val2
                    value: VALUE2
            is_free: false
            groups:
              - external_id: weapons
                name: weapons
            virtual_item_type: non_consumable
            vp_rewards: []
            custom_attributes:
              purchased: 0
              attr: value
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_item'
    Virtual-Items-Currency_200-get-all-items-list:
      description: La lista de todos los artículos virtuales se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con artículos virtuales.
            properties:
              items:
                type: array
                example:
                  - sku: com.xsolla.big_rocket_1
                    name: Big Rocket
                    description: Big Rocket - description
                    groups:
                      - external_id: accessory
                        name:
                          en: accessory
                  - sku: com.xsolla.shotgun_raider_1
                    name: SHOTGUN FOR TRUE RAIDERS
                    description: description
                    groups:
                      - external_id: weapons
                        name:
                          en: Weapons
                  - sku: com.xsolla.shotgun_raider_2
                    name: SHOTGUN FOR TRUE RAIDERS
                    description: description
                    groups: []
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                      example: com.xsolla.big_rocket_1
                      description: >-
                        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.
                    name:
                      type: string
                      example: Big Rocket
                      description: Nombre del artículo.
                    groups:
                      type: array
                      properties:
                        external_id:
                          type: string
                          example: weapons
                        name:
                          type: object
                          additionalProperties:
                            type:
                              - string
                              - 'null'
                    description:
                      type: string
                      example: Big Rocket - description
                      description: Descripción del artículo.
          examples:
            response:
              value:
                items:
                  - sku: com.xsolla.big_rocket_1
                    name: Big Rocket
                    groups:
                      - external_id: accessory
                        name:
                          en: Accessory
                    description: Big Rocket - description
                  - sku: com.xsolla.shotgun_raider_1
                    name: SHOTGUN FOR TRUE RAIDERS
                    groups:
                      - external_id: weapons
                        name:
                          en: Weapons
                    description: description
                  - sku: com.xsolla.shotgun_raider_2
                    name: SHOTGUN FOR TRUE RAIDERS
                    groups: []
                    description: description
    Virtual-Items-Currency_200-get-virtual-currency-list:
      description: La lista de monedas virtuales se recibió correctamente.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_virtual-currency-list'
          examples:
            response:
              value:
                has_more: false
                items:
                  - sku: com.xsolla.crystal_1
                    name: Crystals
                    groups:
                      - external_id: game_currencies
                        name: VC
                        item_order_in_group: 1
                    attributes:
                      - external_id: attr1
                        name:
                          en-US: Attribute
                        values:
                          - external_id: val1
                            value: Value
                          - external_id: val2
                            value: Value
                    type: virtual_currency
                    description: Crystals - short description
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    is_free: false
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    virtual_prices:
                      - amount: 100
                        sku: com.xsolla.vc_1
                        is_default: true
                        amount_without_discount: 100
                        image_url: http://image.png
                        name: Virtual currency name
                        type: virtual_currency
                        description: description
                    can_be_bought: true
                    promotions: []
                    limits: null
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    custom_attributes:
                      purchased: 0
                      attr: value
                    vp_rewards: []
                  - sku: com.xsolla.emerald_1
                    name: Emeralds
                    groups:
                      - external_id: game_currencies
                        name: VC
                        item_order_in_group: 2
                    attributes:
                      - external_id: attr1
                        name:
                          en-US: Attribute
                        values:
                          - external_id: val1
                            value: Value
                          - external_id: val2
                            value: Value
                      - external_id: rating
                        name:
                          en: Rating
                        values:
                          - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '3.9'
                    type: virtual_currency
                    description: Emeralds - short description
                    image_url: http://image.png
                    is_free: false
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    promotions: []
                    limits: null
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    vp_rewards: []
                  - sku: com.xsolla.diamond_1
                    name: Diamonds
                    groups: []
                    attributes: []
                    type: virtual_currency
                    description: Diamonds - description
                    image_url: http://image.png
                    is_free: true
                    price: null
                    virtual_prices: []
                    can_be_bought: true
                    promotions: []
                    limits: null
                    periods: []
                    vp_rewards: []
    Virtual-Items-Currency_200-get-virtual-currency:
      description: La moneda virtual se recibió correctamente.
      content:
        application/json:
          examples:
            response:
              value:
                item_id: 451414
                sku: com.xsolla.crystal_1
                type: virtual_currency
                name: Crystals
                description: Crystals - short description
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                price:
                  amount: '100'
                  amount_without_discount: '100'
                  currency: USD
                virtual_prices: []
                can_be_bought: true
                promotions: []
                limits: null
                periods:
                  - date_from: '2023-08-11T10:00:00+03:00'
                    date_until: '2023-08-11T20:00:00+03:00'
                attributes:
                  - external_id: attr1
                    name:
                      en-US: Attribute
                    values:
                      - external_id: val1
                        value: Value
                      - external_id: val2
                        value: Value
                is_free: false
                groups: []
                custom_attributes:
                  purchased: 0
                  attr: value
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_virtual-currency'
    Virtual-Items-Currency_200-get-virtual-currency-packages-list:
      description: La lista de paquetes de moneda virtual se recibió correctamente.
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_virtual-currency-packages
          examples:
            response:
              value:
                has_more: false
                items:
                  - sku: com.xsolla.vc_package_1
                    name: VC Name first package
                    groups:
                      - external_id: gift
                        name: Gift
                        item_order_in_group: 1
                    attributes: []
                    type: bundle
                    description: VC Short Package Description
                    image_url: http://vc_package_image.png
                    is_free: false
                    price:
                      amount: '2.0000'
                      amount_without_discount: '2.0000'
                      currency: USD
                    bundle_type: virtual_currency_package
                    content:
                      - description: Crystals - short description
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                        sku: com.xsolla.crystal_1
                        name: Crystals
                        type: virtual_currency
                        quantity: 100
                        limits: null
                    virtual_prices: []
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    can_be_bought: true
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    custom_attributes:
                      purchased: 0
                      attr: value
                    vp_rewards: []
                  - sku: com.xsolla.vc_package_3
                    name: VC Name third package
                    groups:
                      - external_id: gift
                        name: Gift
                        item_order_in_group: 2
                    attributes: []
                    type: bundle
                    description: VC Short Package Description
                    image_url: http://vc_package_image.png
                    is_free: false
                    price:
                      amount: '4.0000'
                      amount_without_discount: '4.0000'
                      currency: USD
                    bundle_type: virtual_currency_package
                    content:
                      - description: description
                        image_url: http://image.png
                        sku: com.xsolla.emerald_1
                        name: Emeralds
                        type: virtual_currency
                        quantity: 200
                        limits: null
                    virtual_prices: []
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    can_be_bought: true
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    vp_rewards: []
    Virtual-Items-Currency_200-get-virtual-currency-package:
      description: El paquete de moneda virtual se recibió correctamente.
      content:
        application/json:
          examples:
            response:
              value:
                item_id: 488832
                sku: com.xsolla.crystal_pack_1
                type: bundle
                name: Crystal Pack
                bundle_type: virtual_currency_package
                description: Crystal Pack Short Description
                image_url: http://vc_package_image.png
                price:
                  amount: '100'
                  amount_without_discount: '100'
                  currency: USD
                virtual_prices: []
                can_be_bought: true
                promotions: []
                limits:
                  per_user:
                    total: 1
                    available: 1
                    recurrent_schedule:
                      interval_type: weekly
                      reset_next_date: 1690732800
                    limit_exceeded_visibility: show
                  per_item: null
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                attributes: []
                is_free: false
                groups: []
                content:
                  - item_id: 488831
                    sku: com.xsolla.crystals_1
                    type: virtual_currency
                    name: Crystals
                    description: Crystal - short description
                    image_url: https://cdn.xsolla.net/items/crystal-pack.png
                    quantity: 10
                    limits: null
                vp_rewards: []
                custom_attributes:
                  purchased: 0
                  attr: value
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_virtual-currency-package
    Virtual-Items-Currency_200-get-items-by-group-id:
      description: >-
        Se se recibió correctamente la lista de artículos del grupo
        especificado.
      content:
        application/json:
          schema:
            type: object
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                type: array
                example:
                  - sku: com.xsolla.big_rocket_1
                    name: Big Rocket
                    groups:
                      - external_id: weapons
                        name: weapons
                    attributes:
                      - external_id: stack_size
                        name: Stack size
                        values:
                          - value: '5'
                    type: virtual_good
                    description: Big Rocket - description
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                    is_free: false
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    virtual_prices:
                      - amount: 100
                        sku: com.xsolla.vc_1
                        is_default: true
                        amount_without_discount: 100
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                    can_be_bought: true
                    virtual_item_type: non_renewing_subscription
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                      per_item: null
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                  - sku: com.xsolla.shotgun_raider
                    name: SHOTGUN FOR TRUE RAIDERS
                    groups:
                      - external_id: weapons
                        name:
                          en: weapons
                    attributes:
                      - external_id: stack_size
                        name: Stack size
                        values:
                          - value: '5'
                      - external_id: rating
                        name: Rating
                        values:
                          - value: '3.9'
                      - external_id: genre
                        name: Genre
                        values:
                          - value: Strategy
                          - value: Tactical
                          - Turn-based
                    type: virtual_good
                    description: description
                    image_url: http://image.png
                    is_free: false
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    virtual_prices:
                      - amount: 100
                        sku: com.xsolla.vc_1
                        is_default: true
                        amount_without_discount: 100
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                      - amount: 200
                        sku: com.xsolla.vc_2
                        is_default: false
                        amount_without_discount: 200
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                    can_be_bought: true
                    virtual_item_type: non_renewing_subscription
                    promotions: []
                    limits: null
                    periods: []
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                      example: com.xsolla.big_rocket_1
                      description: >-
                        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.
                    name:
                      type: string
                      example: Big Rocket
                      description: Nombre del artículo.
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    attributes:
                      $ref: >-
                        #/components/schemas/Virtual-Items-Currency_client-attributes
                    type:
                      type: string
                      example: virtual_good
                      description: >-
                        Tipo de artículo:
                        `consumable`/`expiration`/`permanent`/`lootboxes`/`physical`.
                    description:
                      type: string
                      example: Big Rocket - description
                      description: Descripción del artículo.
                    image_url:
                      type: string
                      example: >-
                        https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                      description: URL de la imagen.
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    price:
                      type: object
                      description: Precios de artículos.
                      properties:
                        amount:
                          type: string
                          example: '100.99'
                          description: Precio del artículo con descuento.
                        amount_without_discount:
                          type: string
                          example: '100.99'
                          description: Precio del artículo.
                        currency:
                          type: string
                          example: USD
                          description: >-
                            Divisa del precio del artículo. Código de tres
                            letras según [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                    virtual_prices:
                      $ref: '#/components/schemas/client_virtual_prices_response'
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    virtual_item_type:
                      type: string
                      example: non_consumable
                      description: >-
                        Tipo de artículo virtual.


                        Valores posibles:

                        - `consumable`: Un objeto que desaparece del inventario
                        tras su utilización (p. ej., munición).

                        - `non_consumable`: Un objeto que permanece en el
                        inventario durante un tiempo ilimitado.

                        - `non_renewing_subscription`: Objeto de duración
                        limitada que puede representar el acceso a servicios o
                        contenidos durante un periodo limitado.
                      enum:
                        - consumable
                        - non_consumable
                        - non_renewing_subscription
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    periods:
                      $ref: '#/components/schemas/item-periods-response'
                    custom_attributes:
                      $ref: '#/components/schemas/item-custom-attributes-response'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
          examples:
            response:
              value:
                has_more: false
                items:
                  - sku: com.xsolla.big_rocket_1
                    name: Big Rocket
                    groups:
                      - external_id: weapons
                        name: weapons
                        item_order_in_group: 1
                    attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                    type: virtual_good
                    description: Big Rocket - description
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                    is_free: false
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    virtual_prices:
                      - amount: 100
                        sku: com.xsolla.vc_1
                        is_default: true
                        amount_without_discount: 100
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                    can_be_bought: true
                    virtual_item_type: non_renewing_subscription
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    custom_attributes:
                      purchased: 0
                      attr: value
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                  - sku: com.xsolla.shotgun_raider_1
                    name: SHOTGUN FOR TRUE RAIDERS
                    groups:
                      - external_id: weapons
                        name: weapons
                        item_order_in_group: 2
                    attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                      - external_id: rating
                        name:
                          en: Rating
                        values:
                          - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '3.9'
                    type: virtual_good
                    description: description
                    image_url: http://image.png
                    is_free: false
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    virtual_prices:
                      - amount: 100
                        sku: com.xsolla.vc_1
                        is_default: true
                        amount_without_discount: 100
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                      - amount: 200
                        sku: com.xsolla.vc_2
                        is_default: false
                        amount_without_discount: 200
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        type: virtual_currency
                        description: description
                    can_be_bought: true
                    virtual_item_type: non_renewing_subscription
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    periods: []
                    vp_rewards: []
    Virtual-Items-Currency_404-item-group:
      description: >-
        No se encontró el grupo. Asegúrese de que el `external_id` es correcto y
        de que el grupo no está desactivado ni eliminado.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                description: Código de estado de la respuesta HTTP.
                example: 404
              errorCode:
                type: integer
                description: Código de error de Xsolla
                example: 4403
              errorMessage:
                type: string
                description: Breve descripción del error.
                example: '[0401-4403]: Item group not found'
          examples:
            response:
              value:
                statusCode: 404
                errorCode: 4403
                errorMessage: '[0401-4403]: Item group not found'
    Virtual-Items-Currency_200-get-virtual-currency-by-group-id:
      description: >-
        Se ha recibido correctamente la lista de moneda virtual del grupo
        especificado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_virtual-currency-list'
          examples:
            response:
              value:
                has_more: false
                items:
                  - sku: com.xsolla.crystal_1
                    name: Crystals
                    groups:
                      - external_id: game_currencies
                        name: VC
                        item_order_in_group: 1
                    attributes:
                      - external_id: attr1
                        name:
                          en-US: Attribute
                        values:
                          - external_id: val1
                            value: Value
                          - external_id: val2
                            value: Value
                    type: virtual_currency
                    description: Crystals - short description
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    is_free: false
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    virtual_prices:
                      - amount: 100
                        sku: com.xsolla.vc_1
                        is_default: true
                        amount_without_discount: 100
                        image_url: http://image.png
                        name: Virtual currency name
                        type: virtual_currency
                        description: description
                    can_be_bought: true
                    promotions: []
                    limits: null
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    custom_attributes:
                      purchased: 0
                      attr: value
                    vp_rewards: []
                  - sku: com.xsolla.emerald_1
                    name: Emeralds
                    groups:
                      - external_id: game_currencies
                        name: VC
                        item_order_in_group: 2
                    attributes:
                      - external_id: attr1
                        name:
                          en-US: Attribute
                        values:
                          - external_id: val1
                            value: Value
                          - external_id: val2
                            value: Value
                      - external_id: rating
                        name:
                          en: Rating
                        values:
                          - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '3.9'
                    type: virtual_currency
                    description: Emeralds - short description
                    image_url: http://image.png
                    is_free: false
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    promotions: []
                    limits: null
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    vp_rewards: []
    Virtual-Items-Currency_200-get-virtual-currency-packages-by-group-id:
      description: >-
        Se ha recibido correctamente la lista de paquetes de moneda virtual del
        grupo especificado.
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_virtual-currency-packages
          examples:
            response:
              value:
                has_more: false
                items:
                  - sku: com.xsolla.vc_package_1
                    name: VC Name first package
                    groups:
                      - external_id: gift
                        name: Gift
                        item_order_in_group: 1
                    attributes: []
                    type: bundle
                    description: VC Short Package Description
                    image_url: http://vc_package_image.png
                    is_free: false
                    price:
                      amount: '2.0000'
                      amount_without_discount: '2.0000'
                      currency: USD
                    bundle_type: virtual_currency_package
                    content:
                      - description: Crystals - short description
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                        sku: com.xsolla.crystal_1
                        name: Crystals
                        type: virtual_currency
                        quantity: 100
                        limits: null
                    virtual_prices: []
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    can_be_bought: true
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    custom_attributes:
                      purchased: 0
                      attr: value
                    vp_rewards: []
                  - sku: com.xsolla.vc_package_3
                    name: VC Name third package
                    groups:
                      - external_id: gift
                        name: Gift
                        item_order_in_group: 2
                    attributes: []
                    type: bundle
                    description: VC Short Package Description
                    image_url: http://vc_package_image.png
                    is_free: false
                    price:
                      amount: '4.0000'
                      amount_without_discount: '4.0000'
                      currency: USD
                    bundle_type: virtual_currency_package
                    content:
                      - description: description
                        image_url: http://image.png
                        sku: com.xsolla.emerald_1
                        name: Emeralds
                        type: virtual_currency
                        quantity: 200
                        limits: null
                    virtual_prices: []
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    can_be_bought: true
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    vp_rewards: []
    Virtual-Items-Currency_200-get-items-groups:
      description: La lista de grupos se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              groups:
                type: array
                example:
                  - external_id: weapons
                    name: Weapons
                    description: All weapons available in the game
                    image_url: null
                    order: 1
                  - external_id: group_external_id
                    name: Super
                    description: Super description
                    image_url: null
                    order: 1
                items:
                  type: object
                  properties:
                    external_id:
                      type: string
                      example: weapons
                      description: ID externo del grupo.
                    name:
                      type: string
                      example: Weapons
                      description: Nombre del grupo.
                    description:
                      type: string
                      example: All weapons available in the game
                      description: Group description.
                    image_url:
                      type:
                        - string
                        - 'null'
                      example: null
                      description: URL de la imagen.
                    order:
                      type: integer
                      example: 1
                      description: Define el orden de disposición.
                    level:
                      type: integer
                      example: 0
                      description: Nivel de anidamiento del grupo.
                    children:
                      type: array
                      example:
                        - external_id: background
                          name: Background
                          description: Background description
                          image_url: null
                          order: 1
                          level: 1
                          children:
                            - external_id: accessory
                              name: Accessory
                              description: Accessory
                              image_url: null
                              order: 1
                              level: 2
                              children: []
                              parent_external_id: background
                          parent_external_id: weapons
                      description: Grupos secundarios.
                      items:
                        type: object
                        properties:
                          external_id:
                            type: string
                            example: background
                            description: ID externo del grupo.
                          name:
                            type: string
                            example: Background
                            description: Nombre del grupo.
                          description:
                            type: string
                            example: Background description
                            description: Group description.
                          image_url:
                            type:
                              - string
                              - 'null'
                            example: null
                            description: URL de la imagen del grupo.
                          order:
                            type: integer
                            example: 1
                            description: Define el orden de disposición.
                          level:
                            type: integer
                            example: 1
                            description: Nivel de anidamiento del grupo.
                          children:
                            type: array
                            example:
                              - external_id: accessory
                                name: Accessory
                                description: Accessory
                                image_url: null
                                order: 1
                                level: 2
                                children: []
                                parent_external_id: background
                            description: Grupos secundarios.
                            items:
                              type: object
                              properties:
                                external_id:
                                  type: string
                                  example: accessory
                                  description: ID externo del grupo.
                                name:
                                  type: string
                                  example: Accessory
                                  description: Nombre del grupo.
                                description:
                                  type: string
                                  example: Accessory
                                  description: Group description.
                                image_url:
                                  type:
                                    - string
                                    - 'null'
                                  example: null
                                  description: URL de la imagen.
                                order:
                                  type: integer
                                  example: 1
                                  description: Define el orden de disposición.
                                level:
                                  type: integer
                                  example: 2
                                  description: Nivel de anidamiento del grupo.
                                children:
                                  type: array
                                  example: []
                                  description: Grupos secundarios.
                                  items:
                                    type: string
                                parent_external_id:
                                  type:
                                    - string
                                    - 'null'
                                  example: background
                                  description: ID externo del grupo primario.
                          parent_external_id:
                            type:
                              - string
                              - 'null'
                            example: weapons
                            description: ID externo del grupo primario.
                    parent_external_id:
                      type:
                        - string
                        - 'null'
                      example: null
                      description: ID externo del grupo primario.
          examples:
            response:
              value:
                groups:
                  - external_id: weapons
                    name: Weapons
                    description: All weapons available in the game
                    image_url: https://example.com/groups/weapons.png
                    order: 1
                  - external_id: armor
                    name: Armor
                    description: Protective equipment
                    image_url: https://example.com/groups/armor.png
                    order: 2
                  - external_id: consumables
                    name: Consumables
                    description: Potions, food, and other single-use items
                    image_url: null
                    order: 3
    ItemGroup_200-admin-get-group-list:
      description: La lista de grupos se recuperó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              groups:
                type: array
                items:
                  $ref: '#/components/schemas/admin-group-response-base'
          examples:
            response:
              $ref: '#/components/examples/200-admin-get-group-list'
    ItemGroup_401-invalid-basic-auth:
      description: >-
        No se superó la autenticación básica o se proporcionaron unas
        credenciales no válidas. Asegúrese de utilizar la autenticación básica o
        las credenciales correctas.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/error-response-base'
          examples:
            response:
              value:
                statusCode: 401
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
    ItemGroup_201-admin-create-group:
      description: El grupo de artículos se creó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              external_id:
                type: string
                description: >-
                  ID externo del grupo de artículos especificado durante la
                  creación.
                example: weapons
          examples:
            response:
              $ref: '#/components/examples/201-admin-create-group'
    ItemGroup_422-create-update:
      description: >-
        No puede procesarse la solicitud. Se devolvió por errores de validación
        o si los datos incumplen las normas del sistema.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ItemGroup_422-invalid-request'
          examples:
            The property `external_id` is required:
              $ref: '#/components/examples/422-property-external-id-required'
            Group already exists:
              value:
                statusCode: 422
                errorCode: 4401
                errorMessage: '[0401-4401]: Item group already exists'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
            Group cannot be its own parent:
              value:
                statusCode: 422
                errorCode: 4404
                errorMessage: '[0401-4404]: Group can''t be self parent'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
            Reserved external_id value:
              value:
                statusCode: 422
                errorCode: 4516
                errorMessage: >-
                  [0401-4516]: Value 'tools' not allowed to be used for the
                  property 'external_id'.
                transactionId: x-x-x-x-transactionId-mock-x-x-x
    ItemGroup_200-admin-get-group:
      description: El grupo de artículos se recuperó correctamente.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/admin-group-response-base'
          examples:
            response:
              $ref: '#/components/examples/200-admin-get-group'
    ItemGroup_404-group-not-found:
      description: >-
        No se encontró el grupo de artículos. Se devuelve si el grupo con el
        `external_id` especificado no existe o pertenece a otro proyecto.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/error-response-base'
              - type: object
                properties:
                  errorMessageExtended:
                    type:
                      - object
                      - 'null'
                    description: ID utilizados en la búsqueda fallida.
                    properties:
                      project_id:
                        type: integer
                        description: ID del proyecto utilizado en la solicitud de búsqueda.
                      external_id_list:
                        type: array
                        description: >-
                          Lista de `external_id` de grupos utilizados en la
                          solicitud de búsqueda.
                        items:
                          type: string
                      group_id_list:
                        type: array
                        description: >-
                          Lista de `id` de grupos utilizados en la solicitud de
                          búsqueda.
                        items:
                          type: integer
          examples:
            Group not found by external_id:
              value:
                statusCode: 404
                errorCode: 4403
                errorMessage: '[0401-4403]: Group with external id = ''weapons'' not found'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
                errorMessageExtended:
                  project_id: 123
                  external_id_list:
                    - weapons
            Group not found by ID:
              value:
                statusCode: 404
                errorCode: 4403
                errorMessage: >-
                  [0401-4403]: Group with id in (99) and projectId = 123 not
                  found
                transactionId: x-x-x-x-transactionId-mock-x-x-x
                errorMessageExtended:
                  project_id: 123
                  group_id_list:
                    - 99
            Items or group not found (reorder endpoints):
              value:
                statusCode: 404
                errorCode: 4403
                errorMessage: '[0401-4403]: Items or group were not found.'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
                errorMessageExtended: {}
    ItemGroup_204-admin-update-group:
      description: El grupo de artículos se actualizó correctamente.
    ItemGroup_204-admin-delete-group:
      description: El grupo de artículos se eliminó correctamente.
    ItemGroup_422-delete:
      description: >-
        No puede procesarse la solicitud. No es posible eliminar un grupo que
        contenga artículos.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ItemGroup_422-invalid-request'
          examples:
            Cannot delete group with items:
              value:
                statusCode: 422
                errorCode: 4402
                errorMessage: '[0401-4402]: Item group with items cannot be deleted.'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
    ItemGroup_200-admin-get-group-list-by-item-type:
      description: >-
        Se recuperó correctamente la lista de grupos de artículos. El campo
        `items_count` incluye solamente artículos del tipo especificado. 
      content:
        application/json:
          schema:
            type: object
            properties:
              groups:
                type: array
                items:
                  $ref: '#/components/schemas/admin-group-response-by-item-type'
          examples:
            response:
              $ref: '#/components/examples/200-admin-get-group-list-by-item-type'
    ItemGroup_200-admin-get-group-by-item-type:
      description: >-
        Se recuperó correctamente el grupo de artículos, con `items_count`
        filtrados por el tipo de artículo especificado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/admin-group-detail-response-by-item-type'
          examples:
            response:
              $ref: '#/components/examples/200-admin-get-group-by-item-type'
    ItemGroup_204-admin-reorder-groups:
      description: El grupo de artículos se reordenó correctamente.
    ItemGroup_404-reorder-groups-not-found:
      description: >-
        No se encontró el grupo de artículos. Se devuelve si el grupo con el
        `id` o `external_id` especificado no existe o pertenece a otro proyecto.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/error-response-base'
              - type: object
                properties:
                  errorMessageExtended:
                    type:
                      - object
                      - 'null'
                    description: ID utilizados en la búsqueda fallida.
                    properties:
                      project_id:
                        type: integer
                        description: ID del proyecto utilizado en la solicitud de búsqueda.
                      external_id_list:
                        type: array
                        description: >-
                          Lista de `external_id` de grupos utilizados en la
                          solicitud de búsqueda.
                        items:
                          type: string
                      group_id_list:
                        type: array
                        description: >-
                          Lista de `id` de grupos utilizados en la solicitud de
                          búsqueda.
                        items:
                          type: integer
          examples:
            Group not found by external_id:
              value:
                statusCode: 404
                errorCode: 4403
                errorMessage: '[0401-4403]: Group with external id = ''weapons'' not found'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
                errorMessageExtended:
                  project_id: 123
                  external_id_list:
                    - weapons
            Group not found by ID:
              value:
                statusCode: 404
                errorCode: 4403
                errorMessage: >-
                  [0401-4403]: Group with id in (99) and projectId = 123 not
                  found
                transactionId: x-x-x-x-transactionId-mock-x-x-x
                errorMessageExtended:
                  project_id: 123
                  group_id_list:
                    - 99
    ItemGroup_422-ordering:
      description: >-
        No puede procesarse la solicitud. El cuerpo de la solicitud no superó la
        validación.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ItemGroup_422-invalid-request'
          examples:
            Invalid request body:
              value:
                statusCode: 422
                errorCode: 1102
                errorMessage: '[0401-1102]: Unprocessable Entity'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
                errorMessageExtended:
                  - property: ''
                    message: Object value found, but an array is required
    ItemGroup_204-admin-reorder-items:
      description: Los artículos del grupo se reordenaron correctamente.
    ItemGroup_404-reorder-items-by-external-id-not-found:
      description: >-
        No se encontró el grupo de artículos o los artículos. Se devuelve si el
        grupo con el `external_id` especificado no existe o pertenece a otro
        proyecto, o si no se encontró uno o varios `item_id` en el grupo.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/error-response-base'
              - type: object
                properties:
                  errorMessageExtended:
                    type:
                      - object
                      - 'null'
                    description: ID utilizados en la búsqueda fallida.
                    properties:
                      project_id:
                        type: integer
                        description: ID del proyecto utilizado en la solicitud de búsqueda.
                      external_id_list:
                        type: array
                        description: >-
                          Lista de `external_id` de grupos utilizados en la
                          solicitud de búsqueda.
                        items:
                          type: string
          examples:
            Items or group not found:
              value:
                statusCode: 404
                errorCode: 4403
                errorMessage: '[0401-4403]: Items or group were not found.'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
                errorMessageExtended: {}
    ItemGroup_404-reorder-items-by-id-not-found:
      description: >-
        No se encontró el grupo de artículos o los artículos. Se devuelve si el
        grupo con el `id` especificado no existe o pertenece a otro proyecto, o
        si no se encontró uno o varios `item_id` en el grupo.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/error-response-base'
              - type: object
                properties:
                  errorMessageExtended:
                    type:
                      - object
                      - 'null'
                    description: ID utilizados en la búsqueda fallida.
                    properties:
                      project_id:
                        type: integer
                        description: ID del proyecto utilizado en la solicitud de búsqueda.
                      group_id_list:
                        type: array
                        description: >-
                          Lista de `id` de grupos utilizados en la solicitud de
                          búsqueda.
                        items:
                          type: integer
          examples:
            Items or group not found:
              value:
                statusCode: 404
                errorCode: 4403
                errorMessage: '[0401-4403]: Items or group were not found.'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
                errorMessageExtended: {}
    Virtual-Items-Currency_200-quick-purchase:
      description: Compra virtual rápida realizada correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              order_id:
                type: integer
                description: ID del pedido.
          examples:
            response:
              value:
                order_id: 641
    Virtual-Items-Currency_422-not-enough-virtual-currency:
      description: No hay suficiente moneda virtual.
      content:
        application/json:
          schema:
            type: object
            properties:
              errorCode:
                type: integer
                example: 5006
              statusCode:
                type: integer
                example: 422
              errorMessage:
                type: string
                example: '[0401-5006]: Not enough virtual currency'
          examples:
            response:
              value:
                errorCode: 5006
                statusCode: 422
                errorMessage: '[0401-5006]: Not enough virtual currency'
    Game-Keys_200-get-games-catalog:
      description: La lista de juegos se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con juegos.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                type: array
                example:
                  - sku: com.xsolla.game_1
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                      - external_id: Xsolla
                        name: Xsolla games
                    type: unit
                    unit_type: game
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    promotions: []
                    unit_items:
                      - sku: com.xsolla.game_key_01
                        type: game_key
                        is_free: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_1
                        has_keys: true
                        is_pre_order: true
                        release_date: '2020-08-11T10:00:00+03:00'
                        promotions: []
                        periods:
                          - date_from: '2020-08-11T10:00:00+03:00'
                            date_until: '2020-08-11T20:00:00+03:00'
                      - sku: com.xsolla.game_key_02
                        type: game_key
                        is_free: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        drm_name: Origin
                        drm_sku: origin_key_1
                        has_keys: false
                        is_pre_order: false
                        release_date: null
                        promotions: []
                        periods: []
                  - sku: com.xsolla.game_2
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                    type: unit
                    unit_type: game
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                    promotions: []
                    unit_items:
                      - sku: com.xsolla.game_key_01
                        type: game_key
                        is_free: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_2
                        has_keys: false
                        is_pre_order: false
                        release_date: null
                        promotions: []
                        periods:
                          - date_from: null
                            date_until: '2020-08-11T20:00:00+03:00'
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                      example: game_01
                      description: >-
                        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.
                    name:
                      type: string
                      example: Game name
                      description: Nombre del artículo.
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_schemas-client-attributes'
                    type:
                      type: string
                      example: unit
                      description: >-
                        Tipo de artículo:
                        `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
                    unit_type:
                      type: string
                      example: game
                      description: 'Tipo de unidad: `game`.'
                    description:
                      type: string
                      example: Game description
                      description: Descripción del artículo.
                    image_url:
                      type: string
                      example: >-
                        https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                      description: URL de la imagen.
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    unit_items:
                      type: array
                      items:
                        type: object
                        properties:
                          sku:
                            type: string
                            example: game_01
                            description: >-
                              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.
                          type:
                            type: string
                            example: game_key
                            description: 'Tipo de artículo: `game_key`.'
                          is_free:
                            $ref: '#/components/schemas/value-is_free'
                          price:
                            type: object
                            description: Precios de artículos.
                            properties:
                              amount:
                                type: string
                                example: '2.9900'
                                description: Precio del artículo con descuento.
                              amount_without_discount:
                                type: string
                                example: '2.9900'
                                description: Precio del artículo.
                              currency:
                                type: string
                                example: USD
                                description: >-
                                  Divisa del precio del artículo. Código de tres
                                  letras según [ISO
                                  4217](https://en.wikipedia.org/wiki/ISO_4217).
                          virtual_prices:
                            $ref: >-
                              #/components/schemas/client_virtual_prices_response
                          can_be_bought:
                            $ref: '#/components/schemas/Can_be_bought'
                          drm_name:
                            type: string
                            example: Steam
                            description: Nombre del DRM (gestión de derechos digitales).
                          drm_sku:
                            type: string
                            example: steam
                            description: >-
                              ID único de DRM. El SKU solo puede contener
                              caracteres alfanuméricos latinos en minúsculas y
                              mayúsculas, puntos, guiones y guiones bajos.
                          has_keys:
                            type: boolean
                            example: false
                            description: >-
                              Si es `true`, la clave del juego tiene claves para
                              la venta.
                          is_pre_order:
                            type: boolean
                            example: true
                            description: >-
                              Si es `true`, la clave del juego está reservada y
                              la fecha de lanzamiento no ha pasado.
                          release_date:
                            type:
                              - string
                              - 'null'
                            example: '2020-08-11T10:00:00+03:00'
                            description: >-
                              Fecha de lanzamiento de la clave del juego en
                              formato ISO 8601.
                          promotions:
                            $ref: '#/components/schemas/Catalog_item_promotions'
                          periods:
                            $ref: '#/components/schemas/item-periods'
                          vp_rewards:
                            $ref: >-
                              #/components/schemas/client-item-value-point-reward
          examples:
            response:
              value:
                has_more: false
                items:
                  - sku: com.xsolla.game_1
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                        item_order_in_group: 2
                      - external_id: Xsolla
                        name: Xsolla games
                        item_order_in_group: 1
                    type: unit
                    unit_type: game
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    promotions: []
                    unit_items:
                      - sku: com.xsolla.game_key_01
                        type: game_key
                        is_free: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_1
                        has_keys: true
                        is_pre_order: true
                        release_date: '2020-08-11T10:00:00+03:00'
                        periods:
                          - date_from: '2020-08-11T10:00:00+03:00'
                            date_until: '2020-08-11T20:00:00+03:00'
                        vp_rewards:
                          - item_id: 175232
                            sku: com.xsolla.value_point_1
                            amount: 130
                            name: Value point
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                          - item_id: 186321
                            sku: com.xsolla.clan_value_point_1
                            amount: 50
                            name: Clan Reward VP 1
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                            is_clan: true
                      - sku: com.xsolla.game_key_02
                        type: game_key
                        is_free: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        drm_name: Origin
                        drm_sku: origin_key_1
                        has_keys: false
                        is_pre_order: false
                        release_date: null
                        periods: []
                        vp_rewards: []
                  - sku: com.xsolla.game_2
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                        item_order_in_group: 1
                    type: unit
                    unit_type: game
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                    promotions: []
                    unit_items:
                      - sku: com.xsolla.game_key_01
                        type: game_key
                        is_free: false
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_1
                        has_keys: false
                        is_pre_order: false
                        release_date: null
                        periods:
                          - date_from: '2020-08-11T20:00:00+03:00'
                            date_until: null
                        vp_rewards: []
    Game-Keys_200-get-game-keys-by-group-catalog:
      description: La lista de claves del juego se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con juegos.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                type: array
                example:
                  - sku: com.xsolla.game_1
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                      - external_id: Xsolla
                        name: Xsolla games
                    type: game_key
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    is_free: false
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    virtual_prices: []
                    drm_name: Steam
                    drm_sku: steam_key_1
                    has_keys: true
                    is_pre_order: true
                    release_date: '2020-08-11T10:00:00+03:00'
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                  - sku: com.xsolla.game_2
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                    type: game_key
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    is_free: false
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    virtual_prices: []
                    drm_name: Steam
                    drm_sku: steam_key_2
                    has_keys: true
                    is_pre_order: false
                    release_date: null
                    periods: []
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                      example: game_01
                      description: >-
                        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.
                    name:
                      type: string
                      example: Game name
                      description: Nombre del artículo.
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_schemas-client-attributes'
                    type:
                      type: string
                      example: game_key
                      description: 'Tipo de artículo: `game_key`.'
                    description:
                      type: string
                      example: Game description
                      description: Descripción del artículo.
                    image_url:
                      type: string
                      example: >-
                        https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                      description: URL de la imagen.
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    price:
                      type: object
                      description: Precios de artículos.
                      properties:
                        amount:
                          type: string
                          example: '2.9900'
                          description: Precio del artículo con descuento.
                        amount_without_discount:
                          type: string
                          example: '2.9900'
                          description: Precio del artículo.
                        currency:
                          type: string
                          example: USD
                          description: >-
                            Divisa del precio del artículo. Código de tres
                            letras según [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                    virtual_prices:
                      $ref: '#/components/schemas/client_virtual_prices_response'
                    drm_name:
                      type: string
                      example: Steam
                      description: Nombre del DRM (gestión de derechos digitales).
                    drm_sku:
                      type: string
                      example: steam
                      description: >-
                        ID único de DRM. El SKU solo puede contener caracteres
                        alfanuméricos latinos en minúsculas y mayúsculas,
                        puntos, guiones y guiones bajos.
                    has_keys:
                      type: boolean
                      example: false
                      description: >-
                        Si es `true`, la clave del juego tiene claves para la
                        venta.
                    is_pre_order:
                      type: boolean
                      example: true
                      description: >-
                        Si es `true`, la clave del juego está reservada y la
                        fecha de lanzamiento no ha pasado.
                    release_date:
                      type:
                        - string
                        - 'null'
                      example: '2020-08-11T10:00:00+03:00'
                      description: >-
                        Fecha de lanzamiento de la clave del juego en formato
                        ISO 8601.
                    periods:
                      $ref: '#/components/schemas/item-periods-response'
          examples:
            response:
              value:
                has_more: true
                items:
                  - sku: com.xsolla.game_1
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                        item_order_in_group: 2
                      - external_id: Xsolla
                        name: Xsolla games
                        item_order_in_group: 1
                    type: game_key
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    is_free: false
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    virtual_prices: []
                    drm_name: Steam
                    drm_sku: steam_key_1
                    has_keys: true
                    is_pre_order: true
                    release_date: '2020-08-11T10:00:00+03:00'
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                  - sku: com.xsolla.game_2
                    name: Game name
                    groups:
                      - external_id: all
                        name: All games
                        item_order_in_group: 1
                    type: game_key
                    description: Game description
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    is_free: false
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    virtual_prices: []
                    drm_name: Steam
                    drm_sku: steam_key_2
                    has_keys: true
                    is_pre_order: false
                    release_date: null
                    periods: []
    Game-Keys_200-get-drm-list:
      description: La lista de sistemas de DRM se ha recibido correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con juegos.
            properties:
              drm:
                type: array
                example:
                  - sku: steam_key_1
                    name: Steam
                    image: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    link: https://support.steampowered.com
                    redeem_instruction_link: https://support.steampowered.com
                    drm_id: 1
                  - sku: playstation_key_1
                    name: Playstation
                    image: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    link: null
                    redeem_instruction_link: https://support.us.playstation.com
                    drm_id: 2
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                      example: steam
                      description: >-
                        ID único de DRM. El SKU solo puede contener caracteres
                        alfanuméricos latinos en minúsculas y mayúsculas,
                        puntos, guiones y guiones bajos.
                    name:
                      type: string
                      example: Steam
                      description: Nombre del DRM (gestión de derechos digitales).
                    image:
                      type: string
                      example: >-
                        https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                      description: URL de la imagen.
                    link:
                      type:
                        - string
                        - 'null'
                      example: https://support.us.playstation.com
                      description: Enlace para canjear.
                    redeem_instruction_link:
                      type: string
                      example: https://support.us.playstation.com
                      description: Enlace de las instrucciones de canje.
                    drm_id:
                      type: number
                      example: 1
                      description: ID del DRM.
          examples:
            response:
              value:
                drm:
                  - sku: steam_key_1
                    name: Steam
                    image: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    link: https://support.steampowered.com
                    redeem_instruction_link: https://support.steampowered.com
                    drm_id: 1
                  - sku: playstation_key_1
                    name: Playstation
                    image: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    link: null
                    redeem_instruction_link: https://support.us.playstation.com
                    drm_id: 2
    Game-Keys_200-admin-get-games-list:
      description: La lista de juegos se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con juegos.
            properties:
              items:
                type: array
                items:
                  type: object
                  properties:
                    item_id:
                      type: integer
                      example: 1
                      description: >-
                        ID único interno del artículo que se proporciona al
                        crearlo.
                    sku:
                      type: string
                      example: game_1
                      description: >-
                        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.
                    type:
                      type: string
                      example: unit
                      description: Tipo de artículo. En este caso es siempre `unit`.
                    name:
                      $ref: '#/components/schemas/name-localization-object'
                    description:
                      $ref: '#/components/schemas/description-localization-object'
                    long_description:
                      $ref: >-
                        #/components/schemas/long-description-localization-object
                    image_url:
                      type: string
                      example: https://image.example.com
                      description: URL de la imagen.
                    media_list:
                      type: array
                      example:
                        - type: image
                          url: >-
                            https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                      description: >-
                        Recursos adicionales del juego, como capturas de
                        pantalla, vídeos de partidas del juego, etc.
                      items:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                              - image
                              - video
                            example: image
                            description: 'Tipo de soporte multimedia: `image`/`video`.'
                          url:
                            type: string
                            example: >-
                              https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                            description: Archivo de recurso.
                    is_enabled:
                      type: boolean
                      description: >-
                        Si se deshabilita, el artículo no se puede comprar ni se
                        puede acceder a este a través del inventario.
                    is_show_in_store:
                      type: boolean
                      description: El artículo está disponible para la compra.
                    order:
                      type: integer
                      example: 1
                      description: Prioridad de orden del juego en la lista.
                    groups:
                      type: array
                      example:
                        - external_id: horror
                          name:
                            en: Horror
                      description: Grupos a los que pertenece el artículo.
                      items:
                        type: object
                        properties:
                          external_id:
                            type: string
                            example: horror
                          name:
                            type: object
                            example:
                              en: Horror
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_admin-attributes'
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    unit_items:
                      type: array
                      description: >-
                        Claves del juego para diferentes DRM (gestión de
                        derechos digitales).
                      items:
                        type: object
                        description: >-
                          Artículo de clave del juego. Representa el juego en
                          una plataforma determinada (Steam, GOG, etc.).
                        properties:
                          item_id:
                            type: integer
                            example: 1
                            description: >-
                              ID único interno del artículo que se proporciona
                              al crearlo.
                          sku:
                            type: string
                            example: game_1
                            description: >-
                              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.
                          type:
                            type: string
                            example: game_key
                            description: >-
                              Tipo de artículo. En este caso es siempre
                              `game_key`.
                          is_free:
                            $ref: '#/components/schemas/value-is_free'
                          prices:
                            type: array
                            description: Precios en monedas reales.
                            example:
                              - amount: 1299.99
                                currency: RUB
                                is_default: true
                                is_enabled: true
                            items:
                              type: object
                              properties:
                                amount:
                                  type: number
                                  example: 1299.99
                                currency:
                                  type: string
                                  example: RUB
                                  description: >-
                                    Divisa del precio del artículo. Código de
                                    tres letras según [ISO
                                    4217](https://en.wikipedia.org/wiki/ISO_4217).
                                is_default:
                                  type: boolean
                                  description: >-
                                    El precio por defecto se utiliza para
                                    generar el catálogo si no se especifica el
                                    precio en la moneda del usuario.
                                is_enabled:
                                  type: boolean
                                country_iso:
                                  type:
                                    - string
                                    - 'null'
                                  example: US
                                  description: >-
                                    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).
                          virtual_prices:
                            type:
                              - array
                              - 'null'
                            example:
                              - sku: com.xsolla.gold_1
                                name:
                                  en: Gold
                                type: virtual_currency
                                description: null
                                image_url: >-
                                  https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png
                                amount: 1000
                                is_default: true
                            items:
                              type: object
                              properties:
                                sku:
                                  type: string
                                  example: gold
                                  description: >-
                                    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.
                                name:
                                  type: object
                                  additionalProperties: true
                                  example:
                                    en: Gold
                                  description: >-
                                    Objeto con traducciones para el nombre de la
                                    moneda virtual. Las claves se especifican en
                                    la norma ISO 3166-1.
                                type:
                                  type: string
                                  example: virtual_currency
                                  description: >-
                                    Tipo de artículo. En este caso es siempre
                                    `virtual_currency`.
                                description:
                                  type:
                                    - object
                                    - 'null'
                                  additionalProperties: true
                                  example:
                                    en: Game 1 Example
                                  description: >-
                                    Object with localizations for game
                                    description. Keys are specified in ISO
                                    3166-1.
                                image_url:
                                  type: string
                                  example: https://image.example.com
                                  description: URL de la imagen.
                                amount:
                                  type: number
                                is_default:
                                  type: boolean
                          order:
                            type: integer
                            example: 1
                            description: Prioridad de orden del juego en la lista.
                          is_enabled:
                            type: boolean
                            description: >-
                              Si se deshabilita, el artículo no se puede comprar
                              ni se puede acceder a este a través del
                              inventario.
                          is_show_in_store:
                            type: boolean
                            description: El artículo está disponible para la compra.
                          drm_name:
                            type: string
                            example: Steam
                            description: Nombre del DRM de la clave del juego.
                          drm_sku:
                            type: string
                            example: steam
                            description: ID único del DRM.
                          drm_image:
                            type:
                              - string
                              - 'null'
                            example: >-
                              https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                            description: Icono del DRM de clave del juego.
                          drm_id:
                            type: integer
                            example: 1
                            description: ID único interno de DRM.
                          keys:
                            type: object
                            properties:
                              available:
                                type: integer
                                description: Número de claves disponibles para la compra.
                              total:
                                type: integer
                                description: Número total de claves cargadas.
                              used:
                                type: integer
                                description: Número de claves vendidas.
                          is_sales_exist:
                            type: boolean
                            description: >-
                              Si es `true`, la clave del juego fue comprada por
                              los usuarios.
                          pre_order:
                            type: object
                            description: Configuración del pedido por anticipado.
                            properties:
                              release_date:
                                type:
                                  - string
                                  - 'null'
                                description: >-
                                  Fecha de lanzamiento de la clave del juego en
                                  formato ISO 8601.
                              is_enabled:
                                type: boolean
                                description: >-
                                  Si está deshabilitada, el artículo no es un
                                  pedido por anticipado.
                              description:
                                type:
                                  - string
                                  - 'null'
                                description: >-
                                  Additional information for the pre-order which
                                  will be emailed.
                          regions:
                            $ref: '#/components/schemas/Game-Keys_regions'
                          limits:
                            $ref: '#/components/schemas/admin-item-limit-response'
                          periods:
                            $ref: '#/components/schemas/item-periods-response'
                          name:
                            $ref: '#/components/schemas/name-localization-object'
                          attributes:
                            $ref: '#/components/schemas/Game-Keys_admin-attributes'
                          long_description:
                            $ref: >-
                              #/components/schemas/long-description-localization-object
                          groups:
                            type: array
                            example:
                              - external_id: horror
                                name:
                                  en: Horror
                            description: Grupos a los que pertenece el artículo.
                            items:
                              type: object
                              properties:
                                external_id:
                                  type: string
                                  example: horror
                                name:
                                  type: object
                                  example:
                                    en: Horror
          examples:
            response:
              value:
                items:
                  - item_id: 1
                    sku: com.xsolla.game_1
                    type: unit
                    name:
                      en: Game 1
                    description:
                      en: Example game 1
                    long_description:
                      en: Example game's long description
                    image_url: https://image.example.com
                    media_list:
                      - type: image
                        url: >-
                          https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                    order: 1
                    groups:
                      - external_id: horror
                        name:
                          en: Horror
                    attributes:
                      - external_id: platform
                        name:
                          en-US: Platform
                        values:
                          - external_id: >-
                              platform_value_d847f9a494487f5e95ad218f7beecac646f15989
                            value:
                              en-US: Windows, Linux
                              de-DE: Windows, Linux
                    is_free: false
                    is_enabled: true
                    is_show_in_store: false
                    unit_items:
                      - item_id: 3
                        sku: com.xsolla.game_1_key_1
                        type: game_key
                        is_free: false
                        prices:
                          - amount: 1199.99
                            currency: RUB
                            is_default: true
                            is_enabled: true
                            country_iso: RU
                        virtual_prices: []
                        order: 1
                        is_enabled: true
                        is_show_in_store: false
                        drm_name: Steam
                        drm_sku: steam_key_1
                        drm_image: >-
                          https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                        drm_id: 1
                        keys:
                          available: 3
                          total: 4
                          used: 1
                        is_sales_exist: false
                        pre_order:
                          release_date: null
                          is_enabled: false
                          description: null
                        limits:
                          per_user:
                            total: 10
                            limit_exceeded_visibility: show
                          per_item:
                            total: 10000
                            available: 5000
                            reserved: 500
                            sold: 4500
                          recurrent_schedule:
                            per_user:
                              interval_type: daily
                              time: 11:00:00+08:00
                              reset_next_date: 1677553200
                              displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                              displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                        periods:
                          - date_from: '2020-08-11T20:00:00+03:00'
                            date_until: null
                      - item_id: 4
                        sku: com.xsolla.game_1_key_2
                        type: game_key
                        name:
                          en: Game 1 Key 2
                        groups: []
                        attributes: []
                        is_free: false
                        prices:
                          - amount: 1299.99
                            currency: RUB
                            is_default: true
                            is_enabled: true
                            country_iso: RU
                        virtual_prices: null
                        order: 1
                        is_enabled: true
                        is_show_in_store: false
                        drm_name: Epic Games Store
                        drm_sku: epicgames_key_1
                        drm_image: null
                        drm_id: 8
                        keys:
                          available: 0
                          total: 0
                          used: 0
                        is_sales_exist: true
                        pre_order:
                          release_date: '2020-08-11T10:00:00+03:00'
                          is_enabled: true
                          description: Some description
                        limits:
                          per_user: null
                          per_item: null
                          recurrent_schedule: null
                        periods: []
                  - item_id: 2
                    sku: com.xsolla.game_2
                    type: unit
                    name:
                      en: Game 2
                    description:
                      en: Example game 2
                    long_description:
                      en: Example game's long description
                    image_url: https://image.example.com
                    media_list: []
                    order: 1
                    groups:
                      - external_id: horror
                        name:
                          en: Horror
                    attributes:
                      - external_id: platform
                        name:
                          en-US: Platform
                        values:
                          - external_id: >-
                              platform_value_d847f9a494487f5e95ad218f7beecac646f15989
                            value:
                              en-US: Windows, Linux
                              de-DE: Windows, Linux
                    is_free: false
                    is_enabled: true
                    is_show_in_store: true
                    unit_items:
                      - item_id: 5
                        sku: com.xsolla.game_2_key_2
                        type: game_key
                        is_free: false
                        prices: []
                        virtual_prices:
                          - sku: com.xsolla.gold_1
                            name:
                              en: Gold
                            type: virtual_currency
                            description: null
                            image_url: >-
                              https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png
                            amount: 1000
                            is_default: true
                        order: 1
                        is_enabled: false
                        is_show_in_store: false
                        drm_name: Epic Games Store
                        drm_sku: epicgames_key_1
                        drm_image: null
                        drm_id: 8
                        keys:
                          available: 0
                          total: 0
                          used: 0
                        is_sales_exist: true
                        pre_order:
                          release_date: null
                          is_enabled: false
                          description: null
                        limits:
                          per_user:
                            total: 10
                            limit_exceeded_visibility: show
                          per_item:
                            total: 10000
                            available: 5000
                            reserved: 500
                            sold: 4500
                          recurrent_schedule:
                            per_user:
                              interval_type: daily
                              time: 11:00:00+08:00
                              reset_next_date: 1677553200
                              displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                              displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                        periods:
                          - date_from: '2020-08-11T10:00:00+03:00'
                            date_until: '2020-08-11T20:00:00+03:00'
    Game-Keys_401-invalid-basic-auth:
      description: >-
        Autenticación básica no superada o errónea. Asegúrese de haber utilizado
        la autenticación básica o las credenciales correctas.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 401
              errorCode:
                type: integer
                example: 1020
              errorMessage:
                type: string
                example: '[0401-1020]: Error in Authentication method occurred'
          examples:
            response:
              value:
                statusCode: 401
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
    Game-Keys_422-invalid-request:
      description: Solicitud no válida.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Game-Keys_422-invalid-request'
          examples:
            The property `drm_sku` is required:
              value:
                statusCode: 422
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `drm_sku` is
                  required
            Numbers of attribute values per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attribute-values-per-item-exceeded
            Numbers of attributes per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attributes-per-item-exceeded
            Value limit exceeded:
              $ref: '#/components/examples/422-value-limit-exceeded'
    Game-Keys_200-admin-get-game-by-sku:
      description: El juego se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con información del juego.
            properties:
              item_id:
                type: integer
                example: 1
                description: ID único interno del artículo que se proporciona al crearlo.
              sku:
                type: string
                example: game_1
                description: >-
                  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.
              type:
                type: string
                example: unit
                description: Tipo de artículo. En este caso es siempre `unit`.
              name:
                $ref: '#/components/schemas/name-localization-object'
              description:
                $ref: '#/components/schemas/description-localization-object'
              long_description:
                $ref: '#/components/schemas/long-description-localization-object'
              image_url:
                type: string
                example: https://image.example.com
                description: URL de la imagen.
              media_list:
                type: array
                example:
                  - type: image
                    url: >-
                      https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                description: >-
                  Recursos adicionales del juego, como capturas de pantalla,
                  vídeos de partidas del juego, etc.
                items:
                  type: object
                  properties:
                    type:
                      type: string
                      enum:
                        - image
                        - video
                      example: image
                      description: 'Tipo de soporte multimedia: `image`/`video`.'
                    url:
                      type: string
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                      description: Archivo de recurso.
              order:
                type: integer
                example: 1
                description: Prioridad de orden del juego en la lista.
              groups:
                type: array
                example:
                  - external_id: horror
                    name:
                      en: Horror
                description: Grupos a los que pertenece el artículo.
                items:
                  type: object
                  properties:
                    external_id:
                      type: string
                      example: horror
                    name:
                      type: object
                      example:
                        en: Horror
              attributes:
                $ref: '#/components/schemas/Game-Keys_admin-attributes'
              is_enabled:
                type: boolean
              is_free:
                $ref: '#/components/schemas/value-is_free'
              is_show_in_store:
                type: boolean
              unit_items:
                type: array
                description: >-
                  Claves del juego para diferentes DRM (gestión de derechos
                  digitales).
                items:
                  type: object
                  description: >-
                    Artículo de clave del juego. Representa el juego en una
                    plataforma determinada (Steam, GOG, etc.).
                  properties:
                    item_id:
                      type: integer
                      example: 1
                      description: >-
                        ID único interno del artículo que se proporciona al
                        crearlo.
                    sku:
                      type: string
                      example: game_1
                      description: >-
                        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.
                    type:
                      type: string
                      example: game_key
                      description: Tipo de artículo. En este caso es siempre `game_key`.
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    prices:
                      type: array
                      description: Precios en monedas reales.
                      example:
                        - amount: 1299.99
                          currency: RUB
                          is_default: true
                          is_enabled: true
                          country_is: RU
                      items:
                        type: object
                        properties:
                          amount:
                            type: number
                            example: 1299.99
                          currency:
                            type: string
                            example: RUB
                            description: >-
                              Divisa del precio del artículo. Código de tres
                              letras según [ISO
                              4217](https://en.wikipedia.org/wiki/ISO_4217).
                          is_default:
                            type: boolean
                            description: >-
                              El precio por defecto se utiliza para generar el
                              catálogo si no se especifica el precio en la
                              moneda del usuario.
                          is_enabled:
                            type: boolean
                          country_iso:
                            type:
                              - string
                              - 'null'
                            example: US
                            description: >-
                              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).
                    virtual_prices:
                      type:
                        - array
                        - 'null'
                      example:
                        - sku: com.xsolla.gold_1
                          name:
                            en: Gold
                          type: virtual_currency
                          description: null
                          image_url: >-
                            https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png
                          amount: 1000
                          is_default: true
                      items:
                        type: object
                        properties:
                          sku:
                            type: string
                            example: gold
                            description: >-
                              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.
                          name:
                            type: object
                            additionalProperties: true
                            example:
                              en: Gold
                            description: >-
                              Objeto con traducciones para el nombre de la
                              moneda virtual. Las claves se especifican en la
                              norma ISO 3166-1.
                          type:
                            type: string
                            example: virtual_currency
                            description: >-
                              Tipo de artículo. En este caso es siempre
                              `virtual_currency`.
                          description:
                            type: object
                            additionalProperties: true
                            example:
                              en: Game 1 Example
                            description: >-
                              Object with localizations for game description.
                              Keys are specified in ISO 3166-1.
                          image_url:
                            type: string
                            example: https://image.example.com
                            description: URL de la imagen.
                          amount:
                            type: number
                          is_default:
                            type: boolean
                    order:
                      type: integer
                      example: 1
                      description: Prioridad de orden del juego en la lista.
                    is_enabled:
                      type: boolean
                      description: >-
                        Si se deshabilita, el artículo no se puede comprar ni se
                        puede acceder a este a través del inventario.
                    is_show_in_store:
                      type: boolean
                      description: El artículo está disponible para la compra.
                    drm_name:
                      type: string
                      example: Steam
                      description: Nombre del DRM de la clave del juego.
                    drm_sku:
                      type: string
                      example: steam
                      description: ID único del DRM.
                    drm_image:
                      type:
                        - string
                        - 'null'
                      example: >-
                        https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                      description: Icono del DRM de clave del juego.
                    drm_id:
                      type: integer
                      example: 1
                      description: ID único interno de DRM.
                    keys:
                      type: object
                      properties:
                        available:
                          type: integer
                          description: Número de claves disponibles para la compra.
                        total:
                          type: integer
                          description: Número total de claves cargadas.
                        used:
                          type: integer
                          description: Número de claves vendidas.
                    is_sales_exist:
                      type: boolean
                      description: >-
                        Si es `true`, la clave del juego fue comprada por los
                        usuarios.
                    pre_order:
                      type: object
                      description: Configuración del pedido por anticipado.
                      properties:
                        release_date:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Fecha de lanzamiento de la clave del juego en
                            formato ISO 8601.
                        is_enabled:
                          type: boolean
                          description: >-
                            Si está deshabilitada, el artículo no es un pedido
                            por anticipado.
                        description:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Additional information for the pre-order which will
                            be emailed.
                    regions:
                      $ref: '#/components/schemas/Game-Keys_regions'
                    limits:
                      $ref: '#/components/schemas/admin-item-limit-response'
                    periods:
                      $ref: '#/components/schemas/item-periods-response'
          examples:
            response:
              value:
                item_id: 1
                sku: com.xsolla.game_1
                type: unit
                name:
                  en: Game 1
                description:
                  en: Example game 1
                long_description:
                  en: Example game's long description
                image_url: https://image.example.com
                media_list:
                  - type: image
                    url: >-
                      https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                order: 1
                groups:
                  - external_id: horror
                    name:
                      en: Horror
                attributes:
                  - external_id: platform
                    name:
                      en-US: Platform
                    values:
                      - external_id: >-
                          platform_value_d847f9a494487f5e95ad218f7beecac646f15989
                        value:
                          en-US: Windows, Linux
                          de-DE: Windows, Linux
                is_free: false
                is_enabled: true
                is_show_in_store: false
                unit_items:
                  - item_id: 3
                    sku: com.xsolla.game_1_key_1
                    type: game_key
                    is_free: false
                    prices:
                      - amount: 1199.99
                        currency: RUB
                        is_default: true
                        is_enabled: true
                        country_iso: RU
                    virtual_prices: []
                    order: 1
                    is_enabled: true
                    is_show_in_store: false
                    drm_name: Steam
                    drm_sku: steam_key_1
                    drm_image: >-
                      https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                    drm_id: 1
                    keys:
                      available: 3
                      total: 4
                      used: 1
                    is_sales_exist: false
                    pre_order:
                      release_date: null
                      is_enabled: false
                      description: null
                    limits:
                      per_user:
                        total: 5
                        limit_exceeded_visibility: show
                      per_item:
                        total: 10000
                        available: 5000
                        reserved: 500
                        sold: 4500
                      recurrent_schedule:
                        per_user:
                          interval_type: daily
                          time: 11:00:00+08:00
                          reset_next_date: 1677553200
                          displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                          displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                  - item_id: 4
                    sku: com.xsolla.game_1_key_2
                    type: game_key
                    is_free: false
                    prices:
                      - amount: 1299.99
                        currency: RUB
                        is_default: true
                        is_enabled: true
                        country_iso: RU
                    virtual_prices: null
                    order: 1
                    is_enabled: true
                    is_show_in_store: false
                    drm_name: Epic Games Store
                    drm_sku: epicgames_key_1
                    drm_image: null
                    drm_id: 8
                    keys:
                      available: 0
                      total: 0
                      used: 0
                    is_sales_exist: false
                    pre_order:
                      release_date: '2020-08-11T10:00:00+03:00'
                      is_enabled: true
                      description: null
                    regions:
                      - id: 12
                      - id: 64
                    limits:
                      per_user: null
                      per_item: null
                      recurrent_schedule: null
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
    Game-Keys_200-session-information:
      description: >-
        Los códigos que cargan la información de sesión se recibieron
        correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              session_id:
                type: string
                example: fc7105b6e8ee01339582970b37697242
              count_uploaded:
                type: integer
                example: 0
              count_total:
                type: integer
                example: 100
              count_skipped:
                type: integer
                example: 10
              status:
                type: string
                example: processing
          examples:
            response:
              value:
                session_id: fc7105b6e8ee01339582970b37697242
                count_uploaded: 0
                count_total: 100
                count_skipped: 10
                status: processing
    Game-Keys_200-get-codes:
      description: Los códigos se recibieron correctamente.
      content:
        text/plain:
          schema:
            type: string
            example: PIN-CODE-ALL PIN-CODE-ALL-3
          examples:
            response:
              value: PIN-CODE-ALL PIN-CODE-ALL-3
    Game-Keys_200-user-entitlement-list:
      description: >-
        La lista de claves de juego propiedad del usuario se recibió
        correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con información del juego.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              total_items_count:
                $ref: '#/components/schemas/Pagination_total-items-count'
              items:
                type: array
                items:
                  $ref: '#/components/schemas/Game-Keys_entitlement_item'
          examples:
            response:
              value:
                has_more: false
                total_items_count: 1
                items:
                  - name: The Greatest Game in the World
                    description: Description of the greatest game in the world.
                    image_url: https://none
                    project_id: 30810
                    game_sku: com.xsolla.key_1
                    drm: drmfree
                    is_pre_order: false
    Game-Keys_403-auth-header-not-sent:
      description: No se envió el encabezado de autorización.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 403
              errorCode:
                type: integer
                example: 0
              errorMessage:
                type: string
                example: No se envió el encabezado de autorización.
              transactionId:
                type: string
                example: x-x-x-x-transactionId-mock-x-x-x
          examples:
            response:
              value:
                statusCode: 403
                errorCode: 0
                errorMessage: Authorization header not sent
    Bundles_200-admin-get-bundle-list:
      description: La lista de lotes se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con artículos.
            properties:
              items:
                type: array
                items:
                  $ref: '#/components/schemas/Bundles_admin_bundle_response'
          example:
            items:
              - item_id: 610316
                sku: com.xsolla.UltraSuperLootboxBundle_1
                name:
                  en: Ultra Super Lootbox Bundle
                type: bundle
                description:
                  en: Ultra Super Lootbox with items
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/779d2588a5b3cf348133fa7d5755cec8.png
                long_description:
                  en: Ultra Super lootbox with different items
                attributes: []
                is_free: false
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                prices:
                  - amount: '150.49'
                    currency: USD
                    is_default: true
                    is_enabled: true
                virtual_prices: []
                media_list: []
                order: 1
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: standard
                content:
                  - sku: com.xsolla.booster_min_1
                    name:
                      en: Xsolla Booster Mini
                    type: virtual_good
                    description:
                      en: >-
                        Test your luck to find glorious treasures from the past
                        in an Xsolla Booster Mini.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5ee252b292a560930c8f7e2c791dfc6d.png
                    quantity: 2
                  - sku: com.xsolla.booster_min_2
                    name:
                      en: Booster
                    type: virtual_good
                    description:
                      en: >-
                        Get high-quality, competitively priced gas with Booster.
                        Download the app for free same-day delivery. Kick the
                        gas station habit for good.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e76d317ee5a8d06a4b730bcf23746e9e.png
                    quantity: 15
                  - sku: com.xsolla.gloves_1
                    name:
                      en: Xsolla Gloves
                    type: virtual_good
                    description:
                      en: >-
                        Enjoy a range of outdoor activities with gloves from EK
                        Sporting Goods.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/93a7ee3ae284b677d3dc1f2e989731cb.png
                    quantity: 3
                  - sku: com.xsolla.boots_1
                    name:
                      en: Xsolla Boots
                    type: virtual_good
                    description:
                      en: Stylishly protect your toes with the accent of Xsolla
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/6e33d40df3cdac152dac9ac3d1f5986e.png
                    quantity: 2
                  - sku: com.xsolla.gun_max
                    name:
                      en: Xsolla Gun
                    type: virtual_good
                    description:
                      en: >-
                        The M134 Minigun is a 7.62×51mm NATO, six-barrel rotary
                        machine gun with a high rate of fire (2,000 to 6,000
                        rounds per minute)
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/3093eeb39d5ec7def3af6396607a30ba.png
                    quantity: 10
                  - sku: com.xsolla.minigun_2
                    name:
                      en: Empire Minigun
                    type: virtual_good
                    description:
                      en: Just hold down the trigger and pray to the Empire
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/dabfa4567cd2d82e0562d4b0f448b436.png
                    quantity: 3
                limits:
                  per_user:
                    total: 10
                    limit_exceeded_visibility: show
                  per_item:
                    total: 500
                    available: 455
                    reserved: 5
                    sold: 40
                  recurrent_schedule:
                    per_user:
                      interval_type: daily
                      time: 11:00:00+08:00
                      reset_next_date: 1677639600
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-03-01T11:00:00+08:00'
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                custom_attributes:
                  type: lootbox
                  purchased: 0
              - item_id: 610317
                sku: com.xsolla.EmpireBundle_1
                name:
                  en: Empire bundle
                type: bundle
                description:
                  en: Empire bundle with items
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/685b21f9d9dca4aa0c953e8816b4eb4b.png
                long_description:
                  en: Empire bundle with some goods
                attributes: []
                is_free: false
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                prices: []
                virtual_prices:
                  - sku: com.xsolla.crystal_1
                    name:
                      en: Crystals
                      ru: Crystals
                    type: virtual_currency
                    description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    amount: '150'
                    is_default: true
                media_list: []
                order: 1
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: standard
                content:
                  - sku: com.xsolla.keys_2
                    name:
                      en: Empire Key
                    type: virtual_good
                    description:
                      en: Opens ONE Empire lootbox of any kind
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c2f8536f08a9949964e4fa2e01a7cb8.png
                    quantity: 5
                  - sku: com.xsolla.booster_mega_2
                    name:
                      en: Empire Booster Mega
                    type: virtual_good
                    description:
                      en: >-
                        Take it, take it all! All of the Empires riches in one
                        Mega Booster.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/55e908cb9670301ac8f89a6382433a27.png
                    quantity: 1
                  - sku: com.xsolla.booster_min_2
                    name:
                      en: Empire Booster Mini
                    type: virtual_good
                    description:
                      en: >-
                        Test your luck to find glorious treasures from Empire's
                        past
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5bcecec17400a0d8c72dd265ff730b07.png
                    quantity: 3
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods: []
    Bundles_401-invalid-basic-auth:
      description: >-
        Autenticación básica no superada o errónea. Asegúrese de haber utilizado
        la autenticación básica o las credenciales correctas.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 401
              errorCode:
                type: integer
                example: 1020
              errorMessage:
                type: string
                example: '[0401-1020]: Error in Authentication method occurred'
          examples:
            response:
              value:
                statusCode: 401
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
    Bundles_201-admin-create-bundle:
      description: El lote se creó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              sku:
                $ref: '#/components/schemas/Bundles_sku'
          examples:
            response:
              value:
                sku: com.xsolla.kg_1
    Bundles_422-invalid-request:
      description: Solicitud no válida.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Bundles_422-invalid-request'
          examples:
            The property `sku` is required:
              $ref: '#/components/examples/422-property-sku-is-required'
            Numbers of attribute values per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attribute-values-per-item-exceeded
            Numbers of attributes per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attributes-per-item-exceeded
            Value limit exceeded:
              $ref: '#/components/examples/422-value-limit-exceeded'
            Custom attributes JSON can’t exceed 500 characters:
              $ref: '#/components/examples/422-custom-attributes-size-exceeded'
    Bundles_200-admin-get-bundle-list-in-group:
      description: La lista de lotes se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con artículos.
            properties:
              items:
                type: array
                items:
                  $ref: '#/components/schemas/Bundles_admin_bundle_response'
          example:
            items:
              - item_id: 610316
                sku: com.xsolla.UltraSuperLootboxBundle_1
                name:
                  en: Ultra Super Lootbox Bundle
                type: bundle
                description:
                  en: Ultra Super Lootbox with items
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/779d2588a5b3cf348133fa7d5755cec8.png
                long_description:
                  en: Ultra Super lootbox with different items
                attributes: []
                is_free: false
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                prices:
                  - amount: '150.49'
                    currency: USD
                    is_default: true
                    is_enabled: true
                virtual_prices: []
                media_list: []
                order: 1
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: standard
                content:
                  - sku: com.xsolla.booster_min_1
                    name:
                      en: Xsolla Booster Mini
                    type: virtual_good
                    description:
                      en: >-
                        Test your luck to find glorious treasures from the past
                        in an Xsolla Booster Mini.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5ee252b292a560930c8f7e2c791dfc6d.png
                    quantity: 2
                  - sku: com.xsolla.booster_min_2
                    name:
                      en: Booster
                    type: virtual_good
                    description:
                      en: >-
                        Get high-quality, competitively priced gas with Booster.
                        Download the app for free same-day delivery. Kick the
                        gas station habit for good.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e76d317ee5a8d06a4b730bcf23746e9e.png
                    quantity: 15
                  - sku: com.xsolla.gloves_1
                    name:
                      en: Xsolla Gloves
                    type: virtual_good
                    description:
                      en: >-
                        Enjoy a range of outdoor activities with gloves from EK
                        Sporting Goods.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/93a7ee3ae284b677d3dc1f2e989731cb.png
                    quantity: 3
                  - sku: com.xsolla.boots_1
                    name:
                      en: Xsolla Boots
                    type: virtual_good
                    description:
                      en: Stylishly protect your toes with the accent of Xsolla
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/6e33d40df3cdac152dac9ac3d1f5986e.png
                    quantity: 2
                  - sku: com.xsolla.gun_max
                    name:
                      en: Xsolla Gun
                    type: virtual_good
                    description:
                      en: >-
                        The M134 Minigun is a 7.62×51mm NATO, six-barrel rotary
                        machine gun with a high rate of fire (2,000 to 6,000
                        rounds per minute)
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/3093eeb39d5ec7def3af6396607a30ba.png
                    quantity: 10
                  - sku: com.xsolla.minigun_2
                    name:
                      en: Empire Minigun
                    type: virtual_good
                    description:
                      en: Just hold down the trigger and pray to the Empire
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/dabfa4567cd2d82e0562d4b0f448b436.png
                    quantity: 3
                limits:
                  per_user:
                    total: 10
                    limit_exceeded_visibility: show
                  per_item:
                    total: 500
                    available: 455
                    reserved: 5
                    sold: 40
                  recurrent_schedule:
                    per_user:
                      interval_type: weekly
                      day_of_week: 2
                      time: 11:00:00+08:00
                      reset_next_date: 1677553200
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_next_date: '2023-03-07T11:00:00+08:00'
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                custom_attributes:
                  type: lootbox
                  purchased: 0
              - item_id: 610317
                sku: com.xsolla.EmpireBundle_1
                name:
                  en: Empire bundle
                type: bundle
                description:
                  en: Empire bundle with items
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/685b21f9d9dca4aa0c953e8816b4eb4b.png
                long_description:
                  en: Empire bundle with some goods
                attributes: []
                is_free: false
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                prices: []
                virtual_prices:
                  - sku: com.xsolla.crystal_1
                    name:
                      en: Crystals
                      ru: Crystals
                    type: virtual_currency
                    description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    amount: '150'
                    is_default: true
                media_list: []
                order: 1
                is_enabled: true
                is_show_in_store: true
                regions: []
                bundle_type: standard
                content:
                  - sku: com.xsolla.keys_2
                    name:
                      en: Empire Key
                    type: virtual_good
                    description:
                      en: Opens ONE Empire lootbox of any kind
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c2f8536f08a9949964e4fa2e01a7cb8.png
                    quantity: 5
                  - sku: com.xsolla.booster_mega_2
                    name:
                      en: Empire Booster Mega
                    type: virtual_good
                    description:
                      en: >-
                        Take it, take it all! All of the Empires riches in one
                        Mega Booster.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/55e908cb9670301ac8f89a6382433a27.png
                    quantity: 1
                  - sku: com.xsolla.booster_min_2
                    name:
                      en: Empire Booster Mini
                    type: virtual_good
                    description:
                      en: >-
                        Test your luck to find glorious treasures from Empire's
                        past
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5bcecec17400a0d8c72dd265ff730b07.png
                    quantity: 3
                limits:
                  per_user: null
                  per_item: null
                  recurrent_schedule: null
                periods: []
    Bundles_200-admin-get-bundle:
      description: El lote especificado se recibió correctamente.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Bundles_admin_bundle_response'
          example:
            item_id: 610316
            sku: com.xsolla.EmpireBundle_1
            name:
              en: Empire bundle
            type: bundle
            description:
              en: Empire bundle with items
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/685b21f9d9dca4aa0c953e8816b4eb4b.png
            long_description:
              en: Empire bundle with some goods
            attributes: []
            is_free: false
            is_paid_randomized_reward: true
            groups:
              - external_id: all
                name:
                  en: Equipment
            prices: []
            virtual_prices:
              - sku: com.xsolla.crystal_1
                name:
                  en: Crystals
                  ru: Crystals
                type: virtual_currency
                description:
                  en: Main in-game currency
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                amount: '150'
                is_default: true
            media_list: []
            order: 1
            is_enabled: true
            is_show_in_store: true
            regions: []
            bundle_type: standard
            content:
              - sku: com.xsolla.keys_2
                name:
                  en: Empire Key
                type: virtual_good
                description:
                  en: Opens ONE Empire lootbox of any kind
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c2f8536f08a9949964e4fa2e01a7cb8.png
                quantity: 5
              - sku: com.xsolla.booster_mega_2
                name:
                  en: Empire Booster Mega
                type: virtual_good
                description:
                  en: >-
                    Take it, take it all! All of the Empires riches in one Mega
                    Booster.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/55e908cb9670301ac8f89a6382433a27.png
                quantity: 1
              - sku: com.xsolla.booster_min_2
                name:
                  en: Empire Booster Mini
                type: virtual_good
                description:
                  en: Test your luck to find glorious treasures from Empire's past
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5bcecec17400a0d8c72dd265ff730b07.png
                quantity: 3
            limits:
              per_user:
                total: 10
                limit_exceeded_visibility: show
              per_item: null
              recurrent_schedule: null
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            custom_attributes:
              type: lootbox
              purchased: 0
    Bundles_204-admin-update-bundle:
      description: El lote se actualizó correctamente.
      content: {}
    Bundles_204-admin-delete-bundle:
      description: El lote se eliminó correctamente.
      content: {}
    Bundles_204-admin-show-bundle:
      description: El lote se visualizó correctamente.
      content: {}
    Bundles_204-admin-hide-bundle:
      description: El lote se ocultó correctamente.
      content: {}
    Bundles_200-get-bundle-list:
      description: La lista de lotes se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con artículos.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                type: array
                items:
                  $ref: '#/components/schemas/Bundles_client_bundle'
          examples:
            response:
              $ref: '#/components/examples/Bundles_200-get-bundle-list'
    Cart-Payment_200-get-cart-json-model:
      description: La cesta con artículos se devolvió correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              cart_id:
                type: string
                example: cart_id
                description: ID de la cesta.
              price:
                type:
                  - object
                  - 'null'
                properties:
                  amount:
                    type: string
                    default: '50.0000000000000000'
                  amount_without_discount:
                    type: string
                    default: '100.0000000000000000'
                  currency:
                    type: string
                    default: USD
                example:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                description: Precio de la cesta.
              is_free:
                $ref: '#/components/schemas/value-cart_is_free'
              items:
                type: array
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                    groups:
                      type: array
                      items:
                        type: object
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                    name:
                      type:
                        - string
                        - 'null'
                    attributes:
                      $ref: '#/components/schemas/Cart-Payment_client-attributes'
                    type:
                      type: string
                    description:
                      type: string
                    image_url:
                      type: string
                    quantity:
                      type: integer
                    price:
                      type:
                        - object
                        - 'null'
                      properties:
                        amount:
                          type: string
                        amount_without_discount:
                          type: string
                        currency:
                          type: string
                      example:
                        amount: '6150.0000000000000000'
                        amount_without_discount: '6150.0000000000000000'
                        currency: USD
                      description: Precio del artículo.
                    virtual_item_type:
                      type: string
                      description: Tipo de artículo.
                    virtual_prices:
                      $ref: '#/components/schemas/client_virtual_prices_response'
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    is_bonus:
                      type: boolean
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    periods:
                      $ref: '#/components/schemas/item-periods'
              promotions:
                $ref: '#/components/schemas/Catalog_cart_promotions'
          examples:
            response:
              value:
                cart_id: cart_id
                is_free: false
                items:
                  - attributes: []
                    description: >-
                      Take it, take it all! All of Xsollas riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    is_bonus: false
                    name: Xsolla Booster Mega
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    quantity: 123
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                    promotions: []
                    can_be_bought: true
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                price:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                promotions:
                  - name: Bonus promotion
                    date_start: '2020-04-15T16:16:00+03:00'
                    date_end: '2026-04-15T16:16:00+03:00'
                    discount:
                      percent: '50.00'
                    bonus:
                      - quantity: 1
                        name: Xsolla Minigun
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                        sku: com.xsolla.minigun_1
                        type: virtual_good
    Cart-Payment_200-fill-cart-json-model:
      description: La cesta con artículos se devolvió correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              cart_id:
                type: string
                example: cart_id
                description: ID de la cesta.
              price:
                type:
                  - object
                  - 'null'
                properties:
                  amount:
                    type: string
                    default: '50.0000000000000000'
                  amount_without_discount:
                    type: string
                    default: '100.0000000000000000'
                  currency:
                    type: string
                    default: USD
                example:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                description: Precio de la cesta.
              is_free:
                $ref: '#/components/schemas/value-cart_is_free'
              items:
                type: array
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                    groups:
                      type: array
                      items:
                        type: object
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                    name:
                      type:
                        - string
                        - 'null'
                    attributes:
                      $ref: '#/components/schemas/Cart-Payment_client-attributes'
                    type:
                      type: string
                    description:
                      type: string
                    image_url:
                      type: string
                    quantity:
                      type: integer
                    price:
                      type:
                        - object
                        - 'null'
                      properties:
                        amount:
                          type: string
                        amount_without_discount:
                          type: string
                        currency:
                          type: string
                      example:
                        amount: '6150.0000000000000000'
                        amount_without_discount: '6150.0000000000000000'
                        currency: USD
                      description: Precio del artículo.
                    virtual_item_type:
                      type: string
                      description: Tipo de artículo.
                    virtual_prices:
                      $ref: '#/components/schemas/client_virtual_prices_response'
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    is_bonus:
                      type: boolean
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    periods:
                      $ref: '#/components/schemas/item-periods'
              promotions:
                $ref: '#/components/schemas/Catalog_cart_promotions'
              warnings:
                type: array
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                    quantity:
                      type: integer
                    errorCode:
                      type: integer
                    errorMessage:
                      type: string
          examples:
            response:
              value:
                cart_id: cart_id
                is_free: false
                items:
                  - attributes: []
                    description: >-
                      Take it, take it all! All of Xsollas riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    is_bonus: false
                    name: Xsolla Booster Mega
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    quantity: 123
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    can_be_bought: true
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                warnings:
                  - sku: com.xsolla.booster_mega_21
                    quantity: 1
                    errorCode: 4001
                    errorMessage: >-
                      [0401-4001]: Item with Project Id = 44056 and Sku =
                      booster_mega_2 not found
                price:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                promotions:
                  - name: Bonus promotion
                    date_start: '2020-04-15T16:16:00+03:00'
                    date_end: '2026-04-15T16:16:00+03:00'
                    discount:
                      percent: '50.00'
                    bonus:
                      - quantity: 1
                        name: Xsolla Minigun
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                        sku: com.xsolla.minigun_1
                        type: virtual_good
    Cart-Payment_404-item:
      description: >-
        No se encontró el artículo. Asegúrese de que el `project_id` y el
        `item_sku` son correctos.
      content:
        application/json:
          schema:
            properties:
              statusCode:
                type: integer
                example: 404
              errorCode:
                type: integer
                example: 4001
              errorMessage:
                type: string
                example: >-
                  [0401-4001]: Item with Project Id = 44056 and Sku =
                  booster_mega_12222 not found
            type: object
    Cart-Payment_422-non-negative-quantity:
      description: La cantidad del artículo debe ser un número entero no negativo.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 422
              errorMessage:
                type: string
                example: >-
                  La cantidad del artículo debe ser un número entero no
                  negativo.
              errorCode:
                type: integer
                example: 1102
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: '[0401-1102]: Item quantity must be non-negative integer'
                statusCode: 422
    Cart-Payment_422-can-put-only-virtual-good-to-cart:
      description: >-
        Este tipo de artículo no se puede colocar en la cesta. Seleccione otro
        tipo de artículo.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 422
              errorCode:
                type: integer
                example: 1421
              errorMessage:
                type: string
                example: >-
                  Este tipo de artículo no se puede colocar en la cesta.
                  Seleccione otro tipo de artículo.
          examples:
            response:
              value:
                statusCode: 422
                errorCode: 1421
                errorMessage: Only Virtual Good Supported
    Cart-Payment_200-order-created:
      description: El pedido se creó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              order_id:
                type: integer
                description: ID del pedido.
              token:
                type: string
                description: Token de pago.
          examples:
            response:
              value:
                order_id: 641
                token: f4puMEFFDZcx9nv5HoNHIkPe9qghvBQo
    Cart-Payment_422-invalid-cart:
      description: >-
        Cesta no válida. Compruebe que la cesta existe, no está vacía y que
        todos los artículos que contiene no son gratuitos.
      content:
        application/json:
          schema:
            type: object
            properties:
              errorCode:
                type: integer
                example: 1401
              statusCode:
                type: integer
                example: 422
              errorMessage:
                type: string
                example: '[0401-1401]: Invalid cart'
          examples:
            response:
              value:
                errorCode: 1401
                statusCode: 422
                errorMessage: '[0401-1401]: Invalid cart'
    Cart-Payment_404-create-order-with-item-not-found-errors:
      description: >-
        Artículo o cupón no encontrado. Asegúrese de que los datos utilizados
        son correctos.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
              errorCode:
                type: integer
              errorMessage:
                type: string
              transactionId:
                type: string
          examples:
            item not found:
              $ref: '#/components/examples/404-item-by-sku-not-found'
            coupon not found:
              $ref: '#/components/examples/404-coupon-not-found'
    Cart-Payment_422-create-order-with-item-invalid:
      description: Error no válido.
      content:
        application/json:
          schema:
            type: object
            properties:
              errorCode:
                type: integer
                example: 1411
              statusCode:
                type: integer
                example: 422
              errorMessage:
                type: string
                example: '[0401-1411]: Invalid item'
          examples:
            invalid item:
              value:
                errorCode: 1411
                statusCode: 422
                errorMessage: '[0401-1411]: Invalid item'
            code expired:
              value:
                errorCode: 9810
                statusCode: 422
                errorMessage: '[0401-9810]: Sorry, this code is expired.'
            code redemption limit:
              value:
                errorCode: 9804
                statusCode: 422
                errorMessage: '[0401-9804]: You have reached the coupon redemption limit.'
            regionally restricted:
              value:
                errorCode: 9808
                statusCode: 422
                errorMessage: '[0401-9808]: Coupon is not available in your region.'
    Cart-Free_200-order-created:
      description: El pedido gratuito se creó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              order_id:
                type: integer
                description: ID del pedido.
          examples:
            response:
              value:
                order_id: 641
    Cart-Payment_422-invalid-item:
      description: >-
        Artículo no válido. Compruebe que el artículo existe, no esté
        desactivado, eliminado ni sea gratuito.
      content:
        application/json:
          schema:
            type: object
            properties:
              errorCode:
                type: integer
                example: 1411
              statusCode:
                type: integer
                example: 422
              errorMessage:
                type: string
                example: '[0401-1411]: Invalid item'
          examples:
            response:
              value:
                errorCode: 1411
                statusCode: 422
                errorMessage: '[0401-1411]: Invalid item'
    Cart-Payment_200-get-order:
      description: Solicitud de pedido aceptada.
      content:
        application/json:
          schema:
            type: object
            properties:
              order_id:
                type: integer
                example: 1
                default: ID del pedido.
                description: ID del pedido.
              status:
                type: string
                example: paid
                enum:
                  - new
                  - paid
                  - done
                  - canceled
                  - expired
                description: >-
                  Estado del pedido. Consulte la sección [Ciclo de vida del
                  pedido](https://developers.xsolla.com/es/api/catalog/order-life-cycle)
                  para obtener una descripción detallada del estado.
              content:
                type: object
                description: Detalles del pedido.
                properties:
                  price:
                    type: object
                    description: Precio del pedido.
                    properties:
                      amount:
                        type: string
                        example: '30'
                        description: Precio con descuento del pedido.
                      amount_without_discount:
                        type: string
                        example: '30'
                        description: Precio del pedido.
                      currency:
                        type: string
                        example: USD
                        description: >-
                          Moneda del precio del pedido. Código de tres letras
                          según [ISO
                          4217](https://en.wikipedia.org/wiki/ISO_4217).
                  virtual_price:
                    type: object
                    description: Precio del pedido en moneda virtual.
                    properties:
                      amount:
                        type: string
                        example: '100'
                        description: Precio con descuento del pedido.
                      amount_without_discount:
                        type: string
                        example: '150'
                        description: Precio del pedido.
                      currency:
                        type: string
                        example: test_vc
                        description: SKU de la moneda virtual usado en el pedido.
                  is_free:
                    type: boolean
                    example: false
                    description: Si es `true`, el pedido es gratuito.
                  items:
                    type: array
                    example:
                      - sku: com.xsolla.item_1
                        quantity: 1
                        is_free: false
                        price:
                          amount: '30'
                          amount_without_discount: '30'
                          currency: USD
                    description: Lista de artículos.
                    items:
                      type: object
                      properties:
                        sku:
                          type: string
                          example: some_sku
                          description: >-
                            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.
                        quantity:
                          type: integer
                          example: 1
                          description: Cantidad del artículo.
                        is_free:
                          $ref: '#/components/schemas/value-is_free'
                        price:
                          type: object
                          description: Precio del artículo.
                          properties:
                            amount:
                              type: string
                              example: '30'
                              description: Precio del artículo con descuento.
                            amount_without_discount:
                              type: string
                              example: '30'
                              description: Precio del artículo.
                            currency:
                              type: string
                              example: USD
                              description: >-
                                Divisa del precio del artículo. Código de tres
                                letras según [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217).
          examples:
            response:
              value:
                order_id: 1
                status: paid
                content:
                  price:
                    amount: '30'
                    amount_without_discount: '30'
                    currency: USD
                  is_free: false
                  items:
                    - sku: com.xsolla.item_1
                      quantity: 1
                      is_free: false
                      price:
                        amount: '30'
                        amount_without_discount: '30'
                        currency: USD
    Cart-Payment_404-get-order:
      description: >-
        Pedido no encontrado. Asegúrese de que el `project_id` y el `order_id`
        son correctos.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 404
              errorCode:
                type: integer
                example: 9001
              errorMessage:
                type: string
                example: '[0401-9001]: Order not found'
          examples:
            response:
              value:
                statusCode: 404
                errorCode: 9001
                errorMessage: '[0401-9001]: Order not found'
    200-admin-order-search:
      description: La lista de pedidos se recuperó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              orders:
                type: array
                description: Lista de pedidos.
                items:
                  type: object
                  properties:
                    order_id:
                      type: integer
                      example: 1
                      description: ID del pedido.
                    project_id:
                      type: integer
                      example: 44056
                      description: >-
                        ID del proyecto. Encontrará este parámetro en su [Cuenta
                        del editor](https://publisher.xsolla.com/) junto al
                        nombre del proyecto.
                    status:
                      type: string
                      enum:
                        - new
                        - paid
                        - done
                        - canceled
                        - expired
                      example: paid
                      description: >-
                        Estado del pedido. Consulte la sección [Ciclo de vida
                        del
                        pedido](https://developers.xsolla.com/es/api/catalog/order-life-cycle)
                        para obtener una descripción detallada del estado.
                    date_created:
                      type: string
                      format: date-time
                      example: '2020-08-11T10:00:00+03:00'
                      description: >-
                        Fecha de creación del pedido o código fecha-hora de
                        conformidad con la norma [ISO
                        8601](https://en.wikipedia.org/wiki/ISO_8601).
                    mode:
                      type: string
                      enum:
                        - default
                        - sandbox
                      example: default
                      description: Modo de creación de pedidos.
                    is_free:
                      type: boolean
                      example: false
                      description: Si el pedido es gratuito.
                    invoice_id:
                      type: string
                      description: ID de factura.
                    price:
                      type:
                        - object
                        - 'null'
                      description: Precio del pedido.
                      properties:
                        amount:
                          type: string
                          example: '30'
                          description: Precio final del pedido.
                        amount_without_discount:
                          type: string
                          example: '30'
                          description: Precio de pedido sin descuentos.
                        currency:
                          type: string
                          example: USD
                          description: >-
                            SKU de moneda virtual o código de tres letras de
                            moneda real conforme a la norma [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217)
                            Consulte la documentación para obtener información
                            detallada sobre [monedas admitidas por
                            Xsolla](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/)
                            .
                        is_virtual_currency:
                          type: boolean
                          example: false
                          description: Si la moneda es virtual.
                    user:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 07e653a2b15011e6818f005056a54369
                          description: ID de usuario transmitido al crear el pedido.
                        country:
                          type: string
                          description: >-
                            Código de país de dos letras mayúsculas de
                            conformidad con la norma [ISO 3166-1
                            alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
                            Consulte la documentación para obtener información
                            detallada sobre los [países que admite
                            Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/).
                          example: US
                        email:
                          type: string
                          format: email
                          example: user@xsolla.com
                          description: >-
                            Correo electrónico del usuario formateado conforme
                            al protocolo [RFC
                            822](https://www.w3.org/Protocols/rfc822/#z8).
                        region_id:
                          type:
                            - integer
                            - 'null'
                          example: 12
                          description: >-
                            ID de región del usuario. Se devuelve si se han
                            establecido restricciones regionales de venta. El
                            país del usuario, transmitido al crear el pedido, se
                            coteja con la lista de países especificada al [crear
                            la
                            región](https://developers.xsolla.com/es/api/shop-builder/operation/admin-create-region/).
                            Consulte la
                            [documentación](https://developers.xsolla.com/es/doc/shop-builder/features/regional-restrictions/)
                            para obtener más información sobre las restricciones
                            de ventas regionales.
                    items:
                      type: array
                      description: Lista de artículos.
                      items:
                        type: object
                        properties:
                          order_item_id:
                            type: integer
                            description: >-
                              ID del artículo en el pedido. Lo genera Xsolla
                              durante la creación del pedido.
                          item_id:
                            type: integer
                            example: 1
                            description: >-
                              ID del artículo. Lo genera Xsolla al crear un
                              artículo.
                          sku:
                            type: string
                            example: elven_shield
                            description: >-
                              ID del artículo especificado durante su creación.
                              El SKU solo puede contener caracteres
                              alfanuméricos latinos en minúsculas y mayúsculas,
                              puntos, guiones y guiones bajos.
                          type:
                            type: string
                            example: virtual_good
                            description: Tipo de artículo.
                            enum:
                              - virtual_good
                              - virtual_currency
                              - bundle
                              - game_key
                              - physical_good
                              - value_point
                          quantity:
                            type: integer
                            example: 1
                            description: Cantidad del artículo.
                          is_free:
                            type: boolean
                            example: false
                            default: false
                            description: Si el artículo es gratuito.
                          is_bonus:
                            type: boolean
                            example: false
                            description: Si el artículo es una bonificación.
                          region_id:
                            type:
                              - integer
                              - 'null'
                            description: >-
                              ID de la región en la que está disponible el
                              artículo. Consulte la
                              [documentación](https://developers.xsolla.com/es/doc/shop-builder/features/regional-restrictions/)
                              para obtener más información sobre las
                              restricciones de venta regionales.
                          tax_category:
                            type: string
                            example: DG00002
                            description: Categoría fiscal.
                          price:
                            type:
                              - object
                              - 'null'
                            description: Precio del artículo.
                            properties:
                              amount:
                                type: string
                                example: '30'
                                description: Precio del artículo con descuento.
                              amount_without_discount:
                                type: string
                                example: '30'
                                description: Precio del artículo sin descuentos.
                              currency:
                                type: string
                                example: USD
                                description: >-
                                  SKU de moneda virtual o código de tres letras
                                  conforme a la norma [ISO
                                  4217](https://en.wikipedia.org/wiki/ISO_4217)
                                  Consulte la documentación para obtener
                                  información detallada sobre las [monedas
                                  admitidas por
                                  Xsolla](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/).
                              is_virtual_currency:
                                type: boolean
                                example: false
                                description: Si la moneda es virtual.
                          description:
                            type:
                              - object
                              - 'null'
                            description: Object with information about the item.
                            properties:
                              name:
                                type: string
                                description: Nombre del artículo.
                              image_url:
                                type: string
                                format: uri
                                description: Item image URL.
                              description:
                                type: string
                                description: Descripción del artículo.
                    promotions:
                      type:
                        - array
                        - 'null'
                      description: Lista de promociones aplicada al pedido.
                      items:
                        type: object
                        properties:
                          promotion_id:
                            type: integer
                            example: 111425
                            description: ID de promoción dentro del proyecto.
                    coupons:
                      type:
                        - array
                        - 'null'
                      description: Lista de cupones aplicada al pedido.
                      items:
                        type: object
                        properties:
                          coupon_id:
                            type: integer
                            description: >-
                              ID del cupón, generado por Xsolla al crear una
                              promoción con un cupón.
                          sku:
                            type: string
                            description: >-
                              SKU del cupón, generado por Xsolla al crear una
                              promoción con un cupón.
                          code:
                            type: string
                            description: >-
                              Código de cupón utilizado. Código único que
                              distingue entre mayúsculas y minúsculas. Contiene
                              letras y números.
                          type:
                            type: string
                            enum:
                              - unique_catalog_offer
                              - coupon
                              - promocode
                            description: Tipo de cupón.
              total_items_count:
                type: integer
                example: 1
                description: >-
                  El número total de pedidos durante el periodo de tiempo
                  especificado.
              has_more:
                type: boolean
                example: true
                description: Si hay páginas adicionales.
          examples:
            response:
              value:
                orders:
                  - order_id: 100511
                    project_id: 101
                    status: done
                    date_created: '2018-01-08T15:32:06+03:00'
                    mode: default
                    user:
                      id: 07e653a2b15011e6818f005056a54369
                      country: US
                      email: user@xsolla.com
                      region_id: 1
                    is_free: true
                    items:
                      - order_item_id: 29
                        item_id: 1005111
                        sku: com.xsolla.1005111
                        type: virtual_good
                        quantity: 1
                        is_free: true
                        is_bonus: false
                        region_id: 1
                        tax_category: DG00001
                        description:
                          name: bla
                          image_url: http://example.com/image.jpg
                          description: 'yes'
                      - order_item_id: 30
                        item_id: 1005112
                        sku: com.xsolla.1005112
                        type: value_point
                        quantity: 3
                        is_free: true
                        is_bonus: true
                        region_id: 1
                        tax_category: DG00001
                        description: null
                  - order_id: 100510
                    project_id: 101
                    status: paid
                    date_created: '2018-01-07T15:32:06+03:00'
                    mode: default
                    user:
                      id: 07e653a2b15011e6818f005056a54369
                      country: US
                      email: user@xsolla.com
                      region_id: null
                    is_free: false
                    items:
                      - order_item_id: 27
                        item_id: 1005101
                        sku: com.xsolla.1005101
                        type: game_key
                        quantity: 1
                        is_free: false
                        is_bonus: false
                        region_id: null
                        tax_category: DG00001
                        description: null
                        price:
                          amount: '67.3400'
                          amount_without_discount: '67.3400'
                          currency: USD
                          is_virtual_currency: false
                      - order_item_id: 28
                        item_id: 1005102
                        sku: com.xsolla.1005102
                        type: value_point
                        quantity: 2
                        is_free: true
                        is_bonus: true
                        region_id: null
                        tax_category: DG00001
                        description: null
                    price:
                      amount: '67.3400'
                      amount_without_discount: '72.3400'
                      currency: USD
                      is_virtual_currency: false
                    invoice_id: '100510'
                    promotions:
                      - promotion_id: 1005101
                    coupons:
                      - coupon_id: 100510
                        sku: com.xsolla.100510
                        code: OPQRSTUVWX
                        type: promocode
                  - order_id: 100505
                    project_id: 101
                    status: paid
                    date_created: '2018-01-02T15:32:06+03:00'
                    mode: default
                    user:
                      id: 07e653a2b15011e6818f005056a54369
                      country: US
                      email: user@xsolla.com
                      region_id: null
                    is_free: false
                    items:
                      - order_item_id: 17
                        item_id: 1005051
                        sku: com.xsolla.1005051
                        type: virtual_good
                        quantity: 1
                        is_free: true
                        is_bonus: true
                        region_id: null
                        tax_category: DG00001
                        description: null
                      - order_item_id: 18
                        item_id: 1005052
                        sku: com.xsolla.1005052
                        type: value_point
                        quantity: 3
                        is_free: true
                        is_bonus: true
                        region_id: null
                        tax_category: DG00001
                        description: null
                    price:
                      amount: '78.2300'
                      amount_without_discount: '78.2300'
                      currency: popugi
                      is_virtual_currency: true
                total_items_count: 11
                has_more: true
    401-invalid-basic-auth:
      description: >-
        Autenticación básica no superada o errónea. Asegúrese de haber utilizado
        la autenticación básica o las credenciales correctas.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 401
              errorCode:
                type: integer
                example: 1020
              errorMessage:
                type: string
                example: '[0401-1020]: Error in Authentication method occurred'
          examples:
            response:
              value:
                statusCode: 401
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
    Cart-Payment_201-admin-create-payment-token:
      description: Token de pago y pedido creados correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              token:
                type: string
                description: Token de pago.
              order_id:
                type: integer
                example: 1
                description: ID del pedido.
          examples:
            response:
              value:
                token: huooAqbXBSJxB8Q4dYBqJp4ybiInqsPb
                order_id: 12345
    Cart-Payment_401-invalid-basic-auth:
      description: >-
        Autenticación básica no superada o errónea. Asegúrese de haber utilizado
        la autenticación básica o las credenciales correctas.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 401
              errorCode:
                type: integer
                example: 1020
              errorMessage:
                type: string
                example: '[0401-1020]: Error in Authentication method occurred'
          examples:
            response:
              value:
                statusCode: 401
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
    Cart-Payment_422-admin-create-payment-token:
      description: >-
        Error de validación del cuerpo de la solicitud y de creación de la
        cesta.

        - Cesta no válida, creada a partir de artículos transferidos. Comprueba
        que la cesta no esté vacía y que todos los artículos no sean gratuitos.

        - Cuerpo de la solicitud no válido.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/422-invalid-request'
          examples:
            Invalid request body:
              value:
                errorCode: 1102
                statusCode: 422
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `name` is
                  required
                transactionId: da145238620011eb8e24fe6913ff226a
            Item is free:
              value:
                errorCode: 1421
                statusCode: 422
                errorMessage: '[0401-1421]: Item is free'
                transactionId: da145238620011eb8e24fe6913ff226a
            Invalid cart:
              value:
                errorCode: 1401
                statusCode: 422
                errorMessage: '[0401-1401]: Invalid cart'
                transactionId: da145238620011eb8e24fe6913ff226a
            Empty cart:
              value:
                errorCode: 1417
                statusCode: 422
                errorMessage: '[0401-1417]: Empty cart! Cart shouldn''t be empty!'
                transactionId: da145238620011eb8e24fe6913ff226a
            User country not provided:
              value:
                errorCode: 1102
                statusCode: 422
                errorMessage: >-
                  [0401-1102]: The parameter user.country.value or the header
                  X-User-Ip must be specified
                transactionId: da145238620011eb8e24fe6913ff226a
    Cart-Payment_200-admin-fill-cart-json-model:
      description: La cesta con artículos se devolvió correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              cart_id:
                type: string
                example: cart_id
                description: >-
                  ID de cesta. Transmítalo a la consulta de la página de compra
                  o a los puntos finales de la API de pago.
              price:
                type:
                  - object
                  - 'null'
                properties:
                  amount:
                    type: string
                  amount_without_discount:
                    type: string
                  currency:
                    type: string
                description: Precio de la cesta.
              is_free:
                $ref: '#/components/schemas/value-cart_is_free'
              items:
                type: array
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                    groups:
                      type: array
                      items:
                        type: object
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                    name:
                      type:
                        - string
                        - 'null'
                    attributes:
                      $ref: '#/components/schemas/Cart-Payment_client-attributes'
                    type:
                      type: string
                    description:
                      type: string
                    image_url:
                      type: string
                    quantity:
                      type: integer
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    is_bonus:
                      type: boolean
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    periods:
                      $ref: '#/components/schemas/item-periods'
                    price:
                      type:
                        - object
                        - 'null'
                      properties:
                        amount:
                          type: string
                        amount_without_discount:
                          type: string
                        currency:
                          type: string
                      description: Precio del artículo.
                    virtual_prices:
                      $ref: '#/components/schemas/client_virtual_prices_response'
              promotions:
                $ref: '#/components/schemas/Catalog_cart_promotions'
              warnings:
                type: array
                items:
                  type: object
                  properties:
                    sku:
                      type: string
                    quantity:
                      type: integer
                    errorCode:
                      type: integer
                    errorMessage:
                      type: string
          examples:
            response:
              value:
                cart_id: cart_id
                is_free: false
                items:
                  - attributes: []
                    description: The cup of tea
                    groups:
                      - external_id: cups
                        name: Cups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    is_bonus: false
                    name: Cup
                    price:
                      amount: '5.99'
                      amount_without_discount: '5.99'
                      currency: USD
                    quantity: 2
                    sku: com.xsolla.cup01
                    type: physical_good
                    virtual_prices: []
                    promotions: []
                    can_be_bought: true
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                  - attributes: []
                    description: Wonderful white T-shirt
                    groups: []
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    is_bonus: false
                    name: White T-shirt
                    price:
                      amount: '3.99'
                      amount_without_discount: '4.99'
                      currency: USD
                    quantity: 1
                    sku: com.xsolla.t-shirt01
                    type: physical_good
                    virtual_prices: []
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    can_be_bought: true
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                  - attributes: []
                    description: Wonderful white T-shirt
                    groups:
                      - external_id: clothes
                        name: Clothes
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: true
                    is_bonus: false
                    name: Cat's cup
                    price: null
                    quantity: 1
                    sku: com.xsolla.cup01
                    type: physical_good
                    virtual_prices: []
                    promotions: []
                    can_be_bought: true
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                warnings:
                  - sku: com.xsolla.hat01
                    quantity: 1
                    errorCode: 4001
                    errorMessage: >-
                      [0401-4001]: Item with Project Id = 44056 and Sku = hut01
                      not found
                price:
                  amount: '15.97'
                  amount_without_discount: '22.96'
                  currency: USD
                promotions:
                  - name: Bonus promotion
                    date_start: '2020-04-15T16:16:00+03:00'
                    date_end: '2026-04-15T16:16:00+03:00'
                    discount:
                      percent: '50.00'
                    bonus:
                      - quantity: 1
                        name: Xsolla Minigun
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                        sku: com.xsolla.minigun_1
                        type: virtual_good
    Cart-Payment_404-user:
      description: >-
        No se encontró el usuario. Asegúrese de que el token `x-user-for` o
        `x-user-id` es correcto.
      content:
        application/json:
          schema:
            properties:
              statusCode:
                type: integer
                example: 404
              errorCode:
                type: integer
                example: 5008
              errorMessage:
                type: string
                example: '[0401-5008]: Could not find User'
            type: object
    Common_401-invalid-basic-auth:
      description: >-
        Autenticación básica no superada o errónea. Asegúrese de haber utilizado
        la autenticación básica o las credenciales correctas.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 401
              errorCode:
                type: integer
                example: 1020
              errorMessage:
                type: string
                example: '[0401-1020]: Error in Authentication method occurred'
          examples:
            response:
              value:
                statusCode: 401
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
    200-admin-get-user-item-limits:
      description: Se recibieron correctamente los límites de compra para un usuario.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/User-limit-item'
          examples:
            response:
              value:
                per_user:
                  total: 10
                  available: 9
    connector-422-validation-failed:
      description: >-
        Error de validación causado por parámetros incorrectos del cuerpo de la
        solicitud, las propiedades del archivo o el contenido del archivo.
      content:
        application/json:
          schema:
            type: object
            properties:
              errorCode:
                type: integer
                example: 1803
              statusCode:
                type: integer
                example: 422
              errorMessage:
                type: string
                example: >-
                  [0410-1803]: File content-type doesn't allowed. Allowed
                  content types: application/json; current content type:
                  text/plain
              transactionId:
                type: string
                example: x-x-x-x-transactionId-mock-x-x-x
          examples:
            response:
              value:
                statusCode: 422
                errorCode: 1803
                errorMessage: >-
                  [0410-1803]: File content-type doesn't allowed. Allowed
                  content types: application/json; current content type:
                  text/plain
                transactionId: x-x-x-x-transactionId-mock-x-x-x
    200-items-import-status-model:
      description: El estado de la importación se ha recuperado correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: error
                description: >-
                  Estado de la importación.


                  Valores posibles:

                  - `initialized` — Se ha iniciado la importación.

                  - `process` — La importación está en curso.

                  - `done` — La importación se realizó correctamente.

                  - `error` — Debido a errores, la importación no se completó o
                  solo se completó parcialmente.
                enum:
                  - initialized
                  - process
                  - done
                  - error
              date_created:
                type: string
                example: '2024-12-15T18:16:00+03:00'
                description: >-
                  La fecha y hora de la operación de creación de la importación
                  expresada en la zona horaria GMT+3.
              date_updated:
                type: string
                example: '2024-12-15T18:16:00+03:00'
                description: >-
                  La fecha y hora en que se interrumpió la importación debido a
                  un error, en la zona horaria GMT+3.
              date_completed:
                type: string
                example: '2024-12-15T18:16:00+03:00'
                description: >-
                  La fecha y hora de finalización de la operación de importación
                  está en la zona horaria GMT+3. Si la importación se
                  interrumpió debido a un error y no se importó ningún artículo,
                  se devolverá una cadena (string) vacía.
              progress:
                type: integer
                example: 100
                description: El progreso de la ejecución de la importación en porcentaje.
              error:
                type: string
                description: Descripción del error general de importación.
              error_code:
                type: string
                description: El código del error general de importación.
              result:
                type: object
                description: >-
                  Un objeto con datos sobre los resultados de la importación y
                  los errores de importación para SKU de artículos específicos.
                properties:
                  errors_count:
                    type: integer
                    example: 3
                    description: >-
                      El número de artículos para los que hubo errores durante
                      la importación.
                  total_entities_count:
                    type: integer
                    example: 11
                    description: El número total de artículos importados.
                  errors_by_sku:
                    type: array
                    description: >-
                      Una matriz de objetos con datos sobre errores de
                      importación para SKU de artículos específicos.
                    items:
                      type: object
                      properties:
                        sku:
                          type: string
                          example: sku_1
                          description: SKU del artículo importado.
                        type:
                          type: string
                          example: vi
                          description: Tipo de artículo.
                          enum:
                            - virtual_good
                            - virtual_currency
                            - virtual_currency_packages
                            - bundle
                        error_code:
                          type: integer
                          example: 1001
                          description: >-
                            El código de error de importación para un SKU de
                            artículo específico.
                        error_message:
                          type: string
                          example: Something went wrong
                          description: >-
                            La descripción del error de importación para un SKU
                            de artículo específico.
            example:
              status: error
              date_created: '2024-11-19T14:27:31+03:00'
              date_updated: '2024-11-19T15:27:31+03:00'
              date_completed: '2024-11-19T15:27:31+03:00'
              progress: 100
              error: null
              error_code: null
              result:
                errors_count: 2
                total_entities_count: 10
                errors_by_sku:
                  - sku: com.xsolla.sword_1
                    type: virtual_items
                    error_code: 4055
                    error_message: '[0401-4055]: Item default price not set'
                  - sku: ''
                    type: null
                    error_code: 1817
                    error_message: '[0410-1817]: SKU can''t be empty'
    sellable_items_200-get-items-list:
      description: La lista de artículos vendibles se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con artículos vendibles.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                type: array
                example:
                  - item_id: 259765
                    sku: com.xsolla.gold_1
                    type: virtual_currency
                    name: Gold
                    description: ''
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                    price:
                      amount: '1.00'
                      amount_without_discount: '1.00'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups: []
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                  - item_id: 259766
                    sku: com.xsolla.silver_1
                    type: virtual_currency
                    name: Silver
                    description: ''
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                    price:
                      amount: '0.50'
                      amount_without_discount: '0.50'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups: []
                    limits: null
                    vp_rewards: []
                  - item_id: 259767
                    sku: com.xsolla.bronze_1
                    type: virtual_currency
                    name: Bronze
                    description: ''
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                    price:
                      amount: '0.10'
                      amount_without_discount: '0.10'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups: []
                    limits: null
                    vp_rewards: []
                  - item_id: 259768
                    sku: com.xsolla.gold_chest_1
                    type: bundle
                    name: Chest of gold
                    bundle_type: virtual_currency_package
                    description: Chest of gold
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/61b8d0785093017ce1f50ebed55c42a9.png
                    price:
                      amount: '7.99'
                      amount_without_discount: '7.99'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups: []
                    content:
                      - item_id: 259765
                        sku: com.xsolla.gold_1
                        type: virtual_currency
                        name: Gold
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        quantity: 10
                    limits: null
                    vp_rewards: []
                  - item_id: 259769
                    sku: com.xsolla.silver_chest_1
                    type: bundle
                    name: Chest of silver
                    bundle_type: virtual_currency_package
                    description: Chest of silver
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/f0b59a3370404e8881107249051b70bd.png
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups: []
                    content:
                      - item_id: 259766
                        sku: com.xsolla.silver_1
                        type: virtual_currency
                        name: Silver
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        quantity: 50
                    limits: null
                    vp_rewards: []
                  - item_id: 259770
                    sku: com.xsolla.bronze_chest_1
                    type: bundle
                    name: Chest of bronze
                    bundle_type: virtual_currency_package
                    description: Chest of bronze
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b32eb5b1f4f0c202ea6ac4e21c2eae18.png
                    price:
                      amount: '5.99'
                      amount_without_discount: '5.99'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups: []
                    content:
                      - item_id: 259767
                        sku: com.xsolla.bronze_2
                        type: virtual_currency
                        name: Bronze
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        quantity: 100
                    limits: null
                    vp_rewards: []
                  - item_id: 259771
                    sku: com.xsolla.sword_1
                    type: virtual_good
                    name: Sword
                    description: Sword
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/a558727a420cad609556e4449b9ecb12.png
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_2
                        name: Gold
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_2
                        name: Silver
                        type: virtual_currency
                        amount: 5
                        amount_without_discount: 5
                        calculated_price:
                          amount: '5.00'
                          amount_without_discount: '5.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_2
                        name: Bronze
                        type: virtual_currency
                        amount: 50
                        amount_without_discount: 50
                        calculated_price:
                          amount: '50.00'
                          amount_without_discount: '50.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: swords
                        name: Swords
                    virtual_item_type: non_consumable
                    limits: null
                    vp_rewards: []
                  - item_id: 259772
                    sku: com.xsolla.saber_1
                    type: virtual_good
                    name: Saber
                    description: Saber
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/edd914d60301d77b94926478d253fcb6.png
                    price:
                      amount: '3.99'
                      amount_without_discount: '3.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_3
                        name: Gold
                        type: virtual_currency
                        amount: 3
                        amount_without_discount: 3
                        calculated_price:
                          amount: '3.00'
                          amount_without_discount: '3.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_3
                        name: Silver
                        type: virtual_currency
                        amount: 7
                        amount_without_discount: 7
                        calculated_price:
                          amount: '7.00'
                          amount_without_discount: '7.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_3
                        name: Bronze
                        type: virtual_currency
                        amount: 70
                        amount_without_discount: 70
                        calculated_price:
                          amount: '70.00'
                          amount_without_discount: '70.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: swords
                        name: Swords
                    virtual_item_type: non_consumable
                    limits: null
                    vp_rewards: []
                  - item_id: 259773
                    sku: com.xsolla.bow_1
                    type: virtual_good
                    name: Bow
                    description: Bow
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/3bb3b0a5254ad15134c891108898363f.png
                    price:
                      amount: '4.99'
                      amount_without_discount: '4.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_4
                        name: Gold
                        type: virtual_currency
                        amount: 5
                        amount_without_discount: 5
                        calculated_price:
                          amount: '5.00'
                          amount_without_discount: '5.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_4
                        name: Silver
                        type: virtual_currency
                        amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_4
                        name: Bronze
                        type: virtual_currency
                        amount: 100
                        amount_without_discount: 100
                        calculated_price:
                          amount: '100.00'
                          amount_without_discount: '100.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: bows
                        name: Bows
                    virtual_item_type: non_consumable
                    limits: null
                    vp_rewards: []
                  - item_id: 259774
                    sku: com.xsolla.electric_shield_1
                    type: virtual_good
                    name: Electric shield
                    description: Electric shield
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_5
                        name: Gold
                        type: virtual_currency
                        amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_5
                        name: Silver
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_5
                        name: Bronze
                        type: virtual_currency
                        amount: 200
                        amount_without_discount: 200
                        calculated_price:
                          amount: '200.00'
                          amount_without_discount: '200.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259775
                    sku: com.xsolla.royal_shield_1
                    type: virtual_good
                    name: Royal shield
                    description: Royal shield
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_6
                        name: Gold
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_6
                        name: Silver
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_6
                        name: Bronze
                        type: virtual_currency
                        amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259776
                    sku: com.xsolla.ancient_helmet_1
                    type: virtual_good
                    name: Ancient helmet
                    description: Ancient helmet
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_7
                        name: Gold
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_7
                        name: Silver
                        type: virtual_currency
                        amount: 4
                        amount_without_discount: 4
                        calculated_price:
                          amount: '4.00'
                          amount_without_discount: '4.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_7
                        name: Bronze
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259777
                    sku: com.xsolla.wooden_helmet_1
                    type: virtual_good
                    name: Wooden helmet
                    description: Wooden helmet
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png
                    price:
                      amount: '0.99'
                      amount_without_discount: '0.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_8
                        name: Gold
                        type: virtual_currency
                        amount: 1
                        amount_without_discount: 1
                        calculated_price:
                          amount: '1.00'
                          amount_without_discount: '1.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_8
                        name: Silver
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_8
                        name: Bronze
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259778
                    sku: com.xsolla.armor_chest_1
                    type: bundle
                    name: Chest of armor
                    bundle_type: standard
                    description: Chest of armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/5212202f9b8c9dbd254652d6cbeba03e.png
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_9
                        name: Gold
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_9
                        name: Silver
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_9
                        name: Bronze
                        type: virtual_currency
                        amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups: []
                    total_content_price:
                      amount: '11.98'
                      amount_without_discount: '11.98'
                      currency: USD
                    content:
                      - item_id: 259774
                        sku: com.xsolla.electric_shield_2
                        type: virtual_good
                        name: Electric shield
                        description: Electric shield
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                        price:
                          amount: '9.99'
                          amount_without_discount: '9.99'
                          currency: USD
                        virtual_prices:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            item_id: 259765
                            sku: com.xsolla.gold_10
                            name: Gold
                            type: virtual_currency
                            amount: 10
                            amount_without_discount: 10
                            calculated_price:
                              amount: '10.00'
                              amount_without_discount: '10.00'
                            is_default: true
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            item_id: 259766
                            sku: com.xsolla.silver_10
                            name: Silver
                            type: virtual_currency
                            amount: 20
                            amount_without_discount: 20
                            calculated_price:
                              amount: '20.00'
                              amount_without_discount: '20.00'
                            is_default: false
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            item_id: 259767
                            sku: com.xsolla.bronze_10
                            name: Bronze
                            type: virtual_currency
                            amount: 200
                            amount_without_discount: 200
                            calculated_price:
                              amount: '200.00'
                              amount_without_discount: '200.00'
                            is_default: false
                        can_be_bought: true
                        attributes: []
                        is_free: false
                        groups:
                          - external_id: armour
                            name: Armour
                        virtual_item_type: non_consumable
                        quantity: 1
                      - item_id: 259776
                        sku: com.xsolla.ancient_helmet_2
                        type: virtual_good
                        name: Ancient helmet
                        description: Ancient helmet
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                        price:
                          amount: '1.99'
                          amount_without_discount: '1.99'
                          currency: USD
                        virtual_prices:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            item_id: 259765
                            sku: com.xsolla.gold_11
                            name: Gold
                            type: virtual_currency
                            amount: 2
                            amount_without_discount: 2
                            calculated_price:
                              amount: '2.00'
                              amount_without_discount: '2.00'
                            is_default: true
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            item_id: 259766
                            sku: com.xsolla.silver_11
                            name: Silver
                            type: virtual_currency
                            amount: 4
                            amount_without_discount: 4
                            calculated_price:
                              amount: '4.00'
                              amount_without_discount: '4.00'
                            is_default: false
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            item_id: 259767
                            sku: com.xsolla.bronze_11
                            name: Bronze
                            type: virtual_currency
                            amount: 40
                            amount_without_discount: 40
                            calculated_price:
                              amount: '40.00'
                              amount_without_discount: '40.00'
                            is_default: false
                        can_be_bought: true
                        attributes: []
                        is_free: false
                        groups:
                          - external_id: armour
                            name: Armour
                        virtual_item_type: non_consumable
                        quantity: 1
                    vp_rewards: []
                  - item_id: 259779
                    sku: com.xsolla.treasure_chest_1
                    type: bundle
                    name: Treasure Chest
                    bundle_type: standard
                    description: Treasure Chest
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/7b1c0136d91398f9ab17924deee5eeec.png
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_12
                        name: Gold
                        type: virtual_currency
                        amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_12
                        name: Silver
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_12
                        name: Bronze
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                    can_be_bought: true
                    attributes: []
                    is_free: false
                    groups: []
                    total_content_price:
                      amount: '802.89'
                      amount_without_discount: '802.89'
                      currency: USD
                    content:
                      - item_id: 259772
                        sku: com.xsolla.saber_2
                        type: virtual_good
                        name: Saber
                        description: Saber
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/edd914d60301d77b94926478d253fcb6.png
                        price:
                          amount: '3.99'
                          amount_without_discount: '3.99'
                          currency: USD
                        virtual_prices:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            item_id: 259765
                            sku: com.xsolla.gold_13
                            name: Gold
                            type: virtual_currency
                            amount: 3
                            amount_without_discount: 3
                            calculated_price:
                              amount: '3.00'
                              amount_without_discount: '3.00'
                            is_default: true
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            item_id: 259766
                            sku: com.xsolla.silver_13
                            name: Silver
                            type: virtual_currency
                            amount: 7
                            amount_without_discount: 7
                            calculated_price:
                              amount: '7.00'
                              amount_without_discount: '7.00'
                            is_default: false
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            item_id: 259767
                            sku: com.xsolla.bronze_13
                            name: Bronze
                            type: virtual_currency
                            amount: 70
                            amount_without_discount: 70
                            calculated_price:
                              amount: '70.00'
                              amount_without_discount: '70.00'
                            is_default: false
                        can_be_bought: true
                        attributes: []
                        is_free: false
                        groups:
                          - external_id: swords
                            name: Swords
                        virtual_item_type: non_consumable
                        quantity: 1
                      - item_id: 259769
                        sku: com.xsolla.silver_chest_2
                        type: bundle
                        name: Chest of silver
                        bundle_type: virtual_currency_package
                        description: Chest of silver
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/f0b59a3370404e8881107249051b70bd.png
                        price:
                          amount: '19.99'
                          amount_without_discount: '19.99'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        attributes: []
                        is_free: false
                        groups: []
                        content:
                          - item_id: 259766
                            sku: com.xsolla.silver_14
                            type: virtual_currency
                            name: Silver
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            quantity: 50
                        quantity: 10
                      - item_id: 259770
                        sku: com.xsolla.bronze_chest_2
                        type: bundle
                        name: Chest of bronze
                        bundle_type: virtual_currency_package
                        description: Chest of bronze
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b32eb5b1f4f0c202ea6ac4e21c2eae18.png
                        price:
                          amount: '5.99'
                          amount_without_discount: '5.99'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        attributes: []
                        is_free: false
                        groups: []
                        content:
                          - item_id: 259767
                            sku: com.xsolla.bronze_11
                            type: virtual_currency
                            name: Bronze
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            quantity: 100
                        quantity: 100
                    vp_rewards: []
                items:
                  type: object
                  properties:
                    item_id:
                      type: integer
                      example: 259774
                      description: >-
                        ID único interno del artículo que se proporciona al
                        crearlo.
                    sku:
                      type: string
                      example: com.xsolla.electric_shield_1
                      description: >-
                        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.
                    name:
                      type: string
                      example: Electric shield
                      description: Nombre del artículo.
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    total_content_price:
                      $ref: '#/components/schemas/Bundles_total_content_price'
                    attributes:
                      $ref: >-
                        #/components/schemas/Virtual-Items-Currency_client-attributes
                    type:
                      type: string
                      example: virtual_good
                      description: >-
                        Tipo de artículo:
                        `virtual_good`/`virtual_currency`/`bundle`/`game_key`/`physical_good`.
                      enum:
                        - virtual_good
                        - virtual_currency
                        - bundle
                        - game_key
                        - physical_good
                    bundle_type:
                      type: string
                      description: >-
                        Tipo de lote. Se devuelve si el tipo de artículo es un
                        lote.
                      enum:
                        - standard
                        - virtual_currency_package
                    description:
                      type: string
                      example: Electric shield
                      description: Descripción del artículo.
                    image_url:
                      type: string
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                      description: URL de la imagen.
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    price:
                      type: object
                      description: Precios de artículos.
                      properties:
                        amount:
                          type: string
                          example: '9.99'
                          description: Precio del artículo con descuento.
                        amount_without_discount:
                          type: string
                          example: '9.99'
                          description: Precio del artículo.
                        currency:
                          type: string
                          example: USD
                          description: >-
                            Divisa del precio del artículo. Código de tres
                            letras según [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                    virtual_prices:
                      $ref: >-
                        #/components/schemas/client_virtual_prices_with_calculated_price_response
                    can_be_bought:
                      type: boolean
                      example: true
                      description: Si es `true`, el usuario puede comprar un artículo.
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    virtual_item_type:
                      type: string
                      example: non-consumable
                      description: >-
                        Tipo de artículo virtual.


                        Valores posibles:

                        - `consumable`: Un objeto que desaparece del inventario
                        tras su utilización (p. ej., munición).

                        - `non_consumable`: Un objeto que permanece en el
                        inventario durante un tiempo ilimitado.

                        - `non_renewing_subscription`: Objeto de duración
                        limitada que puede representar el acceso a servicios o
                        contenidos durante un periodo limitado.
                      enum:
                        - consumable
                        - non_consumable
                        - non_renewing_subscription
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    custom_attributes:
                      $ref: '#/components/schemas/item-custom-attributes-response'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                    content:
                      type: array
                      items:
                        type: object
                        items:
                          $ref: '#/components/schemas/Bundles_client_content'
          examples:
            response:
              value:
                has_more: false
                items:
                  - item_id: 259765
                    sku: com.xsolla.gold_1
                    type: virtual_currency
                    name: Gold
                    description: ''
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                    price:
                      amount: '1.00'
                      amount_without_discount: '1.00'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups: []
                    limits: null
                    custom_attributes:
                      purchased: 0
                      attr: value
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                  - item_id: 259766
                    sku: com.xsolla.silver_1
                    type: virtual_currency
                    name: Silver
                    description: ''
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                    price:
                      amount: '0.50'
                      amount_without_discount: '0.50'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups: []
                    vp_rewards: []
                  - item_id: 259767
                    sku: com.xsolla.bronze_1
                    type: virtual_currency
                    name: Bronze
                    description: ''
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                    price:
                      amount: '0.10'
                      amount_without_discount: '0.10'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups: []
                    vp_rewards: []
                  - item_id: 259768
                    sku: com.xsolla.gold_chest_1
                    type: bundle
                    name: Chest of gold
                    bundle_type: virtual_currency_package
                    description: Chest of gold
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/61b8d0785093017ce1f50ebed55c42a9.png
                    price:
                      amount: '7.99'
                      amount_without_discount: '7.99'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups: []
                    content:
                      - item_id: 259765
                        sku: com.xsolla.gold_2
                        type: virtual_currency
                        name: Gold
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        quantity: 10
                    vp_rewards: []
                  - item_id: 259769
                    sku: com.xsolla.silver_chest_1
                    type: bundle
                    name: Chest of silver
                    bundle_type: virtual_currency_package
                    description: Chest of silver
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/f0b59a3370404e8881107249051b70bd.png
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups: []
                    content:
                      - item_id: 259766
                        sku: com.xsolla.silver_2
                        type: virtual_currency
                        name: Silver
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        quantity: 50
                    vp_rewards: []
                  - item_id: 259770
                    sku: com.xsolla.bronze_chest_1
                    type: bundle
                    name: Chest of bronze
                    bundle_type: virtual_currency_package
                    description: Chest of bronze
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b32eb5b1f4f0c202ea6ac4e21c2eae18.png
                    price:
                      amount: '5.99'
                      amount_without_discount: '5.99'
                      currency: USD
                    virtual_prices: []
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups: []
                    content:
                      - item_id: 259767
                        sku: com.xsolla.bronze_1
                        type: virtual_currency
                        name: Bronze
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        quantity: 100
                    vp_rewards: []
                  - item_id: 259771
                    sku: com.xsolla.sword_1
                    type: virtual_good
                    name: Sword
                    description: Sword
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/a558727a420cad609556e4449b9ecb12.png
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_2
                        name: Gold
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_2
                        name: Silver
                        type: virtual_currency
                        amount: 5
                        amount_without_discount: 5
                        calculated_price:
                          amount: '5.00'
                          amount_without_discount: '5.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_2
                        name: Bronze
                        type: virtual_currency
                        amount: 50
                        amount_without_discount: 50
                        calculated_price:
                          amount: '50.00'
                          amount_without_discount: '50.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: swords
                        name: Swords
                        item_order_in_group: 1
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259772
                    sku: com.xsolla.saber_1
                    type: virtual_good
                    name: Saber
                    description: Saber
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/edd914d60301d77b94926478d253fcb6.png
                    price:
                      amount: '3.99'
                      amount_without_discount: '3.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_3
                        name: Gold
                        type: virtual_currency
                        amount: 3
                        amount_without_discount: 3
                        calculated_price:
                          amount: '3.00'
                          amount_without_discount: '3.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_3
                        name: Silver
                        type: virtual_currency
                        amount: 7
                        amount_without_discount: 7
                        calculated_price:
                          amount: '7.00'
                          amount_without_discount: '7.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_3
                        name: Bronze
                        type: virtual_currency
                        amount: 70
                        amount_without_discount: 70
                        calculated_price:
                          amount: '70.00'
                          amount_without_discount: '70.00'
                        is_default: false
                    can_be_bought: true
                    promotions: []
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: swords
                        name: Swords
                        item_order_in_group: 2
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259773
                    sku: com.xsolla.bow_1
                    type: virtual_good
                    name: Bow
                    description: Bow
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/3bb3b0a5254ad15134c891108898363f.png
                    price:
                      amount: '4.99'
                      amount_without_discount: '4.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_4
                        name: Gold
                        type: virtual_currency
                        amount: 5
                        amount_without_discount: 5
                        calculated_price:
                          amount: '5.00'
                          amount_without_discount: '5.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_4
                        name: Silver
                        type: virtual_currency
                        amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_5
                        name: Bronze
                        type: virtual_currency
                        amount: 100
                        amount_without_discount: 100
                        calculated_price:
                          amount: '100.00'
                          amount_without_discount: '100.00'
                        is_default: false
                    can_be_bought: true
                    promotions: []
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: bows
                        name: Bows
                        item_order_in_group: 1
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259774
                    sku: com.xsolla.electric_shield_2
                    type: virtual_good
                    name: Electric shield
                    description: Electric shield
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_5
                        name: Gold
                        type: virtual_currency
                        amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_5
                        name: Silver
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_5
                        name: Bronze
                        type: virtual_currency
                        amount: 200
                        amount_without_discount: 200
                        calculated_price:
                          amount: '200.00'
                          amount_without_discount: '200.00'
                        is_default: false
                    can_be_bought: true
                    promotions: []
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                        item_order_in_group: 1
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259775
                    sku: com.xsolla.royal_shield_2
                    type: virtual_good
                    name: Royal shield
                    description: Royal shield
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_6
                        name: Gold
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_6
                        name: Silver
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_6
                        name: Bronze
                        type: virtual_currency
                        amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                        item_order_in_group: 2
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259776
                    sku: com.xsolla.ancient_helmet_1
                    type: virtual_good
                    name: Ancient helmet
                    description: Ancient helmet
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_7
                        name: Gold
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_7
                        name: Silver
                        type: virtual_currency
                        amount: 4
                        amount_without_discount: 4
                        calculated_price:
                          amount: '4.00'
                          amount_without_discount: '4.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_7
                        name: Bronze
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                    can_be_bought: true
                    promotions: []
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                        item_order_in_group: 3
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259777
                    sku: com.xsolla.wooden_helmet_1
                    type: virtual_good
                    name: Wooden helmet
                    description: Wooden helmet
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png
                    price:
                      amount: '0.99'
                      amount_without_discount: '0.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_8
                        name: Gold
                        type: virtual_currency
                        amount: 1
                        amount_without_discount: 1
                        calculated_price:
                          amount: '1.00'
                          amount_without_discount: '1.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_8
                        name: Silver
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_8
                        name: Bronze
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                        item_order_in_group: 4
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259778
                    sku: com.xsolla.armor_chest_1
                    type: bundle
                    name: Chest of armor
                    bundle_type: standard
                    description: Chest of armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/5212202f9b8c9dbd254652d6cbeba03e.png
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_9
                        name: Gold
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_9
                        name: Silver
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_9
                        name: Bronze
                        type: virtual_currency
                        amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups: []
                    total_content_price:
                      amount: '11.98'
                      amount_without_discount: '11.98'
                      currency: USD
                    content:
                      - item_id: 259774
                        sku: com.xsolla.electric_shield_2
                        type: virtual_good
                        name: Electric shield
                        description: Electric shield
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                        price:
                          amount: '9.99'
                          amount_without_discount: '9.99'
                          currency: USD
                        virtual_prices:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            item_id: 259765
                            sku: com.xsolla.gold_10
                            name: Gold
                            type: virtual_currency
                            amount: 10
                            amount_without_discount: 10
                            calculated_price:
                              amount: '10.00'
                              amount_without_discount: '10.00'
                            is_default: true
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            item_id: 259766
                            sku: com.xsolla.silver_10
                            name: Silver
                            type: virtual_currency
                            amount: 20
                            amount_without_discount: 20
                            calculated_price:
                              amount: '20.00'
                              amount_without_discount: '20.00'
                            is_default: false
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            item_id: 259767
                            sku: com.xsolla.bronze_10
                            name: Bronze
                            type: virtual_currency
                            amount: 200
                            amount_without_discount: 200
                            calculated_price:
                              amount: '200.00'
                              amount_without_discount: '200.00'
                            is_default: false
                        can_be_bought: true
                        promotions:
                          - name: Bonus promotion
                            date_start: '2020-04-15T16:16:00+03:00'
                            date_end: '2026-04-15T16:16:00+03:00'
                            discount:
                              percent: '50.00'
                            bonus:
                              - quantity: 1
                                name: Xsolla Minigun
                                image_url: >-
                                  https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                                sku: com.xsolla.minigun_1
                                type: virtual_good
                        attributes: []
                        is_free: false
                        groups:
                          - external_id: armour
                            name: Armour
                        virtual_item_type: non_consumable
                        quantity: 1
                      - item_id: 259776
                        sku: com.xsolla.ancient_helmet_2
                        type: virtual_good
                        name: Ancient helmet
                        description: Ancient helmet
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                        price:
                          amount: '1.99'
                          amount_without_discount: '1.99'
                          currency: USD
                        virtual_prices:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            item_id: 259765
                            sku: com.xsolla.gold_11
                            name: Gold
                            type: virtual_currency
                            amount: 2
                            amount_without_discount: 2
                            calculated_price:
                              amount: '2.00'
                              amount_without_discount: '2.00'
                            is_default: true
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            item_id: 259766
                            sku: com.xsolla.silver_11
                            name: Silver
                            type: virtual_currency
                            amount: 4
                            amount_without_discount: 4
                            calculated_price:
                              amount: '4.00'
                              amount_without_discount: '4.00'
                            is_default: false
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            item_id: 259767
                            sku: com.xsolla.bronze_11
                            name: Bronze
                            type: virtual_currency
                            amount: 40
                            amount_without_discount: 40
                            calculated_price:
                              amount: '40.00'
                              amount_without_discount: '40.00'
                            is_default: false
                        can_be_bought: true
                        promotions:
                          - name: Bonus promotion
                            date_start: '2020-04-15T16:16:00+03:00'
                            date_end: '2026-04-15T16:16:00+03:00'
                            discount:
                              percent: '50.00'
                            bonus:
                              - quantity: 1
                                name: Xsolla Minigun
                                image_url: >-
                                  https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                                sku: com.xsolla.minigun_1
                                type: virtual_good
                        attributes: []
                        is_free: false
                        groups:
                          - external_id: armour
                            name: Armour
                        virtual_item_type: non_consumable
                        quantity: 1
                    vp_rewards: []
                  - item_id: 259779
                    sku: com.xsolla.treasure_chest_1
                    type: bundle
                    name: Treasure Chest
                    bundle_type: standard
                    description: Treasure Chest
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/7b1c0136d91398f9ab17924deee5eeec.png
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    virtual_prices:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_12
                        name: Gold
                        type: virtual_currency
                        amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        is_default: true
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_12
                        name: Silver
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_12
                        name: Bronze
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups: []
                    total_content_price:
                      amount: '802.89'
                      amount_without_discount: '802.89'
                      currency: USD
                    content:
                      - item_id: 259772
                        sku: com.xsolla.saber_1
                        type: virtual_good
                        name: Saber
                        description: Saber
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/edd914d60301d77b94926478d253fcb6.png
                        price:
                          amount: '3.99'
                          amount_without_discount: '3.99'
                          currency: USD
                        virtual_prices:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            item_id: 259765
                            sku: com.xsolla.gold_13
                            name: Gold
                            type: virtual_currency
                            amount: 3
                            amount_without_discount: 3
                            calculated_price:
                              amount: '3.00'
                              amount_without_discount: '3.00'
                            is_default: true
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            item_id: 259766
                            sku: com.xsolla.silver_13
                            name: Silver
                            type: virtual_currency
                            amount: 7
                            amount_without_discount: 7
                            calculated_price:
                              amount: '7.00'
                              amount_without_discount: '7.00'
                            is_default: false
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            item_id: 259767
                            sku: com.xsolla.bronze_13
                            name: Bronze
                            type: virtual_currency
                            amount: 70
                            amount_without_discount: 70
                            calculated_price:
                              amount: '70.00'
                              amount_without_discount: '70.00'
                            is_default: false
                        can_be_bought: true
                        attributes: []
                        is_free: false
                        groups:
                          - external_id: swords
                            name: Swords
                        virtual_item_type: non_consumable
                        quantity: 1
                      - item_id: 259769
                        sku: com.xsolla.silver_chest_2
                        type: bundle
                        name: Chest of silver
                        bundle_type: virtual_currency_package
                        description: Chest of silver
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/f0b59a3370404e8881107249051b70bd.png
                        price:
                          amount: '19.99'
                          amount_without_discount: '19.99'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        promotions: []
                        attributes: []
                        is_free: false
                        groups: []
                        content:
                          - item_id: 259766
                            sku: com.xsolla.silver_13
                            type: virtual_currency
                            name: Silver
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            quantity: 50
                        quantity: 10
                      - item_id: 259770
                        sku: com.xsolla.bronze_chest_2
                        type: bundle
                        name: Chest of bronze
                        bundle_type: virtual_currency_package
                        description: Chest of bronze
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b32eb5b1f4f0c202ea6ac4e21c2eae18.png
                        price:
                          amount: '5.99'
                          amount_without_discount: '5.99'
                          currency: USD
                        virtual_prices: []
                        can_be_bought: true
                        promotions: []
                        attributes: []
                        is_free: false
                        groups: []
                        content:
                          - item_id: 259767
                            sku: com.xsolla.bronze_13
                            type: virtual_currency
                            name: Bronze
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            quantity: 100
                        quantity: 100
                    vp_rewards: []
    sellable_items_200-get-item-by-id:
      description: El artículo vendible se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con artículo vendible.
            properties:
              item_id:
                type: integer
                example: 259774
                description: ID único interno del artículo que se proporciona al crearlo.
              sku:
                type: string
                example: electric_shield
                description: >-
                  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.
              name:
                type: string
                example: Electric shield
                description: Nombre del artículo.
              groups:
                $ref: '#/components/schemas/items_client_groups_response'
              attributes:
                $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
              type:
                type: string
                example: virtual_good
                description: >-
                  Tipo de artículo:
                  `virtual_good`/`virtual_currency`/`bundle`/`game_key`/`physical_good`.
                enum:
                  - virtual_good
                  - virtual_currency
                  - bundle
                  - game_key
                  - physical_good
              description:
                type: string
                example: Electric shield
                description: Descripción del artículo.
              image_url:
                type: string
                example: >-
                  https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                description: URL de la imagen.
              is_free:
                $ref: '#/components/schemas/value-is_free'
              price:
                type: object
                description: Precios de artículos.
                properties:
                  amount:
                    type: string
                    example: '9.99'
                    description: Precio del artículo con descuento.
                  amount_without_discount:
                    type: string
                    example: '9.99'
                    description: Precio del artículo.
                  currency:
                    type: string
                    example: USD
                    description: >-
                      Divisa del precio del artículo. Código de tres letras
                      según [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
              virtual_prices:
                $ref: >-
                  #/components/schemas/client_virtual_prices_with_calculated_price_response
              can_be_bought:
                type: boolean
                example: true
                description: Si es `true`, el usuario puede comprar un artículo.
              promotions:
                $ref: '#/components/schemas/Catalog_item_promotions'
              virtual_item_type:
                type: string
                example: non-consumable
                description: >-
                  Tipo de artículo virtual.


                  Valores posibles:

                  - `consumable`: Un objeto que desaparece del inventario tras
                  su utilización (p. ej., munición).

                  - `non_consumable`: Un objeto que permanece en el inventario
                  durante un tiempo ilimitado.

                  - `non_renewing_subscription`: Objeto de duración limitada que
                  puede representar el acceso a servicios o contenidos durante
                  un periodo limitado.
                enum:
                  - consumable
                  - non_consumable
                  - non_renewing_subscription
              limits:
                $ref: '#/components/schemas/Catalog_item_limits'
              custom_attributes:
                $ref: '#/components/schemas/item-custom-attributes-response'
              vp_rewards:
                $ref: '#/components/schemas/client-item-value-point-reward'
          examples:
            response:
              value:
                item_id: 259774
                sku: com.xsolla.electric_shield_1
                type: virtual_good
                name: Electric shield
                description: Electric shield
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                price:
                  amount: '9.99'
                  amount_without_discount: '9.99'
                  currency: USD
                virtual_prices:
                  - description: null
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                    item_id: 259765
                    sku: com.xsolla.gold_1
                    name: Gold
                    type: virtual_currency
                    amount: 10
                    amount_without_discount: 10
                    calculated_price:
                      amount: '10.00'
                      amount_without_discount: '10.00'
                    is_default: true
                  - description: null
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                    item_id: 259766
                    sku: com.xsolla.silver_1
                    name: Silver
                    type: virtual_currency
                    amount: 20
                    amount_without_discount: 20
                    calculated_price:
                      amount: '20.00'
                      amount_without_discount: '20.00'
                    is_default: false
                  - description: null
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                    item_id: 259767
                    sku: com.xsolla.bronze_1
                    name: Bronze
                    type: virtual_currency
                    amount: 200
                    amount_without_discount: 200
                    calculated_price:
                      amount: '200.00'
                      amount_without_discount: '200.00'
                    is_default: false
                can_be_bought: true
                promotions:
                  - name: Bonus promotion
                    date_start: '2020-04-15T16:16:00+03:00'
                    date_end: '2026-04-15T16:16:00+03:00'
                    discount:
                      percent: '50.00'
                    bonus:
                      - quantity: 1
                        name: Xsolla Minigun
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                        sku: com.xsolla.minigun_1
                        type: virtual_good
                attributes: []
                is_free: false
                groups:
                  - external_id: armour
                    name: Armour
                    item_order_in_group: 10
                virtual_item_type: non_consumable
                limits:
                  per_user:
                    total: 5
                    available: 3
                    recurrent_schedule:
                      interval_type: weekly
                      reset_next_date: 1746057600
                    limit_exceeded_visibility: show
                vp_rewards:
                  - item_id: 175232
                    sku: com.xsolla.value_point_1
                    amount: 130
                    name: Value point
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                  - item_id: 186321
                    sku: com.xsolla.clan_value_point_1
                    amount: 50
                    name: Clan Reward VP 1
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    is_clan: true
                custom_attributes:
                  purchased: 0
                  attr: value
    sellable-item-by-id_404:
      description: >-
        Artículo no encontrado. Asegúrese de que el `project_id` y el `item_id`
        sean correctos.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 404
              errorCode:
                type: integer
                example: 4001
              errorMessage:
                type: string
                example: '[0401-4001]: Item with id = 259774 not found'
    sellable-item-by-sku_404:
      description: >-
        Artículo no encontrado. Asegúrese de que el `project_id` y el `sku` sean
        correctos.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 404
              errorCode:
                type: integer
                example: 4001
              errorMessage:
                type: string
                example: '[0401-4001]: Item with sku = ''electric_shiel'' not found'
    sellable_items_200-get-items-by-group-id:
      description: >-
        La lista de artículos vendibles del grupo especificado se recibió
        correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                type: array
                example:
                  - item_id: 259774
                    sku: com.xsolla.electric_shield_1
                    type: virtual_good
                    name: Electric shield
                    description: Electric shield
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    virtual_prices:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_1
                        name: Gold
                        type: virtual_currency
                        amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        is_default: true
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_1
                        name: Silver
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_1
                        name: Bronze
                        type: virtual_currency
                        amount: 200
                        amount_without_discount: 200
                        calculated_price:
                          amount: '200.00'
                          amount_without_discount: '200.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                    virtual_item_type: non_consumable
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        limit_exceeded_visibility: show
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: clan_value_point_sku_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                  - item_id: 259775
                    sku: com.xsolla.royal_shield_1
                    type: virtual_good
                    name: Royal shield
                    description: Royal shield
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    virtual_prices:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_2
                        name: Gold
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: true
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_2
                        name: Silver
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_2
                        name: Bronze
                        type: virtual_currency
                        amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        is_default: false
                    can_be_bought: true
                    promotions: []
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259776
                    sku: com.xsolla.ancient_helmet_1
                    type: virtual_good
                    name: Ancient helmet
                    description: Ancient helmet
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    virtual_prices:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_3
                        name: Gold
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: true
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_3
                        name: Silver
                        type: virtual_currency
                        amount: 4
                        amount_without_discount: 4
                        calculated_price:
                          amount: '4.00'
                          amount_without_discount: '4.00'
                        is_default: false
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_3
                        name: Bronze
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                    virtual_item_type: non_consumable
                    vp_rewards: []
                  - item_id: 259777
                    sku: com.xsolla.wooden_helmet_1
                    type: virtual_good
                    name: Wooden helmet
                    description: Wooden helmet
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png
                    price:
                      amount: '0.99'
                      amount_without_discount: '0.99'
                      currency: USD
                    virtual_prices:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_4
                        name: Gold
                        type: virtual_currency
                        amount: 1
                        amount_without_discount: 1
                        calculated_price:
                          amount: '1.00'
                          amount_without_discount: '1.00'
                        is_default: true
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_4
                        name: Silver
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: false
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_4
                        name: Bronze
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                    can_be_bought: true
                    promotions: []
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                    virtual_item_type: non_consumable
                    vp_rewards: []
                items:
                  type: object
                  properties:
                    item_id:
                      type: integer
                      example: 259774
                      description: >-
                        ID único interno del artículo que se proporciona al
                        crearlo.
                    sku:
                      type: string
                      example: com.xsolla.electric_shield_1
                      description: >-
                        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.
                    name:
                      type: string
                      example: Electric shield
                      description: Nombre del artículo.
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    attributes:
                      $ref: >-
                        #/components/schemas/Virtual-Items-Currency_client-attributes
                    type:
                      type: string
                      example: virtual_good
                      description: >-
                        Tipo de artículo:
                        `virtual_good`/`virtual_currency`/`bundle`/`game_key`/`physical_good`.
                      enum:
                        - virtual_good
                        - virtual_currency
                        - bundle
                        - game_key
                        - physical_good
                    description:
                      type:
                        - string
                        - 'null'
                      example: Electric shield
                      description: Descripción del artículo.
                    image_url:
                      type: string
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                      description: URL de la imagen.
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    price:
                      type: object
                      description: Precios de artículos.
                      properties:
                        amount:
                          type: string
                          example: '9.99'
                          description: Precio del artículo con descuento.
                        amount_without_discount:
                          type: string
                          example: '9.99'
                          description: Precio del artículo.
                        currency:
                          type: string
                          example: USD
                          description: >-
                            Divisa del precio del artículo. Código de tres
                            letras según [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                    virtual_prices:
                      $ref: >-
                        #/components/schemas/client_virtual_prices_with_calculated_price_response
                    virtual_item_type:
                      type: string
                      example: non_consumable
                      description: >-
                        Tipo de artículo virtual.


                        Valores posibles:

                        - `consumable`: Un objeto que desaparece del inventario
                        tras su utilización (p. ej., munición).

                        - `non_consumable`: Un objeto que permanece en el
                        inventario durante un tiempo ilimitado.

                        - `non_renewing_subscription`: Objeto de duración
                        limitada que puede representar el acceso a servicios o
                        contenidos durante un periodo limitado.
                      enum:
                        - consumable
                        - non_consumable
                        - non_renewing_subscription
                    can_be_bought:
                      type: boolean
                      example: true
                      description: Si es `true`, el usuario puede comprar un artículo.
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    custom_attributes:
                      $ref: '#/components/schemas/item-custom-attributes-response'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
          examples:
            response:
              value:
                has_more: true
                items:
                  - item_id: 259774
                    sku: com.xsolla.electric_shields_1
                    type: virtual_good
                    name: Electric shield
                    description: Electric shield
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    virtual_prices:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_1
                        name: Gold
                        type: virtual_currency
                        amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        is_default: true
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_1
                        name: Silver
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_1
                        name: Bronze
                        type: virtual_currency
                        amount: 200
                        amount_without_discount: 200
                        calculated_price:
                          amount: '200.00'
                          amount_without_discount: '200.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                        item_order_in_group: 1
                    virtual_item_type: non_consumable
                  - item_id: 259775
                    sku: com.xsolla.royal_shield_1
                    type: virtual_good
                    name: Royal shield
                    description: Royal shield
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    virtual_prices:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_1
                        name: Gold
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: true
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_1
                        name: Silver
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_1
                        name: Bronze
                        type: virtual_currency
                        amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        is_default: false
                    can_be_bought: true
                    promotions: []
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                        item_order_in_group: 2
                    virtual_item_type: non_consumable
                  - item_id: 259776
                    sku: com.xsolla.ancient_helmet_1
                    type: virtual_good
                    name: Ancient helmet
                    description: Ancient helmet
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    virtual_prices:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_2
                        name: Gold
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: true
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_2
                        name: Silver
                        type: virtual_currency
                        amount: 4
                        amount_without_discount: 4
                        calculated_price:
                          amount: '4.00'
                          amount_without_discount: '4.00'
                        is_default: false
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_2
                        name: Bronze
                        type: virtual_currency
                        amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                        item_order_in_group: 3
                    virtual_item_type: non_consumable
                  - item_id: 259777
                    sku: com.xsolla.wooden_helmet_2
                    type: virtual_good
                    name: Wooden helmet
                    description: Wooden helmet
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png
                    price:
                      amount: '0.99'
                      amount_without_discount: '0.99'
                      currency: USD
                    virtual_prices:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        sku: com.xsolla.gold_3
                        name: Gold
                        type: virtual_currency
                        amount: 1
                        amount_without_discount: 1
                        calculated_price:
                          amount: '1.00'
                          amount_without_discount: '1.00'
                        is_default: true
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        sku: com.xsolla.silver_3
                        name: Silver
                        type: virtual_currency
                        amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        is_default: false
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        sku: com.xsolla.bronze_3
                        name: Bronze
                        type: virtual_currency
                        amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        is_default: false
                    can_be_bought: true
                    promotions:
                      - name: Bonus promotion
                        date_start: '2020-04-15T16:16:00+03:00'
                        date_end: '2026-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        bonus:
                          - quantity: 1
                            name: Xsolla Minigun
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                    attributes: []
                    is_free: false
                    groups:
                      - external_id: armour
                        name: Armour
                        item_order_in_group: 4
                    virtual_item_type: non_consumable
                    limits:
                      per_user:
                        total: 5
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                    vp_rewards:
                      - item_id: 175232
                        sku: com.xsolla.value_point_1
                        amount: 130
                        name: Value point
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                      - item_id: 186321
                        sku: com.xsolla.clan_value_point_1
                        amount: 50
                        name: Clan Reward VP 1
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                    custom_attributes:
                      purchased: 0
                      attr: value
    200-admin-get-regions-list:
      description: La lista de regiones se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con artículos.
            properties:
              regions:
                type: array
                items:
                  $ref: '#/components/schemas/Regions_200-region-short-model'
          examples:
            response:
              value:
                regions:
                  - id: 44
                    name:
                      en-US: Asia
                      de-DE: Asien
                  - id: 45
                    name:
                      en-US: CIS
                      de-DE: GUS
    201-admin-create-region:
      description: La región se creó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              region_id:
                $ref: '#/components/schemas/Regions_region_id'
          example:
            region_id: 42
    200-admin-get-region:
      description: La región especificada se recibió correctamente.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Regions_200-region-model'
    404-region-not-found:
      description: Región no encontrada. Asegúrese de que el `id` es correcto.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 404
              errorCode:
                type: integer
                example: 9701
              errorMessage:
                type: string
                example: '[0401-9701]: Region not found'
              transactionId:
                type: string
                example: x-x-x-x-transactionId-mock-x-x-x
    204-admin-update-region:
      description: La región se actualizó correctamente.
      content: {}
    204-admin-delete-region:
      description: La región se eliminó correctamente.
      content: {}
    200-admin-get-attribute-list-response:
      description: La lista de atributos se recibió correctamente.
      content:
        application/json:
          schema:
            type: object
            description: Objeto con artículos.
            properties:
              attributes:
                type: array
                items:
                  $ref: '#/components/schemas/admin_attribute_response'
              total_count:
                type: integer
          examples:
            response:
              value:
                total_count: 2
                attributes:
                  - external_id: size
                    name:
                      en: Size
                      de: Größe
                  - external_id: genre
                    name:
                      en: Genre
                      de: Genre
    201-admin-create-attribute:
      description: El atributo se creó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              external_id:
                $ref: '#/components/schemas/admin-attribute-external_id'
          example:
            external_id: genre
    422-validation-failed:
      description: Solicitud no válida.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/schemas-422-invalid-request'
          examples:
            response:
              value:
                statusCode: 422
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `external_id`
                  is required
    200-admin-get-attribute:
      description: El atributo especificado se recibió correctamente.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/admin_attribute_response'
    404-attribute-not-found:
      description: Atributo no encontrado.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 404
              errorCode:
                type: integer
                example: 9901
              errorMessage:
                type: string
                example: '[0401-9901]: Attribute not found.'
              transactionId:
                type: string
                example: x-x-x-x-transactionId-mock-x-x-x
          examples:
            response:
              value:
                statusCode: 404
                errorCode: 9901
                errorMessage: '[0401-9901]: Attribute not found.'
                transactionId: x-x-x-x-transactionId-mock-x-x-x
    204-admin-update-attribute:
      description: El atributo se actualizó correctamente.
      content: {}
    201-admin-create-attribute-value:
      description: El valor de atributo se creó correctamente.
      content:
        application/json:
          schema:
            type: object
            properties:
              external_id:
                $ref: '#/components/schemas/value-external_id'
          example:
            external_id: rpg
    403-auth-header-not-sent:
      description: No se envió el encabezado de autorización.
      content:
        application/json:
          schema:
            type: object
            properties:
              statusCode:
                type: integer
                example: 403
              errorCode:
                type: integer
                example: 0
              errorMessage:
                type: string
                example: No se envió el encabezado de autorización.
              transactionId:
                type: string
                example: x-x-x-x-transactionId-mock-x-x-x
          examples:
            response:
              value:
                statusCode: 403
                errorCode: 0
                errorMessage: Authorization header not sent
    422-create-update-attribute-value:
      description: Solicitud no válida.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/schemas-422-invalid-request'
          examples:
            external_id is required:
              $ref: '#/components/examples/422-external-id-required'
            external_id is invalid:
              $ref: '#/components/examples/422-external-id-invalid'
            external_id is duplicate:
              $ref: '#/components/examples/422-external-id-duplicate'
            value is required:
              $ref: '#/components/examples/422-value-invalid'
            value properties minimum length:
              $ref: '#/components/examples/422-value-properties-required'
            value limit exceeded:
              $ref: '#/components/examples/422-value-limit-exceeded'
    404-attribute-value-not-found:
      description: Valor de atributo no encontrado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/404-not-found'
          examples:
            Attribute not found:
              $ref: '#/components/examples/404-attribute-not-found'
            Attribue value not found:
              $ref: '#/components/examples/404-attribute-value-not-found'
  requestBodies:
    Virtual-Items-Currency_admin-create-virtual-item:
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_admin-create-virtual-item
          examples:
            default:
              summary: Minimal setup example
              value:
                sku: booster_mega_1
                name:
                  en: Mega Booster
                description:
                  en: Temporarily doubles the experience points earned in battle.
            quickstart:
              summary: Quickstart example
              value:
                sku: booster_mega_1
                name:
                  en: Mega Booster
                  de: Mega-Booster
                description:
                  en: Temporarily doubles the experience points earned in battle.
                  de: >-
                    Verdoppelt vorübergehend die im Kampf erhaltenen
                    Erfahrungspunkte.
                is_enabled: true
                is_show_in_store: true
                is_free: false
                groups:
                  - boosters
                order: 1
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
            full-payload:
              summary: Full payload example
              value:
                sku: com.xsolla.sword_1
                name:
                  en: Sword
                  de: Schwert
                is_enabled: true
                is_free: false
                is_paid_randomized_reward: true
                groups:
                  - weapons
                order: 1
                description:
                  en: >-
                    A sword is a bladed melee weapon intended for cutting or
                    thrusting that is longer than a knife or dagger, consisting
                    of a long blade attached to a hilt.
                  de: >-
                    Ein Schwert ist eine Nahkampfwaffe mit Klinge, die zum
                    Schneiden oder Stechen bestimmt ist, länger als ein Messer
                    oder Dolch ist und aus einer langen Klinge besteht, die an
                    einem Griff befestigt ist.
                prices:
                  - amount: 100
                    currency: USD
                    is_enabled: true
                    is_default: true
                  - amount: 200
                    currency: CZK
                    country_iso: CZ
                    is_enabled: false
                    is_default: true
                vc_prices: []
                is_show_in_store: true
                attributes:
                  - external_id: craft-materials
                    name:
                      en: Craft materials
                    values:
                      - external_id: steel
                        value:
                          en-US: '5'
                      - external_id: leather
                        value:
                          en-US: '1'
                limits:
                  per_user: 5
                  per_item: 100
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                custom_attributes:
                  purchased: 0
                  attr: value
    Virtual-Items-Currency_admin-create-virtual-currency:
      content:
        application/json:
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_admin-create-virtual-currency
          example:
            sku: com.xsolla.coin_1
            name:
              en-US: Gold coin
              de-DE: Goldmünze
            is_enabled: true
            is_free: false
            is_paid_randomized_reward: false
            groups:
              - gold
            order: 1
            description:
              en-US: The main currency of your kingdom
              de-DE: Die Hauptwährung deines Königreichs
            prices:
              - amount: 100
                currency: USD
                is_enabled: true
                is_default: true
            attributes:
              - external_id: material
                name:
                  en-US: Material
                values:
                  - external_id: gold
                    value:
                      en-US: Gold
            limits:
              per_user: 5
              per_item: 10000
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            custom_attributes:
              purchased: 0
              attr: value
    Virtual-Items-Currency_admin-create-virtual-currency-package:
      content:
        application/json:
          example:
            sku: com.xsolla.novigrad_crown_500
            name:
              en-US: 500x Novigradian crown
              ru-RU: 500x Новиградских крон
            is_enabled: true
            is_free: false
            is_paid_randomized_reward: true
            groups:
              - witcher
            order: 1
            long_description:
              en-US: Long Test new
              ru-RU: Длинное описание
            description:
              en-US: >-
                The Crown (also known as the Novigradian crown) is a monetary
                unit which is used in some Northern Kingdoms
              ru-RU: >-
                Крона (Также известна как Новиградская крона) - платежная
                единица, используемая в северных королевствах
            image_url: >-
              https://vignette.wikia.nocookie.net/witcher/images/7/7c/Items_Orens.png/revision/latest?cb=20081113120917
            media_list:
              - type: image
                url: https://test.com/image0
              - type: image
                url: https://test.com/image1
            attributes:
              - external_id: event
                name:
                  en-US: Event
                values:
                  - external_id: 10-anniversary
                    value:
                      en-US: 10th anniversary
                  - external_id: christmas
                    value:
                      en-US: Christmas
            prices:
              - currency: USD
                amount: 99.99
                is_default: true
              - currency: EUR
                amount: 80.03
                is_enabled: false
            vc_prices: null
            content:
              - sku: com.xsolla.novigrad_crown
                quantity: 500
            limits:
              per_user: null
              per_item: null
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            custom_attributes:
              purchased: 0
              attr: value
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_admin-create-virtual-currency-package
    ItemGroup_create:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/admin-group-create-request'
          example:
            external_id: weapons
            name:
              en: Weapons
              de: Waffen
            description:
              en: Player weapons
              de: Spielerwaffen
            iconUrl: https://example.com/weapons.png
            isEnabled: true
            order: 1
      description: Objeto con datos del grupo de artículos.
      required: true
    ItemGroup_update:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/admin-group-update-request'
          example:
            external_id: weapons
            name:
              en: Weapons Updated
              de: Waffen Aktualisiert
            description:
              en: Updated player weapons
              de: Aktualisierte Spielerwaffen
            iconUrl: https://example.com/weapons-new.png
            isEnabled: true
            order: 2
      description: Objeto con datos del grupo de artículos que se deben actualizar.
      required: true
    ItemGroup_order:
      content:
        application/json:
          schema:
            oneOf:
              - title: Identificar por el ID
                type: array
                uniqueItems: true
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      description: ID del grupo de artículos asignado por Xsolla.
                      minimum: 0
                      example: 1
                    order:
                      type: integer
                      description: Nuevo valor del orden de visualización.
                      minimum: 0
                      example: 1
                  required:
                    - id
                    - order
                  additionalProperties: false
              - title: Identificar por el external_id
                type: array
                uniqueItems: true
                items:
                  type: object
                  properties:
                    external_id:
                      type: string
                      description: >-
                        ID externo del grupo de artículos especificado durante
                        la creación.
                      minLength: 1
                      example: weapons
                    order:
                      type: integer
                      description: Nuevo valor del orden de visualización.
                      minimum: 0
                      example: 1
                  required:
                    - external_id
                    - order
                  additionalProperties: false
          examples:
            by_id:
              summary: Identify groups by ID
              value:
                - id: 1
                  order: 1
                - id: 2
                  order: 2
                - id: 3
                  order: 3
            by_external_id:
              summary: Identify groups by external_id
              value:
                - external_id: weapons
                  order: 1
                - external_id: armor
                  order: 2
                - external_id: consumables
                  order: 3
      description: >-
        Matriz de grupos con nuevos valores de orden. Todos los artículos deben
        usar el mismo método de identificación (ya sea todos por `id` o todos
        por `external_id`).
      required: true
    ItemGroup_item_order:
      content:
        application/json:
          schema:
            type: array
            uniqueItems: true
            items:
              $ref: '#/components/schemas/item-in-group-order-request-item'
          example:
            - item_id: 101
              order: 1
            - item_id: 102
              order: 2
            - item_id: 103
              order: 3
      description: Matriz de artículos con nuevos valores de orden en el grupo.
      required: true
    Game-Keys_create-update-game-model:
      content:
        application/json:
          schema:
            type: object
            properties:
              sku:
                type: string
                minLength: 1
                maxLength: 255
                example: game_1
                pattern: ^[a-zA-Z0-9_\-–.]*$
                description: >-
                  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.
              name:
                $ref: '#/components/schemas/name-localization-object'
              description:
                $ref: '#/components/schemas/description-localization-object'
              long_description:
                $ref: '#/components/schemas/long-description-localization-object'
              image_url:
                type: string
                example: https://image.example.com
                description: URL de la imagen.
              media_list:
                type: array
                example:
                  - type: image
                    url: >-
                      https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                description: >-
                  Recursos adicionales del juego, como capturas de pantalla,
                  vídeos de partidas del juego, etc.
                items:
                  type: object
                  properties:
                    type:
                      type: string
                      enum:
                        - image
                        - video
                      example: image
                      description: 'Tipo de soporte multimedia: `image`/`video`.'
                    url:
                      type: string
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                      description: Archivo de recurso.
              order:
                type: integer
                example: 1
                description: Prioridad de orden del juego en la lista.
              groups:
                type: array
                description: Grupos a los que pertenece el artículo.
                items:
                  type: object
                  properties:
                    external_id:
                      type: string
                      example: horror
                  required:
                    - external_id
              attributes:
                $ref: '#/components/schemas/Game-Keys_admin-post-put-attributes'
              is_enabled:
                type: boolean
                description: >-
                  Si se deshabilita, el artículo no se puede comprar ni se puede
                  acceder a este a través del inventario.
              is_show_in_store:
                type: boolean
                description: El artículo está disponible para la compra.
              unit_items:
                type: array
                description: >-
                  Claves del juego para diferentes DRM (gestión de derechos
                  digitales).
                items:
                  type: object
                  description: >-
                    Artículo de clave del juego. Representa el juego en una
                    plataforma determinada (Steam, GOG, etc.).
                  properties:
                    sku:
                      type: string
                      minLength: 1
                      maxLength: 255
                      example: game_1
                      description: >-
                        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.
                    name:
                      $ref: '#/components/schemas/name-localization-object'
                    groups:
                      type: array
                      description: Grupos a los que pertenece el artículo.
                      items:
                        type: object
                        properties:
                          external_id:
                            type: string
                            example: horror
                        required:
                          - external_id
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_admin-attributes'
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    prices:
                      type: array
                      description: Precios en monedas reales.
                      items:
                        type: object
                        properties:
                          amount:
                            type: number
                            example: 1299.99
                          currency:
                            type: string
                            example: RUB
                            description: >-
                              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/).
                          is_default:
                            type: boolean
                            description: >-
                              El precio por defecto se utiliza para generar el
                              catálogo si no se especifica el precio en la
                              moneda del usuario.
                          is_enabled:
                            type: boolean
                        required:
                          - amount
                          - currency
                          - is_default
                          - is_enabled
                    vc_prices:
                      type: array
                      items:
                        type: object
                        properties:
                          sku:
                            type: string
                            example: gold
                            description: >-
                              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.
                          amount:
                            type: number
                          is_default:
                            type: boolean
                          is_enabled:
                            type: boolean
                        required:
                          - amount
                          - currency
                          - is_default
                          - is_enabled
                    order:
                      type: integer
                      example: 1
                      description: Prioridad de orden del juego en la lista.
                    is_enabled:
                      type: boolean
                      description: >-
                        Si se deshabilita, el artículo no se puede comprar ni se
                        puede acceder a este a través del inventario.
                    is_show_in_store:
                      type: boolean
                      description: El artículo está disponible para la compra.
                    drm_sku:
                      type: string
                      example: steam
                      description: ID único del DRM.
                    pre_order:
                      type: object
                      description: Configuración del pedido por anticipado.
                      properties:
                        release_date:
                          type: string
                          description: >-
                            Fecha de lanzamiento de la clave del juego en
                            formato ISO 8601.
                        is_enabled:
                          type: boolean
                          description: >-
                            Si está deshabilitada, el artículo no es un pedido
                            por anticipado.
                        description:
                          type: string
                          description: >-
                            Additional information for the pre-order, which will
                            be emailed.
                      required:
                        - release_date
                        - is_enabled
                    regions:
                      $ref: '#/components/schemas/Game-Keys_regions'
                    limits:
                      $ref: '#/components/schemas/Game-key-item-limit'
                    periods:
                      $ref: '#/components/schemas/item-periods'
                  required:
                    - sku
                    - drm_sku
                    - prices
            required:
              - sku
              - name
              - unit_items
            example:
              sku: com.xsolla.game_1
              name:
                en-US: Game name
                ru-RU: Название игры
              description:
                en-US: Game description
                ru-RU: Краткое описание игры
              long_description:
                en-US: Game long description
                ru-RU: Полное описание игры
              image_url: http://image.png
              media_list:
                - type: image
                  url: http://image.png
                - type: video
                  url: http://video.png
              groups:
                - new_games
              is_enabled: true
              is_show_in_store: true
              unit_items:
                - sku: com.xsolla.game_key_1
                  name:
                    en-US: Game key name
                    ru-RU: Название игрового ключа
                  drm_sku: steam_key_1
                  prices:
                    - amount: 35.5
                      currency: USD
                      is_enabled: true
                      is_default: true
                  vc_prices:
                    - amount: 35.5
                      sku: com.xsolla.gold_1
                      is_enabled: true
                      is_default: true
                  is_enabled: true
                  is_free: false
                  is_show_in_store: true
                  pre_order:
                    release_date: '2020-08-11T10:00:00+03:00'
                    is_enabled: true
                    description: Some description
                  regions:
                    - id: 12
                    - id: 64
                  limits:
                    per_user:
                      total: 5
                    per_item:
                      total: 10000
                      available: 5000
                      reserved: 500
                      sold: 4500
                  periods:
                    - date_from: '2020-08-11T10:00:00+03:00'
                      date_until: '2020-08-11T20:00:00+03:00'
      description: Objeto con datos del juego.
      required: true
    Bundles_bundle:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Bundles_admin_bundle_request'
          example:
            sku: com.xsolla.armour_chest_1
            name:
              en: Chest of armour
              de: Brustpanzer
            is_enabled: true
            is_free: true
            is_paid_randomized_reward: true
            order: 1
            long_description:
              en: Chest of armour for soldiers
              de: Brustpanzer für Soldaten
            description:
              en: Chest of armour for soldiers
              de: Brustpanzer für Soldaten
            image_url: https://picture.bundle-with-many-stuff.png
            media_list:
              - type: image
                url: https://test.com/image0
              - type: image
                url: https://test.com/image1
            groups:
              - chests
            attributes:
              - external_id: class
                name:
                  en: Class
                values:
                  - external_id: soldier
                    value:
                      en: Soldier
                  - external_id: officer
                    value:
                      en: Officer
            prices:
              - currency: USD
                amount: '9.99'
                is_default: true
                is_enabled: true
              - currency: EUR
                amount: '9.99'
                is_default: false
                is_enabled: true
            vc_prices: []
            content:
              - sku: com.xsolla.iron_gloves_1
                quantity: 1
              - sku: com.xsolla.iron_boots_1
                quantity: 1
              - sku: com.xsolla.iron_shield_1
                quantity: 1
              - sku: com.xsolla.iron_armour_1
                quantity: 1
              - sku: com.xsolla.iron_helmet_1
                quantity: 1
            limits:
              per_user: null
              per_item: null
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            custom_attributes:
              type: lootbox
              purchased: 0
      description: Objeto con datos del lote.
      required: true
    Cart-Payment_fill-cart-json-model:
      content:
        application/json:
          schema:
            type: object
            required:
              - items
            example:
              items:
                - sku: com.xsolla.booster_mega_1
                  quantity: 123
            properties:
              items:
                type: array
                description: Lista de artículos.
                items:
                  type: object
                  minItems: 1
                  required:
                    - sku
                    - quantity
                  properties:
                    sku:
                      type: string
                      default: booster_mega_1
                    quantity:
                      type: number
                      default: 123
    Cart-Payment_put-item-by-cart-idJsonModel:
      content:
        application/json:
          schema:
            type: object
            properties:
              quantity:
                type: number
                description: Cantidad del artículo.
                default: 123
    Cart-Payment_create-order-by-cart-idJsonModel:
      content:
        application/json:
          schema:
            type: object
            properties:
              currency:
                type: string
                description: >-
                  Divisa del precio del pedido. Código de moneda 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/).
              locale:
                type: string
                description: Idioma de respuesta.
              sandbox:
                type: boolean
                description: >-
                  Crea un pedido en el modo aislador de proceso (sandbox). La
                  opción está disponible para los usuarios especificados en la
                  lista de usuarios de la empresa.
                default: false
              settings:
                type: object
                description: >-
                  Configuración del proceso de pago y de la interfaz de pago
                  para un usuario.
                additionalProperties: false
                properties:
                  ui:
                    $ref: '#/components/schemas/Cart-Payment_settings_ui'
                  payment_method:
                    $ref: '#/components/schemas/Cart-Payment_settings_payment_method'
                  return_url:
                    $ref: '#/components/schemas/Cart-Payment_settings_return_url'
                  redirect_policy:
                    $ref: '#/components/schemas/Cart-Payment_redirect_policy'
              custom_parameters:
                type: object
                description: Parámetros específicos del proyecto.
                minProperties: 1
                maxProperties: 200
          example:
            sandbox: true
            settings:
              ui:
                theme: 63295a9a2e47fab76f7708e1
                desktop:
                  header:
                    is_visible: true
                    visible_logo: true
                    visible_name: true
                    visible_purchase: true
                    type: normal
                    close_button: false
            custom_parameters:
              character_id: ingameUsername
    Cart-Payment_create-order-with-specified-item-idJsonModel:
      content:
        application/json:
          schema:
            type: object
            properties:
              currency:
                type: string
                description: >-
                  Divisa del precio del pedido. Código de moneda 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/).
              locale:
                type: string
                description: Idioma de respuesta.
              sandbox:
                type: boolean
                description: >-
                  Crea un pedido en el modo aislador de proceso (sandbox). La
                  opción está disponible para los usuarios especificados en la
                  lista de usuarios de la empresa.
                default: false
              quantity:
                type: integer
                minimum: 1
                description: Cantidad del artículo.
                default: 1
              promo_code:
                type: string
                description: >-
                  Canjea un código de una promoción de códigos promocionales con
                  pago.
              settings:
                type: object
                description: >-
                  Configuración del proceso de pago y de la interfaz de pago
                  para un usuario.
                additionalProperties: false
                properties:
                  ui:
                    $ref: '#/components/schemas/Cart-Payment_settings_ui'
                  payment_method:
                    $ref: '#/components/schemas/Cart-Payment_settings_payment_method'
                  return_url:
                    $ref: '#/components/schemas/Cart-Payment_settings_return_url'
                  redirect_policy:
                    $ref: '#/components/schemas/Cart-Payment_redirect_policy'
              custom_parameters:
                type: object
                description: Parámetros específicos del proyecto.
                minProperties: 1
                maxProperties: 200
          example:
            sandbox: true
            quantity: 5
            promo_code: discount_code
            settings:
              ui:
                theme: 63295a9a2e47fab76f7708e1
                desktop:
                  header:
                    is_visible: true
                    visible_logo: true
                    visible_name: true
                    visible_purchase: true
                    type: normal
                    close_button: false
            custom_parameters:
              character_id: ingameUsername
    admin-order-search:
      description: Parámetros de búsqueda de pedidos
      content:
        application/json:
          schema:
            type: object
            properties:
              limit:
                type: integer
                description: Un límite en la cantidad de pedidos incluidos en la respuesta.
                minimum: 1
                maximum: 10
                default: 10
                nullable: false
              offset:
                type: integer
                description: >-
                  Número del pedido a partir del cual se genera la lista (el
                  conteo empieza desde el 0).
                default: 0
                minimum: 0
                nullable: false
              created_date_from:
                type: string
                format: date-time
                nullable: false
                example: '2020-04-15T18:16:00+05:00'
                description: >-
                  Fecha de inicio o fecha-hora del periodo de creación de
                  pedidos de conformidad con la norma [ISO
                  8601](https://en.wikipedia.org/wiki/ISO_8601).
              created_date_until:
                type: string
                format: date-time
                nullable: false
                example: '2020-04-16T18:16:00+05:00'
                description: >-
                  Fecha final o fecha-hora del periodo de creación de pedidos de
                  conformidad con la norma [ISO
                  8601](https://en.wikipedia.org/wiki/ISO_8601).
          example:
            offset: 0
            limit: 5
            created_date_from: '2018-01-07T00:00:00+03:00'
            created_date_until: '2018-01-09T16:00:00+03:00'
    Cart-Payment_admin-create-payment-token:
      content:
        application/json:
          schema:
            type: object
            required:
              - user
              - purchase
            properties:
              sandbox:
                $ref: '#/components/schemas/Cart-Payment_settings_sandbox'
              user:
                $ref: '#/components/schemas/Cart-Payment_admin-user-request-body'
              purchase:
                $ref: '#/components/schemas/Cart_admin_payment'
              promo_code:
                $ref: '#/components/schemas/Promotions_coupon_code'
              settings:
                type: object
                description: >-
                  Configuración del proceso de pago y de la interfaz de pago
                  para un usuario.
                additionalProperties: false
                properties:
                  ui:
                    $ref: '#/components/schemas/Cart-Payment_settings_ui'
                  currency:
                    $ref: '#/components/schemas/Cart-Payment_settings_currency'
                  language:
                    $ref: '#/components/schemas/Cart-Payment_settings_locale'
                  external_id:
                    $ref: '#/components/schemas/Cart-Payment_settings_external_id'
                  payment_method:
                    $ref: '#/components/schemas/Cart-Payment_settings_payment_method'
                  return_url:
                    $ref: '#/components/schemas/Cart-Payment_settings_return_url'
                  redirect_policy:
                    $ref: '#/components/schemas/Cart-Payment_redirect_policy'
              custom_parameters:
                $ref: '#/components/schemas/Cart-Payment_custom_parameters_token'
            additionalProperties: false
          examples:
            common:
              value:
                user:
                  id:
                    value: user-id
                  name:
                    value: user-name
                  email:
                    value: user@xsolla.com
                  country:
                    value: US
                    allow_modify: false
                purchase:
                  items:
                    - sku: com.xsolla.cup01
                      quantity: 2
                    - sku: com.xsolla.t-shirt01
                      quantity: 1
                    - sku: com.xsolla.cup02
                      quantity: 1
                    - sku: com.xsolla.hat01
                      quantity: 1
                settings:
                  language: de
                  external_id: AABBCCDD01
                  currency: USD
                  payment_method: 1380
                  return_url: https://developers.xsolla.com/es/
                  ui:
                    theme: 63295aab2e47fab76f7708e3
            in-sandbox:
              value:
                sandbox: true
                user:
                  id:
                    value: user-id
                purchase:
                  items:
                    - sku: com.xsolla.cup01
                      quantity: 2
                    - sku: com.xsolla.t-shirt01
                      quantity: 1
                    - sku: com.xsolla.cup02
                      quantity: 1
                    - sku: com.xsolla.hat01
                      quantity: 1
                settings:
                  currency: USD
            with-custom-parameters:
              value:
                user:
                  id:
                    value: user-id
                  name:
                    value: user-name
                  email:
                    value: user@xsolla.com
                  country:
                    value: US
                    allow_modify: false
                purchase:
                  items:
                    - sku: com.xsolla.cup01
                      quantity: 2
                    - sku: com.xsolla.t-shirt01
                      quantity: 1
                    - sku: com.xsolla.cup02
                      quantity: 1
                    - sku: com.xsolla.hat01
                      quantity: 1
                settings:
                  language: de
                  external_id: AABBCCDD01
                  currency: USD
                  payment_method: 1380
                  return_url: https://developers.xsolla.com/es/
                  ui:
                    theme: 63295aab2e47fab76f7708e3
                custom_parameters:
                  user_public_id: player1
                  user_os: windows10
    Cart-Payment_admin-fill-cart-json-model:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Cart'
          examples:
            basic:
              value:
                currency: USD
                items:
                  - sku: com.xsolla.cup01
                    quantity: 2
                  - sku: com.xsolla.t-shirt01
                    quantity: 1
                  - sku: com.xsolla.cup02
                    quantity: 1
                  - sku: com.xsolla.hat01
                    quantity: 1
    reset-user-limits:
      content:
        application/json:
          schema:
            type: object
            required:
              - user
            properties:
              user:
                $ref: '#/components/schemas/User-limit_user'
          example:
            user:
              user_external_id: d342dad2-9d59-11e9-a384-42010aa8003f
    reset-user-limits-flexible:
      content:
        application/json:
          schema:
            type: object
            required:
              - user
            properties:
              user:
                $ref: '#/components/schemas/User-limit_user_flexible'
          example:
            user:
              user_external_id: d342dad2-9d59-11e9-a384-42010aa8003f
    update-user-limits-flexible:
      content:
        application/json:
          schema:
            type: object
            required:
              - user
              - available
            properties:
              user:
                $ref: '#/components/schemas/User-limit_user'
              available:
                $ref: '#/components/schemas/User-limit_available_flexible'
          example:
            user:
              user_external_id: d342dad2-9d59-11e9-a384-42010aa8003f
            available: 0
    update-user-limits-strict:
      content:
        application/json:
          schema:
            type: object
            required:
              - user
              - available
            properties:
              user:
                $ref: '#/components/schemas/User-limit_user'
              available:
                $ref: '#/components/schemas/User-limit_available'
          example:
            user:
              user_external_id: d342dad2-9d59-11e9-a384-42010aa8003f
            available: 1
    connector-import-items-body:
      content:
        application/json:
          schema:
            type: object
            required:
              - connector_external_id
              - file_url
            properties:
              connector_external_id:
                type: string
                description: >-
                  Valor fijo que especifica el tipo de operación para importar
                  artículos.
                enum:
                  - import_items
              file_url:
                type: string
                description: >-
                  La URL de un archivo con datos en formato JSON. El archivo
                  debe estar alojado en un servicio de almacenamiento con acceso
                  público. Puede descargar la plantilla del archivo en Cuenta
                  del editor en la sección [Store > Artículos virtuales >
                  Gestionar catálogo > Importar artículos
                  (JSON)](https://publisher.xsolla.com/0/projects/0/storefront/import-export/import-items).
                example: https://my-bucket.s3.amazonaws.com/items.json
              mode:
                type: string
                description: >-
                  Acciones de importación:


                  Valores posibles:

                  - `create` — Añadir nuevos artículos.

                  - `create_and_update` — Añadir nuevos artículos y actualizar
                  los existentes.

                  - `sync` — Añadir nuevos artículos, actualizar los existentes
                  y deshabilitar los que faltan.
                enum:
                  - create
                  - create_and_update
                  - sync
                default: create_and_update
    create-update-region:
      content:
        application/json:
          schema:
            type: object
            required:
              - countries
              - name
            properties:
              countries:
                $ref: '#/components/schemas/Regions_countries'
              name:
                $ref: '#/components/schemas/Regions_name'
            example:
              name:
                en-US: Asia
                de-DE: Asien
              countries:
                - JP
                - CN
                - VN
    create-update-attribute:
      content:
        application/json:
          schema:
            type: object
            required:
              - external_id
              - name
            properties:
              external_id:
                $ref: '#/components/schemas/admin-attribute-external_id'
              name:
                $ref: '#/components/schemas/admin-attribute-name'
          example:
            external_id: genre
            name:
              en: Genre
              de: Genre
    create-update-attribute-value:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/request-attribute-value'
          example:
            external_id: weapon_class_sword_value
            value:
              en: Sword
              de: Schwert
  examples:
    422-property-sku-is-required:
      value:
        statusCode: 422
        errorCode: 1102
        errorMessage: '[0401-1102]: Unprocessable Entity. The property `sku` is required'
        transactionId: da145238620011eb8e24fe6913ff226a
    422-numbers-of-attribute-values-per-item-exceeded:
      value:
        statusCode: 422
        errorCode: 9909
        errorMessage: >-
          [0401-9909]: The number of attribute values you specified for the item
          exceeds the required limit. Try to specify fewer attribute values.
        transactionId: da145238620011eb8e24fe6913ff226a
    422-numbers-of-attributes-per-item-exceeded:
      value:
        statusCode: 422
        errorCode: 9908
        errorMessage: >-
          [0401-9908]: The number of attributes you specified for the item
          exceeds the required limit. Try to specify fewer attributes.
        transactionId: da145238620011eb8e24fe6913ff226a
    422-value-limit-exceeded:
      value:
        statusCode: 422
        errorCode: 9908
        errorMessage: >-
          [0401-9908]: You reached the maximum number of values for the
          attribute.
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-custom-attributes-size-exceeded:
      value:
        statusCode: 422
        errorCode: 1102
        errorMessage: '[0401-1102]: Unprocessable Entity'
        transactionId: da145238620011eb8e24fe6913ff226a
        errorMessageExtended:
          - property: custom_attributes
            message: JSON can’t exceed 500 characters.
    200-admin-get-group-list:
      value:
        groups:
          - id: 1
            external_id: weapons
            name:
              en: Weapons
            description:
              en: Player weapons
            image_url: https://example.com/weapons.png
            order: 1
            is_enabled: true
            items_count: 5
          - id: 2
            external_id: swords
            name:
              en: Swords
            description:
              en: Melee weapons
            image_url: https://example.com/swords.png
            order: 2
            is_enabled: true
            items_count: 3
          - id: 3
            external_id: armor
            name:
              en: Armor
            description:
              en: Player armor
            image_url: https://example.com/armor.png
            order: 3
            is_enabled: true
            items_count: 4
    201-admin-create-group:
      value:
        external_id: weapons
    422-property-external-id-required:
      value:
        statusCode: 422
        errorCode: 1102
        errorMessage: '[0401-1102]: Unprocessable Entity'
        transactionId: x-x-x-x-transactionId-mock-x-x-x
        errorMessageExtended:
          - property: external_id
            message: The property external_id is required
    200-admin-get-group:
      value:
        id: 1
        external_id: weapons
        name:
          en: Weapons
        description:
          en: Player weapons
        image_url: https://example.com/weapons.png
        order: 1
        is_enabled: true
        items_count: 5
    200-admin-get-group-list-by-item-type:
      value:
        groups:
          - id: 1
            external_id: weapons
            name:
              en: Weapons
            description:
              en: Player weapons
            image_url: https://example.com/weapons.png
            order: 1
            is_enabled: true
            items_count: 3
            is_contains_any_items: true
          - id: 2
            external_id: swords
            name:
              en: Swords
            description:
              en: Melee weapons
            image_url: https://example.com/swords.png
            order: 2
            is_enabled: true
            items_count: 2
            is_contains_any_items: true
          - id: 3
            external_id: armor
            name:
              en: Armor
            description:
              en: Player armor
            image_url: https://example.com/armor.png
            order: 3
            is_enabled: true
            items_count: 0
            is_contains_any_items: false
    200-admin-get-group-by-item-type:
      value:
        id: 1
        external_id: weapons
        name:
          en: Weapons
        description:
          en: Player weapons
        image_url: https://example.com/weapons.png
        order: 1
        is_enabled: true
        items_count: 3
        is_contains_any_items: true
    404-game-code-not-found:
      value:
        statusCode: 404
        errorCode: 4603
        errorMessage: '[0401-4603]: Game code not found.'
        transactionId: transaction id
    422-drm-is-not-drm-free:
      value:
        statusCode: 422
        errorCode: 5103
        errorMessage: '[0401-5103]: Selected drm is not drmfree.'
        transactionId: transaction id
    422-user-already-has-entitlement:
      value:
        statusCode: 422
        errorCode: 5101
        errorMessage: '[0401-5101]: User already has entitlement.'
        transactionId: transaction id
    Bundles_200-get-bundle-list:
      value:
        has_more: true
        items:
          - item_id: 61031
            sku: com.xsolla.kg_1
            name: kg_10.00_bundle
            type: bundle
            description: pricePoint_44056_1
            image_url: null
            long_description: null
            attributes:
              - external_id: genre
                name: Genre
                values:
                  - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
                    value: Casual
                  - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
                    value: Strategy
                  - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
                    value: Mobile
            is_free: false
            order: 999
            groups:
              - external_id: exclusive
                name: Exclusive
                item_order_in_group: 1
            price:
              amount: '9.99'
              currency: USD
              amount_without_discount: '9.99'
            total_content_price:
              amount: '10.99'
              currency: USD
              amount_without_discount: '10.99'
            media_list: []
            virtual_prices: []
            can_be_bought: true
            bundle_type: standard
            promotions: []
            limits:
              per_user:
                total: 5
                available: 3
                recurrent_schedule:
                  interval_type: weekly
                  reset_next_date: 1746057600
                limit_exceeded_visibility: show
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            custom_attributes:
              purchased: 0
              attr: value
            content:
              - sku: com.xsolla.big_rocket_1
                name: Big Rocket
                description: Big Rocket - short description.
                image_url: >-
                  https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                type: virtual_currency
                quantity: 100
                virtual_item_type: non_consumable
                attributes:
                  - external_id: size
                    name: Size
                    values:
                      - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                        value: Large
                is_free: false
                groups: []
                price:
                  amount: '10.99'
                  currency: USD
                  amount_without_discount: '10.99'
                virtual_prices: []
                limits:
                  per_user:
                    total: 5
                    available: 3
                    recurrent_schedule:
                      interval_type: weekly
                      reset_next_date: 1746057600
                    limit_exceeded_visibility: show
            vp_rewards:
              - item_id: 175232
                sku: com.xsolla.value_point_1
                amount: 130
                name: Value point
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
              - item_id: 186321
                sku: com.xsolla.clan_value_point_1
                amount: 50
                name: Clan Reward VP 1
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                is_clan: true
    Bundles_200-get-bundle:
      value:
        item_id: 610316
        sku: com.xsolla.kg_1
        name: kg_10.00_bundle
        type: bundle
        description: pricePoint_44056_1.
        image_url: null
        long_description: null
        attributes: []
        is_free: false
        order: 999
        groups: []
        price:
          amount: '9.99'
          currency: USD
          amount_without_discount: '9.99'
        total_content_price:
          amount: '10.99'
          currency: USD
          amount_without_discount: '10.99'
        media_list: []
        virtual_prices: []
        promotions: []
        limits:
          per_user:
            total: 5
            available: 3
            recurrent_schedule:
              interval_type: weekly
              reset_next_date: 1746057600
            limit_exceeded_visibility: show
        can_be_bought: true
        bundle_type: standard
        periods:
          - date_from: '2020-08-11T10:00:00+03:00'
            date_until: '2020-08-11T20:00:00+03:00'
        custom_attributes:
          purchased: 0
          attr: value
        content:
          - description: Big Rocket - short description.
            image_url: >-
              https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
            sku: com.xsolla.big_rocket_1
            name: Big Rocket
            type: virtual_currency
            quantity: 100
            attributes: []
            is_free: false
            groups: []
            price:
              amount: '10.99'
              currency: USD
              amount_without_discount: '10.99'
            virtual_prices: []
            limits:
              per_user:
                total: 5
                available: 3
                recurrent_schedule:
                  interval_type: weekly
                  reset_next_date: 1746057600
                limit_exceeded_visibility: show
        vp_rewards:
          - item_id: 175232
            sku: com.xsolla.value_point_1
            amount: 130
            name: Value point
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
          - item_id: 186321
            sku: com.xsolla.clan_value_point_1
            amount: 50
            name: Clan Reward VP 1
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
            is_clan: true
    404-item-by-sku-not-found:
      value:
        statusCode: 404
        errorCode: 4001
        errorMessage: '[0401-4001]: Item with sku = ''item_sku'' not found'
        transactionId: transaction id
    404-coupon-not-found:
      value:
        statusCode: 404
        errorCode: 9802
        errorMessage: '[0401-9802]: Coupon not found'
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-user-not-found:
      value:
        statusCode: 404
        errorCode: 5008
        errorMessage: '[0401-5008]: Could not find User'
        transactionId: transaction id
    422-user_external_id_invalid:
      value:
        statusCode: 404
        errorCode: 1102
        errorMessage: '[0401-1102]: Unprocessable Entity'
        transactionId: transaction id
        errorMessageExtended:
          - property: user_external_id
            message: Must be at least 1 characters long
          - property: user_external_id
            message: Does not match the regex pattern ^\S+$
    422-item-without-user-limit:
      value:
        statusCode: 422
        errorCode: 4508
        errorMessage: '[0401-4508]: Item does not have configured user limits.'
        transactionId: transaction id
    422-item-out-of-range-available-user-limit:
      value:
        statusCode: 422
        errorCode: 4510
        errorMessage: '[0401-4510]: Available item limit is out of range.'
        transactionId: transaction id
    422-external-id-required:
      value:
        statusCode: 422
        errorCode: 9901
        errorMessage: >-
          [0401-1102]: Unprocessable Entity. The property `external_id` is
          required
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-external-id-invalid:
      value:
        statusCode: 422
        errorCode: 9901
        errorMessage: >-
          [0401-1102]: Unprocessable Entity. Does not match the regex pattern
          ^[a-zA-Z0-9-_]+$
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-external-id-duplicate:
      value:
        statusCode: 422
        errorCode: 9907
        errorMessage: '[0401-9907]: The attribute value already exists.'
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-value-invalid:
      value:
        statusCode: 422
        errorCode: 9901
        errorMessage: '[0401-1102]: Unprocessable Entity. The property `value` is required'
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-value-properties-required:
      value:
        statusCode: 422
        errorCode: 9901
        errorMessage: >-
          [0401-1102]: Unprocessable Entity. Array value found, but an object is
          required
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-attribute-not-found:
      value:
        statusCode: 404
        errorCode: 9901
        errorMessage: '[0401-9901]: Attribute not found.'
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-attribute-value-not-found:
      value:
        statusCode: 404
        errorCode: 9906
        errorMessage: '[0401-9906]: Attribute value not found.'
        transactionId: x-x-x-x-transactionId-mock-x-x-x
x-tagGroups:
  - name: ARTÍCULOS VIRTUALES Y MONEDA
    tags:
      - virtual-items-currency-overview
      - virtual-items-currency-admin
      - virtual-items-currency-catalog
      - virtual-payment
  - name: CLAVES DE JUEGO
    tags:
      - game-keys-overview
      - game-keys-catalog
      - game-keys-entitlement
      - game-keys-admin
  - name: LOTES
    tags:
      - bundles-overview
      - bundles-admin
      - bundles-catalog
  - name: CESTA Y PAGO
    tags:
      - cart-and-payment-overview
      - order-life-cycle
      - cart-client-side
      - cart-server-side
      - payment-client-side
      - payment-server-side
      - order
      - free-item
  - name: LÍMITES
    tags:
      - limits-overview
      - user-limits-admin
  - name: IMPORTACIÓN DE ARTÍCULOS
    tags:
      - connector-admin
  - name: COMÚN
    tags:
      - common-pre-orders
      - common-merchant
      - common-catalog
      - common-regions
      - common-webhooks
  - name: ATRIBUTOS DE ARTÍCULOS
    tags:
      - attribute-admin
  - name: GRUPOS DE ARTÍCULOS
    tags:
      - item-groups-admin
      - item-groups-catalog
