Moneda virtual

Cómo funciona

La moneda virtual es dinero virtual que se emplea para comprar productos virtuales. En función de cómo se utilice, la moneda virtual afecta al equilibrio de la economía del juego o está vinculada a la monetización de la aplicación.

Características principales:

  • Vender cualquier cantidad de moneda virtual o paquetes de moneda virtual con cantidad fija.
  • Vender moneda virtual y paquetes de moneda virtual por moneda real o virtual.
  • Limitar el número de paquetes de moneda virtual disponibles para la compra.
  • Limitar el tiempo de visualización de la moneda virtual y los paquetes de moneda virtual en la tienda.
  • Paquetes de moneda virtual gratuitos.
Aviso
En las campañas de descuentos y en las campañas con códigos promocionales o cupones, debe usar paquetes de moneda virtual. Solo pueden usarse cantidades arbitrarias de moneda virtual en las campañas de bonificaciones.

Las siguientes opciones están disponibles para vender moneda virtual:

  • Cualquier cantidad — les permite vender moneda virtual por la cantidad que especifique el usuario. Para usar esta opción, implementen en el lado cliente un campo de entrada que permita al usuario introducir la cantidad de moneda deseada al realizar la compra.
  • Paquetes — permite vender moneda virtual en cantidades predefinidas. El precio de un paquete de moneda virtual se establece por separado y puede diferir del precio estándar de la misma cantidad de esa moneda.

Ejemplo: Un paquete contiene 100 monedas de oro y cuesta 90 $, mientras que el precio de una moneda de oro es de 1 $.

Restricciones:

  • Solo puede añadirse un tipo de moneda virtual a un paquete.
  • Un precio en otra moneda virtual solo puede configurarse mediante llamadas API.
  • Un paquete de moneda virtual puede hacerse gratuito — sin especificar un precio en moneda real o virtual. Esto puede configurarse a través de la Cuenta del editor o mediante llamadas API. La moneda virtual gratuita que no forma parte de un paquete solo puede crearse mediante llamadas API.
  • Un paquete de moneda virtual puede hacerse gratuito — sin especificar un precio en moneda real o virtual. Esto puede configurarse a través de su cuenta o mediante llamadas API. La moneda virtual gratuita que no forma parte de un paquete solo puede crearse mediante llamadas API.
  • Un paquete de moneda virtual puede hacerse gratuito — sin especificar un precio en moneda real o virtual. Esto puede configurarse en la cuenta para juegos para móviles o mediante llamadas API. La moneda virtual gratuita que no forma parte de un paquete solo puede crearse mediante llamadas API.
  • La cantidad de moneda virtual de un paquete puede especificarse únicamente como un valor entero.

Cómo configurarlo

Configurar en la Cuenta del editor

Configurar en su cuenta

Nota
Antes de configurar la moneda virtual o los paquetes de moneda virtual, se recomienda crear grupos para ayudarles a ordenar los artículos y gestionar cómo se muestran en su tienda.

Configurar mediante API

Para configurar monedas virtuales, pueden usar las llamadas de la subsección Admin del grupo Artículos y monedas virtuales.

Aviso
Las llamadas de la subsección Admin no están pensadas para crear un catálogo de tienda en el front end. No deben usarlas para páginas de destino, tiendas web ni lógicas dentro del juego.
TareaLlamada API
Crear moneda virtual.Crear moneda virtual.
Obtener moneda virtual.Obtener moneda virtual.
Obtener una lista de monedas virtuales.Obtener lista de monedas virtuales.
Actualizar moneda virtual.Actualizar moneda virtual.
Eliminar moneda virtual.Eliminar moneda virtual.
Limitar la cantidad de moneda virtual disponible para la compra.En las llamadas API Crear moneda virtual o Actualizar moneda virtual, pasen los siguientes parámetros:
  • limits — especifica la cantidad máxima de moneda virtual disponible para la compra.
  • limits.recurrent_schedule — define la frecuencia con la que se restablece el límite.
Crear un paquete de moneda virtual.Crear paquete de moneda virtual.
Obtener un paquete de moneda virtual.Obtener paquete de moneda virtual.
Obtener una lista de paquetes de moneda virtual.Obtener lista de paquetes de moneda virtual.
Actualizar un paquete de moneda virtual.Actualizar paquete de moneda virtual.
Eliminar un paquete de moneda virtual.Eliminar paquete de moneda virtual.
Limitar el número de paquetes de moneda virtual disponibles para la compra.En las llamadas API Crear paquete de moneda virtual o Actualizar paquete de moneda virtual, pasen los siguientes parámetros:
  • limits — especifica el número máximo de paquetes de moneda virtual disponibles para la compra.
  • limits.recurrent_schedule — define la frecuencia con la que se restablece el límite.
Aviso
El periodo de visualización de la moneda virtual en la tienda solo puede configurarse mediante llamadas API.

Mostrar moneda virtual en el catálogo

La visualización de la moneda virtual o de los paquetes de moneda virtual depende de cómo se implemente el catálogo — a través del editor de sitios o mediante API.

Mostrar a través del editor de sitios

Nota
Solo pueden mostrarse paquetes de moneda virtual en el catálogo de la tienda.

Para mostrar un paquete de moneda virtual:

  1. Crear paquete de moneda virtual.

  2. En su proyecto en la Cuenta del editor, vayan a la sección Storefronts > Websites.

  3. Hagan clic en el panel del sitio deseado.

  1. Crear paquete de moneda virtual.

  2. En el proyecto en su cuenta, vayan a la sección Storefronts > Websites.

  3. Hagan clic en el panel del sitio deseado.

  1. Crear paquete de moneda virtual.

  2. En el proyecto en su cuenta, vayan a la sección Storefronts > Websites.

  3. Hagan clic en el panel del sitio deseado.

  1. Crear paquete de moneda virtual.

  2. En el proyecto en su cuenta, vayan a la sección Storefronts > Websites.

  3. Hagan clic en el panel del sitio deseado.

  1. Crear paquete de moneda virtual.

  2. En su proyecto en la cuenta para juegos para móviles, vayan a la sección Web Shop.

  3. Hagan clic en el panel del sitio deseado.

  1. Si su sitio incluye varias páginas, seleccionen la que necesiten:

    1. Hagan clic en el título de la página actual en la parte superior del editor.
    2. Seleccionen la página necesaria de la lista desplegable.

  2. En la sección del bloque Store, seleccionen el paquete de moneda virtual que quieren vender en el sitio web en el campo Item type.

  1. Configuren un diseño de ficha de artículo.

  2. Después de realizar todos los cambios necesarios y preparar su sitio web para el lanzamiento:

    1. En la esquina superior derecha del editor del sitio, hagan clic en Publish.
    2. Marquen las casillas junto a las páginas que quieren publicar.
    3. Hagan clic en Publish.

Aviso

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

  • No hay secciones vacías en el sitio web (marcadas con un indicador rojo).
  • Se ha firmado el Acuerdo de licencia con Xsolla.
  • La página principal está publicada o seleccionada para su publicación. No pueden publicarse las páginas secundarias antes que la principal.

Una vez publicado el sitio, estará disponible una sección con paquetes de moneda virtual. Si no se muestra ningún paquete, comprueben que su Estado esté establecido como Available y que no haya ningún límite de visualización por tiempo activo.

Obtener información de moneda virtual mediante API

Para recuperar en el lado cliente el catálogo de monedas virtuales y paquetes de moneda virtual, usen las llamadas de la subsección Catalog del grupo Artículos y monedas virtuales.

TareaLlamada API
Obtener moneda virtual por SKU.Pasen el parámetro virtual_currency_sku a la llamada API Obtener moneda virtual por SKU.
Obtener una lista de monedas virtuales.Obtener lista de monedas virtuales.
Obtener un paquete de moneda virtual por SKU.Pasen el parámetro virtual_currency_package_sku a la llamada API Obtener paquete de moneda virtual por SKU.
Obtener una lista de paquetes de moneda virtual.Obtener lista de paquetes de moneda virtual.

Conceder moneda virtual a los usuarios

En función del tipo de artículo y de la configuración de integración, la moneda virtual se concede al usuario de una de las siguientes formas:

  • Si han integrado PlayFab, la moneda virtual y los artículos se conceden automáticamente al inventario de PlayFab del usuario.

  • Si usan un sistema de entrega personalizado, todos los artículos y la moneda virtual se conceden en su sistema. Recomendamos configurar un controlador de webhook para recibir los datos del pedido en su backend. Los datos necesarios se incluyen en el webhook Pago del pedido realizado correctamente.

Consulte la sección Configurar el seguimiento del estado del pedido para más detalles sobre este y otros métodos de obtención de datos de compra.

¿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: 15 de Mayo 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 [email protected].