Límites de compra de artículos
Cómo funciona
Puede establecer un límite de compra por usuario y configurar reinicios programados de estos límites.
La configuración de límites está disponible para los siguientes escenarios:
- venta de artículos del juego (artículos virtuales, paquetes de moneda virtual y lotes)
- venta de juegos y DLC mediante claves del juego
Puede habilitar reinicios periódicos de límites para:
- Permitir compras repetidas.
- Sincronizar los datos con su sistema cuando los artículos se vendan en múltiples plataformas de publicación de juegos.
Para mostrar correctamente la cantidad disponible para un usuario, debe configurar la autenticación.
Los usuarios no autenticados siempre ven la cantidad máxima de artículos que pueden comprar. Para mostrar la cantidad de artículos que le quedan al usuario con el límite activo aplicado, incluya los datos de autorización del usuario al solicitar:
- El catálogo de artículos mediante llamadas de la subsección Сatálogo del grupo Artículos virtuales y moneda.
- El catálogo de juegos mediante llamadas de la subsección Сatálogo del grupo Claves de juego.
Xsolla aplica límites e impide que los usuarios compren más artículos del límite establecido:
- Cuando se abre la interfaz de pago y se paga un artículo, todos los pedidos pendientes de pago que contengan ese artículo dejan de ser válidos.
- Ejemplo: Un usuario puede abrir el formulario de pago de un artículo limitado en varias pestañas del navegador o en diferentes navegadores antes de realizar la compra, lo que genera varios pedidos del mismo artículo. Una vez completada la compra en una pestaña, Xsolla cancela todos los pedidos pendientes de pago de ese artículo.
- Cuando se reembolsa un pago o se cancela un pedido, no se reinician los límites. Pueden reiniciarlos mediante las siguientes llamadas API: Actualizar todos los límites de compra para un usuario especificado y Actualizar todos los límites de la promoción para un usuario especificado.
- Ejemplo: Un usuario puede comprar un artículo que tiene límites de compra, usarlo en el juego y después solicitar un reembolso. Si los límites se reiniciaran automáticamente, el usuario podría volver a comprar el artículo, usarlo y repetir este ciclo, eludiendo así los límites previstos. Para evitarlo, los límites no se reinician cuando se reembolsa un pago o se cancela un pedido.
Para configurar límites de uso de promociones, consulte las instrucciones.
Configurar y actualizar límites
Configurar y actualizar en Cuenta del editor
- El proceso de configuración que se muestra a continuación utiliza artículos virtuales como ejemplo.
- Antes de configurar artículos virtuales, se recomienda crear grupos. Los grupos permiten crear un catálogo multinivel y gestionar cómo se muestran los artículos en su tienda.
- En Cuenta del editor, pueden actualizar los límites de un artículo específico para todos los usuarios. Hay opciones de configuración avanzadas mediante llamadas API.
Para crear un artículo con un límite de usos:
- Abra su proyecto en la Cuenta del editor y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra su proyecto en la cuenta para juegos en móviles y vaya a la sección Catalog.
- Haga clic en Create manually y seleccione Virtual item en la lista desplegable.
- En la sección General settings, especifique lo siguiente:
- SKU
- uno o varios grupos a los que debe pertenecer el artículo (opcional)
- nombre
- descripción breve
- descripción ampliada: para añadirla, active la opción correspondiente (opcional)
- En la sección Media, suba una o varias imágenes o vídeos (opcional), desde su dispositivo o mediante un enlace. En la tienda creada con el editor de sitios web de Xsolla, todas las tarjetas de artículo muestran el archivo marcado como Main, mientras que los archivos restantes solo están disponibles en tarjetas de artículo con una galería multimedia. El archivo marcado como Main también se devuelve en las respuestas de las llamadas API de obtención del catálogo.
- En la sección Price settings, defina los precios o cree un artículo gratuito:
- Para establecer un precio, seleccione Paid item, active la opción Pricing in real currency o Pricing in virtual currency, y especifique el precio. Si es necesario, configure los precios regionales.
- Para crear un artículo gratuito, seleccione Free item.
Un artículo puede tener precios en varias monedas reales y virtuales. En este caso, debe especificar una moneda predeterminada para cada tipo: una entre las monedas reales y otra entre las monedas virtuales.
Puede especificar un precio en moneda virtual solo si la moneda virtual ya se ha creado en el proyecto.
- Para limitar la cantidad de artículos disponibles para la compra:
- Active la opción en la sección Limits e indique la cantidad.
- Configure la frecuencia de restablecimiento del límite. Para ello, seleccione un periodo en la lista desplegable:
- Daily.
- Weekly.
- Monthly.
- Custom interval. El intervalo se calcula desde la fecha de inicio de visualización del artículo en la tienda.
- No regular refresh.
- Configure la programación del restablecimiento indicando los parámetros correspondientes al periodo seleccionado.
Para configurar un límite de tiempo de visualización del artículo (opcional):
- Active la opción en la sección Add specific display period.
- Especifique la zona horaria, el inicio y el final del periodo.
Para dejar sin especificar el final del periodo de visualización del artículo, active la opción No end date.
- Configure los atributos con una de las siguientes opciones (opcional):
- Si el artículo de pago se va a usar en alguna mecánica con recompensa aleatoria (por ejemplo, cajas de botín o gacha), active la opción Mark as paid randomized reward.
Haga clic en Create.
En la ventana que se abre, seleccione el estado del artículo y haga clic en Continue.
El artículo creado aparecerá en la sección All items.
Para configurar o actualizar los límites de un artículo existente:
Configurar y actualizar en su cuenta
- El proceso de configuración que se muestra a continuación utiliza artículos virtuales como ejemplo.
- Antes de configurar artículos virtuales, se recomienda crear grupos. Los grupos permiten crear un catálogo multinivel y gestionar cómo se muestran los artículos en su tienda.
- En su cuenta, puede actualizar los límites de un artículo específico para todos los usuarios. Hay opciones de configuración avanzadas mediante llamadas API.
Para crear un artículo con un límite de usos:
- Abra su proyecto en la Cuenta del editor y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra su proyecto en la cuenta para juegos en móviles y vaya a la sección Catalog.
- Haga clic en Create manually y seleccione Virtual item en la lista desplegable.
- En la sección General settings, especifique lo siguiente:
- SKU
- uno o varios grupos a los que debe pertenecer el artículo (opcional)
- nombre
- descripción breve
- descripción ampliada: para añadirla, active la opción correspondiente (opcional)
- En la sección Media, suba una o varias imágenes o vídeos (opcional), desde su dispositivo o mediante un enlace. En la tienda creada con el editor de sitios web de Xsolla, todas las tarjetas de artículo muestran el archivo marcado como Main, mientras que los archivos restantes solo están disponibles en tarjetas de artículo con una galería multimedia. El archivo marcado como Main también se devuelve en las respuestas de las llamadas API de obtención del catálogo.
- En la sección Price settings, defina los precios o cree un artículo gratuito:
- Para establecer un precio, seleccione Paid item, active la opción Pricing in real currency o Pricing in virtual currency, y especifique el precio. Si es necesario, configure los precios regionales.
- Para crear un artículo gratuito, seleccione Free item.
Un artículo puede tener precios en varias monedas reales y virtuales. En este caso, debe especificar una moneda predeterminada para cada tipo: una entre las monedas reales y otra entre las monedas virtuales.
Puede especificar un precio en moneda virtual solo si la moneda virtual ya se ha creado en el proyecto.
- Para limitar la cantidad de artículos disponibles para la compra:
- Active la opción en la sección Limits e indique la cantidad.
- Configure la frecuencia de restablecimiento del límite. Para ello, seleccione un periodo en la lista desplegable:
- Daily.
- Weekly.
- Monthly.
- Custom interval. El intervalo se calcula desde la fecha de inicio de visualización del artículo en la tienda.
- No regular refresh.
- Configure la programación del restablecimiento indicando los parámetros correspondientes al periodo seleccionado.
Para configurar un límite de tiempo de visualización del artículo (opcional):
- Active la opción en la sección Add specific display period.
- Especifique la zona horaria, el inicio y el final del periodo.
Para dejar sin especificar el final del periodo de visualización del artículo, active la opción No end date.
- Configure los atributos con una de las siguientes opciones (opcional):
- Si el artículo de pago se va a usar en alguna mecánica con recompensa aleatoria (por ejemplo, cajas de botín o gacha), active la opción Mark as paid randomized reward.
Haga clic en Create.
En la ventana que se abre, seleccione el estado del artículo y haga clic en Continue.
El artículo creado aparecerá en la sección All items.
Para configurar o actualizar los límites de un artículo existente:
Configurar y actualizar en su cuenta
- El proceso de configuración que se muestra a continuación utiliza artículos virtuales como ejemplo.
- Antes de configurar artículos virtuales, se recomienda crear grupos. Los grupos permiten crear un catálogo multinivel y gestionar cómo se muestran los artículos en su tienda.
- En su cuenta, puede actualizar los límites de un artículo específico para todos los usuarios. Hay opciones de configuración avanzadas mediante llamadas API.
Para crear un artículo con un límite de usos:
- Abra su proyecto en la Cuenta del editor y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a Items catalog > All items > Virtual items.
- Abra su proyecto en la cuenta para juegos en móviles y vaya a la sección Catalog.
- Haga clic en Create manually y seleccione Virtual item en la lista desplegable.
- En la sección General settings, especifique lo siguiente:
- SKU
- uno o varios grupos a los que debe pertenecer el artículo (opcional)
- nombre
- descripción breve
- descripción ampliada: para añadirla, active la opción correspondiente (opcional)
- En la sección Media, suba una o varias imágenes o vídeos (opcional), desde su dispositivo o mediante un enlace. En la tienda creada con el editor de sitios web de Xsolla, todas las tarjetas de artículo muestran el archivo marcado como Main, mientras que los archivos restantes solo están disponibles en tarjetas de artículo con una galería multimedia. El archivo marcado como Main también se devuelve en las respuestas de las llamadas API de obtención del catálogo.
- En la sección Price settings, defina los precios o cree un artículo gratuito:
- Para establecer un precio, seleccione Paid item, active la opción Pricing in real currency o Pricing in virtual currency, y especifique el precio. Si es necesario, configure los precios regionales.
- Para crear un artículo gratuito, seleccione Free item.
Un artículo puede tener precios en varias monedas reales y virtuales. En este caso, debe especificar una moneda predeterminada para cada tipo: una entre las monedas reales y otra entre las monedas virtuales.
Puede especificar un precio en moneda virtual solo si la moneda virtual ya se ha creado en el proyecto.
- Para limitar la cantidad de artículos disponibles para la compra:
- Active la opción en la sección Limits e indique la cantidad.
- Configure la frecuencia de restablecimiento del límite. Para ello, seleccione un periodo en la lista desplegable:
- Daily.
- Weekly.
- Monthly.
- Custom interval. El intervalo se calcula desde la fecha de inicio de visualización del artículo en la tienda.
- No regular refresh.
- Configure la programación del restablecimiento indicando los parámetros correspondientes al periodo seleccionado.
Para configurar un límite de tiempo de visualización del artículo (opcional):
- Active la opción en la sección Add specific display period.
- Especifique la zona horaria, el inicio y el final del periodo.
Para dejar sin especificar el final del periodo de visualización del artículo, active la opción No end date.
- Configure los atributos con una de las siguientes opciones (opcional):
- Si el artículo de pago se va a usar en alguna mecánica con recompensa aleatoria (por ejemplo, cajas de botín o gacha), active la opción Mark as paid randomized reward.
Haga clic en Create.
En la ventana que se abre, seleccione el estado del artículo y haga clic en Continue.
El artículo creado aparecerá en la sección All items.
Para configurar o actualizar los límites de un artículo existente:
- Abra su proyecto en Cuenta del editor y vaya a la sección Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a la sección Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a la sección Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta y vaya a la sección Items catalog > All items > Virtual items.
- Abra el proyecto en su cuenta para juegos en móviles y vaya a la sección Catalog > Virtual items.
- Abra el grupo que contiene el artículo.
- En la fila del artículo, haga clic en ••• y seleccione Edit en la lista desplegable.
- En la sección Limits for single user, establezca el límite y/o seleccione la frecuencia de reinicio del límite y, luego, especifique la hora y la zona horaria.
- Haga clic en Save changes.
Configurar y actualizar mediante llamadas API
Para configurar los límites de compra de artículos mediante la API, use el objeto limits en los siguientes métodos:
Para establecer una actualización de límites diaria, semanal o mensual, transmita el objeto limits.recurrent_schedule.
Si tiene configurado un periodo de actualización de límites, también puede controlar si el artículo se mantiene visible en el catálogo tras alcanzar el límite de compra. Para ello, transmita el parámetro “limits.per_user.limit_exceeded_visibility”: “show”.
Si no está configurada ninguna actualización periódica, el artículo se oculta del catálogo tras alcanzar el límite, independientemente del valor del parámetro.
Para actualizar y gestionar los límites mediante API, use los métodos de la subsección Management del grupo de métodos Limits.
| Función | Llamada API |
|---|---|
| Actualizar los límites de un artículo especificado para todos los usuarios o usuarios específicos. | Actualizar límite de compra. |
| Borrar todos los límites de artículos para un usuario especificado. | Borrar todos los límites de compra para un usuario especificado. |
| Cambiar el límite de compra de un artículo especificado para un usuario especificado. | Establecer el número de artículos disponibles para un usuario especificado. |
| Obtener información sobre qué límites están configurados para un artículo especificado y un usuario especificado. | Obtener el número de artículos disponibles para un usuario especificado. |
| Aumentar la cantidad de artículos que puede comprar un usuario especificado. | Aumentar el número de artículos disponibles para un usuario especificado. |
| Disminuir la cantidad de artículos que puede comprar un usuario especificado. | Disminuir el número de artículos disponibles para un usuario especificado. |
Mostrar los límites en el catálogo de artículos
Los límites de venta de artículos se muestran en el catálogo en función de cómo esté implementado: a través de Site Builder o mediante la API.
Mostrar mediante el creador de sitios web
Si utiliza el creador de sitios web, los límites se muestran automáticamente: una ficha de artículo muestra un contador de los artículos disponibles para el usuario.
Obtener información de límites mediante la API
Si el catálogo se implementa mediante API, la información sobre los límites se devuelve en la matriz items.limits en las siguientes llamadas API relacionadas con el catálogo:
- Obtener lista de artículos virtuales
- Obtener lista de monedas virtuales
- Obtener lista de paquetes de moneda virtual
- Obtener lista de lotes
- Obtener lista de juegos
Los artículos para los que el usuario ha alcanzado el límite de compra se devuelven con can_be_bought = false.
Puede actualizar estos límites según sea necesario.
Estos datos se pueden utilizar para mostrar límites en el catálogo, por ejemplo, para mostrar el número máximo de artículos que se pueden comprar.
Enlaces útiles
Última actualización: 14 de Octubre de 2026¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.
