Moneda virtual

Cómo funciona

La moneda virtual es dinero virtual que se utiliza para comprar y vender productos virtuales. Dependiendo de su finalidad, una 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 un paquete de moneda con una cantidad fija.
Vender moneda convertible.
Vender moneda virtual y paquetes de moneda virtual por dinero 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.
Artículos gratuitos.

Contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com si desea crear una moneda virtual y un paquete de moneda virtual con valor cero en el precio.

En campañas con descuentos, códigos o cupones promocionales, solo puede usar paquetes de moneda virtual. Cualquier cantidad de moneda virtual puede utilizarse en campañas con bonificación.

Opciones de venta de moneda

Existen las siguientes opciones para vender moneda virtual:

vender cualquier cantidad de moneda virtual
vender paquetes de moneda virtual

Vender cualquier cantidad de moneda virtual

Venda la moneda virtual en las cantidades requeridas por los usuarios. Implemente la solicitud para introducir la cantidad de moneda requerida para la compra en el lado cliente de la aplicación.

Vender paquetes de moneda virtual

Vender la moneda virtual en cantidades predefinidas. Esta función le permite vender monedas internas del juego en paquetes, cuyo precio puede ser más bajo que si la moneda se comprara con una cantidad personalizada.

Ejemplo: Para un paquete, puede definir un precio especial que no sea igual a la cantidad de moneda virtual que contiene. Por ejemplo: 1 moneda virtual = 1 USD. 500 monedas virtuales = 450 USD.

Restricciones:

Solamente puede añadir un tipo de moneda virtual a un paquete.
Puede crear un paquete de moneda virtual sin especificar su precio en moneda real o virtual. Si dicho artículo se muestra en la tienda, estará disponible para los usuarios de forma gratuita.
La cantidad de moneda virtual ose puede especificar como valor entero.

Entrega de moneda

Métodos de entrega disponibles:

Directamente al Inventario de Xsolla (método por defecto). Antes de la entrega, el paquete de moneda virtual se desempaqueta, y la moneda del paquete se transfiere al inventario del jugador.
A PlayFab si ha configurado la integración.

Si la lógica de la tienda en el juego (In-Game Store) está implementada en sus servidores, puede configurar los webhooks de compra.

Moneda convertible

La moneda convertible es una moneda vinculada a la plataforma de compra y que solo puede adquirirse con dinero real.

Restricciones:

Puede otorgar a la moneda un estatus de convertible solamente durante la primera configuración.
Puede vender paquetes de moneda virtual con moneda virtual convertible solo por dinero real.

Para almacenar monedas convertibles por separado en distintas plataformas:

Establezca el conmutador Monedas convertibles virtuales en la posición On.

Cuando llame a los puntos finales de la API para la gestión de inventario, transmita la string con la plataforma de compra al campo platform.

EJEMPLO

Copy

Full screen

Small screen


"platform": “playstation_network”

Limitar el número de paquetes de moneda virtual disponibles para la compra

Puede limitar la compra de paquetes de moneda virtual. Por ejemplo, puede limitar:

el número de paquetes de moneda virtual por usuario
paquetes de moneda virtual que solo se pueden comprar una vez.

Si el usuario ha alcanzado el límite especificado, el paquete de moneda virtual no se mostrará en el catálogo.

Puede mostrar el número máximo disponible de paquetes y el número restante de paquetes que está disponible para el usuario.

Para establecer un límite de compra al crear un paquetes de moneda virtual en Cuenta del editor, establezca el conmutador Limit number of times one user can buy package en la posición On y especifique el número de veces que se puede comprar el paquete.

Puede utilizar los métodos de la subsección Catálog del grupo de métodos Artículos virtuales y moneda para obtener información sobre los lpaquetes.

En la respuesta, recibirá la siguiente información además de la información sobre el paquete de moneda virtual:

el número máximo de paquetes de moneda virtual que un usuario puede comprar
el número restante de paquetes de moneda virtual disponibles que el usuario puede comprar

Puede obtener más información sobre cómo establecer o actualizar las restricciones en las instrucciones de Límites para el usuario.

Para los usuarios no autorizados, siempre se muestra el número máximo de paquetes de moneda virtual que pueden comprar. Para mostrar al usuario el número restante de paquetes de moneda virtual (sujeto al límite actual), transmita los datos de autorización del usuario cuando solicite el catálogo de paquetes de moneda virtual empleando los métodos de la subsección Catálogo del grupo de métodos Artículos virtuales y moneda.

Para visualizar correctamente el número de paquetes de moneda virtual que están disponibles para el usuario, es necesario configurar la autenticación.

Ejemplo de respuesta con atributos de usuario:

Copy

Full screen

Small screen


{
  "items": [
    {
      "sku": "vc_package_1",
      "name": "VC Name first package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "2.0000",
        "amount_without_discount": "2.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "Big Rocket - short description",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "sku": "big_rocket",
          "name": "Big Rocket",
          "type": "virtual_currency",
          "quantity": 100,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    },
    {
      "sku": "vc_package_3",
      "name": "VC Name third package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "4.0000",
        "amount_without_discount": "4.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "description",
          "image_url": "http://image.png",
          "sku": "shotgun_raider",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "quantity": 200,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    }
  ]
}

Xsolla garantiza que no se superen los límites e impide que los usuarios adquieran más paquetes de moneda virtual que los que establece el límite.

Al abrir la interfaz de pago y abonar un paquete, todos los pedidos pendientes de pago con este paquete quedan anulados.

Ejemplo: el usuario puede abrir el formulario de pago de un paquete con restricción de compra en varias pestañas del navegador hasta que el paquete haya sido adquirido. Esto origina automáticamente la creación de varios pedidos para el mismo paquete. Después de comprar un paquete en una pestaña, Xsolla anulará todos los pedidos no abonados con el mismo paquete.

Limitar el tiempo de visualización de la moneda virtual y de los paquetes de moneda virtual en la tienda

Puede establecer el periodo de visualización de una moneda virtual y de un paquete de monedas virtuales en la tienda para:

mantener la relevancia del catálogo en un momento determinado, por ejemplo, durante la temporada de ventas navideñas
crear una moneda virtual y paquetes de moneda virtual por adelantado sin mostrarlos en el catálogo
motivar a los usuarios a comprar moneda virtual y paquetes de moneda virtual al mostrar un temporizador junto al artículo

Cuando cree una interfaz de catálogo utilizando Site Builder, el temporizador se muestra automáticamente. Cuando cree un catálogo en su propia interfaz, deberá implementar el temporizador.

El periodo de visualización de la moneda virtual en la tienda solo puede establecerse mediante métodos API.

Para establecer un límite de tiempo para mostrar una moneda virtual en la tienda mediante API, transmita los siguientes parámetros en la llamada API Create virtual currency o Update virtual currency:

periods[0].date_from con la fecha y la hora del inicio del periodo de visualización del artículo en formato YYYY-MM-DDThh:mm:ss±TMZ, en el cual TMZ es el indicador de zona horaria en formato GMT hh:mm.
periods[0].date_until con la fecha y hora del final del periodo de visualización del artículo en formato YYYY-MM-DDThh:mm:ss±TMZ, en el cual TMZ es el indicador de zona horaria en formato hh:mm GMT. Para no indicar el final del periodo de visualización de un artículo, transmita null.

Puede establecer múltiples periodos para mostrar una moneda virtual en la tienda. Para ello, en el método Create virtual currency o Update virtual currency, transmita una matriz de objetos con las fechas de inicio y fin de todos los periodos.

Ejemplo:

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

Para establecer un límite de tiempo para visualizar un paquete de moneda virtual en la tienda mediante Cuenta del editor, seleccione Time period y especifique la zona horaria, el inicio y el final del periodo. Para no indicar el final del periodo de visualización del paquete, marque la casilla No end date.

Para establecer un límite de tiempo para mostrar un paquete en la tienda mediante API, transmita los siguientes parámetros en la llamada API Create virtual currency package o Update virtual currency package:

periods[0].date_from con la fecha y la hora del inicio del periodo de visualización del artículo en formato YYYY-MM-DDThh:mm:ss±TMZ, en el cual TMZ es el indicador de zona horaria en formato GMT hh:mm.
periods[0].date_until con la fecha y hora del final del periodo de visualización del artículo en formato YYYY-MM-DDThh:mm:ss±TMZ, en el cual TMZ es el indicador de zona horaria en formato hh:mm GMT. Para no indicar el final del periodo de visualización de un artículo, transmita null.

Puede establecer múltiples periodos para mostrar un paquete en la tienda. Para ello, en el método Create virtual currency package o Update virtual currency package, transmita una matriz de objetos con las fechas de inicio y fin de todos los periodos.

Ejemplo:

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

¿Quién puede utilizarlo?

Para los socios que deseen establecer la economía del juego o la monetización añadiendo moneda virtual al juego y vendiendo artículos virtuales para el juego
Para los socios que hayan integrado al menos uno de los siguientes productos:
- In-Game Store con el módulo Virtual Items configurado.
- Buy Button con el módulo Game Keys configurado.

Cómo conseguirlo

Requisitos previos

Regístrese en Cuenta del editor de Xsolla.
Abra su proyecto.

Configure los módulos para In-Game Store o Buy Button.

Establecer moneda virtual

Puede establecer monedas virtuales de una de las siguientes formas:

a través de Cuenta del editor
o a través de Llamadas API

Establecer una moneda virtual en Cuenta del editor

Establezca una moneda virtual mediante llamadas API

Utilice las llamadas API de la subsección Admin de los puntos finales de API Virtual Items & Currency.

¡Gracias por tu mensaje!

Nos ayudará a mejorar tu experiencia.

Última actualización: 10 de Octubre de 2023

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

Your browser is not supported. Please try a different browser

Artículos populares

O elige una pregunta frecuente:

La respuesta se basa en las siguientes fuentes:

Déjanos un comentario (opcional)

Déjanos un comentario (opcional)

In-Game Store

Moneda virtual

Cómo funciona

Opciones de venta de moneda

Vender cualquier cantidad de moneda virtual

Vender paquetes de moneda virtual

Entrega de moneda

Moneda convertible

Limitar el número de paquetes de moneda virtual disponibles para la compra

Limitar el tiempo de visualización de la moneda virtual y de los paquetes de moneda virtual en la tienda

¿Quién puede utilizarlo?

Cómo conseguirlo

Requisitos previos

Establecer moneda virtual

Establecer una moneda virtual en Cuenta del editor

Establezca una moneda virtual mediante llamadas API