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, deben 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 Catalog del grupo Virtual Items & Currency.
- El catálogo de juegos mediante llamadas de la subsección Catalog del grupo Game Keys.
Xsolla aplica límites e impide que los usuarios compren más artículos de lo 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 completar 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, consulten las instrucciones.
Configurar y actualizar límites
Configurar y actualizar en la 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 la 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:
- Abran su proyecto en la Cuenta del editor y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran su proyecto en la cuenta para juegos para móviles y vayan a la sección Catalog.
- Hagan clic en Create manually y seleccionen Virtual item en la lista desplegable.
- En la sección General settings, indiquen 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, activen el conmutador correspondiente (opcional).
- En la sección Media, suban 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 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 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, establezcan los precios o creen un artículo gratuito:
- Para establecer un precio, seleccionen Paid item, activen el conmutador Real currency prices y/o Virtual currency prices y especifiquen el precio. Si es necesario, configuren los precios regionales.
- Para crear un artículo gratuito, seleccionen Free item.
Un artículo puede tener precios en varias monedas reales y virtuales. En este caso, deben especificar una moneda predeterminada para cada tipo: una entre las monedas reales y otra entre las monedas virtuales.
Pueden 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:
- Activen el conmutador en la sección Limits e indiquen la cantidad.
- Configuren la frecuencia de restablecimiento del límite. Para ello, seleccionen 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.
- Configuren 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):
- Activen el conmutador en la sección Add specific display period.
- Especifiquen la zona horaria, el inicio y el final del periodo.
Para dejar sin especificar el final del periodo de visualización del artículo, activen el conmutador No end date.
- Configuren los atributos con una de las siguientes opciones (opcional):
- Si el artículo de pago se usará en alguna mecánica con recompensa aleatoria (p. ej., cajas de botín o gacha), activen el conmutador Mark as paid randomized reward.
Hagan clic en Create.
En la ventana que se abre, seleccionen el estado del artículo y hagan 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 la Cuenta del editor y vaya a la sección Items catalog > All items > Virtual items.
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, 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:
- Abran su proyecto en la Cuenta del editor y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran su proyecto en la cuenta para juegos para móviles y vayan a la sección Catalog.
- Hagan clic en Create manually y seleccionen Virtual item en la lista desplegable.
- En la sección General settings, indiquen 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, activen el conmutador correspondiente (opcional).
- En la sección Media, suban 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 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 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, establezcan los precios o creen un artículo gratuito:
- Para establecer un precio, seleccionen Paid item, activen el conmutador Real currency prices y/o Virtual currency prices y especifiquen el precio. Si es necesario, configuren los precios regionales.
- Para crear un artículo gratuito, seleccionen Free item.
Un artículo puede tener precios en varias monedas reales y virtuales. En este caso, deben especificar una moneda predeterminada para cada tipo: una entre las monedas reales y otra entre las monedas virtuales.
Pueden 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:
- Activen el conmutador en la sección Limits e indiquen la cantidad.
- Configuren la frecuencia de restablecimiento del límite. Para ello, seleccionen 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.
- Configuren 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):
- Activen el conmutador en la sección Add specific display period.
- Especifiquen la zona horaria, el inicio y el final del periodo.
Para dejar sin especificar el final del periodo de visualización del artículo, activen el conmutador No end date.
- Configuren los atributos con una de las siguientes opciones (opcional):
- Si el artículo de pago se usará en alguna mecánica con recompensa aleatoria (p. ej., cajas de botín o gacha), activen el conmutador Mark as paid randomized reward.
Hagan clic en Create.
En la ventana que se abre, seleccionen el estado del artículo y hagan 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 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.
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, 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:
- Abran su proyecto en la Cuenta del editor y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran el proyecto en su cuenta y vayan a la sección Items catalog > All items > Virtual items.
- Abran su proyecto en la cuenta para juegos para móviles y vayan a la sección Catalog.
- Hagan clic en Create manually y seleccionen Virtual item en la lista desplegable.
- En la sección General settings, indiquen 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, activen el conmutador correspondiente (opcional).
- En la sección Media, suban 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 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 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, establezcan los precios o creen un artículo gratuito:
- Para establecer un precio, seleccionen Paid item, activen el conmutador Real currency prices y/o Virtual currency prices y especifiquen el precio. Si es necesario, configuren los precios regionales.
- Para crear un artículo gratuito, seleccionen Free item.
Un artículo puede tener precios en varias monedas reales y virtuales. En este caso, deben especificar una moneda predeterminada para cada tipo: una entre las monedas reales y otra entre las monedas virtuales.
Pueden 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:
- Activen el conmutador en la sección Limits e indiquen la cantidad.
- Configuren la frecuencia de restablecimiento del límite. Para ello, seleccionen 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.
- Configuren 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):
- Activen el conmutador en la sección Add specific display period.
- Especifiquen la zona horaria, el inicio y el final del periodo.
Para dejar sin especificar el final del periodo de visualización del artículo, activen el conmutador No end date.
- Configuren los atributos con una de las siguientes opciones (opcional):
- Si el artículo de pago se usará en alguna mecánica con recompensa aleatoria (p. ej., cajas de botín o gacha), activen el conmutador Mark as paid randomized reward.
Hagan clic en Create.
En la ventana que se abre, seleccionen el estado del artículo y hagan 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 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, usen 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 tienen configurado un periodo de actualización de límites, también pueden controlar si el artículo se mantiene visible en el catálogo tras alcanzar el límite de compra. Para ello, pasen 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. |
| Actualizar todos los límites de artículos para un usuario especificado. | Actualizar 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 según cómo esté implementado: a través de Site Builder o mediante la API.
Mostrar a través de Site Builder
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: 15 de Mayo de 2026¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.
