{ "openapi": "3.0.0", "info": { "description": "# Información general\n\nDigital Distribution Hub es una nueva solución de Xsolla que tiene por objetivo conectar los pagos digitales y en efectivo a través de la tecnología de pagos únicos inmediatos ('push') y de comercio electrónico.\n\nEsta referencia combina puntos finales de API para dos productos de Xsolla: [In-Game Store](https://developers.xsolla.com/es/doc/in-game-store/) y [Pay Station](https://developers.xsolla.com/es/doc/pay-station/). Hay dos URL base:\n\n* `https://store.xsolla.com/api` para los grupos **Common**, **Catalog**, **Cart**, y **Order**.\n* `https://ps.xsolla.com` para el grupo **Notifications**.\n\nLos puntos finales de API en el grupo **Catalog** no requieren autorización. \n\nPara realizar operaciones en los grupos **Cart** y **Order**, necesita generar un token a través de [Create user token](https://developers.xsolla.com/es/digital-distribution-hub/common/user-token/create-user-token).\n\n
Nota

Esta referencia muestra un diseño de una futura API y no una interfaz plenamente funcional. Actualmente, solo puede probar los puntos finales de los grupos Catalog y Notifications. Si desea compartir sus comentarios, envíenos un correo electrónico a techdoc@xsolla.com.
", "title": "Digital Distribution Hub", "version": "1.0.0" }, "servers": [ { "url": "https://store.xsolla.com/api" } ], "tags": [ { "name": "cart", "x-displayName": "Cesta" }, { "name": "game keys", "x-displayName": "Claves del juego" }, { "name": "virtual items & currency", "x-displayName": "Árticulos y moneda virtuales" }, { "name": "bundles", "x-displayName": "Lotes" }, { "name": "user token", "x-displayName": "Token del usuario" }, { "name": "notifications", "x-displayName": "Notificaciones" }, { "name": "order", "x-displayName": "Pedido" } ], "paths": { "/push-payments/cancel": { "post": { "description": "Envíe la notificación sobre la cancelación del pago si: \n - el pago no se completó\n - el pago fue reembolsado", "operationId": "cancel-notification", "requestBody": { "content": { "application/json": { "example": { "payment_id": 784998479 }, "schema": { "properties": { "payment_id": { "type": "integer" } }, "required": [ "payment_id" ], "type": "object" } } } }, "responses": { "200": { "description": "OK (ACEPTAR)." }, "400": { "description": "Bad Request (Solicitud errónea)." }, "403": { "description": "Access denied (Acceso denegado)." }, "404": { "description": "Payment not found (Pago no encontrado)." }, "409": { "description": "Payment is already cancelled (El pago ya está cancelado)." }, "422": { "description": "Error while cancelling payment (Error al cancelar el pago)." }, "500": { "description": "Internal server error (Error interno del servidor)." } }, "servers": [ { "url": "https://ps.xsolla.com" } ], "summary": "Cancel notification (Cancelar notificación)", "tags": [ "notifications" ] } }, "/push-payments/pay": { "post": { "description": "Envía esta notificación después de cobrar un importe correctamente a un usuario.", "operationId": "pay-notification", "requestBody": { "content": { "application/json": { "example": { "payment": { "amount": 10, "currency": "USD", "geotype_id": 13038, "ps_transaction_id": "ps_transaction_id" }, "project_id": 18404, "purchase": { "order_id": 1334430 }, "user": { "id": "s.ivanov" } }, "schema": { "properties": { "payment": { "properties": { "amount": { "description": "Importe del pago.", "type": "number" }, "currency": { "description": "Moneda del pedido. La moneda virtual utiliza el código de artículo (SKU) y la moneda real utiliza un código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "type": "string" }, "geotype_id": { "description": "ID de socio distribuidor en el lado de Xsolla.", "type": "integer" }, "project_transaction_id": { "description": "ID de transacción del lado del desarrollador del juego.", "type": "string" }, "ps_transaction_id": { "description": "ID de transacción del lado del socio de distribución.", "type": "string" } }, "required": [ "geotype_id", "amount" ], "type": "object" }, "project_id": { "description": "ID del proyecto.", "type": "integer" }, "purchase": { "properties": { "order_id": { "description": "ID del pedido.", "type": "integer" } }, "required": [ "order_id" ], "type": "object" }, "user": { "properties": { "email": { "description": "Dirección de correo electrónico del usuario.", "type": "string" }, "id": { "description": "Identificador único del usuario en el juego.", "type": "string" }, "phone": { "description": "Número de teléfono del usuario.", "type": "string" }, "ps_account_id": { "description": "ID de la cuenta de pago del usuario en el lado del socio de distribución.", "type": "string" } }, "required": [ "id" ], "type": "object" } }, "required": [ "project_id", "payment", "purchase", "user" ], "type": "object" } } } }, "responses": { "200": { "content": { "application/json": { "example": { "payment_id": 784998484 }, "schema": { "properties": { "payment_id": { "type": "integer" } }, "type": "object" } } }, "description": "OK (ACEPTAR)." }, "400": { "description": "Bad Request (Solicitud errónea)." }, "403": { "description": "Access denied (Acceso denegado)." }, "404": { "description": "Pedido no encontrado." }, "409": { "description": "El pedido ya está pagado." }, "422": { "description": "Error al crear el pago." }, "500": { "description": "Internal server error (Error interno del servidor)." } }, "servers": [ { "url": "https://ps.xsolla.com" } ], "summary": "Notificación de pago", "tags": [ "notifications" ] } }, "/v2/project/{project_id}/cart": { "get": { "description": "Devuelve la cesta del usuario actual.", "operationId": "get-user-cart", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/currency-query-param" }, { "$ref": "#/components/parameters/locale-query-param" } ], "responses": { "200": { "content": { "application/json": { "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", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" } } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_200" } } }, "description": "La cesta con artículos se devolvió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener la cesta del usuario actual", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/clear": { "put": { "description": "Elimina todos los artículos de la cesta.", "operationId": "cart-clear", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "responses": { "204": { "description": "La cesta se vació correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Eliminar todos los artículos de la cesta actual", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/fill": { "put": { "description": "Llena la cesta con artículos. Si la cesta ya tiene un artículo con el mismo código de artículo (SKU), el artículo existente se sustituirá por el valor transmitido.", "operationId": "cart-fill", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/fill-cart-json-model" }, "responses": { "200": { "content": { "application/json": { "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", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" }, "warnings": [ { "errorCode": 4001, "errorMessage": "[0401-4001]: Item with Project Id = 44056 and Sku = booster_mega_2 not found", "quantity": 1, "sku": "booster_mega_21" } ] } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_200_1" } } }, "description": "La cesta con artículos se devolvió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Llenar la cesta con artículos", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/item/{item_sku}": { "delete": { "description": "Elimina un artículo de la cesta.", "operationId": "delete-item", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "responses": { "204": { "description": "El artículo de la cesta se eliminó correctamente." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cart_inline_response_404" } } }, "description": "Artículo no encontrado. Asegúrese de que el `project_id` y el `item_sku` sean correctos." } }, "security": [ { "AuthForClient": [] } ], "summary": "Eliminar artículo de la cesta actual", "tags": [ "cart" ] }, "put": { "description": "Actualiza un artículo de la cesta existente o crea uno de la cesta.", "operationId": "put-item", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/put-item-by-cart-id-json-model" }, "responses": { "204": { "description": "La cesta se actualizó correctamente." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cart_inline_response_404" } } }, "description": "Artículo no encontrado. Asegúrese de que el `project_id` y el `item_sku` sean correctos." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1421, "errorMessage": "Only Virtual Good Supported", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_422_1" } } }, "description": "Este tipo de artículo no se puede colocar en la cesta. Seleccione otro tipo de artículo." } }, "security": [ { "basicAuth": [] } ], "summary": "Actualizar artículo de la cesta actual", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/{cart_id}": { "get": { "description": "Devuelve la cesta del usuario por el ID de la cesta.", "operationId": "get-cart-by-id", "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" } ], "responses": { "200": { "content": { "application/json": { "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", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" } } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_200" } } }, "description": "La cesta con artículos se devolvió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener cesta por el ID de la cesta", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/{cart_id}/clear": { "put": { "description": "Elimina todos los artículos de la cesta.", "operationId": "cart-clear-by-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" } ], "responses": { "204": { "description": "La cesta se vació correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Eliminar todos los artículos de la cesta por el ID de la cesta", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/{cart_id}/fill": { "put": { "description": "Llena la cesta específica con artículos. Si la cesta ya contiene un artículo con el mismo código de artículo (SKU), la posición del artículo existente se sustituirá por el valor transmitido.", "operationId": "cart-fill-by-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/fill-cart-json-model" }, "responses": { "200": { "content": { "application/json": { "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", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" }, "warnings": [ { "errorCode": 4001, "errorMessage": "[0401-4001]: Item with Project Id = 44056 and Sku = booster_mega_2 not found", "quantity": 1, "sku": "booster_mega_21" } ] } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_200_1" } } }, "description": "La cesta con artículos se devolvió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Llenar la cesta específica con artículos", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/{cart_id}/item/{item_sku}": { "delete": { "description": "Elimina un artículo de la cesta.", "operationId": "delete-item-by-cart-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "responses": { "204": { "description": "El artículo de la cesta se eliminó correctamente." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cart_inline_response_404" } } }, "description": "Artículo no encontrado. Asegúrese de que el `project_id` y el `item_sku` sean correctos." } }, "security": [ { "AuthForClient": [] } ], "summary": "Eliminar artículo de la cesta por ID de la cesta", "tags": [ "cart" ] }, "put": { "description": "Actualiza un artículo de la cesta existente o crea uno de la cesta.", "operationId": "put-item-by-cart-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/put-item-by-cart-id-json-model" }, "responses": { "204": { "description": "La cesta se actualizó correctamente." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cart_inline_response_404" } } }, "description": "Artículo no encontrado. Asegúrese de que el `project_id` y el `item_sku` sean correctos." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1102, "errorMessage": "[0401-1102]: Item quantity must be non-negative integer", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_422" } } }, "description": "La cantidad del artículo debe ser un número entero no negativo." } }, "security": [ { "basicAuth": [] } ], "summary": "Actualizar artículo de la cesta por ID de la cesta", "tags": [ "cart" ] } }, "/v2/project/{project_id}/distribution_hub/order/{order_id}": { "get": { "description": "Recupera un pedido especificado.", "operationId": "get-order", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/order-id-path-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "content": { "is_free": "false", "items": [ { "is_free": false, "price": { "amount": "30", "amount_without_discount": "30", "currency": "USD" }, "quantity": 1, "sku": "some_sku" } ], "price": { "amount": "30", "amount_without_discount": "30", "currency": "USD" } }, "order_id": 1, "status": "paid" } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_200_1" } } }, "description": "Solicitud de pedido aceptada." }, "404": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 9001, "errorMessage": "[0401-9001]: Order not found", "statusCode": 404 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_404" } } }, "description": "Pedido no encontrado. Asegúrese de que el `project_id` y el `order_id` son correctos." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener pedido", "tags": [ "order" ] } }, "/v2/project/{project_id}/distribution_hub/payment/cart": { "post": { "description": "Crea un pedido con todos los artículos de la cesta. El pedido creado obtendrá el estado de pedido `new`.", "operationId": "create-order", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/create-order-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "billing_info": { "direct_taxes": [ { "amount": 150, "name": "TAX", "rate": 10 } ], "indirect_taxes": [ { "amount": 246.75, "name": "VAT", "rate": 20 } ], "price": { "amount": 1480.45, "currency": "USD" } }, "order_id": 641 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_200" } } }, "description": "El pedido se creó correctamente." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1401, "errorMessage": "[0401-1401]: Invalid cart", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_422" } } }, "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." } }, "security": [ { "AuthForClient": [] } ], "summary": "Crear pedido con todos los artículos de la cesta actual", "tags": [ "order" ] } }, "/v2/project/{project_id}/distribution_hub/payment/cart/{cart_id}": { "post": { "description": "Crea un pedido con todos los artículos de la cesta específica. El pedido creado obtendrá el estado de pedido `new`.", "operationId": "create-order-by-cart-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/create-order-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "billing_info": { "direct_taxes": [ { "amount": 150, "name": "TAX", "rate": 10 } ], "indirect_taxes": [ { "amount": 246.75, "name": "VAT", "rate": 20 } ], "price": { "amount": 1480.45, "currency": "USD" } }, "order_id": 641 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_200" } } }, "description": "El pedido se creó correctamente." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1401, "errorMessage": "[0401-1401]: Invalid cart", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_422" } } }, "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." } }, "security": [ { "AuthForClient": [] } ], "summary": "Crear pedido con todos los artículos de una cesta específica", "tags": [ "order" ] } }, "/v2/project/{project_id}/distribution_hub/payment/item/{item_sku}": { "post": { "description": "Crea un pedido con un artículo especificado. El pedido creado obtendrá el estado de pedido `new`.", "operationId": "create-order-with-item", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/create-order-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "billing_info": { "direct_taxes": [ { "amount": 150, "name": "TAX", "rate": 10 } ], "indirect_taxes": [ { "amount": 246.75, "name": "VAT", "rate": 20 } ], "price": { "amount": 1480.45, "currency": "USD" } }, "order_id": 641 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_200" } } }, "description": "El pedido se creó correctamente." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1411, "errorMessage": "[0401-1411]: Invalid item", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_422_1" } } }, "description": "Artículo no válido. Compruebe que el artículo existe, no esté desactivado, eliminado ni es gratuito." } }, "security": [ { "AuthForClient": [] } ], "summary": "Crear pedido con un artículo especificado", "tags": [ "order" ] } }, "/v2/project/{project_id}/distribution_hub/user/auth": { "post": { "description": "Verifica que un usuario existe en el juego y crea un token de usuario.", "operationId": "create-user-token", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/post-user-token-json-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" } } }, "schema": { "$ref": "#/components/schemas/Common_inline_response_200_1" } } }, "description": "Token de usuario recibido correctamente." } }, "security": [ { "basicAuth": [] } ], "summary": "Crear token de usuario", "tags": [ "user token" ] } }, "/v2/project/{project_id}/items/bundle": { "get": { "description": "Obtiene una lista de lotes para generar un catálogo.\n\n
Atención. Todos los proyectos tienen la limitación del número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es 50 artículos por respuesta.
", "operationId": "get-bundle-list", "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" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "$ref": "#/components/examples/200-get-bundle-list" } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_10" } } }, "description": "La lista de lotes se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener lista de lotes", "tags": [ "bundles" ] } }, "/v2/project/{project_id}/items/bundle/sku/{sku}": { "get": { "description": "Obtiene un lote especificado.", "operationId": "get-bundle", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/sku-path-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "$ref": "#/components/examples/200-get-bundle" } }, "schema": { "$ref": "#/components/schemas/Catalog_client_bundle" } } }, "description": "El lote especificado se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener el lote especificado", "tags": [ "bundles" ] } }, "/v2/project/{project_id}/items/game": { "get": { "description": "Obtiene una lista de juegos para crear un catálogo.\n\n
Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.
", "operationId": "get-games-list", "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" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" }, { "attributes": [ { "external_id": "OS", "name": "OS", "values": [ { "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723", "value": "Windows" } ] } ], "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_2", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_01", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200" } } }, "description": "La lista de juegos se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener lista de juegos", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/drm": { "get": { "description": "Obtiene la lista de sistemas de DRM (gestión de derechos digitales) disponibles.", "operationId": "get-drm-list", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "drm": [ { "drm_id": 1, "image": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "link": "https://support.steampowered.com", "name": "Steam", "redeem_instruction_link": "https://support.steampowered.com", "sku": "steam" }, { "drm_id": 2, "image": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Playstation", "redeem_instruction_link": "https://support.us.playstation.com", "sku": "playstation" } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_4" } } }, "description": "La lista de sistemas de DRM se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener lista de sistemas de DRM", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/group/{external_id}": { "get": { "description": "Obtiene una lista de juegos del grupo especificado para crear un catálogo.\n\n
Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.
", "operationId": "get-games-group", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/external-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" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" }, { "attributes": [ { "external_id": "OS", "name": "OS", "values": [ { "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723", "value": "Windows" } ] } ], "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_2", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_01", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200" } } }, "description": "La lista de juegos se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener lista de juegos por grupo especificado", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/key/group/{external_id}": { "get": { "description": "Obtiene una lista de claves del juego del grupo especificado para crear un catálogo.\n\n
Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.
", "operationId": "get-game-keys-group", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/external-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" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": true, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_1", "type": "game_key", "virtual_prices": [] }, { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": false, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_2", "type": "game_key", "virtual_prices": [] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_3" } } }, "description": "La lista de claves del juego se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener la lista de claves del juego por grupo especificado", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/key/sku/{item_sku}": { "get": { "description": "Obtiene una clave del juego para el catálogo.", "operationId": "get-game-key-by-sku", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": true, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_1", "type": "game_key", "virtual_prices": [] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_2" } } }, "description": "La clave del juego se recibió correctamente." }, "404": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 4001, "errorMessage": "[0401-4001]: Item with sku = 'game_key_1' not found", "statusCode": 404 } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_404_1" } } }, "description": "No se encontró la clave del juego." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener clave del juego para el catálogo", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/sku/{item_sku}": { "get": { "description": "Obtiene un juego para el catálogo.", "operationId": "get-game-by-sku", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_1" } } }, "description": "El juego se recibió correctamente." }, "404": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 4001, "errorMessage": "[0401-4001]: Item with sku = 'game_1' not found", "statusCode": 404 } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_404" } } }, "description": "Juego no encontrado." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener juego para el catálogo", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/groups": { "get": { "description": "Obtiene una lista de grupos de artículos para crear un catálogo.", "operationId": "get-item-groups", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "groups": [ { "children": [], "description": "Accessory", "external_id": "accessory", "level": 0, "name": "Accessory", "order": 1 }, { "children": [], "description": "Background", "external_id": "background", "level": 0, "name": "Background", "order": 1 }, { "children": [], "description": "Hair", "external_id": "hair", "level": 0, "name": "Hair", "order": 1 }, { "children": [], "description": "Outfit", "external_id": "outfit", "level": 0, "name": "Outfit", "order": 1 }, { "children": [], "description": "Body", "external_id": "body", "level": 0, "name": "Body", "order": 1 }, { "children": [], "description": "Body", "external_id": "delete_group", "level": 0, "name": "Body", "order": 1 }, { "children": [ { "children": [], "description": "Group description", "external_id": "test_group_secure", "image_url": "http://static.xsolla.com/img/xsolla-logo2.png", "level": 1, "name": "Test group secure", "order": 5, "parent_external_id": "very_cool_group" } ], "description": "Very cool group", "external_id": "very_cool_group", "level": 0, "name": "Very cool group", "order": 1 }, { "children": [ { "children": [], "description": "Group description", "external_id": "test_group_split", "image_url": "http://static.xsolla.com/img/xsolla-logo2.png", "level": 1, "name": "Test group secure", "order": 1, "parent_external_id": "test_group_secure" } ], "description": "Group description", "external_id": "test_group_secure", "image_url": "http://static.xsolla.com/img/xsolla-logo2.png", "level": 0, "name": "Test group secure", "order": 1 } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_9" } } }, "description": "La lista de grupos se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener lista de grupos de artículos", "tags": [ "virtual items & currency" ] } }, "/v2/project/{project_id}/items/virtual_currency": { "get": { "description": "Obtiene una lista de monedas virtuales para crear un catálogo.\n\n
Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.
", "operationId": "get-virtual-currency", "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" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] } ], "description": "Big Rocket - short description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_currency", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85", "value": "3.9" } ] } ], "description": "description", "groups": [ { "external_id": "hair", "name": "Hair" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_currency", "virtual_prices": [] }, { "attributes": [], "description": "description", "groups": [], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider_2", "type": "virtual_currency", "virtual_prices": [] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_6" } } }, "description": "La lista de monedas virtuales se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener lista de monedas virtuales", "tags": [ "virtual items & currency" ] } }, "/v2/project/{project_id}/items/virtual_currency/package": { "get": { "description": "Obtiene una lista de paquetes de moneda virtual para crear un catálogo.\n\n
Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.
", "operationId": "get-virtual-currency-package", "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" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": "Big Rocket - short description", "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "Big Rocket", "quantity": 100, "sku": "big_rocket", "type": "virtual_currency" } ], "description": "VC Short Package Description", "groups": [], "image_url": "http://vc_package_image.png", "is_free": false, "name": "VC Name first package", "price": { "amount": "2.0000", "amount_without_discount": "2.0000", "currency": "USD" }, "sku": "vc_package_1", "type": "bundle", "virtual_prices": [] }, { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": "description", "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "SHOTGUN FOR TRUE RAIDERS", "quantity": 200, "sku": "shotgun_raider", "type": "virtual_currency" } ], "description": "VC Short Package Description", "groups": [], "image_url": "http://vc_package_image.png", "is_free": false, "name": "VC Name third package", "price": { "amount": "4.0000", "amount_without_discount": "4.0000", "currency": "USD" }, "sku": "vc_package_3", "type": "bundle", "virtual_prices": [] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_7" } } }, "description": "La lista de paquetes de moneda virtual se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener la lista de paquetes de moneda virtual", "tags": [ "virtual items & currency" ] } }, "/v2/project/{project_id}/items/virtual_items": { "get": { "description": "Obtiene una lista de artículos virtuales para crear un catálogo.\n\n
Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.
", "operationId": "get-virtual-items", "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" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] } ], "description": "Big Rocket - description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85", "value": "3.9" } ] } ], "description": "description", "groups": [ { "external_id": "hair", "name": "Hair" } ], "image_url": "http://image.png", "inventory_options": [ { "consumable": [ { "usages_count": 1 } ] }, { "expiration_period": [ { "type": "day" }, { "value": 1 } ] } ], "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" }, { "amount": 200, "amount_without_discount": 200, "description": "description", "image_url": "http://image.png", "is_default": false, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test_2", "type": "virtual_currency" } ] }, { "attributes": [], "description": "description", "groups": [], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider_2", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_5" } } }, "description": "La lista de artículos virtuales se recibió correctamente." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener lista de artículos virtuales", "tags": [ "virtual items & currency" ] } }, "/v2/project/{project_id}/items/virtual_items/group/{external_id}": { "get": { "description": "Obtiene una lista de artículos del grupo especificado para crear un catálogo.\n\n
Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.
", "operationId": "get-virtual-items-group", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/external-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" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] } ], "description": "Big Rocket - description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85", "value": "3.9" } ] } ], "description": "description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" }, { "amount": 200, "amount_without_discount": 200, "description": "description", "image_url": "http://image.png", "is_default": false, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test_2", "type": "virtual_currency" } ] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_8" } } }, "description": "Se recibió correctamente la lista de artículos del grupo especificado." }, "404": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 4403, "errorMessage": "[0401-4403]: Item group not found", "statusCode": 404 } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_404_2" } } }, "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." } }, "security": [ { "AuthForClient": [] } ], "summary": "Obtener lista de artículos por grupo especificado", "tags": [ "virtual items & currency" ] } } }, "components": { "securitySchemes": { "AuthForClient": { "description": "Utilice el punto final [Create user token](https://developers.xsolla.com\\/es/api/digital-distribution-hub/operation/create-user-token) para generar un token.", "scheme": "bearer", "type": "http" }, "basicAuth": { "description": "La API de Xsolla usa una autenticación básica de acceso. Todas las solicitudes a la API deben contener el encabezado `Authorization: Basic `, en el cual `your_authorization_basic_key` es el par `distribution_hub_id:api_key` codificado según el estándar Base64. \n\nContacte con su gestor de cuenta para obtener `distribution_hub_id` y `api_key`.", "scheme": "basic", "type": "http" } }, "parameters": { "project-id-path-param": { "description": "ID del proyecto.", "explode": false, "in": "path", "name": "project_id", "required": true, "schema": { "example": 44056, "type": "integer" }, "style": "simple" }, "currency-query-param": { "description": "Moneda en la que se muestran los precios (USD por defecto). Código de moneda de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "explode": true, "in": "query", "name": "currency", "required": false, "schema": { "default": "USD", "type": "string" }, "style": "form" }, "locale-query-param": { "description": "Idioma de respuesta. Código de idioma de dos letras minúsculas según la norma ISO 639-1.", "explode": true, "in": "query", "name": "locale", "required": false, "schema": { "default": "en", "type": "string" }, "style": "form" }, "item-sku-path-param": { "description": "Código (SKU) del artículo.", "explode": false, "in": "path", "name": "item_sku", "required": true, "schema": { "example": "booster_mega_1", "type": "string" }, "style": "simple" }, "cart-id-path-param": { "description": "ID de la cesta.", "explode": false, "in": "path", "name": "cart_id", "required": true, "schema": { "example": "custom_id", "type": "string" }, "style": "simple" }, "order-id-path-param": { "description": "ID del pedido.", "explode": false, "in": "path", "name": "order_id", "required": true, "schema": { "example": "656", "type": "string" }, "style": "simple" }, "limit-query-param": { "description": "Límite para el número de elementos presentes en la página.", "example": 50, "explode": true, "in": "query", "name": "limit", "required": false, "schema": { "example": 50, "type": "integer" }, "style": "form" }, "offset-query-param": { "description": "Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).", "example": 0, "explode": true, "in": "query", "name": "offset", "required": false, "schema": { "example": 0, "type": "integer" }, "style": "form" }, "additional-fields-query-param": { "description": "Lista de campos adicionales. Estos campos estarán en la respuesta si los envía en su solicitud. Campos disponibles `media_list`, `order` y `long_description`.", "explode": true, "in": "query", "name": "additional_fields[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" }, "style": "form" }, "country-query-param": { "description": "País para calcular los precios regionales y las restricciones del catálogo. Código de país de dos letras en mayúscula según la norma [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Si no especifica el país explícitamente, se calculará en función de la dirección IP del usuario.", "explode": true, "in": "query", "name": "country", "required": false, "schema": { "default": "US", "type": "string" }, "style": "form" }, "sku-path-param": { "description": "Código de artículo (SKU) del lote.", "explode": false, "in": "path", "name": "sku", "required": true, "schema": { "example": "kg_1", "type": "string" }, "style": "simple" }, "external-id-path-param": { "description": "ID externo del grupo.", "explode": false, "in": "path", "name": "external_id", "required": true, "schema": { "default": "all", "type": "string" }, "style": "simple" } }, "schemas": { "Cart_admin-attribute-external_id": { "description": "ID único del atributo. `external_id` solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.", "example": "attribute_1", "maxLength": 255, "minLength": 1, "pattern": "^[a-zA-Z0-9-_]+$", "type": "string" }, "Cart_value-external_id": { "description": "ID de valor único para un atributo. `external_id` solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.", "example": "attribute_value", "maxLength": 255, "minLength": 1, "pattern": "^[-_.\\d\\w]+$", "type": "string" }, "Cart_clientattributes_inner": { "properties": { "external_id": { "$ref": "#/components/schemas/Cart_admin-attribute-external_id" }, "name": { "description": "Nombre del atributo.", "example": "Genre", "type": "string" }, "values": { "items": { "properties": { "external_id": { "$ref": "#/components/schemas/Cart_value-external_id" }, "value": { "description": "Valor del atributo.", "example": "Strategy", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "Cart_client-attributes": { "default": [], "description": "Lista de atributos y sus valores correspondientes al artículo. Puede utilizarse para el filtrado de catálogos.", "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" } ] } }, "items": { "$ref": "#/components/schemas/Cart_clientattributes_inner" }, "type": "array" }, "Cart_inline_response_200_groups": { "properties": { "external_id": { "type": "string" }, "name": { "type": "string" } }, "type": "object" }, "Cart_inline_response_200_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Cart_client-attributes" }, "description": { "type": "string" }, "groups": { "items": { "$ref": "#/components/schemas/Cart_inline_response_200_groups" }, "type": "array" }, "image_url": { "type": "string" }, "is_free": { "type": "boolean" }, "name": { "nullable": true, "type": "string" }, "quantity": { "type": "integer" }, "sku": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "Cart_inline_response_200_price": { "description": "Precio de la cesta.", "example": "{\"amount\":\"6150.0000000000000000\",\"amount_without_discount\":\"6150.0000000000000000\",\"currency\":\"USD\"}", "nullable": true, "properties": { "amount": { "default": "50.0000000000000000", "type": "string" }, "amount_without_discount": { "default": "100.0000000000000000", "type": "string" }, "currency": { "default": "USD", "type": "string" } }, "type": "object" }, "Cart_inline_response_200": { "properties": { "cart_id": { "description": "ID de la cesta.", "example": "cart_id", "type": "string" }, "is_free": { "description": "Si es `true`, la cesta es gratuita.", "type": "boolean" }, "items": { "example": [ { "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", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Cart_inline_response_200_items" }, "type": "array" }, "price": { "$ref": "#/components/schemas/Cart_inline_response_200_price" } }, "type": "object" }, "Cart-Payment_settings_currency": { "description": "Moneda de pago preferida. Código de moneda de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "type": "string" }, "Cart_inline_response_200_1_warnings": { "properties": { "errorCode": { "type": "integer" }, "errorMessage": { "type": "string" }, "quantity": { "type": "integer" }, "sku": { "type": "string" } }, "type": "object" }, "Cart_inline_response_200_1": { "properties": { "cart_id": { "description": "ID de la cesta.", "example": "cart_id", "type": "string" }, "is_free": { "description": "Si es `true`, la cesta es gratuita.", "type": "boolean" }, "items": { "items": { "$ref": "#/components/schemas/Cart_inline_response_200_items" }, "type": "array" }, "price": { "$ref": "#/components/schemas/Cart_inline_response_200_price" }, "warnings": { "example": [ { "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", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Cart_inline_response_200_1_warnings" }, "type": "array" } }, "type": "object" }, "Cart_inline_response_404": { "properties": { "errorCode": { "example": 4001, "type": "integer" }, "errorMessage": { "example": "[0401-4001]: Item with Project ID = 44056 and SKU = booster_mega_12222 not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" }, "Cart_inline_response_422_1": { "properties": { "errorCode": { "example": 1421, "type": "integer" }, "errorMessage": { "example": "This type of item cannot be put to the cart. Select another type of item.", "type": "string" }, "statusCode": { "example": 422, "type": "integer" } }, "type": "object" }, "Cart_inline_response_422": { "properties": { "errorCode": { "example": 1102, "type": "integer" }, "errorMessage": { "example": "Item quantity must be non-negative integer.", "type": "string" }, "statusCode": { "example": 422, "type": "integer" } }, "type": "object" }, "Order_inline_response_200_1_content_price_1": { "description": "Precio del artículo.", "properties": { "amount": { "description": "Precio del artículo con descuento.", "example": "30", "type": "string" }, "amount_without_discount": { "description": "Precio del artículo.", "example": "30", "type": "string" }, "currency": { "description": "Moneda de compra por defecto. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "Order_inline_response_200_1_content_items": { "properties": { "is_free": { "description": "Si es `true`, el artículo es gratuito.", "example": "false", "type": "string" }, "price": { "$ref": "#/components/schemas/Order_inline_response_200_1_content_price_1" }, "quantity": { "description": "Cantidad del artículo.", "example": 1, "type": "integer" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "some_sku", "type": "string" } }, "type": "object" }, "Order_inline_response_200_1_content_price": { "description": "Precio del pedido.", "properties": { "amount": { "description": "Precio con descuento del pedido.", "example": "30", "type": "string" }, "amount_without_discount": { "description": "Precio del pedido.", "example": "30", "type": "string" }, "currency": { "description": "Moneda de compra por defecto. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "Order_inline_response_200_1_content_virtual_price": { "description": "Precio del pedido en moneda virtual.", "properties": { "amount": { "description": "Precio con descuento del pedido.", "example": "100", "type": "string" }, "amount_without_discount": { "description": "Precio del pedido.", "example": "150", "type": "string" }, "currency": { "description": "Código de artículo (SKU) de moneda virtual usado en el pedido.", "example": "test_vc", "type": "string" } }, "type": "object" }, "Order_inline_response_200_1_content": { "description": "Detalles del pedido.", "properties": { "is_free": { "description": "Si es `true`, el pedido es gratuito.", "example": "false", "type": "string" }, "items": { "description": "Lista de artículos.", "example": [ { "is_free": false, "price": { "amount": "30", "amount_without_discount": "30", "currency": "USD" }, "quantity": 1, "sku": "some_sku" } ], "items": { "$ref": "#/components/schemas/Order_inline_response_200_1_content_items" }, "type": "array" }, "price": { "$ref": "#/components/schemas/Order_inline_response_200_1_content_price" }, "virtual_price": { "$ref": "#/components/schemas/Order_inline_response_200_1_content_virtual_price" } }, "type": "object" }, "Order_inline_response_200_1": { "properties": { "content": { "$ref": "#/components/schemas/Order_inline_response_200_1_content" }, "order_id": { "description": "ID del pedido.", "example": 1, "type": "integer" }, "status": { "description": "Estado del pedido: `new`/`paid`/`done`/`canceled`.", "example": "paid", "type": "string" } }, "type": "object" }, "Order_inline_response_404": { "properties": { "errorCode": { "example": 9001, "type": "integer" }, "errorMessage": { "example": "[0401-9001]: Order not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" }, "Order_inline_response_200_billing_info_direct_tax": { "properties": { "amount": { "example": 150, "type": "number" }, "name": { "example": "TAX", "type": "string" }, "rate": { "example": 10, "type": "number" } }, "type": "object" }, "Order_inline_response_200_billing_info_indirect_tax": { "properties": { "amount": { "example": 246.75, "type": "number" }, "name": { "example": "VAT", "type": "string" }, "rate": { "example": 20, "type": "number" } }, "type": "object" }, "Order_inline_response_200_billing_info_price": { "properties": { "amount": { "example": 1480.45, "type": "number" }, "currency": { "description": "Moneda de compra. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "maxLength": 3, "minLength": 3, "type": "string" } }, "type": "object" }, "Order_inline_response_200_billing_info": { "description": "Información de facturación.", "properties": { "direct_tax": { "items": { "$ref": "#/components/schemas/Order_inline_response_200_billing_info_direct_tax" }, "type": "array" }, "indirect_tax": { "items": { "$ref": "#/components/schemas/Order_inline_response_200_billing_info_indirect_tax" }, "type": "array" }, "price": { "$ref": "#/components/schemas/Order_inline_response_200_billing_info_price" } }, "type": "object" }, "Order_inline_response_200": { "properties": { "billing_info": { "$ref": "#/components/schemas/Order_inline_response_200_billing_info" }, "order_id": { "description": "ID del pedido.", "type": "integer" } }, "type": "object" }, "Order_inline_response_422": { "properties": { "errorCode": { "example": 1401, "type": "integer" }, "errorMessage": { "example": "[0401-1401]: Invalid cart", "type": "string" }, "statusCode": { "example": 422, "type": "integer" } }, "type": "object" }, "Order_inline_response_422_1": { "properties": { "errorCode": { "example": 1411, "type": "integer" }, "errorMessage": { "example": "[0401-1411]: Invalid item", "type": "string" }, "statusCode": { "example": 422, "type": "integer" } }, "type": "object" }, "email-required": { "properties": { "country": { "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).", "example": "US", "nullable": true, "type": "string" }, "email": { "description": "La dirección de correo electrónico del usuario en la que puede recibir la clave del juego adquirida.", "example": "public_email@test.com", "type": "string" }, "id": { "description": "Identificador único del usuario en el juego.", "example": "public_id", "nullable": true, "type": "string" }, "ip": { "description": "La dirección IP del usuario.", "example": "127.0.0.1", "nullable": true, "type": "string" }, "name": { "description": "Nombre público del usuario.", "example": "Public name", "nullable": true, "type": "string" }, "phone": { "description": "El número de teléfono del usuario.", "example": "+66-000-000-00-00", "nullable": true, "type": "string" } }, "required": [ "email" ] }, "Common_inline_response_200_1": { "properties": { "token": { "description": "Token del usuario", "type": "string" } }, "type": "object" }, "Catalog_admin-attribute-external_id": { "description": "ID único del atributo. `external_id` solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.", "example": "attribute_1", "maxLength": 255, "minLength": 1, "pattern": "^[a-zA-Z0-9-_]+$", "type": "string" }, "Catalog_value-external_id": { "description": "ID de valor único para un atributo. `external_id` solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.", "example": "attribute_value", "maxLength": 255, "minLength": 1, "pattern": "^[-_.\\d\\w]+$", "type": "string" }, "Catalog_clientattributes_inner": { "properties": { "external_id": { "$ref": "#/components/schemas/Catalog_admin-attribute-external_id" }, "name": { "description": "Nombre del atributo.", "example": "Genre", "type": "string" }, "values": { "items": { "properties": { "external_id": { "$ref": "#/components/schemas/Catalog_value-external_id" }, "value": { "description": "Valor del atributo.", "example": "Strategy", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "Catalog_client-attributes-common": { "default": [], "description": "Lista de atributos y sus valores correspondientes al artículo. Puede utilizarse para el filtrado de catálogos.", "items": { "$ref": "#/components/schemas/Catalog_clientattributes_inner" }, "type": "array" }, "Catalog_bundle_type": { "description": "Tipo de lote. En este caso, siempre es `standart`.", "example": "standart", "type": "string" }, "Catalog_client_content_inner": { "description": "Artículo dentro de un paquete.", "properties": { "description": { "description": "Descripción del artículo.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "description": "URL de la imagen.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "name": { "description": "Nombre del artículo.", "example": "Big Rocket", "type": "string" }, "price": { "description": "Precios de artículos.", "nullable": true, "properties": { "amount": { "description": "Precio del artículo con descuento.", "example": "100.99", "type": "string" }, "amount_without_discount": { "description": "Precio del artículo.", "example": "100.99", "type": "string" }, "currency": { "description": "Moneda de compra por defecto. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "quantity": { "description": "Cantidad del artículo en un paquete.", "example": 250, "type": "integer" }, "sku": { "description": "ID único del artículo. El código de artículo (SKU) solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.", "example": "big_rocket", "type": "string" }, "type": { "description": "Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.", "example": "virtual_currency", "type": "string" }, "virtual_prices": { "description": "Precios virtuales.", "items": { "description": "Precio virtual.", "properties": { "amount": { "description": "Precio del artículo en moneda virtual con descuento.", "example": 100, "type": "integer" }, "amount_without_discount": { "description": "Precio del artículo.", "example": 200, "type": "integer" }, "description": { "description": "Descripción de la moneda virtual.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "description": "Imagen de la moneda virtual.", "example": "http://image.png", "type": "string" }, "is_default": { "description": "Si el precio está predeterminado para un artículo.", "example": true, "type": "boolean" }, "name": { "description": "Nombre de la moneda virtual.", "example": "SHOTGUN FOR TRUE RAIDERS", "type": "string" }, "sku": { "description": "Código de artículo (SKU) de la moneda virtual.", "example": "vc_test", "type": "string" }, "type": { "description": "Tipo de moneda virtual.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "Catalog_client_content": { "description": "Contenido del paquete del lote.", "example": [ { "attributes": [], "description": "Big Rocket - short description.", "groups": [], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "is_free": false, "name": "Big Rocket", "price": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "quantity": 100, "sku": "big_rocket", "type": "virtual_currency" } ], "items": { "$ref": "#/components/schemas/Catalog_client_content_inner" }, "type": "array" }, "Catalog_client_description": { "description": "Descripción del artículo.", "example": "Big Rocket - description.", "nullable": true, "type": "string" }, "Catalog_groups_response_inner": { "properties": { "external_id": { "example": "horror", "type": "string" }, "name": { "example": { "en": "Horror" }, "type": "object" } }, "type": "object" }, "Catalog_groups_response": { "default": [], "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "horror", "name": { "en": "Horror" } } ], "items": { "$ref": "#/components/schemas/Catalog_groups_response_inner" }, "type": "array" }, "Catalog_image_url": { "description": "URL de la imagen.", "example": "https://image.example.com", "nullable": true, "type": "string" }, "Catalog_is_free": { "default": "false", "description": "Siempre es `false`.", "example": "false", "type": "string" }, "Catalog_client_name": { "description": "Nombre del artículo.", "example": "Big Rocket", "type": "string" }, "Catalog_amount": { "description": "Precio del artículo con descuento.", "example": "100.99", "pattern": "^\\d*\\.?\\d*$", "type": "string" }, "Catalog_amount_without_discount": { "description": "Precio del artículo.", "example": "100.99", "pattern": "^\\d*\\.?\\d*$", "type": "string" }, "Catalog_currency": { "description": "Moneda de compra. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" }, "Catalog_price": { "description": "Precio del artículo.", "nullable": true, "properties": { "amount": { "$ref": "#/components/schemas/Catalog_amount" }, "amount_without_discount": { "$ref": "#/components/schemas/Catalog_amount_without_discount" }, "currency": { "$ref": "#/components/schemas/Catalog_currency" } }, "required": [ "amount", "amount_without_discount", "currency" ], "type": "object" }, "Catalog_sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "bundle_1", "type": "string" }, "Catalog_total_content_price": { "description": "Suma de los precios del contenido del lote.", "nullable": true, "properties": { "amount": { "description": "Suma de los precios de los contenidos del lote con un descuento.", "example": "100.99", "type": "string" }, "amount_without_discount": { "description": "Suma de los precios del contenido del lote.", "example": "100.99", "type": "string" }, "currency": { "$ref": "#/components/schemas/Catalog_currency" } }, "type": "object" }, "Catalog_type": { "description": "Tipo de artículo.", "example": "bundle", "type": "string" }, "Catalog_virtual_prices_inner": { "description": "Precio virtual.", "properties": { "amount": { "description": "Precio del artículo en moneda virtual con descuento.", "example": 100, "type": "integer" }, "amount_without_discount": { "description": "Precio del artículo en moneda virtual.", "example": 200, "type": "integer" }, "description": { "description": "Descripción de la moneda virtual.", "example": "Most popular gold", "nullable": true, "type": "string" }, "image_url": { "description": "Imagen de la moneda virtual.", "example": "http://image.png", "nullable": true, "type": "string" }, "is_default": { "description": "Si el precio está predeterminado para un artículo.", "example": true, "type": "boolean" }, "name": { "description": "Nombre de la moneda virtual.", "example": "Gold", "type": "string" }, "sku": { "description": "Código de artículo (SKU) de la moneda virtual.", "example": "gold", "type": "string" }, "type": { "description": "Tipo de moneda virtual.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "Catalog_virtual_prices": { "description": "Precios virtuales.", "items": { "$ref": "#/components/schemas/Catalog_virtual_prices_inner" }, "type": "array" }, "Catalog_client_bundle": { "description": "El lote especificado.", "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes-common" }, "bundle_type": { "$ref": "#/components/schemas/Catalog_bundle_type" }, "content": { "$ref": "#/components/schemas/Catalog_client_content" }, "description": { "$ref": "#/components/schemas/Catalog_client_description" }, "groups": { "$ref": "#/components/schemas/Catalog_groups_response" }, "image_url": { "$ref": "#/components/schemas/Catalog_image_url" }, "is_free": { "$ref": "#/components/schemas/Catalog_is_free" }, "name": { "$ref": "#/components/schemas/Catalog_client_name" }, "price": { "$ref": "#/components/schemas/Catalog_price" }, "sku": { "$ref": "#/components/schemas/Catalog_sku" }, "total_content_price": { "$ref": "#/components/schemas/Catalog_total_content_price" }, "type": { "$ref": "#/components/schemas/Catalog_type" }, "virtual_prices": { "$ref": "#/components/schemas/Catalog_virtual_prices" } }, "type": "object" }, "Catalog_inline_response_200_10": { "description": "Objeto con artículos.", "properties": { "items": { "items": { "$ref": "#/components/schemas/Catalog_client_bundle" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_groups": { "properties": { "external_id": { "example": "accessory", "type": "string" }, "name": { "example": "Accessory", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_price": { "description": "Precios de artículos.", "properties": { "amount": { "description": "Precio del artículo con descuento.", "example": "2.9900", "type": "string" }, "amount_without_discount": { "description": "Precio del artículo.", "example": "2.9900", "type": "string" }, "currency": { "description": "Moneda de compra por defecto. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_virtual_prices": { "description": "Precio virtual.", "properties": { "amount": { "description": "Precio del artículo con descuento en moneda virtual.", "example": 100, "type": "integer" }, "amount_without_discount": { "description": "Precio del artículo.", "example": 200, "type": "integer" }, "description": { "description": "Descripción de la moneda virtual.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "description": "Imagen de la moneda virtual.", "example": "http://image.png", "type": "string" }, "is_default": { "description": "Si el precio está predeterminado o no para el artículo.", "example": true, "type": "boolean" }, "name": { "description": "Nombre de la moneda virtual.", "example": "SHOTGUN FOR TRUE RAIDERS", "type": "string" }, "sku": { "description": "Código de artículo (SKU) de la moneda virtual.", "example": "vc_test", "type": "string" }, "type": { "description": "Tipo de moneda virtual.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_unit_items": { "properties": { "drm_name": { "description": "Nombre del DRM (gestión de derechos digitales).", "example": "Steam", "type": "string" }, "drm_sku": { "description": "ID único del DRM. El código de artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "steam", "type": "string" }, "has_keys": { "description": "Si es `true`, la clave del juego tiene claves para la venta.", "example": false, "type": "boolean" }, "is_free": { "description": "Si es `true`, el artículo es gratuito.", "example": false, "type": "boolean" }, "is_pre_order": { "description": "Si es `true`, la clave del juego está reservada y la fecha de lanzamiento no ha pasado.", "example": true, "type": "boolean" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_price" }, "release_date": { "description": "Fecha de lanzamiento de la clave del juego en formato ISO 8601.", "example": "2020-08-11T10:00:00+03:00", "type": "string" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "game_01", "type": "string" }, "type": { "description": "Tipo de artículo: `game_key`.", "example": "game_key", "type": "string" }, "virtual_prices": { "description": "Precios virtuales.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes-common" }, "description": { "description": "Descripción del artículo.", "example": "Game description", "type": "string" }, "groups": { "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL de la imagen.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "name": { "description": "Nombre del artículo.", "example": "Game name", "type": "string" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "game_01", "type": "string" }, "type": { "description": "Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.", "example": "unit", "type": "string" }, "unit_items": { "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_unit_items" }, "type": "array" }, "unit_type": { "description": "Tipo de unidad: `game`.", "example": "game", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200": { "description": "Objeto con juegos.", "properties": { "items": { "example": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" }, { "attributes": [ { "external_id": "OS", "name": "OS", "values": [ { "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723", "value": "Windows" } ] } ], "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_2", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_01", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_4_drm": { "properties": { "drm_id": { "description": "ID del DRM.", "example": 1, "type": "number" }, "image": { "description": "URL de la imagen.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "link": { "description": "Enlace para canjear.", "example": "https://support.us.playstation.com", "type": "string" }, "name": { "description": "Nombre del DRM (gestión de derechos digitales).", "example": "Steam", "type": "string" }, "redeem_instruction_link": { "description": "Enlace de las instrucciones de canje.", "example": "https://support.us.playstation.com", "type": "string" }, "sku": { "description": "ID único del DRM. El código de artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "steam", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_4": { "description": "Objeto con juegos.", "properties": { "drm": { "example": [ { "drm_id": 1, "image": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "link": "https://support.steampowered.com", "name": "Steam", "redeem_instruction_link": "https://support.steampowered.com", "sku": "steam" }, { "drm_id": 2, "image": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Playstation", "redeem_instruction_link": "https://support.us.playstation.com", "sku": "playstation" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_4_drm" }, "type": "array" } }, "type": "object" }, "Catalog_client-attributes": { "default": [], "description": "Lista de atributos y sus valores correspondientes al juego.\n\n
Atención: esta parte de la respuesta solo está disponible si envía el parámetro de consulta `additional_fields[]=attributes`.
", "items": { "$ref": "#/components/schemas/Catalog_clientattributes_inner" }, "type": "array" }, "Catalog_inline_response_200_3_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Descripción del artículo.", "example": "Game description", "type": "string" }, "drm_name": { "description": "Nombre del DRM (gestión de derechos digitales).", "example": "Steam", "type": "string" }, "drm_sku": { "description": "ID único del DRM. El código de artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "steam", "type": "string" }, "groups": { "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "has_keys": { "description": "Si es `true`, la clave del juego tiene claves para la venta.", "example": false, "type": "boolean" }, "image_url": { "description": "URL de la imagen.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "is_free": { "description": "Si es `true`, el artículo es gratuito.", "example": false, "type": "boolean" }, "is_pre_order": { "description": "Si es `true`, la clave del juego está reservada y la fecha de lanzamiento no ha pasado.", "example": true, "type": "boolean" }, "name": { "description": "Nombre del artículo.", "example": "Game name", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_price" }, "release_date": { "description": "Fecha de lanzamiento de la clave del juego en formato ISO 8601.", "example": "2020-08-11T10:00:00+03:00", "type": "string" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "game_01", "type": "string" }, "type": { "description": "Tipo de artículo: `game_key`.", "example": "game_key", "type": "string" }, "virtual_prices": { "description": "Precios virtuales.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_3": { "description": "Objeto con juegos.", "properties": { "items": { "example": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": true, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_1", "type": "game_key", "virtual_prices": [] }, { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": false, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_2", "type": "game_key", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_3_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_2": { "description": "Objeto con información de la clave del juego.", "example": { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": true, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_1", "type": "game_key", "virtual_prices": [] }, "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes-common" }, "description": { "description": "Descripción del artículo.", "example": "Game description", "type": "string" }, "drm_name": { "description": "Nombre del DRM (gestión de derechos digitales).", "example": "Steam", "type": "string" }, "drm_sku": { "description": "ID único del DRM. El código de artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "steam", "type": "string" }, "groups": { "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "has_keys": { "description": "Si es `true`, la clave del juego tiene claves para la venta.", "example": false, "type": "boolean" }, "image_url": { "description": "URL de la imagen.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "is_free": { "description": "Si es `true`, el artículo es gratuito.", "example": false, "type": "boolean" }, "is_pre_order": { "description": "Si es `true`, la clave del juego está reservada y la fecha de lanzamiento no ha pasado.", "example": true, "type": "boolean" }, "name": { "description": "Nombre del artículo.", "example": "Game name", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_price" }, "release_date": { "description": "Fecha de lanzamiento de la clave del juego en formato ISO 8601.", "example": "2020-08-11T10:00:00+03:00", "type": "string" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "game_01", "type": "string" }, "type": { "description": "Tipo de artículo: `game_key`.", "example": "game_key", "type": "string" }, "virtual_prices": { "description": "Precios virtuales.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_404_1": { "properties": { "errorCode": { "example": 4001, "type": "integer" }, "errorMessage": { "example": "[0401-4001]: Item with sku = 'game_key_1' not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_1": { "description": "Objeto con información del juego.", "example": { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" }, "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Descripción del artículo.", "example": "Game description", "type": "string" }, "groups": { "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL de la imagen.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "name": { "description": "Nombre del artículo.", "example": "Game name", "type": "string" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "game_01", "type": "string" }, "type": { "description": "Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.", "example": "unit", "type": "string" }, "unit_items": { "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_unit_items" }, "type": "array" }, "unit_type": { "description": "Tipo de unidad: `game`.", "example": "game", "type": "string" } }, "type": "object" }, "Catalog_inline_response_404": { "properties": { "errorCode": { "example": 4001, "type": "integer" }, "errorMessage": { "example": "[0401-4001]: Item with sku = 'game_1' not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_9_children": { "properties": { "children": { "description": "Grupos secundarios.", "example": [], "items": { "type": "string" }, "type": "array" }, "description": { "description": "Descripción del grupo.", "example": "Accessory", "type": "string" }, "external_id": { "description": "ID externo del grupo.", "example": "accessory", "type": "string" }, "image_url": { "description": "URL de la imagen.", "type": "string" }, "level": { "description": "Nivel de anidamiento del grupo.", "example": 2, "type": "integer" }, "name": { "description": "Nombre del grupo.", "example": "Accessory", "type": "string" }, "order": { "description": "Define el orden de disposición.", "example": 1, "type": "integer" }, "parent_external_id": { "description": "ID externo del grupo primario.", "example": "background", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_9_children_1": { "properties": { "children": { "description": "Grupos secundarios.", "example": [ { "children": [], "description": "Accessory", "external_id": "accessory", "level": 2, "name": "Accessory", "order": 1, "parent_external_id": "background" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_9_children" }, "type": "array" }, "description": { "description": "Descripción del grupo.", "example": "Background description", "type": "string" }, "external_id": { "description": "ID externo del grupo.", "example": "background", "type": "string" }, "image_url": { "description": "URL de la imagen del grupo.", "type": "string" }, "level": { "description": "Nivel de anidamiento del grupo.", "example": 1, "type": "integer" }, "name": { "description": "Nombre del grupo.", "example": "Background", "type": "string" }, "order": { "description": "Define el orden de disposición.", "example": 1, "type": "integer" }, "parent_external_id": { "description": "ID externo del grupo primario.", "example": "hair", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_9_groups": { "properties": { "children": { "description": "Grupos secundarios.", "example": [ { "children": [ { "children": [], "description": "Accessory", "external_id": "accessory", "level": 2, "name": "Accessory", "order": 1, "parent_external_id": "background" } ], "description": "Background description", "external_id": "background", "level": 1, "name": "Background", "order": 1, "parent_external_id": "hair" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_9_children_1" }, "type": "array" }, "description": { "description": "Descripción del grupo.", "example": "Hair description", "type": "string" }, "external_id": { "description": "ID externo del grupo.", "example": "hair", "type": "string" }, "image_url": { "description": "URL de la imagen.", "type": "string" }, "level": { "description": "Nivel de anidamiento del grupo.", "example": 0, "type": "integer" }, "name": { "description": "Nombre del grupo.", "example": "Hair", "type": "string" }, "order": { "description": "Define el orden de disposición.", "example": 1, "type": "integer" }, "parent_external_id": { "description": "ID externo del grupo primario.", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_9": { "properties": { "groups": { "example": [ { "children": [ { "children": [ { "children": [], "description": "Accessory", "external_id": "accessory", "level": 2, "name": "Accessory", "order": 1, "parent_external_id": "background" } ], "description": "Background description", "external_id": "background", "level": 1, "name": "Background", "order": 1, "parent_external_id": "hair" } ], "description": "Hair description", "external_id": "hair", "level": 0, "name": "Hair", "order": 1 }, { "children": [], "description": "Super description", "external_id": "group_external_id", "level": 0, "name": "Super", "order": 1 } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_9_groups" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_5_inventory_options_consumable": { "description": "Define las propiedades consumibles si se trata de un artículo consumible, o `null` si se trata de un artículo no consumible.", "nullable": true, "properties": { "usages_count": { "description": "Número total de usos restantes si se trata de un artículo consumible, o `null` si se trata de un artículo no consumible.", "example": 1, "nullable": true, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_5_inventory_options_expiration_period": { "description": "Define las propiedades de expiración si se trata de un artículo expirado, o `null` si se trata de un artículo no expirado.", "nullable": true, "properties": { "type": { "description": "Define el tipo de expiración del artículo.", "enum": [ "minute", "hour", "day", "week", "month", "year" ], "example": "day", "type": "string" }, "value": { "description": "Define el valor de un periodo de expiración.", "example": 1, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_5_inventory_options": { "description": "Define las opciones de artículo del inventario.", "properties": { "consumable": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options_consumable" }, "expiration_period": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options_expiration_period" } }, "type": "object" }, "Catalog_inline_response_200_5_price": { "description": "Precios de artículos.", "properties": { "amount": { "description": "Precio del artículo con descuento.", "example": "100.99", "type": "string" }, "amount_without_discount": { "description": "Precio del artículo.", "example": "100.99", "type": "string" }, "currency": { "description": "Moneda de compra por defecto. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_6_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Descripción del artículo.", "example": "Big Rocket - description", "type": "string" }, "groups": { "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "accessory", "name": "Accessory" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL de la imagen.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "inventory_options": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options" }, "is_free": { "description": "Si es `true`, el artículo es gratuito.", "example": "false", "type": "string" }, "name": { "description": "Nombre del artículo.", "example": "Big Rocket", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_price" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "big_rocket", "type": "string" }, "type": { "description": "Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.", "example": "virtual_currency", "type": "string" }, "virtual_prices": { "description": "Precios virtuales.", "example": [ { "amount": 100, "amount_without_discount": 100, "image_url": "http://image.png", "is_default": true, "sku": "shotgun_raider" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_6": { "properties": { "items": { "example": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "value": "5" } ] } ], "description": "Big Rocket - short description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_currency", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "value": "1" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "value": "3.9" } ] }, { "external_id": "genre", "name": "Genre", "values": [ { "value": "Strategy" }, { "value": "Tactical" }, "Turn-based" ] } ], "description": "description", "groups": [ { "external_id": "hair", "name": "Hair" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_currency", "virtual_prices": [] }, { "attributes": [], "description": "description", "groups": [], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider_2", "type": "virtual_currency", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_6_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_7_inventory_options_expiration_period": { "description": "Define las propiedades de expiración si se trata de un artículo expirado, o `null` si se trata de un artículo no expirado.", "nullable": true, "properties": { "type": { "description": "Define el tipo de expiración de un artículo.", "enum": [ "minute", "hour", "day", "week", "month", "year" ], "example": "day", "type": "string" }, "value": { "description": "Define el valor del periodo de expiración.", "example": 1, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_7_inventory_options": { "description": "Define las opciones de artículo del inventario.", "properties": { "consumable": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options_consumable" }, "expiration_period": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_inventory_options_expiration_period" } }, "type": "object" }, "Catalog_inline_response_200_7_content": { "description": "Moneda virtual en un paquete.", "properties": { "description": { "description": "Descripción del artículo.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "description": "URL de la imagen.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "inventory_options": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_inventory_options" }, "name": { "description": "Nombre del artículo.", "example": "Big Rocket", "type": "string" }, "quantity": { "description": "Cantidad de moneda virtual que hay en un paquete.", "example": 250, "type": "integer" }, "sku": { "description": "ID único del artículo. El código de artículo (SKU) solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.", "example": "big_rocket", "type": "string" }, "type": { "description": "Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_7_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "bundle_type": { "description": "Tipo de lote: `standard`/`virtual_currency_package`.", "example": "virtual_currency_package", "type": "string" }, "content": { "description": "Contenido del paquete de moneda virtual.", "example": [ { "description": "Big Rocket - short description", "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "Big Rocket", "quantity": 100, "sku": "big_rocket", "type": "virtual_currency" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_content" }, "type": "array" }, "description": { "description": "Descripción del artículo.", "example": "Big Rocket - description", "type": "string" }, "groups": { "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "accessory", "name": "Accessory" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL de la imagen.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "is_free": { "description": "Si es `true`, el artículo es gratuito.", "example": "false", "type": "string" }, "name": { "description": "Nombre del artículo.", "example": "Big Rocket", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_price" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "big_rocket", "type": "string" }, "type": { "description": "Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.", "example": "bundle", "type": "string" }, "virtual_prices": { "description": "Precios virtuales.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_7": { "description": "Objeto con artículos.", "properties": { "items": { "example": [ { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": "Big Rocket - short description", "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "Big Rocket", "quantity": 100, "sku": "big_rocket", "type": "virtual_currency" } ], "description": "VC Short Package Description", "groups": [], "image_url": "http://vc_package_image.png", "is_free": false, "name": "VC Name first package", "price": { "amount": "2.0000", "amount_without_discount": "2.0000", "currency": "USD" }, "sku": "vc_package_1", "type": "bundle", "virtual_prices": [] }, { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": "description", "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "SHOTGUN FOR TRUE RAIDERS", "quantity": 200, "sku": "shotgun_raider", "type": "virtual_currency" } ], "description": "VC Short Package Description", "groups": [], "image_url": "http://vc_package_image.png", "is_free": false, "name": "VC Name third package", "price": { "amount": "4.0000", "amount_without_discount": "4.0000", "currency": "USD" }, "sku": "vc_package_3", "type": "bundle", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_5_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Descripción del artículo.", "example": "Big Rocket - description", "type": "string" }, "groups": { "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "accessory", "name": "Accessory" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL de la imagen.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "inventory_options": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options" }, "is_free": { "description": "Si es `true`, el artículo es gratuito.", "example": false, "type": "boolean" }, "name": { "description": "Nombre del artículo.", "example": "Big Rocket", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_price" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "big_rocket", "type": "string" }, "type": { "description": "Tipo de artículo: `virtual_good`/`virtual_currency`/`bundle`.", "example": "virtual_good", "type": "string" }, "virtual_item_type": { "description": "Tipo de artículo virtual.", "enum": [ "consumable", "non_consumable", "non_renewing_subscription" ], "example": "non-consumable", "type": "string" }, "virtual_prices": { "description": "Precios virtuales.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_5": { "description": "Objeto con artículos virtuales.", "properties": { "items": { "example": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] } ], "description": "Big Rocket - description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85", "value": "3.9" } ] } ], "description": "description", "groups": [ { "external_id": "hair", "name": "Hair" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" }, { "amount": 200, "amount_without_discount": 200, "description": "description", "image_url": "http://image.png", "is_default": false, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test_2", "type": "virtual_currency" } ] }, { "attributes": [], "description": "description", "groups": [], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider_2", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_8_virtual_prices": { "description": "Precio virtual.", "properties": { "amount": { "description": "Precio del artículo con descuento en moneda virtual.", "example": 100, "type": "integer" }, "amount_without_discount": { "description": "Precio del artículo.", "example": 200, "type": "integer" }, "description": { "description": "Descripción de la moneda virtual.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "example": "http://image.png", "type": "string" }, "is_default": { "description": "Si el precio está predeterminado o no para un artículo.", "example": true, "type": "boolean" }, "name": { "description": "Nombre de la moneda virtual.", "example": "SHOTGUN FOR TRUE RAIDERS", "type": "string" }, "sku": { "description": "Código de artículo (SKU) de la moneda virtual.", "example": "vc_test", "type": "string" }, "type": { "description": "Tipo de moneda virtual.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_8_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Descripción del artículo.", "example": "Big Rocket - description", "type": "string" }, "groups": { "description": "Grupos a los que pertenece el artículo.", "example": [ { "external_id": "accessory", "name": "Accessory" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL de la imagen.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "inventory_options": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_inventory_options" }, "is_free": { "description": "Si es `true`, el artículo es gratuito.", "example": "false", "type": "string" }, "name": { "description": "Nombre del artículo.", "example": "Big Rocket", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_price" }, "sku": { "description": "ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.", "example": "big_rocket", "type": "string" }, "type": { "description": "Tipo de artículo: `consumable`/`expiration`/`permanent`/`lootboxes`/`physical`.", "example": "virtual_good", "type": "string" }, "virtual_item_type": { "description": "Tipo de artículo virtual.", "enum": [ "consumable", "non_consumable", "non_renewing_subscription" ], "example": "non_consumable", "type": "string" }, "virtual_prices": { "description": "Precios virtuales.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_8_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_8": { "properties": { "items": { "example": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "value": "5" } ] } ], "description": "Big Rocket - description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" } ] }, { "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" ] } ], "description": "description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" }, { "amount": 200, "amount_without_discount": 200, "description": "description", "image_url": "http://image.png", "is_default": false, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test_2", "type": "virtual_currency" } ] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_8_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_404_2": { "properties": { "errorCode": { "example": 4403, "type": "integer" }, "errorMessage": { "example": "[0401-4403]: Item group not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" } }, "requestBodies": { "fill-cart-json-model": { "content": { "application/json": { "schema": { "example": [ { "quantity": 123, "sku": "booster_mega_1" } ], "properties": { "currency": { "$ref": "#/components/schemas/Cart-Payment_settings_currency" }, "items": { "description": "Lista de artículos.", "items": { "minItems": 1, "properties": { "quantity": { "default": 123, "type": "number" }, "sku": { "default": "booster_mega_1", "type": "string" } }, "required": [ "quantity", "sku" ], "type": "object" }, "type": "array" } }, "required": [ "items" ], "type": "object" } } } }, "put-item-by-cart-id-json-model": { "content": { "application/json": { "schema": { "properties": { "currency": { "$ref": "#/components/schemas/Cart-Payment_settings_currency" }, "quantity": { "default": 123, "description": "Cantidad del artículo.", "type": "number" } }, "type": "object" } } } }, "create-order-model": { "content": { "application/json": { "schema": { "example": { "geotype": 13038 }, "properties": { "currency": { "$ref": "#/components/schemas/Cart-Payment_settings_currency" }, "geotype": { "description": "ID de socio distribuidor en el lado de Xsolla.", "type": "number" }, "quantity": { "description": "Cantidad del artículo.", "example": 1, "type": "integer" } }, "required": [ "geotype", "currency" ], "type": "object" } } }, "description": "Objeto con datos de creación del pedido.", "required": true }, "post-user-token-json-model": { "content": { "application/json": { "schema": { "properties": { "user": { "$ref": "#/components/schemas/email-required", "description": "Datos del usuario.", "type": "object" } }, "required": [ "user" ], "type": "object" } } } } }, "examples": { "200-get-bundle-list": { "value": { "items": [ { "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" } ] }, "bundle_type": "standard", "content": [ { "attributes": { "external_id": "size", "name": "Size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "Large" } ] }, "description": "Big Rocket - short description.", "groups": [], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "is_free": false, "name": "Big Rocket", "price": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "quantity": 100, "sku": "big_rocket", "type": "virtual_currency", "virtual_item_type": "non_consumable", "virtual_prices": [] } ], "description": "pricePoint_44056_1", "groups": [], "is_free": false, "media_list": [], "name": "kg_10.00_bundle", "order": 999, "price": { "amount": 9.99, "amount_without_discount": 9.99, "currency": "USD" }, "sku": "kg_1", "total_content_price": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "type": "bundle", "virtual_prices": [] } ] } }, "200-get-bundle": { "value": { "attributes": [], "bundle_type": "standard", "content": [ { "attributes": [], "description": "Big Rocket - short description.", "groups": [], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "is_free": false, "name": "Big Rocket", "price": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "quantity": 100, "sku": "big_rocket", "type": "virtual_currency", "virtual_prices": [] } ], "description": "pricePoint_44056_1.", "groups": [], "is_free": false, "media_list": [], "name": "kg_10.00_bundle", "order": 999, "price": { "amount": 9.99, "amount_without_discount": 9.99, "currency": "USD" }, "sku": "kg_1", "total_content_amount": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "type": "bundle", "virtual_prices": [] } } } }, "x-tagGroups": [ { "name": "Cesta", "tags": [ "cart" ] }, { "name": "Catálogo", "tags": [ "game keys", "virtual items & currency", "bundles" ] }, { "name": "Común", "tags": [ "user token" ] }, { "name": "Notificaciones", "tags": [ "notifications" ] }, { "name": "Pedido", "tags": [ "order" ] } ] }