# Shop Builder API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **Contact URL:** https://xsolla.com/ * **Required TLS version:** 1.2 Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart Al vender una cesta con juegos, puede [llamar al punto final sin autorización](/es/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). Para ello, haga lo siguiente: * Añada un identificador único al parámetro `x-unauthorized-id` en el encabezado de los juegos. * Añada el correo electrónico del usuario al parámetro `x-user` (con codificación Base64) en el encabezado de los juegos. Por defecto, el JWT de usuario de Login de Xsolla (Bearer Token) se utiliza para la autorización. Puede intentar llamar a este punto final con un token JWT de usuario de Login de Xsolla de prueba: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Como alternativa, puede utilizar el token de acceso a [Pay Station](https://developers.xsolla.com/es/api/pay-station/operation/create-token/). Type: http Scheme: bearer ### XsollaLoginUserJWT Por defecto, el JWT de usuario de Login de Xsolla (Bearer Token) se utiliza para la autorización. Puede intentar llamar a este punto final con un token JWT de usuario de Login de Xsolla de prueba: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Como alternativa, puede utilizar el token de acceso a [Pay Station](https://developers.xsolla.com/es/api/pay-station/operation/create-token/). Type: http Scheme: bearer Bearer Format: JWT ### basicAuth La API de Xsolla utiliza 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 `project_id:api_key` codificado según el estándar Base64. Puede utilizar `merchant_id` en lugar de `project_id` si lo necesita. No afecta a la funcionalidad. Vaya a [Cuenta de editor](https://publisher.xsolla.com/) para encontrar los valores de los parámetros: * Se muestra el `merchant_id`: * En la sección **Configuración de la empresa > Empresa** * En la URL de la barra de direcciones del navegador en cualquier página de cuenta de editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/`. * `api_key` se muestra en la cuenta de editor solo una vez cuando se crea y debe almacenarse en tu lado. Puedes crear una nueva clave en la siguiente sección: * **Configuración de la empresa > Claves API** * **Configuración del proyecto > Claves API** * Se muestra el `project_id`: * En Cuenta del editor junto al nombre del proyecto. * En la URL de la barra de direcciones del navegador cuando se trabaja en el proyecto en la cuenta de Publisher. La URL tiene el siguiente formato: `https://publisher.xsolla.com//projects/`. Para más información sobre cómo trabajar con claves API, consulte la [referencia API](https://developers.xsolla.com/es/api/getting-started/#api_keys_overview). Type: http Scheme: basic ### basicMerchantAuth 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 `merchant_id:api_key` codificado según el estándar Base64. Vaya a [Cuenta de editor](https://publisher.xsolla.com/) para encontrar los valores de los parámetros: * Se muestra el `merchant_id`: * En la sección **Configuración de la empresa > Empresa** * En la URL de la barra de direcciones del navegador en cualquier página de cuenta de editor. La URL tiene el siguiente formato: `https://publisher.xsolla.com/` * `api_key` se muestra en la cuenta de editor solo una vez cuando se crea y debe almacenarse en tu lado. Puedes crear una nueva clave en la siguiente sección: * **Configuración de la empresa > Claves API** * **Configuración del proyecto > Claves API** Para más información sobre cómo trabajar con claves API, consulte la [referencia API](https://developers.xsolla.com/es/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [Shop Builder API](https://developers.xsolla.com/_bundle/@l10n/es/api/shop-builder/index.yaml) ## Admin ### Obtener lista de atributos (admin) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/admin-get-attribute-list.md): Obtiene la lista de atributos de un proyecto para su administración. ### Crear atributo - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/admin-create-attribute.md): Crea un atributo. ### Eliminar atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/delete-attribute.md): Elimina un atributo. AvisoSi elimina un atributo de artículo, se perderán todos sus datos y conexiones con los artículos. ### Obtener atributo especificado - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/admin-get-attribute.md): Obtiene un atributo especificado. ### Actualizar atributo - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/admin-update-attribute.md): Actualiza un atributo. ### Borrar todos los valores del atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/admin-delete-all-attribute-value.md): Elimina todos los valores del atributo. AvisoSi elimina el valor de un atributo, se perderán todas las conexiones entre el atributo y los artículos. Para cambiar el valor de atributo de un artículo, utilice la llamada API Actualizar valor de atributo en vez de eliminar el valor y crear uno nuevo. ### Crear valor de atributo - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/admin-create-attribute-value.md): Crea un valor de atributo. AtenciónTodos los proyectos tienen limitación del número de valores de atributo. El valor por defecto y máximo es 20 valores por atributo. ### Eliminar valor de atributo - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/admin-delete-attribute-value.md): Elimina un valor de atributo. AvisoSi elimina el valor de un atributo, se perderán todas las conexiones entre el atributo y los artículos. Para cambiar el valor de atributo de un artículo, utilice la llamada API Actualizar valor de atributo en vez de eliminar el valor y crear uno nuevo. ### Actualizar valor de atributo - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/es/api/shop-builder/attribute-admin/admin-update-attribute-value.md): Actualiza los valores de un atributo. ## Catálogo personalizado Esta API permite especificar reglas para los atributos de usuario. Si el usuario cumple todas las condiciones de una regla específica, se mostrarán los elementos personalizados. Para promociones personalizadas, consulte la sección [Promotions](/es/api/shop-builder/tag/promotions-discounts). Para transmitir atributos antes de una compra, puede utilizar [Xsolla Login API](/es/api/login/operation/update-users-attributes-from-server/) o transmitirlos a la propiedad [user.attributes mientras se genera el token utilizando Pay Station API](/es/api/pay-station/operation/create-token). ### Obtener lista de reglas de filtrado del catálogo - [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/es/api/shop-builder/personalized-catalog/get-filter-rules.md): Obtiene todas las reglas que se aplican a los atributos de usuario. ### Crear regla de filtrado del catálogo - [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/es/api/shop-builder/personalized-catalog/create-filter-rule.md): Crear regla para atributos de usuario. ### Obtener todas las reglas del catálogo para la búsqueda en el lado del cliente - [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/es/api/shop-builder/personalized-catalog/get-all-filter-rules.md): Obtiene una lista de todas las reglas del catálogo para buscar en el lado del cliente. AtenciónDevuelve solo el ID de la regla, el nombre y is_enabled ### Eliminar regla de filtro del catálogo - [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/es/api/shop-builder/personalized-catalog/delete-filter-rule-by-id.md): Elimina una regla específica. ### Obtener regla de filtro del catálogo - [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/es/api/shop-builder/personalized-catalog/get-filter-rule-by-id.md): Obtiene una regla específica que se aplica a los atributos del usuario. ### Revisar regla de filtro del catálogo - [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/es/api/shop-builder/personalized-catalog/patch-filter-rule-by-id.md): Actualiza una regla específica que se aplica a los atributos de usuario. Se utilizará el valor actual para una propiedad no especificada. ### Actualizar regla de filtro del catálogo - [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/es/api/shop-builder/personalized-catalog/update-filter-rule-by-id.md): Actualiza una regla específica que se aplica a los atributos de usuario. Se utilizará el valor por defecto para una propiedad no especificada (si la propiedad no es obligatoria). ## Admin ### Obtener lista de lotes - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-get-bundle-list.md): Obtiene la lista de lotes de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear lote - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-create-bundle.md): Crea un lote. ### Obtener lista de lotes por ID externo del grupo especificado - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Obtiene la lista de lotes dentro de un grupo para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Obtener lista de lotes por ID de grupo especificado - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Obtiene la lista de lotes dentro de un grupo para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Eliminar lote - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-delete-bundle.md): Elimina un lote. ### Obtener lote - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-get-bundle.md): Obtiene el lote dentro de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar lote - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-update-bundle.md): Actualiza un lote. ### Ocultar lote en el catálogo - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-hide-bundle.md): Oculta un lote en un catálogo. ### Mostrar lote en el catálogo - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/es/api/shop-builder/bundles-admin/admin-show-bundle.md): Muestra un lote en un catálogo. ## Catálogo ### Obtener lista de lotes - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/es/api/shop-builder/bundles-catalog/get-bundle-list.md): Obtiene una lista de lotes para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener la lista de lotes por grupo especificado - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/es/api/shop-builder/bundles-catalog/get-bundle-list-in-group.md): Obtiene una lista de lotes dentro de un grupo para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener el lote especificado - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/es/api/shop-builder/bundles-catalog/get-bundle.md): Obtiene un paquete especificado. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles. ## Cesta (cliente) ### Obtener la cesta del usuario actual - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/get-user-cart.md): Devuelve la cesta del usuario actual. ### Eliminar todos los artículos de la cesta actual - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/cart-clear.md): Elimina todos los artículos de la cesta. ### Llenar la cesta con artículos - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/cart-fill.md): Llena la cesta con artículos. Si la cesta ya tiene un artículo con el mismo SKU, el artículo existente se sustituirá por el valor transmitido. ### Eliminar artículo de la cesta actual - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/delete-item.md): Elimina un artículo de la cesta. ### Actualizar artículo de la cesta actual - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/put-item.md): Actualiza un artículo de la cesta existente o crea el de la cesta. ### Obtener cesta por el ID de la cesta - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/get-cart-by-id.md): Devuelve la cesta del usuario por el ID de la cesta. ### Eliminar todos los artículos de la cesta por el ID de la cesta - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/cart-clear-by-id.md): Elimina todos los artículos de la cesta. ### Llenar la cesta específica con artículos - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/cart-fill-by-id.md): Llena la cesta específica con artículos. Si la cesta ya contiene un artículo con el mismo SKU, la posición del artículo existente se sustituirá por el valor transmitido. ### Eliminar artículo de la cesta por ID de la cesta - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/delete-item-by-cart-id.md): Elimina un artículo de la cesta. ### Actualizar artículo de la cesta por ID de la cesta - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/cart-client-side/put-item-by-cart-id.md): Actualiza un artículo de la cesta existente o crea el de la cesta. ## Cesta (lado del servidor) ### Llenar la cesta con artículos - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/es/api/shop-builder/cart-server-side/admin-cart-fill.md): Rellena la cesta actual con artículos. Si la cesta ya tiene un artículo con el mismo SKU, el artículo existente se sustituirá por el valor transmitido. ### Llenar la cesta con artículos por el ID de la cesta - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/es/api/shop-builder/cart-server-side/admin-fill-cart-by-id.md): Rellena la cesta con artículos por ID de la cesta. Si la cesta ya tiene un artículo con el mismo SKU, el artículo existente se sustituirá por el valor transmitido. ## Pago (lado del cliente) ### Crear pedido con todos los artículos de la cesta actual - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/es/api/shop-builder/payment-client-side/create-order.md): Se utiliza para la integración cliente-servidor. Crea un pedido con todos los artículos de la cesta y genera un token de pago para esta. El pedido creado obtiene el estado de pedido new. La IP del cliente se utiliza para determinar el país del usuario, que a su vez se utiliza para aplicar la moneda correspondiente y los métodos de pago disponibles para el pedido. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el cual {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como este método utiliza la IP para determinar el país del usuario y seleccionar una moneda para el pedido, es importante utilizar este método solamente desde el lado del cliente y no desde el lado del servidor. El uso de este método desde el lado del servidor puede causar una determinación incorrecta de la moneda y afectar a los métodos de pago en Pay Station. ### Crear pedido con todos los artículos de la cesta - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/es/api/shop-builder/payment-client-side/create-order-by-cart-id.md): Se utiliza para la integración cliente-servidor. Crea un pedido con todos los artículos de la cesta concreta y genera un token de pago para esta. El pedido creado obtiene el estado de pedido new. La IP del cliente se utiliza para determinar el país del usuario, que a su vez se utiliza para aplicar la moneda correspondiente y los métodos de pago disponibles para el pedido. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el cual {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como este método utiliza la IP para determinar el país del usuario y seleccionar una moneda para el pedido, es importante utilizar este método solamente desde el lado del cliente y no desde el lado del servidor. El uso de este método desde el lado del servidor puede causar una determinación incorrecta de la moneda y afectar a los métodos de pago en Pay Station. ### Crear pedido con un artículo especificado - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/payment-client-side/create-order-with-item.md): Se utiliza para la integración cliente-servidor. Crea un pedido con un artículo específico y genera un token de pago para este. El pedido creado obtiene el newestado de pedido. La IP del cliente se utiliza para determinar el país del usuario, que a su vez se utiliza para aplicar la moneda correspondiente y los métodos de pago disponibles para el pedido. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el cual {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Como este método utiliza la IP para determinar el país del usuario y seleccionar una moneda para el pedido, es importante utilizar este método solamente desde el lado del cliente y no desde el lado del servidor. El uso de este método desde el lado del servidor puede causar una determinación incorrecta de la moneda y afectar a los métodos de pago en Pay Station. ### Crear pedido para el paso de cadena de ofertas de pago - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/es/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): Crea un pedido para el artículo asociado al paso de la cadena de ofertas de pago especificado. El pedido creado obtiene el estado de pedido new. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el que {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Este método debe utilizarse en el lado del cliente. La dirección IP del usuario se utiliza para determinar el país, lo que afecta a la moneda y a los métodos de pago disponibles. El uso de este método en el lado del servidor puede dar lugar a la detección incorrecta de la moneda y afectar a los métodos de pago en Pay Station. Aviso Utilice esta llamada solo para los pasos de cadena de ofertas de pago. Para los pasos gratuitos, utilice la llamada Reclamar paso de cadena de ofertas gratuito. ### Crear pedido para el paso de cadena de ofertas de pago - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/es/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): Crea un pedido para el artículo asociado al paso de la cadena de ofertas de pago especificado. El pedido creado obtiene el estado de pedido new. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el que {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Este método debe utilizarse en el lado del cliente. La dirección IP del usuario se utiliza para determinar el país, lo que afecta a la moneda y a los métodos de pago disponibles. El uso de este método en el lado del servidor puede dar lugar a la detección incorrecta de la moneda y afectar a los métodos de pago en Pay Station. Aviso Utilice esta llamada solo para los pasos de cadena de ofertas de pago. Para los pasos gratuitos, utilice la llamada Reclamar paso de cadena de ofertas gratuito. ## Cliente ### Crear pedido para el paso de cadena de ofertas de pago - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/es/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): Crea un pedido para el artículo asociado al paso de la cadena de ofertas de pago especificado. El pedido creado obtiene el estado de pedido new. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el que {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Este método debe utilizarse en el lado del cliente. La dirección IP del usuario se utiliza para determinar el país, lo que afecta a la moneda y a los métodos de pago disponibles. El uso de este método en el lado del servidor puede dar lugar a la detección incorrecta de la moneda y afectar a los métodos de pago en Pay Station. Aviso Utilice esta llamada solo para los pasos de cadena de ofertas de pago. Para los pasos gratuitos, utilice la llamada Reclamar paso de cadena de ofertas gratuito. ### Obtener las cadenas de ofertas del usuario actual - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/es/api/shop-builder/offer-chain-client/get-offer-chains-list.md): Obtiene las cadenas de ofertas del usuario actual. AvisoTodos los proyectos tienen un límite de número de artículos que pueden devolverse en una sola respuesta. El valor por defecto y máximo es 30 artículos por respuesta. Para obtener más datos, utilice los parámetros de consulta limit y offset para la paginación. ### Obtener la cadena de ofertas del usuario actual por ID - [GET /v2/project/{project_id}/user/offer_chain/{offer_chain_id}](https://developers.xsolla.com/es/api/shop-builder/offer-chain-client/get-user-offer-chain-by-id.md): Obtiene la cadena de ofertas del usuario actual por el ID de la cadena de ofertas. ### Reclamar paso de cadena de ofertas gratuito - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/es/api/shop-builder/offer-chain-client/claim-user-offer-chain-step-reward.md): Completa la progresión del usuario actual por el paso de la cadena de ofertas y concede la recompensa asociada. Aviso Utilice esta llamada solo para los pasos gratuitos de la cadena de ofertas. Para los pasos que requieran un pago en moneda real, utilice la llamada Crear pedido para el paso de cadena de ofertas de pago. ### Crear pedido para el paso de cadena de ofertas de pago - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/es/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): Crea un pedido para el artículo asociado al paso de la cadena de ofertas de pago especificado. El pedido creado obtiene el estado de pedido new. Para abrir la interfaz de pago en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el que {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso Este método debe utilizarse en el lado del cliente. La dirección IP del usuario se utiliza para determinar el país, lo que afecta a la moneda y a los métodos de pago disponibles. El uso de este método en el lado del servidor puede dar lugar a la detección incorrecta de la moneda y afectar a los métodos de pago en Pay Station. Aviso Utilice esta llamada solo para los pasos de cadena de ofertas de pago. Para los pasos gratuitos, utilice la llamada Reclamar paso de cadena de ofertas gratuito. ## Pago (lado del servidor) ### Crear token de pago para la compra - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/es/api/shop-builder/payment-server-side/admin-create-payment-token.md): Genera un pedido y un token de pago para el mismo. El pedido se genera en función de los artículos transmitidos en el cuerpo de la solicitud. Para abrir la interfaz de usuario para pagos en una nueva ventana, utilice el siguiente enlace: https://secure.xsolla.com/paystation4/?token={token}, en el cual {token} es el token recibido. Para realizar pruebas, utilice esta URL: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Aviso El parámetro user.country.value se usa para seleccionar una moneda para el pedido. Si se desconoce el país del usuario, otra opción es proporcionar la IP del usuario en el encabezado X-User-Ip. Se requiere una de estas dos opciones para el correcto funcionamiento de este método. La moneda seleccionada se usa para los métodos de pago en Pay Station. ## Pedido ### Obtener pedido - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/es/api/shop-builder/order/get-order.md): Recupera un pedido especificado. ### Obtener la lista de pedidos del periodo especificado - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/es/api/shop-builder/order/admin-order-search.md): Recupera la lista de pedidos, ordenados de la fecha de creación más antigua a la más reciente. ## Artículos gratuitos ### Crear pedido con cesta gratuita - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/es/api/shop-builder/free-item/create-free-order.md): Crea un pedido con todos los artículos de la cesta gratuita. El pedido creado obtendrá el estado de pedido done. ### Crear pedido con una cesta gratuita concreta - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/es/api/shop-builder/free-item/create-free-order-by-cart-id.md): Crea un pedido con todos los artículos de la cesta gratuita concreta. El pedido creado obtendrá el estado de pedido done. ### Crear pedido con un artículo gratuito especificado - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/free-item/create-free-order-with-item.md): Crea un pedido con un artículo gratuito especificado. El pedido creado obtendrá el estado de pedido done. ## Webhooks ### Obtener información sobre la configuración de webhooks - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/es/api/shop-builder/common-webhooks/get-webhook.md): Obtiene la información sobre la configuración de webhooks en Store. Consulte la documentación de webhooks para obtener más información. ### Actualizar la información sobre la configuración de webhooks - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/es/api/shop-builder/common-webhooks/update-webhook.md): Actualiza la información sobre la configuración de webhooks en Store. Consulte la documentación de webhooks para obtener más información. ## Pedidos anticipados ### Eliminar el límite de cantidad de artículos para pedidos por anticipado - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/common-pre-orders/remove-pre-order-limit.md): Elimina la cantidad del límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Obtener información sobre el límite de pedidos por anticipado del artículo - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/common-pre-orders/get-pre-order-limit.md): Obtenga el límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Agregar cantidad al límite de pedidos por anticipado del artículo - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/common-pre-orders/add-pre-order-limit.md): Añada la cantidad del límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Establecer el límite de cantidad de artículos para pedidos por anticipado - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/common-pre-orders/set-pre-order-limit.md): Establezca la cantidad del límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Eliminar todo el límite de cantidad de artículos para pedidos por anticipado - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/es/api/shop-builder/common-pre-orders/remove-all-pre-order-limit.md): Elimine toda la cantidad de límite de pedido por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all ### Cambiar el límite para los pedidos por anticipado del artículo - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/es/api/shop-builder/common-pre-orders/toggle-pre-order-limit.md): Habilitar/deshabilitar el límite para los pedidos por anticipado del artículo. La API de límite de pedido por anticipado le permite vender un artículo en una cantidad limitada. Para configurar el pedido por anticipado, vaya a Admin del módulo del artículo deseado: * Game Keys * Virtual Items & Currency * Bundles Alias para este punto final: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle ## Comerciante ### Obtener proyectos - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/es/api/shop-builder/common-merchant/get-projects.md): Obtiene la lista de proyectos del comerciante. AvisoEsta llamada API no contiene el parámetro de ruta project_id, para que no tenga que utilizar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización. ## Catálogo Esta API permite obtener cualquier tipo de artículo vendible o artículo específico. ### Obtener lista de artículos vendibles - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/es/api/shop-builder/common-catalog/get-sellable-items.md): Obtiene una lista de artículos vendibles para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener lista de artículos vendibles por grupo especificado - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/es/api/shop-builder/common-catalog/get-sellable-items-group.md): Obtiene una lista de artículos vendibles del grupo especificado para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener artículo vendible por ID - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/es/api/shop-builder/common-catalog/get-sellable-item-by-id.md): Obtiene un artículo vendible por su ID. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. No obstante, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener artículo vendible por SKU - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/es/api/shop-builder/common-catalog/get-sellable-item-by-sku.md): Obtiene un artículo vendible por SKU para crear un catálogo. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ## Regiones comunes ### Obtener lista de regiones - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/es/api/shop-builder/common-regions/admin-get-regions.md): Obtiene la lista de regiones. Puede utilizar una región para gestionar sus restricciones regionales. ### Crear región - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/es/api/shop-builder/common-regions/admin-create-region.md): Crea una región. Puede utilizar una región para gestionar sus restricciones regionales. ### Eliminar región - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/es/api/shop-builder/common-regions/admin-delete-region.md): Elimina una región concreta. ### Obtener región - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/es/api/shop-builder/common-regions/admin-get-region.md): Obtiene una región concreta. Puede utilizar una región para gestionar sus restricciones regionales. ### Actualizar región - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/es/api/shop-builder/common-regions/admin-update-region.md): Actualiza una región concreta. Puede utilizar una región para gestionar sus restricciones regionales. ## Catálogo ### Obtener lista de juegos - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/es/api/shop-builder/game-keys-catalog/get-games-list.md): Obtiene una lista de juegos para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener lista de sistemas de DRM - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/es/api/shop-builder/game-keys-catalog/get-drm-list.md): Obtiene la lista de sistemas de DRM (gestión de derechos digitales) disponibles. ### Obtener lista de juegos por grupo especificado - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-catalog/get-games-group.md): Obtiene una lista de juegos del grupo especificado para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener la lista de claves de juego por grupo especificado - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-catalog/get-game-keys-group.md): Obtiene una lista de claves de juego del grupo especificado para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener clave del juego para el catálogo - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/game-keys-catalog/get-game-key-by-sku.md): Obtiene una clave de juego para el catálogo. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener juego para el catálogo - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/game-keys-catalog/get-game-by-sku.md): Obtiene un juego para el catálogo. NotaEste punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ## Derechos ### Conceder derecho (admin) - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/es/api/shop-builder/game-keys-entitlement/grant-entitlement-admin.md): Concede el derecho al usuario. AtenciónSolo se pueden conceder códigos de juego o juegos para plataformas sin DRM (gestión de derechos digitales). ### Revocar el derecho (admin) - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/es/api/shop-builder/game-keys-entitlement/revoke-entitlement-admin.md): Revoca el derecho del usuario. AtenciónSolo se pueden conceder códigos de juego o juegos para plataformas sin DRM (gestión de derechos digitales). ### Obtener la lista de juegos propiedad del usuario - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/es/api/shop-builder/game-keys-entitlement/get-user-games.md): Obtiene la lista de juegos propiedad del usuario. La respuesta contendrá una matriz de juegos propiedad de un usuario concreto. AtenciónTodos 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. Para obtener más datos página por página, utilice los campos limit y offset. ### Canjear código del juego por cliente - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/es/api/shop-builder/game-keys-entitlement/redeem-game-pin-code.md): Concede el derecho mediante un código de juego suministrado. AtenciónSólo puede canjear códigos para la plataforma sin DRM (gestión de derechos digitales). ## Admin ### Obtener lista de juegos (admin) - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-get-game-list.md): Obtiene la lista de juegos dentro de un proyecto para su administración. El juego se compone de claves del juego que podrían ser compradas por un usuario. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear juego - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-create-game.md): Crea un juego en el proyecto. ### Eliminar un juego por su ID - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-delete-game-by-id.md): Elimina un juego del proyecto por su ID. ### Obtener juego por ID (admin) - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-get-game-by-id.md): Obtiene un juego para administración. El juego se compone de claves del juego que podrían ser compradas por un usuario. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar juego por su ID - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-update-game-by-id.md): Actualiza un juego en el proyecto por su ID. ### Borrar códigos por ID - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-delete-codes-by-id.md): Elimina todos los códigos por ID de la clave del juego. ### Eliminar códigos - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-delete-codes-by-sku.md): Elimina todos los códigos por SKU de clave de juego. ### Obtener códigos por ID - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-get-codes-by-id.md): Obtiene un determinado número de códigos por la ID de la clave del juego. ### Obtener códigos - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-get-codes-by-sku.md): Obtiene un determinado número de códigos por SKU de clave de juego. ### Cargar códigos por ID - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-upload-codes-by-id.md): Carga códigos por la ID de la clave del juego. ### Obtener información de la sesión de carga de códigos - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-get-codes-session.md): Obtiene información de la sesión de carga de códigos. ### Cargar códigos - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-upload-codes-by-sku.md): Carga códigos por SKU de clave de juego. ### Eliminar juego por SKU - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-delete-game-by-sku.md): Elimina un juego del proyecto por SKU. ### Obtener juego (admin) - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-get-game-by-sku.md): Obtiene un juego para administración. El juego se compone de claves del juego que podrían ser compradas por un usuario. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar juego por SKU - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/game-keys-admin/admin-update-game-by-sku.md): Actualiza un juego en el proyecto por SKU. ## Común ### Activar promoción - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/es/api/shop-builder/promotions-common/activate-promotion.md): Activa una promoción. ### Desactivar promoción - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/es/api/shop-builder/promotions-common/deactivate-promotion.md): Desactiva una promoción. ### Verificar el código de promoción - [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/es/api/shop-builder/promotions-common/verify-promotion-code.md): Determina si el código es un código promocional o de cupón y si el usuario puede aplicarlo. ### Obtener toda la lista de promociones - [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/es/api/shop-builder/promotions-common/get-promotion-list.md): Obtiene la lista de promociones de un proyecto. ### Obtener promoción canjeable por código - [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/es/api/shop-builder/promotions-common/get-redeemable-promotion-by-code.md): Obtiene la promoción mediante un código promocional o un código de cupón. ## Cupones Esta API le permite gestionar cupones. ### Obtener límites de código único de cupón - [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/get-coupon-code-limit.md): Obtiene el número restante de veces que se pueden utilizar los códigos. Para filtrar los códigos, utilice el parámetro de consulta codes. Para configurar el límite de códigos propiamente dicho, vaya a Admin: * Coupons. ### Activar promoción de cupones - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/activate-coupon.md): Activa una promoción de cupones. La promoción de cupones creada está deshabilitada por defecto. No estará lista para el canje hasta que la active. Utilice este punto final para habilitar y activar una promoción de cupones. ### Obtener códigos de cupón - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/get-coupon-codes.md): Obtiene códigos de cupón. ### Crear código de cupón - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/create-coupon-code.md): Crea un código de cupón. ### Generar códigos de cupón - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/generate-coupon-codes.md): Genera códigos de cupón. ### Desactivar promoción de cupones - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/deactivate-coupon.md): Desactiva una promoción de cupones. La promoción de cupones creada está deshabilitada por defecto. No estará lista para su canje hasta que la active. Utilice este punto final para deshabilitar y desactivar una promoción de cupones. ### Obtener el límite de cupones para un usuario especificado - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/get-coupon-user-limit.md): Obtiene el número restante de veces que el usuario especificado puede utilizar el cupón. La API de límite del usuario le permite limitar el número de veces que los usuarios pueden utilizar un cupón. Para configurar este límite de usuario, vaya a Admin: * Coupons ### Consigue recompensas en forma de cupones - [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/get-coupon-rewards-by-code.md): Obtiene las recompensas en forma de cupones por su código. Puede utilizarse para permitir a los usuarios elegir uno de varios artículos como bonificación. El caso más habitual es elegir un DRM (gestión de derechos digitales) si el cupón contiene un juego como bonificación (type=unit). ### Canjear código de cupón - [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/redeem-coupon.md): Canjea un código de cupón. El usuario recibe una bonificación tras canjear un cupón. ### Obtener la lista de promociones de cupones - [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/get-coupons.md): Obtiene la lista de promociones de cupones de un proyecto. ### Crear promoción de cupones - [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/admin-create-coupon.md): Crea una promoción de cupones. ### Eliminar una promoción de cupones - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/delete-coupon-promotion.md): Elimina la promoción de cupones. La promoción eliminada: * Desaparece de la lista de promociones establecidas en su proyecto. * Ya no se aplica al catálogo de artículos ni a la cesta. El usuario no puede obtener artículos de bonificación con esta promoción. Después de eliminarla, la promoción no se puede restaurar. Los códigos de cupón procedentes de la promoción eliminada pueden añadirse a las promociones existentes. ### Obtener promoción de cupones - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/get-coupon.md): Obtiene una promoción de cupones especificada. ### Actualizar promoción de cupones - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-coupons/update-coupon-promotion.md): Actualiza una promoción de cupones. ## Códigos promocionales Esta API permite gestionar códigos promocionales. ### Obtener límite del código promocional para los códigos - [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/get-promo-code-code-limit.md): Obtiene el número restante de veces que se pueden utilizar los códigos. Para filtrar los códigos, utilice el parámetro de consulta codes. Para configurar el límite de códigos propiamente dicho, vaya a Admin: * Promo Codes ### Activar promoción de códigos promocionales - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/activate-promo-code.md): Activa una promoción de códigos promocionales. La promoción de códigos promocionales creada está desactivada por defecto. No estará lista para el canje hasta que la active. Utilice este punto final para habilitar y activar una promoción de códigos promocionales. ### Obtener códigos de una promoción de códigos promocionales - [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/get-promocode-codes.md): Obtiene los códigos de una promoción de códigos promocionales. ### Crear código de promoción de códigos promocionales - [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/create-promo-code-code.md): Crea un código para una promoción de códigos promocionales. ### Generar códigos para una promoción de códigos promocionales - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/generate-promo-code-codes.md): Genera códigos para una promoción de códigos promocionales. ### Desactivar promoción de códigos promocionales - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/deactivate-promo-code.md): Desactiva una promoción de códigos promocionales. La promoción de códigos promocionales creada está deshabilitada por defecto. No estará lista para el canje hasta que la active. Utilice este punto final para deshabilitar y desactivar una promoción de códigos promocionales. ### Obtener el límite de códigos promocionales para el usuario especificado - [GET /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/get-promo-code-user-limit.md): Obtiene el número restante de veces que el usuario especificado puede utilizar el código promocional. La API de límite del usuario permite limitar el número de veces que los usuarios pueden utilizar un código promocional. Para configurar el límite del usuario, vaya a Admin: * Promo Codes ### Obtener recompensas de códigos promocionales - [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/get-promo-code-rewards-by-code.md): Obtiene las recompensas de códigos promocionales por su código. Pueden utilizarse para permitir a los usuarios elegir uno de varios artículos como bonificación. El caso más habitual es elegir un DRM (gestión de derechos digitales) si el código promocional contiene un juego como bonificación (type=unit). ### Canjear código promocional - [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/redeem-promo-code.md): Canjea una promoción de códigos promocionales. Tras canjear un código promocional, el usuario obtendrá artículos gratuitos o se reducirá el precio de la cesta o de determinados artículos. ### Eliminar código promocional de la cesta - [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/remove-cart-promo-code.md): Elimina un código promocional de una cesta. Una vez eliminado el código promocional, el precio total de todos los artículos de la cesta se volverá a calcular sin bonificaciones ni descuentos proporcionados por un código promocional. ### Obtener la lista de promociones de códigos promocionales - [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/get-promo-codes.md): Obtiene la lista de códigos promocionales de un proyecto. ### Crear promoción de códigos promocionales - [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/create-promo-code.md): Crea una promoción de códigos promocionales. ### Eliminar promoción de códigos promocionales - [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/delete-promo-code.md): Elimina la promoción de códigos promocionales. La promoción eliminada: * Desaparece de la lista de promociones establecidas en su proyecto. * Ya no se aplica al catálogo de artículos ni a la cesta. El usuario no puede obtener artículos de bonificación ni comprar artículos usando esta promoción. Después de eliminarla, la promoción no se puede restaurar. Los códigos promocionales de la promoción eliminada se pueden añadir a las promociones existentes. ### Obtener promoción de códigos promocionales - [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/get-promo-code.md): Obtiene una promoción de códigos promocionales especificada. ### Actualizar promoción de códigos promocionales - [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-promo-codes/update-promo-code.md): Actualiza una promoción de códigos promocionales. ## Ofertas únicas por catálogo Esta API le permite gestionar ofertas de catálogo únicas. ### Activar promoción de oferta única de catálogo - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/activate-unique-catalog-offer.md): Activa una promoción de oferta única de catálogo. La promoción de oferta única de catálogo creada está desactivada por defecto. No se puede canjear hasta que la active. Utilice este punto final para activar y activar una promoción de cupones. ### Obtenga códigos de oferta de catálogos exclusivos - [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): Obtiene códigos de oferta de catálogo únicos. ### Crear un código de oferta de catálogo único - [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): Crea un código de oferta de catálogo único. ### Generar códigos de oferta de catálogo únicos - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): Genera códigos de oferta de catálogo únicos. ### Desactivar la promoción de oferta única de catálogo - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): Desactiva una promoción de oferta única de catálogo. La promoción de oferta única de catálogo creada está desactivada por defecto. No se puede canjear hasta que la active. Utilice este punto final para desactivar y desactivar una promoción de cupones. ### Obtenga una lista de promociones de ofertas únicas por catálogo - [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offers.md): Obtiene la lista de promociones únicas de oferta de catálogo de un proyecto. ### Crear una promoción única de ofertas por catálogo - [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): Crea una promoción de oferta de catálogo única. ### Eliminar la promoción de oferta única de catálogo - [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/delete-unique-catalog-offer-promotion.md): Elimina la promoción única de oferta de catálogo. La promoción eliminada: * Desaparece de la lista de promociones establecidas en su proyecto. * Ya no se aplica al catálogo de artículos ni a la cesta. El usuario no puede comprar artículos con esta promoción. Después de eliminarla, la promoción no se puede restaurar. ### Consiga una promoción de oferta de catálogo única - [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer.md): Obtiene la promoción de oferta de catálogo única especificada. ### Actualizar la promoción de ofertas únicas por catálogo - [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/es/api/shop-builder/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): Actualiza la promoción de oferta única de catálogo. ## Descuentos Esta API le permite gestionar promociones de descuento. ### Obtener lista de promociones del artículo - [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/es/api/shop-builder/promotions-discounts/get-item-promotion-list.md): Obtenga la lista de promociones de artículos de un proyecto. Las promociones proporcionan un descuento (%) en los artículos. El descuento se aplicará a todos los precios de los artículos especificados. ### Crear promoción de descuento para un artículo - [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/es/api/shop-builder/promotions-discounts/create-item-promotion.md): Crea una promoción de descuento para un artículo. Las promociones proporcionan un descuento (%) en los artículos. El descuento se aplicará a todos los precios de los artículos especificados. ### Eliminar la promoción de artículos - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/es/api/shop-builder/promotions-discounts/delete-item-promotion.md): Elimina la promoción de descuento. La promoción eliminada: * Desaparece de la lista de promociones establecidas en su proyecto. * Ya no se aplica al catálogo de artículos ni a la cesta. El usuario no puede obtener artículos con esta promoción. Después de eliminarla, la promoción no se puede restaurar. ### Obtener promoción del artículo - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/es/api/shop-builder/promotions-discounts/get-item-promotion.md): Obtiene la promoción aplicada a artículos concretos. Las promociones proporcionan un descuento (%) para los artículos. El descuento se aplicará a todos los precios de los artículos especificados. ### Actualizar la promoción del artículo - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/es/api/shop-builder/promotions-discounts/update-item-promotion.md): Actualiza la promoción. NotaLos nuevos datos sustituirán a los antiguos. Si desea actualizar sólo una parte de una promoción, deberá transferir también todos los datos necesarios en la solicitud. Las promociones ofrecen un descuento (%) en los artículos. El descuento se aplicará a todos los precios de los artículos especificados. ## Bonificaciones Esta API permite gestionar promociones de bonificaciones. ### Obtenga la lista de promociones de bonificaciones - [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/es/api/shop-builder/promotions-bonuses/get-bonus-promotion-list.md): Obtiene la lista de promociones de bonificaciones de un proyecto. La promoción añade artículos de bonificación gratuitos a la compra realizada por un usuario. La promoción puede aplicarse a cada compra dentro de un proyecto o a una compra que incluya artículos concretos. ### Crear promoción de bonificaciones - [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/es/api/shop-builder/promotions-bonuses/create-bonus-promotion.md): Crea la promoción de bonificaciones. La promoción añade artículos de bonificación gratuitos a la compra realizada por un usuario. La promoción puede aplicarse a cada compra dentro de un proyecto o a una compra que incluya determinados artículos. ### Eliminar la promoción de bonificaciones - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/es/api/shop-builder/promotions-bonuses/delete-bonus-promotion.md): Elimina la promoción de bonificaciones. La promoción eliminada: * Desaparece de la lista de promociones establecidas en su proyecto. * Ya no se aplica al catálogo de artículos ni a la cesta. El usuario no puede obtener artículos de bonificación con esta promoción. Después de eliminarla, la promoción no se puede restaurar. ### Obtener una promoción de bonificación - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/es/api/shop-builder/promotions-bonuses/get-bonus-promotion.md): Obtiene la promoción de bonificaciones. La promoción añade artículos de bonificación gratuitos a la compra realizada por un usuario. La promoción puede aplicarse a cada compra dentro de un proyecto o a una compra que incluya artículos concretos. ### Actualizar la promoción de bonificación - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/es/api/shop-builder/promotions-bonuses/update-bonus-promotion.md): Actualiza la promoción. NotaLos nuevos datos sustituirán a los antiguos. Si desea actualizar solo una parte de una promoción, deberá transferir también todos los datos requeridos en la solicitud. La promoción añade artículos de bonificación gratuitos a la compra realizada por un usuario. La promoción puede aplicarse a todas las compras de un proyecto o a una compra que incluya artículos concretos. ## Admin ### Obtener lista de monedas virtuales - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Obtiene la lista de monedas virtuales dentro de un proyecto para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear moneda virtual - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency.md): Crea una moneda virtual. ### Obtener lista de paquetes de moneda virtual (admin) - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Obtiene la lista de paquetes de moneda virtual dentro de un proyecto para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear un paquete de moneda virtual - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Crea un paquete de moneda virtual. ### Eliminar el paquete de moneda virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Elimina un paquete de moneda virtual. ### Obtener el paquete de moneda virtual - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Obtiene el paquete de moneda virtual dentro de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de la tienda. ### Actualizar el paquete de moneda virtual - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Actualiza un paquete de moneda virtual. ### Eliminar moneda virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency.md): Elimina una moneda virtual. ### Obtener moneda virtual - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency.md): Obtiene la moneda virtual dentro de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar la moneda virtual - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency.md): Actualiza una moneda virtual. ### Obtener lista de artículos virtuales - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list.md): Obtiene la lista de artículos virtuales de un proyecto para administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Crear artículo virtual - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-item.md): Crea un artículo virtual. ### Obtener lista de artículos virtuales por ID externo del grupo especificado - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Obtiene la lista de artículos virtuales de un grupo para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Obtener la lista de artículos virtuales por ID del grupo especificado - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Obtiene la lista de artículos virtuales de un grupo para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Borrar artículo virtual - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-item.md): Elimina un artículo virtual. ### Obtener artículo virtual - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-item.md): Obtiene el artículo virtual dentro de un proyecto para su administración. NotaNo utilice este punto final para crear un catálogo de tienda. ### Actualizar artículo virtual - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-item.md): Actualiza un artículo virtual. ## Catálogo ### Obtener lista de grupos de artículos - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-item-groups.md): Obtiene una lista de grupos de artículos para crear un catálogo. ### Obtener lista de monedas virtuales - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency.md): Obtiene una lista de monedas virtuales para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener la lista de paquetes de moneda virtual - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package.md): Obtiene una lista de paquetes de moneda virtual para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener paquete de moneda virtual por SKU - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Obtiene paquetes de moneda virtual por SKU para crear un catálogo. Nota Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener moneda virtual por SKU - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-sku.md): Obtiene una moneda virtual por SKU para crear un catálogo. Nota Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener lista de artículos virtuales - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-virtual-items.md): Obtiene una lista de artículos virtuales para crear un catálogo. AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset. NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener la lista de todos los artículos virtuales - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-all-virtual-items.md): Obtiene una lista de todos los artículos virtuales para su búsqueda en el lado del cliente. AtenciónSolo devuelve el SKU, el nombre, los grupos y la descripción del artículo NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization. ### Obtener lista de artículos por grupo especificado - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-group.md): Obtiene una lista de artículos del grupo especificado para crear un catálogo. AtenciónTodos los proyectos tienen la limitación del número de artículos que se pueden obtener en la respuesta. El valor máximo y por defecto es 50 artículos por respuesta. Para obtener más datos página por página, utilice los campos limit y offset. Nota Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con datos específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles. ### Obtener artículo virtual por SKU - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-sku.md): Obtiene un artículo virtual por SKU para crear un catálogo. Nota Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles. ## Pago virtual ### Crear pedido con artículo especificado comprado mediante moneda virtual - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/es/api/shop-builder/virtual-payment/create-order-with-item-for-virtual-currency.md): Crea una compra de artículos utilizando moneda virtual. ## Gestión ### Actualizar todos los límites de compra para un usuario especificado - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/reset-all-user-items-limit.md): Actualiza todos los límites de compra de todos los artículos para un usuario especificado para que pueda comprar estos artículos de nuevo. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Reducir el número de artículos disponibles para un usuario especificado - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/remove-user-item-limit.md): Reduce el número restante de artículos disponibles para el usuario especificado dentro del límite aplicado. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Obtener el número de artículos disponibles para un usuario especificado - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/get-user-item-limit.md): Obtiene el número restante de artículos disponibles para el usuario especificado dentro del límite aplicado. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Aumentar el número de artículos disponibles para el usuario especificado - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/add-user-item-limit.md): Aumenta el número restante de artículos disponibles para el usuario especificado dentro del límite aplicado. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Establecer el número de artículos disponibles para el usuario especificado - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/set-user-item-limit.md): Establece el número de artículos que el usuario especificado puede comprar dentro del límite aplicado después de que se haya aumentado o reducido. La API de límite del usuario le permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Actualizar límite de compra - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/reset-user-item-limit.md): Actualiza el límite de compra de un artículo para que un usuario pueda volver a comprarlo. Si el parámetro user es null, esta llamada actualiza este límite para todos los usuarios. La API de límite del usuario permite vender un artículo en una cantidad limitada. Para configurar los límites de compra, vaya a Admin del módulo del tipo de artículo deseado: * Game Keys * Virtual Items & Currency * Bundles ### Actualizar todos los límites de la promoción para un usuario especificado - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/reset-all-user-promotions-limit.md): Actualiza todos los límites de todas las promociones destinadas al usuario especificado para que pueda utilizar estas promociones de nuevo. La API de límite del usuario le permite limitar el número de veces que los usuarios pueden utilizar una promoción. Para configurar el límite del usuario, vaya a la sección Admin del tipo de promoción deseada: * Discount Promotions * Bonus Promotions ### Reducir el límite de la promoción para el usuario especificado - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/remove-user-promotion-limit.md): Reduce el número de veces que el usuario especificado puede utilizar una promoción dentro del límite aplicado. La API de límite de usuarios permite limitar el número de veces que los usuarios pueden utilizar una promoción. Para configurar el límite de usuario, vaya a la sección Admin del tipo de promoción deseado: * Discount Promotions * Bonus Promotions ### Obtener el límite de promoción para el usuario especificado - [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/get-user-promotion-limit.md): Obtiene el número restante de veces que el usuario especificado puede utilizar la promoción dentro del límite aplicado. La API de límite de usuarios permite limitar el número de veces que los usuarios pueden usar una promoción. Para configurar el límite de usuario, vaya a la sección Admin del tipo de promoción deseado: * Discount Promotions * Bonus Promotions ### Aumentar el límite de la promoción para el usuario especificado - [POST /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/add-user-promotion-limit.md): Aumenta el número restante de veces que el usuario especificado puede utilizar la promoción dentro del límite aplicado. La API de límite de usuarios permite limitar el número de veces que los usuarios pueden usar una promoción. Para configurar el límite de usuario, vaya a la sección Admin del tipo de promoción deseado: * Discount Promotions * Bonus Promotions ### Establecer el límite de la promoción para el usuario especificado - [PUT /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/set-user-promotion-limit.md): Establece el número de veces que el usuario especificado puede usar una promoción dentro del límite aplicado después de que se haya aumentado o reducido. La API de límite del usuario le permite limitar el número de veces que los usuarios pueden utilizar una promoción. Para configurar el límite de usuario, vaya a la sección Admin del tipo de promoción deseado: * Discount Promotions * Bonus Promotions ### Actualizar el límite de promoción para los usuarios - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/es/api/shop-builder/user-limits-admin/reset-user-promotion-limit.md): Actualiza el límite de la promoción para que un usuario pueda utilizar esta promoción de nuevo. Si el parámetro user es null, esta llamada actualiza este límite para todos los usuarios. La API de límite del usuario le permite limitar el número de veces que los usuarios pueden usar una promoción. Para configurar el límite del usuario, vaya a la sección Admin del tipo de promoción deseada: * Discount Promotions * Bonus Promotions ## Admin ### Obtener lista de puntos de valor - [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-get-value-points-list.md): Obtiene la lista de puntos de valor dentro de un proyecto para su administración. ### Crear un punto de valor - [POST /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-create-value-points.md): Crea un punto de valor. ### Eliminar puntos de valor - [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-delete-value-point.md): Elimina un punto de valor identificado por un SKU. ### Obtener punto de valor - [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-get-value-point.md): Obtiene un punto de valor por el SKU dentro de un proyecto para su administración. ### Actualizar punto de valor - [PUT /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-update-value-point.md): Actualiza un punto de valor identificado por un SKU. ### Eliminar puntos de valor de los artículos - [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): Elimina las recompensas de puntos de valor de TODOS los artículos. ### Obtener lista de artículos con puntos de valor - [GET /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-get-items-value-point-reward.md): Obtiene la lista de todos los artículos con puntos de valor dentro de un proyecto para su administración. ### Actualizar parcialmente los puntos de valor para los artículos - [PATCH /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-patch-items-value-point-reward.md): Actualiza parcialmente la cantidad de puntos de valor de uno o más artículos según el SKU del artículo. Los usuarios reciben estos puntos de valor después de comprar los artículos especificados. Principios de actualización de los puntos de valor: * Si un artículo aún no tiene puntos de valor, el envío de un valor distinto de cero en el campo amount los genera. * Si un artículo ya tiene puntos de valor, enviar un valor distinto de cero en el campo amount los actualiza. * Si amount se establece en 0, se eliminan los puntos de valor existentes para ese artículo. A diferencia del método PUT (Establecer puntos de valor para artículos), este método PATCH no sobrescribe todos los puntos de valor existentes para los artículos del proyecto, solo actualiza los artículos especificados. Una sola solicitud puede actualizar hasta 100 artículos. No se pueden incluir SKU de artículos duplicados en la misma solicitud. ### Establecer puntos de valor para los artículos - [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-set-items-value-point-reward.md): Asigna puntos de valor a uno o varios artículos por un SKU. Los usuarios reciben puntos de valor después de comprar estos artículos. Recuerde que esta solicitud PUT sobrescribe todos los puntos de valor establecidos previamente para los artículos del proyecto. Para evitar la eliminación involuntaria de puntos de valor, incluya todos los artículos y sus respectivos puntos de valor en cada solicitud PUT. Si solo desea actualizar los puntos de valor de un artículo específico conservando los puntos de valor de otros artículos, debe recuperar el conjunto actual de puntos de valor mediante una solicitud GET, modificar los puntos de valor del artículo deseado y, luego, devolver el conjunto modificado de puntos de valor con los puntos de valor actualizados para el artículo específico. ### Obtener lista de cadenas de recompensas - [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chains.md): Obtiene la lista de cadenas de recompensas. AtenciónTodos 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 10 artículos por respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### Crear una cadena de recompensas - [POST /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-create-reward-chain.md): Crea una cadena de recompensas. ### Eliminar cadena de recompensas - [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-delete-reward-chain.md): Elimina una cadena de recompensas concreta. ### Obtener cadena de recompensas - [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chain.md): Consigue una cadena de recompensas concreta. ### Actualizar cadena de recompensas - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-update-reward-chain.md): Actualiza una cadena de recompensas concreta. ### Restablecer cadena de recompensas - [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-reset-reward-chain.md): Restablece los puntos de valor y el progreso de todos los usuarios de la cadena de recompensas. Tras el restablecimiento, puede actualizar el periodo de validez de la cadena de recompensas y el usuario puede volver a hacer progresos en ella. Aviso No debe restablecer la cadena de recompensas durante su periodo de validez. En este caso, los usuarios pueden perder los puntos de valor ganados antes de reclamar su recompensa. ### Activar/desactivar cadena de recompensas - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/es/api/shop-builder/reward-chain-value-points-admin/admin-toggle-reward-chain.md): Habilitar/deshabilitar cadena de recompensas. ## Cliente ### Obtener las cadenas de recompensas del usuario actual - [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/es/api/shop-builder/reward-chain-client/get-reward-chains-list.md): Punto final de cliente. Obtiene las cadenas de recompensas del usuario actual. AtenciónTodos los proyectos tienen la limitación del número de artículos que se pueden obtener en la respuesta. El valor máximo y por defecto es 50 artículos por respuesta. Para obtener más datos página por página, utilice los campos limit y offset. ### Obtener el saldo de puntos de valor del usuario actual - [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/es/api/shop-builder/reward-chain-client/get-user-reward-chain-balance.md): Punto final del cliente. Obtiene el saldo de puntos de valor del usuario actual. ### Reclamar recompensa por paso - [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/es/api/shop-builder/reward-chain-client/claim-user-reward-chain-step-reward.md): Punto final del cliente. Reclama la recompensa por paso del usuario actual de una cadena de recompensas. ## Cliente de clanes ### Obtén los 10 mejores contribuyentes a la cadena de recompensas bajo clan - [GET /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top](https://developers.xsolla.com/es/api/shop-builder/clan-reward-chain-client/get-user-clan-top-contributors.md): Recupera la lista de los 10 contribuyentes principales a la cadena de recompensas específica bajo el clan del usuario actual. Si un usuario no pertenece a un clan, la llamada devuelve una matriz vacía. ### Actualice el clan del usuario actual - [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/es/api/shop-builder/clan-reward-chain-client/user-clan-update.md): Actualiza el clan de un usuario actual a través de los atributos de usuario. Reclama todas las recompensas de las cadenas de recompensas que no se reclamaron para un clan anterior y las devuelve en la respuesta. Si el usuario estaba en un clan y ahora no lo está, se revocará su inclusión en el clan. Si el usuario cambió de clan, se cambiará el clan. ## Admin ### Obtener lista de cadenas de ofertas - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/es/api/shop-builder/offer-chain-admin/admin-get-offer-chains.md): Obtiene la lista de cadenas de ofertas para su administración. AvisoTodos los proyectos tienen un límite en el número de artículos que se pueden devolver en una sola respuesta. El valor por defecto y máximo es 10 artículos por respuesta. Para obtener más datos, utilice los parámetros de consulta limit y offset para la paginación. ### Crear cadena de ofertas - [POST /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/es/api/shop-builder/offer-chain-admin/admin-create-offer-chain.md): Crea una cadena de ofertas. ### Eliminar cadena de ofertas - [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/es/api/shop-builder/offer-chain-admin/admin-delete-offer-chain.md): Elimina una cadena de ofertas determinada. Tras la eliminación:Se mantienen todas las recompensas ya recibidas por los usuarios.Los pasos no completados dejan de estar disponibles y ya no se pueden obtener sus recompensas. A diferencia de la desactivación de la cadena de ofertas mediante la llamada Activar o desactivar cadena de ofertas, la eliminación es irreversible y no se mantiene el progreso del usuario. ### Obtener cadena de ofertas - [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/es/api/shop-builder/offer-chain-admin/admin-get-offer-chain.md): Obtiene una cadena de ofertas concreta para su administración. ### Actualizar cadena de ofertas - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/es/api/shop-builder/offer-chain-admin/admin-update-offer-chain.md): Actualiza una cadena de ofertas determinada. ### Activar o desactivar cadena de ofertas - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/es/api/shop-builder/offer-chain-admin/admin-toggle-offer-chain.md): Activa o desactiva una cadena de ofertas. Cuando se desactiva la cadena de ofertas, los usuarios pierden temporalmente el acceso a ella, pero se guarda su progreso. Cuando se vuelve a activar la cadena de ofertas, los usuarios pueden continuar desde el paso en el que lo dejaron. ## Admin ### Obtener lista de recompensas diarias - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/es/api/shop-builder/daily-chain-admin/admin-get-daily-chains.md): Obtiene una lista de recompensas diarias para su administración. AvisoUn método devuelve una lista paginada de artículos. El valor máximo y por defecto es 50 artículos por respuesta. Para obtener más artículos de la lista, utilice los parámetros limit y offset y obtenga más páginas. Por ejemplo, al llamar a un método con limit = 25 y offset = 100, la respuesta devuelve 25 artículos empezando por el artículo 101 de la lista global. ### Crear recompensa diaria - [POST /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/es/api/shop-builder/daily-chain-admin/admin-create-daily-chain.md): Crea una recompensa diaria. ### Eliminar recompensa diaria - [DELETE /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/es/api/shop-builder/daily-chain-admin/admin-delete-daily-chain.md): Elimina una recompensa diaria concreta. ### Obtener recompensa diaria - [GET /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/es/api/shop-builder/daily-chain-admin/admin-get-daily-chain.md): Obtiene una recompensa diaria concreta para su administración. ### Actualizar recompensa diaria - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/es/api/shop-builder/daily-chain-admin/admin-update-daily-chain.md): Actualiza una recompensa diaria concreta. ### Restablecer recompensa diaria - [POST /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset](https://developers.xsolla.com/es/api/shop-builder/daily-chain-admin/admin-reset-daily-chain.md): Restablece el progreso de todos los usuarios en la recompensa diaria. Solo se aplica a las recompensas diarias del tipo rolling. ### Activar o desactivar recompensa diaria - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/es/api/shop-builder/daily-chain-admin/admin-toggle-daily-chain.md): Activa o desactiva una recompensa diaria. ## Cliente ### Obtener recompensas diarias del usuario actual - [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/es/api/shop-builder/daily-chain-client/get-daily-chains-list.md): Punto final de cliente. Obtiene las recompensas diarias del usuario actual. AvisoUn método devuelve una lista paginada de artículos. El valor máximo y por defecto es 50 artículos por respuesta. Para obtener más artículos de la lista, utilice los parámetros limit y offset y obtenga más páginas. Por ejemplo, al llamar a un método con limit = 25 y offset = 100, la respuesta devuelve 25 artículos empezando por el artículo 101 de la lista global. ### Obtener recompensa diaria del usuario actual por su ID - [GET /v2/project/{project_id}/user/daily_chain/{daily_chain_id}](https://developers.xsolla.com/es/api/shop-builder/daily-chain-client/get-user-daily-chain-by-id.md): Punto final de cliente. Obtiene la recompensa diaria del usuario actual por su ID. ### Reclamar paso de recompensa diaria - [POST /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/es/api/shop-builder/daily-chain-client/claim-user-daily-chain-step-reward.md): Punto final de cliente. Reclama la recompensa por pasos del usuario actual de una recompensa diaria. Todos los pasos solo se pueden reclamar en orden secuencial. La recompensa por un paso omitido no se puede obtener a cambio de moneda virtual o real, ni viendo un anuncio. ## Admin ### Obtener información sobre la venta adicional en proyecto - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/es/api/shop-builder/upsell-admin/get-upsell-configurations-for-project-admin.md): Recupera la información sobre la venta adicional en el proyecto: si está activada, el tipo de venta adicional y la lista de SKU de los artículos que forman parte de esta venta adicional. ### Crear venta adicional - [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/es/api/shop-builder/upsell-admin/post-upsell.md): Crea una venta adicional para un proyecto. ### Actualizar venta adicional - [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/es/api/shop-builder/upsell-admin/put-upsell.md): Actualizar una venta adicional de un proyecto. ### Activar/Desactivar la venta adicional de un proyecto - [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/es/api/shop-builder/upsell-admin/put-upsell-toggle-active-inactive.md): Cambia el estado de una venta adicional en un proyecto a activo o inactivo. ## Cliente ### Obtener lista de artículos de venta adicional en proyecto - [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/es/api/shop-builder/upsell-client/get-upsell-for-project-client.md): Obtiene una lista de los artículos de venta adicional en un proyecto si ya han sido configurados. ## Admin ### Obtener el estado de la importación de artículos - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/es/api/shop-builder/connector-admin/get-items-import-status.md): Recupera información sobre el progreso de la importación de artículos al proyecto. Esta llamada API recupera datos sobre la última importación realizada mediante la API o mediante Cuenta del editor. ### Importar artículos mediante un archivo JSON - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/es/api/shop-builder/connector-admin/import-items-from-external-file.md): Importa artículos a la tienda desde un archivo JSON mediante la URL especificada. Consulte la documentación para obtener más información sobre la importación desde un archivo JSON.