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:

Nota
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.
Aviso
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

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.
Nota
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.

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.

Nota

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
    }
  ]
}
Nota

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
Nota
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.
Nota
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 Crear paquete de moneda virtual o Actualizar paquete de moneda virtual:

  • 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 Crear moneda virtual o Actualizar moneda virtual, 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.

    Cómo conseguirlo

    Establecer moneda virtual

    Puede establecer monedas virtuales de una de las siguientes formas:

    Establecer una moneda virtual en Cuenta del editor

    Para establecer una moneda virtual en la Cuenta del editor:

    1. Conecte el módulo Virtual Currency en Cuenta del editor.

    1. Vaya a Store > Virtual Currency y haga clic en New virtual currency.

    1. Especifique los parámetros requeridos:
      1. Cargue la imagen de la moneda virtual.
      2. Especifique el código de artículo (SKU) de la moneda virtual.
      3. Establezca el nombre para la moneda virtual.
      4. Establezca los precios en las monedas requeridas.
      5. Defina la moneda por defecto.
      6. Si la moneda es Hard (Convertible), consulte las instrucciones sobre cómo configurarla.
    2. Compruebe la configuración y haga clic en Create currency.

    Establezca una moneda virtual mediante llamadas API

    Utilice las llamadas API de la subsección Admin de los puntos finales de la API Artículos y moneda virtuales.
    ¿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: 2 de Abril de 2025

    ¿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.