Cupones

Cómo funciona

Las campañas de cupones son una herramienta de marketing diseñada para atraer a usuarios potenciales hacia su producto e impulsar las ventas. Cuando un usuario canjea un cupón, recibe uno o más artículos de bonificación. Los siguientes artículos pueden utilizarse como recompensas:

  • paquetes de moneda virtual
  • claves de juego
  • artículos virtuales
  • lotes

Un cupón contiene un código único. Para canjear un cupón, el usuario debe introducir el código en el cliente del juego o en la tienda del juego, incluida la Web Shop.

Funciones principales:

  • Establecer el número total de canjes dentro de una campaña.
  • Establecer el número de canjes por usuario dentro de una campaña.
  • Generación múltiple de códigos para cupones.
  • Aplicar restricciones regionales para campañas y artículos vinculados a un cupón.
Nota
Para establecer las restricciones regionales de una campaña, contacte con nosotros escribiendo a igs@xsolla.com.

Limitaciones:

  • Si las claves del juego se usan como artículo de bonificación, la clave se enviará al usuario por correo electrónico o al sistema de derechos tras su canje. Si se agotan las claves de la campaña, el usuario no podrá canjear el cupón.
  • Si se aplican restricciones regionales a una promoción con cupones, los usuarios de esas regiones no podrán canjear el cupón.
  • Si un cupón incluye al menos un artículo de bonificación con restricciones regionales, los usuarios de esa región no podrán recibir el artículo mediante este cupón.
  1. Ejemplo: se ofrecen un escudo y una espada como bonificación con el cupón. El escudo tiene una restricción regional y solo puede comprarse en EE. UU. Si un usuario de fuera de EE. UU introduce el código del cupón, se devolverá un error en la respuesta a las llamadas Verify promotion code (Verificar el código de promoción) o Redeem coupon code (Canjear código de cupón). El usuario no podrá obtener ninguno de los artículos del cupón.
Nota

También puede establecer promociones con códigos promocionales para su tienda.

Diferencias fundamentales:

  • Un cupón permite al usuario recibir únicamente artículos de bonificación. Un código promocional puede ofrecer artículos de bonificación, un descuento en un artículo específico o un descuento en toda la cesta.

  • Los códigos promocionales se canjean durante la compra ( en la pasarela de pago), mientras que los cupones se canjean después de que el usuario ingrese el código y lo aplique.

Flujo del usuario:

  1. Un usuario autorizado accede a la tienda.
  2. El usuario introduce el código del cupón.
  3. Xsolla devuelve una lista de artículos de bonificación disponibles para el cupón (opcional).
  4. El usuario selecciona bonificaciones (opcional).
  5. El usuario canjea el cupón.
  6. Los artículos vinculados al cupón se abonan al usuario del mismo modo que una compra normal.

Establecer campaña de cupones

Requisitos previos

Antes de establecer una campaña de cupones, debe configurar los artículos que se emitirán como bonificaciones.

Para crear artículos de forma manual en su proyecto en Cuenta del editor, vaya a la sección Items catalog > All items. Puede encontrar información detallada sobre este y otros métodos para crear artículos en la sección Catálogo de artículos de la documentación.

Establecer en Cuenta del editor

Para crear una nueva campaña de cupones:

  1. En su proyecto en Cuenta del editor, vaya a LiveOps > Promotions.
  2. En la pestaña de Promotions, haga clic en Create promotion.
  1. Especifique los parámetros principales de la promoción:
    1. Especifique el Nombre de la promoción.
    1. En la lista desplegable Promotion type, seleccione Coupon.
    1. En el campo External ID (ID externo), especifique un ID de promoción empleado para gestionar promociones mediante llamadas API.
    1. En la lista desplegable Select bonus items seleccione el tipo de artículo que se concederá a un usuario al canjear el cupón.
Nota
Un tipo de artículo solamente podrá seleccionarse si se ha creado al menos un artículo de ese tipo en su proyecto.

    1. Seleccione los artículos que se concederán a un usuario al canjear el cupón.
    1. Para los artículos virtuales, especifique la cantidad de cada artículo.
    1. Para las claves de juego, especifique cuándo se determinará la plataforma:
      • Para asignar de antemano una plataforma específica (por ejemplo, Steam), seleccione Select DRM during code generation en la lista desplegable Type of DRM selection. Luego, seleccione la plataforma de la lista desplegable DRM.
      • Si quiere permitir que el usuario elija, seleccione Player selects DRM at redemption en la lista desplegable Type of DRM selection.

Nota

Puede seleccionar diferentes tipos de artículos como bonificaciones. Para alternar entre los diferentes tipos de artículos, use el campo Select bonus items. La información sobre todos los artículos seleccionados se muestra en el área List of bonus items.

    1. Haga clic en Next.
  1. Configure los límites de canje de cupones:
    1. Para limitar el número total de canjes de cupones para todos los usuarios dentro de una campaña, establezca el conmutador Limit total number of coupon redemptions como On y especifique el número máximo de canjes.
    1. Para limitar el número de cupones que un solo usuario puede canjear en una campaña, establezca el conmutador Limit total number of redemptions per user como On y especifique el número máximo de canjes por usuario.
    1. Para limitar el número de veces que se puede canjear un código de cupón único para todos los usuarios, establezca el conmutador Limit number of unique coupon code redemptions como On y especifique el número máximo de canjes para el cupón.
    1. Haga clic en Next.
  1. Especifique el periodo de validez de la campaña: una zona horaria, una fecha de inicio y una fecha de finalización. Para crear una campaña sin fecha de finalización, marque la casilla No end date.
  2. Haga clic en Next.
  3. Revise la configuración de la campaña.
  4. Haga clic en Save and exit.

Para añadir códigos de cupones a una campaña:

  1. En su proyecto en Cuenta del editor, vaya a LiveOps > Promotions.
  2. En la fila con la promoción con cupones, haga clic en ••• y seleccione Edit promotion en la lista desplegable.
  1. Vaya a la pestaña Codes.
  2. Para generar códigos de forma automática:
    1. En la lista desplegable Code string format, seleccione Auto-generated.
    1. Especifique el número de códigos que desea generar y pulse en Generate.
  1. Para agregar códigos de forma manual:
    1. En la lista desplegable Code string format, seleccione Manually entered.
    1. Especifique el número de códigos que desea generar y pulse en Generate.
    1. Repita el paso anterior para agregar el número de códigos deseado.
  1. Descargue un archivo CSV con los códigos (opcional).
Nota

Los códigos de cupón distinguen entre mayúsculas y minúsculas. Por ejemplo, winter123 y WINTER123 se consideran cupones diferentes.

Puede agregar nuevos códigos a una campaña un número ilimitado de veces. Sin embargo, el número total de códigos agregados no debe superar los 50 000.

Si tiene que cargar una gran cantidad de códigos autogenerados, contáctenos escribiendo a igs@xsolla.com.

Para que la campaña esté disponible para los usuarios, debe activarla. Para ello, haga lo siguiente:

  1. En su proyecto de Cuenta del editor, vaya a la sección LiveOps > Promotions.
  2. En la fila con la promoción con cupones, haga clic en ••• y seleccione Edit promotion en la lista desplegable.
  3. En la lista desplegable de la esquina superior derecha, seleccione Activate promotion.

Establecer mediante API

Aviso
La lista de parámetros necesarios cuando se usan las llamadas API para actualizar promociones no coincide con la lista de parámetros devueltos por las llamadas API para recuperar promociones. Al invocar los métodos API para actualizar promociones, debe transmitir lo siguiente:
  • los parámetros requeridos
  • los parámetros que quiere cambiar
  • el resto de parámetros devueltos por la llamada para obtener promociones

Para establecer y gestionar campañas con cupones mediante API, utilice las siguientes llamadas:

TareaLlamada API
Crear una promoción con un cupón.Crear promoción con cupones
Activar una promoción con un cupón.Activar promoción con cupones.
Editar una promoción.Actualizar promoción de cupones con nuevas opciones de promoción. También pueden editarse las promociones con el estado Active.
Desactivar una promoción con un cupón.Desactivar promoción con cupones.
Establecer una promoción indefinida.Crear promoción con cupones o Actualizar promoción con cupones. Transmita el parámetro “date_end”: null a las llamadas indicadas.
Eliminar una promoción.Eliminar promoción con cupones
Nota
Si desactiva o elimina una promoción activa, dejará de estar disponible para los usuarios.

Establezca el canje de cupones en su aplicación o sitio web

Canje de cupones en su propia interfaz de usuario

Para permitir que los usuarios canjeen cupones en su aplicación o sitio web:

  1. Implemente los siguientes elementos en su interfaz de usuario:

    • Un campo para introducir el código del cupón.
    • Un formulario para mostrar las recompensas de los cupones.
    • Un botón para canjear el código del cupón.
  2. Implemente la lógica del cupón mediante las siguientes llamadas API del lado del cliente:

Nota
Para llamar a la API de Xsolla, puede utilizar los métodos del SDK prediseñados para motores y plataformas de juegos:
TareaLlamada API
Comprobar la validez del cupón.Verificar el código de promoción
Canjear cupón.Canjear código del cupón.
Obtener una lista de plataformas de distribución del juego para mostrar al usuario si se proporciona una clave del juego como bonificación del cupón.

Obtener recompensas en forma de cupones.

Si la respuesta devuelve is_selectable=true, para cada elemento con type=unit, debe mostrar un formulario de selección para los elementos del objeto unit_items. En este formulario, el usuario solo puede seleccionar un elemento para cada tipo de unit.

El parámetro type=unit se transmite para las claves del juego. En este caso, el usuario deberá seleccionar una plataforma.

Nota
Para comprobar además cuántas veces más puede un usuario aplicar un cupón dentro de una campaña, use la llamada API del lado del servidor Obtener el límite de cupones para un usuario especificado.
  1. Asegúrese de que los artículos se concedan correctamente al usuario al canjear el cupón.
  1. Si ya ha implementado una tienda en el juego en su aplicación o en su sitio web, no se requiere ninguna configuración adicional. Los artículos vinculados a un cupón se conceden al usuario del mismo modo que una compra estándar.
Nota
Las claves del juego se envían al usuario por correo electrónico o al sistema de derechos.

Canje de cupones en el sitio web creado con Xsolla

Aviso
Solo puede añadir la función de canje de cupones y códigos promocionales a sitios web creados con la plantilla Web Shop.

Para mostrar el campo de entrada de códigos en su sitio web:

  1. Abra su proyecto en Cuenta del editor y vaya a la sección Storefronts > Websites.
  2. En la sección Sites, seleccione su sitio web y haga clic en Open Site Builder.
  3. En el área principal del creador, seleccione el lugar donde quiera agregar un nuevo bloque y haga clic en Add block.
  4. Seleccione el bloque Promo codes.
  5. Personalice el aspecto del bloque (opcional):
    • Editar el encabezado y el texto descriptivo del bloque.
    • Establecer un fondo personalizado para el bloque.
    • Cambiar el estilo del botón.
    • Edite el texto del botón de canje de cupón.
  6. Para aplicar los cambios, publique su sitio web:

    1. En la esquina superior derecha del creador de sitios web, haga clic en Publish.
    1. Marque las casillas junto a las páginas que quiera publicar.
    1. Haga clic en Publish.

Nota

Si no está disponible la publicación del sitio web, cerciórese de que se cumplan todas las condiciones:

  • No hay secciones vacías en el sitio web (marcadas con un indicador rojo).
  • Se haya firmado el Acuerdo de licencia con Xsolla.
  • La página principal está publicada o seleccionada para su publicación. No puede publicar páginas secundarias antes de publicar la página principal.
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Última actualización: 13 de Febrero de 2026

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!
No hemos podido enviar sus comentarios
Vuelva a intentarlo más tarde o escríbanos a doc_feedback@xsolla.com.