Códigos promocionales

Cómo funciona

Información general

Las promociones con códigos promocionales son una herramienta de marketing diseñada para aumentar las tasas de conversión de compras y el ticket medio. Al aplicarse un código promocional a un pedido, el usuario puede recibir:

  • un descuento que se aplica a toda la compra o a artículos específicos
  • artículos de bonificación, entre los que se incluyen:
    • paquetes de moneda virtual
    • claves de juego
    • artículos virtuales
    • lotes

Funciones principales:

  • Configuración flexible de bonificaciones. Puede crear un único tipo de bonificación (descuento en la compra, descuento en artículos seleccionados o un artículo de bonificación) o una combinación de ellos.
  • 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 de múltiples códigos promocionales.
  • Aplicación de restricciones regionales para campañas y artículos vinculados a un código promocional.
Nota
Para establecer las restricciones regionales de una campaña, contacte con nosotros escribiendo a igs@xsolla.com.

Limitaciones:

  • Solo se puede aplicar un código promocional a la compra.
  • Para recibir un descuento o un artículo de bonificación, el usuario debe pagar la compra.
  • No se aplican descuentos a los precios especificados en moneda virtual. Para los artículos con precios en moneda real y virtual, los descuentos solo se aplicarán al precio en moneda real.
  • Si se usan claves de juego 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 código promocional.
  • Si se aplican restricciones regionales a una campaña con código promocional, los usuarios de esas regiones no podrán canjear el código promocional.
  • Si un código promocional incluye al menos un artículo de bonificación con restricciones regionales, los usuarios de esa región no podrán canjear este código promocional.
Ejemplo: se ofrecen un escudo y una espada como bonificación con el código promocional. 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 promocional, se devolverá un error en la respuesta a las llamadas Verificar código promocional o Canjear código promocional. El usuario no podrá obtener ninguno de los artículos del código promocional.
Nota

También puede crear promociones con cupones para su tienda.

Diferencias principales:

  • 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

Nota
El usuario puede cancelar la aplicación del código promocional antes de completar el pago.

Normas para la aplicación de descuentos

Si se admiten varias promociones para un artículo en el momento de la compra, los descuentos se aplican al artículo de uno en uno. El orden de aplicación de los descuentos no importa.

Ejemplo:

El precio de un artículo virtual es de 10 $. En Cuenta del editor, se han creado las siguientes promociones para los artículos virtuales:

  • Promoción de descuento por Black Friday con un 10 % de descuento del 4 al 30 de noviembre
  • Oferta con un descuento del 20 % del 15 de noviembre al 15 de diciembre
  • Promoción con un código promocional para obtener un descuento del 5 % del 4 al 30 de noviembre

Si el artículo se compra el 20 de noviembre, se admiten tanto las promociones con descuento como las promociones con código promocional.

El coste total del artículo virtual se calcula como ((10 $ - 10 %) - 20 %) - 5 % = 10 $ × (100 %-10 %) × (100 %-20 %) × (100 %-5 %) = 10 $ × 0,9 × 0,8 × 0,95, lo que da un resultado de 6,84 $.

Configurar una campaña con códigos promocionales

Nota

Si quiere crear una promoción con artículos de bonificación, debe configurar estos artículos antes de crear la promoción.

Para crear artículos de forma manual en su proyecto en Cuenta del editor, vaya 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 con códigos promocionales:

  1. En su proyecto de Cuenta del editor, vaya a LiveOps > Promotions.
  2. En la pestaña Promotions, haga clic en Create promotion.
  1. Especifique el nombre en Promotion name.
  2. En la lista desplegable Promotion type, seleccione Promo code.
  3. En el campo External ID, especifique un ID de promoción que se utilice para gestionar promociones mediante llamadas API.
  4. Para aplicar un descuento a cualquier artículo o a toda la cesta cuando se utiliza un código promocional:

    1. Active la opción Discount on purchase.
    1. En el campo Discount amount, especifique el porcentaje de descuento.

  1. Para aplicar un descuento a artículos específicos cuando se utiliza un código promocional:

    1. Active la opción Discount on selected items.
    1. En el campo Discount amount, especifique el porcentaje de descuento.
    1. En la lista desplegable Item type, seleccione el tipo de artículo que se descontará al utilizar el código promocional.
    1. Seleccione los artículos.

  1. Para conceder artículos de bonificación cuando se utiliza un código promocional:

    1. Active la opción Bonus items.
    1. En la lista desplegable Select bonus items seleccione el tipo de artículo que se concederá a un usuario al canjear el código promocional.
    1. Seleccione los artículos que se proporcionarán al canjear el código promocional.
    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.
    1. Haga clic en Next.

Nota

El descuento para un pedido o artículos específicos debe ser un número entero y no puede ser superior al 99 %. Al configurar descuentos para artículos específicos o artículos de bonificación, tenga en cuenta lo siguiente:

  • Un tipo de artículo solamente podrá seleccionarse si se ha creado al menos un artículo de ese tipo en su proyecto.
  • Puede configurar artículos de diferentes tipos. Para cambiar de tipo de artículo, utilice el campo de selección de tipo de artículo.
  1. Establezca límites de uso de códigos promocionales:

    1. Para limitar el número total de usos de códigos promocionales para todos los usuarios dentro de una campaña, active la opción Limit total number of redemptions y especifique el número máximo de usos.
    1. Para limitar el número de códigos promocionales que un usuario puede canjear en una campaña, active la opción Limit total number of redemptions per user y especifique el número máximo de usos por usuario.
    1. Para limitar el número de veces que los usuarios pueden usar un código promocional, active la opción Limit number of unique promo code redemptions y especifique el número máximo de usos del código promocional.
    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 promocionales a una campaña:

  1. En su proyecto de Cuenta del editor, vaya a LiveOps > Promotions.
  2. En la fila con la promoción de código promocional, 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 añadir códigos de forma manual:
    1. En la lista desplegable Code string format, seleccione Manually entered.
    1. Introduzca el código promocional y haga clic en Create.
    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 promocionales distinguen entre mayúsculas y minúsculas. Por ejemplo, winter123 y WINTER123 se consideran códigos promocionales distintos.

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 LiveOps > Promotions.
  2. En la fila con la promoción de código promocional, 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

Nota
Al configurar una promoción mediante API, puede especificar un importe de descuento fraccionario.
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 configurar y gestionar campañas con códigos promocionales a través de API, utilice las siguientes llamadas:

TareaLlamada API
Crear una promoción con un código promocionalCrear promoción de código promocional
Activar una promoción con código promocionalActivar promoción de código promocional
Editar una promociónActualizar promoción de código promocional con nuevas opciones de promoción. También es posible editar las promociones con el estado Activo.
Desactivar promociónDesactivar promoción de código promocional
Establecer una promoción indefinidaCrear promoción de código promocional o Actualizar promoción de código promocional. Transmita el parámetro “date_end”: null a las llamadas indicadas.
Eliminar una promociónEliminar promoción de código promocional
Nota
Si desactiva o elimina una promoción activa, dejará de estar disponible para los usuarios.

Configurar el uso de códigos promocionales en su aplicación o sitio web

Uso de códigos promocionales en su interfaz de usuario

  1. En la interfaz de usuario de su aplicación (en el catálogo o la cesta) implemente los siguientes elementos:

    • un campo para introducir el código promocional
    • elementos de la interfaz de usuario para mostrar recompensas y descuentos con códigos promocionales
    • un formulario de selección para recompensas con códigos promocionales (si procede)
    • un botón para aplicar el código promocional
  2. Implemente la lógica del código promocional utilizando 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 si el código promocional es válidoVerificar código de promoción
Obtener una lista de plataformas de distribución de juegos para mostrar al usuario si se proporciona una clave de juego como bonificación de código promocional.

Obtener recompensas de códigos promocionales

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 de juego. En este caso, el usuario deberá seleccionar una plataforma de juegos.

Mostrar el catálogo actualizado teniendo en cuenta los descuentos y los artículos de bonificación de un código promocional.Utilice llamadas de la subsección Catalog. Debe transmitir el código promocional en el parámetro de solicitud promo_code.
Comprar un artículo específico directamente (sin añadirlo a la cesta) y canjear un código promocional.

Crear pedido con un artículo especificado

Debe transmitir el código promocional en el parámetro de solicitud promo_code.

Aplicar un código promocional y actualizar el contenido de la cesta y el coste total (aplicar descuentos y añadir artículos de bonificación)

Canjear código promocional

Debe transmitir el código promocional en el parámetro de solicitud coupon_code.

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

Uso de códigos promocionales en sitios web creados 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.