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 de 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
- el catálogo de artículos utilizando llamadas desde la subsección Сatálogo del grupo Virtual Items & Currency
- el catálogo de juegos utilizando llamadas desde la subsección Catálogo 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 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. Puede reiniciarlos utilizando 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, utilizarlo en el juego y luego solicitar un reembolso. Si los límites se reiniciaran automáticamente, el usuario podría volver a comprar el artículo, utilizarlo y repetir este ciclo, saltándose así los límites establecidos. Para evitarlo, los límites no se reinician cuando se reembolsa un pago o se cancela un pedido.
Configurar y actualizar límites
Configurar y actualizar en Cuenta del editor
- El proceso de configuración que se describe a continuación se muestra utilizando artículos virtuales como ejemplo.
- Antes de configurar los artículos virtuales, recomendamos crear grupos. Los grupos le permiten crear un catálogo de varios niveles y gestionar cómo se muestran los artículos en su tienda.
- En Cuenta del editor, puede actualizar los límites de un artículo específico para todos los usuarios. Las opciones de configuración avanzadas están disponibles mediante llamadas API.
- Abra su proyecto en Cuenta del editor y vaya a Items catalog > All items > Virtual items.
- Haga clic en Add y seleccione Virtual items.
- Especifique los siguientes parámetros:
- imagen
- SKU
- uno o varios grupos a los que debe pertenecer el artículo
- nombre
- descripción
- precios
- Para limitar el número de veces que un usuario puede comprar un artículo, active la opción Limit the number of times one user can buy this item y especifique el límite.
- Para establecer la frecuencia con la que se actualizan los límites:
- En la lista desplegable, seleccione el periodo:
- Daily
- Weekly
- Monthly
- Custom interval. El intervalo se calcula a partir de la fecha de inicio del periodo de visualización del artículo en la tienda.
- No regular refresh
- En la lista desplegable, seleccione el periodo:
- Configure la programación de actualizaciones especificando los parámetros correspondientes al periodo.
- Para establecer un periodo de visualización del artículo en el catálogo, seleccione Limited time, especifique la zona horaria y la fecha de inicio y fin. Si quiere que el artículo esté disponible de forma indefinida, seleccione No end date.
- Haga clic en Create item.
Para configurar o actualizar los límites de un artículo existente:
- Abra su proyecto en Cuenta del editor y vaya a Items catalog > All items > 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 o seleccione la frecuencia de reinicio del límite y, después, especifique la hora y la zona horaria.
- Haga clic en Save changes.

Configuración y actualización mediante llamadas API
Para establecer límites diarios, semanales o mensuales, transmita la matriz recurrent_schedule en las siguientes llamadas API:
| Función | Llamada API |
|---|---|
| Actualizar los límites para un artículo específico para todos los usuarios o para usuarios específicos. | Actualizar límite de compra. |
| Borrar todos los límites de artículos para un usuario específico. | Actualizar todos los límites de compra para un usuario especificado. |
| Cambiar el límite de compra de un artículo específico para un usuario específico. | Establecer el número de artículos disponibles para un usuario específico. |
| Obtener información sobre los límites configurados para un artículo específico para un usuario específico. | Obtener el número de artículos disponibles para un usuario específico. |
| Aumentar el número de artículos que un usuario específico puede comprar. | Aumentar el número de artículos disponibles para un usuario específico. |
| Reducir el número de artículos que un usuario específico puede comprar. | Reducir el número de artículos disponibles para un usuario especificado. |
Mostrar límites en el catálogo de artículos
Los límites de venta de artículos se muestran en el catálogo dependiendo de cómo se implemente: a través del creador de sitios web o a través de la API.
Mostrar a través del 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 sobre límites a través de 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
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: 13 de Febrero de 2026¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.