# LiveOps 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 LiveOps API ofrece endpoints para impulsar la participación de los jugadores. 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 [LiveOps API](https://developers.xsolla.com/_bundle/@l10n/es/api/liveops/index.yaml) ## Común ### Activar promoción - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/es/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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. ## 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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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). ## Gestión ### 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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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 recompensas diarias - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/es/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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 lista de cadenas de ofertas - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/es/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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. ## Cliente ### Obtener las cadenas de ofertas del usuario actual - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/es/api/liveops/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/liveops/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/liveops/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/liveops/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. ## payment-client-side ### 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/liveops/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. ## Admin ### Obtener información sobre la venta adicional en proyecto - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/es/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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.