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.
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
Configurar mediante API
Para configurar monedas virtuales, pueden usar las llamadas de la subsección Admin del grupo Artículos y monedas virtuales.
| Tarea | Llamada 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:
|
| 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:
|
Para obtener más información sobre los límites, consulten las siguientes guías:
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
Para mostrar un paquete de moneda virtual:
En su proyecto en la Cuenta del editor, vayan a la sección Storefronts > Websites.
Hagan clic en el panel del sitio deseado.
En el proyecto en su cuenta, vayan a la sección Storefronts > Websites.
Hagan clic en el panel del sitio deseado.
En el proyecto en su cuenta, vayan a la sección Storefronts > Websites.
Hagan clic en el panel del sitio deseado.
En el proyecto en su cuenta, vayan a la sección Storefronts > Websites.
Hagan clic en el panel del sitio deseado.
En su proyecto en la cuenta para juegos para móviles, vayan a la sección Web Shop.
Hagan clic en el panel del sitio deseado.
Si su sitio incluye varias páginas, seleccionen la que necesiten:
- Hagan clic en el título de la página actual en la parte superior del editor.
- Seleccionen la página necesaria de la lista desplegable.
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.
Después de realizar todos los cambios necesarios y preparar su sitio web para el lanzamiento:
- En la esquina superior derecha del editor del sitio, hagan clic en Publish.
- Marquen las casillas junto a las páginas que quieren publicar.
- Hagan clic en Publish.
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.
| Tarea | Llamada 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.
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.




