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.

Contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com si vous souhaitez créer une monnaie virtuelle et un package de monnaie virtuelle dont le prix est nul.

Dans les campagnes avec remises, codes promo ou coupons, seuls les packages de monnaie virtuelle sont utilisés. La monnaie virtuelle en quantité arbitraire est réservée aux campagnes avec bonus.

Options de vente de la monnaie

Les options suivantes sont disponibles pour vendre de la monnaie virtuelle :

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

Vendre n'importe quel montant de monnaie virtuelle

Vendez de la monnaie virtuelle dans les quantités demandées par l’utilisateur. Côté client de l’application, implémentez la demande de saisie de la quantité de monnaie requise à l’achat.

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

Méthodes de livraison disponibles :

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.

Si la logique d’In-Game Store est implémentée sur vos serveurs, vous pouvez configurer les webhooks d’achat.

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

Copy

Full screen

Small screen


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

Pour les utilisateurs non autorisés, le nombre maximum de packages de monnaie virtuelle qu’ils peuvent acheter est toujours affiché. Pour afficher à l’utilisateur le nombre restant de packages de monnaie virtuelle (sous réserve de la limite courante), passez les données d’autorisation de l’utilisateur lors de la requête de catalogue des packages de monnaie virtuelle à l’aide des méthodes de la sous-section Catalogue du groupe de méthodes Objets et monnaie virtuels.

Pour un affichage correct du nombre de packages de monnaie virtuelle disponibles pour l’utilisateur, configurez l’authentification.

Exemple de réponse avec les attributs utilisateur :

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 garantit que les limites ne sont pas dépassées et empêche les utilisateurs d’acheter plus de packages de monnaie virtuelle que la limite fixée.

Lorsque l’utilisateur ouvre l’interface de paiement et paie pour un package, toutes les commandes impayées contenant ce package deviennent invalides.

Exemple : l’utilisateur ouvre le formulaire de paiement d’un package soumis à une restriction d’achat dans plusieurs onglets du navigateur avant de payer. Cela entraîne automatiquement la création de plusieurs commandes pour le même package. Après avoir payé le package dans un des onglets, Xsolla annulera toutes les commandes impayées portant sur le même package.

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

Définissez la période d’affichage d’une monnaie virtuelle ou d’un package de monnaie virtuelle dans le magasin pour :

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.

Lorsque vous créez une interface de catalogue à l’aide de Site Builder, la minuterie s’affiche automatiquement. Lorsque vous créez un catalogue dans votre propre interface, vous devez implémenter la minuterie.

La période d’affichage de la monnaie virtuelle dans le magasin ne peut être définie qu’à l’aide de méthodes API.

Pour définir une limite de temps d’affichage d’une monnaie virtuelle dans le magasin via API, passez les paramètres suivants dans l’appel API Create virtual currency ou Update virtual currency.

periods[0].date_from avec la date et l’heure de début de la période d’affichage du bien au format YYYY-MM-DDThh:mm:ss±TMZ, où TMZ est l’indicateur de fuseau horaire au format hh:mm GMT ;
periods[0].date_until avec la date et l’heure de fin de la période d’affichage du bien au formatYYYY-MM-DDThh:mm:ss±TMZ, où TMZ est l’indicateur de fuseau horaire au format hh:mm GMT. Pour ne pas indiquer la fin de la période d’affichage du bien, passez null.

Vous pouvez définir plusieurs périodes pour l’affichage d’une monnaie virtuelle dans le magasin. Pour ce faire, dans la méthode Create virtual currency ou Update virtual currency, passez un tableau contenant les dates de début et de fin de toutes les périodes.

Exemple :

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

Pour définir une limite de temps pour l’affichage d’un package de monnaie virtuelle dans le magasin via le Compte éditeur, sélectionnez Time period et spécifiez le fuseau horaire ainsi que les dates de début et de fin de la période. Si vous ne souhaitez pas indiquer de date de fin d’affichage, cochez la case No end date.

Pour définir une limite de temps d’affichage d’un package dans le magasin via API, passez les paramètres suivants dans l’appel API Create virtual currency package ou Update virtual currency package.

periods[0].date_from avec la date et l’heure de début de la période d’affichage du bien au format YYYY-MM-DDThh:mm:ss±TMZ, où TMZ est l’indicateur de fuseau horaire au format hh:mm GMT ;
periods[0].date_until avec la date et l’heure de fin de la période d’affichage du bien au formatYYYY-MM-DDThh:mm:ss±TMZ, où TMZ est l’indicateur de fuseau horaire au format hh:mm GMT. Pour ne pas indiquer la fin de la période d’affichage du bien, passez null.

Vous pouvez définir plusieurs périodes pour l’affichage d’un package dans le magasin. Pour ce faire, dans la méthode Create virtual currency package ou Update virtual currency package, passez un tableau contenant les dates de début et de fin de toutes les périodes.

Exemple :

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

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

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

Configurer une monnaie virtuelle

Vous pouvez configurer des monnaies virtuelles :

dans le Compte éditeur ;
via appels API.

Configurer la monnaie virtuelle dans le Compte éditeur

Configurer la monnaie virtuelle via appels API

Utilisez les appels API de la sous-section Admin des API des endpoints Virtual Items & Currency.

Merci pour votre commentaire !

Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.

Dernière mise à jour: 10 Octobre 2023

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Your browser is not supported. Please try a different browser

Articles populaires

Ou choisissez les questions les plus fréquemment posées:

Réponse basée sur les sources suivantes:

Laissez-nous un commentaire (facultatif)

Laissez-nous un commentaire (facultatif)

In-Game Store

Monnaie virtuelle

Comment ça marche

Options de vente de la monnaie

Vendre n'importe quel montant de monnaie virtuelle

Vendre des packages de monnaie virtuelle

Livraison de la monnaie

Monnaie premium

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

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

Qui peut l'utiliser

Comment configurer

Prérequis

Configurer une monnaie virtuelle

Configurer la monnaie virtuelle dans le Compte éditeur

Configurer la monnaie virtuelle via appels API