Monnaie virtuelle

Comment ça marche

La monnaie virtuelle est de l’argent virtuel qui est utilisé pour acheter et vendre des biens virtuels. Selon son objectif, une monnaie virtuelle affecte l’équilibre économique du jeu ou est liée à la monétisation de l’application.

Principales caractéristiques:

• Vente d’une quantité quelconque de monnaie virtuelle ou d’un paquet séparé de monnaie avec un montant fixe.
• Vente de monnaie forte.
• Vente de monnaie virtuelle et de paquets de monnaie virtuelle pour de l’argent réel ou virtuel.
• Limite le nombre de paquets de monnaie virtuelle disponibles à l’achat.
• Limite le temps d’affichage de la monnaie virtuelle et des paquets de monnaie virtuelle dans le magasin.
• Objets gratuits.

Options de vente de la monnaie

• vente de n’importe quel montant de monnaie virtuelle ;
• vente des packages de monnaie virtuelle.

Vendre n'importe quel montant de monnaie virtuelle

Vendre des packages de monnaie virtuelle

Vendez de la monnaie virtuelle en quantités prédéfinies. Cette fonction vous permet de vendre de la monnaie en jeu en packages, pour lesquels le prix peut être plus bas que si la monnaie avait été achetée avec un montant personnalisé.

Exemple : Pour un package, vous pouvez définir un prix spécial qui n’est pas égal à la quantité de monnaie virtuelle qu’il contient. Par exemple : 1 pièce virtuelle = 1 USD. 500 pièces virtuelles = 450 USD.

Restrictions :

• Vous ne pouvez ajouter qu’un seul type de monnaie virtuelle à un package.
• Vous pouvez créer un package de monnaie virtuelle sans spécifier son prix en devises réelles ni en monnaie virtuelle. Si un tel package est affiché dans le magasin, il sera disponible gratuitement pour l’utilisateur.
• La quantité de la monnaie virtuelle ne peut être spécifiée que sous la forme d’une valeur entière.

Livraison de la monnaie

• Directement dans Xsolla Inventory (méthode par défaut). Avant la livraison, le package de monnaie virtuelle est déballé, et la monnaie du package est ajoutée dans Player Inventory.
• Dans PlayFab si vous avez configuré son intégration.

Monnaie premium

La monnaie premium est une monnaie liée à la plateforme d’achat et ne peut être achetée que contre de l’argent réel.

Restrictions :

• Vous ne pouvez attribuer le statut premium à la monnaie virtuelle qu’à la première configuration.
• Vous ne pouvez vendre des packages de monnaie virtuelle contenant de la monnaie virtuelle premium que contre de l’argent réel.

Pour stocker de la monnaie premium séparément sur différentes plateformes :

• Réglez la bascule Hard virtual currency sur On.

• Lors des appels API des endpoints de gestion de l'inventaire, passez la chaîne avec la plateforme d'achat dans le champ platform.

EXEMPLE

"platform": “playstation_network”

Limiter le nombre de packages de monnaie virtuelle disponibles à l'achat

L’achat de packages de monnaie virtuelle peut être limité. Par exemple, vous pouvez limiter :

• le nombre de packages de monnaie virtuelle par utilisateur ;
• les packages de monnaie virtuelle de bienvenue qui ne peuvent être achetés qu’une seule fois.

Si l’utilisateur a atteint la limite spécifiée, le package de monnaie virtuelle ne sera plus affiché dans le catalogue.

Vous pouvez afficher le nombre maximal de packages disponibles pour l’utilisateur ainsi que le nombre de packages restant.

Pour définir une limite d’achat lors de la création d’un package de monnaie virtuelle dans le Compte éditeur, réglez l’option Limit number of times one user can buy this package sur On et spécifiez le nombre de fois que le package peut être acheté.

Utilisez les méthodes de la sous-section Catalogue du groupe de méthodes Objets et monnaie virtuels pour obtenir des informations sur les packages de monnaie virtuelle.

Dans la réponse, vous recevrez les informations suivantes en plus des informations sur le package de monnaie virtuelle :

• le nombre maximum de packages de monnaie virtuelle que l’utilisateur peut acheter ;
• le nombre restant de packages de monnaie virtuelle que l’utilisateur peut acheter.

Pour en savoir plus sur la manière de définir ou de mettre à jour des restrictions, consultez les instructions Limites pour l’utilisateur.

{
  "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
    }
  ]
}

Limiter la durée d'affichage de la monnaie virtuelle et des packages de monnaie virtuelle dans le magasin

• maintenir la pertinence du catalogue à un moment donné, par exemple pendant les soldes des fêtes ;
• créer une monnaie virtuelle et des packages de monnaie virtuelle à l’avance sans les afficher dans le catalogue ;
• inciter l’utilisateur à acheter de la monnaie virtuelle et des packages de monnaie virtuelle en affichant une minuterie à côté du bien.

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

"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 peut l'utiliser

• Les partenaires qui souhaitent configurer une économie de jeu ou une monétisation en ajoutant de la monnaie virtuelle au jeu et en vendant des objets virtuels contre cette monnaie.
• Les partenaires qui ont intégré au moins un des produits suivants :
  • In-Game Store avec le module Virtual Items configuré ;
  • Buy Button avec le module Game Keys configuré.

Comment configurer

Prérequis

1. Connectez-vous au Compte éditeur Xsolla.
2. Ouvrez votre projet.

3. Configurez les modules pour In-Game Store ou Buy Button.

Configurer une monnaie virtuelle

• dans le Compte éditeur ;
• via appels API.

Configurer la monnaie virtuelle dans le Compte éditeur

Configurer la monnaie virtuelle via appels API