Monnaie virtuelle

Comment ça marche

La monnaie virtuelle est une monnaie numérique utilisée pour acquérir des objets virtuels. Selon son usage, elle peut affecter l’économie du jeu ou contribuer à la monétisation de l’application.

Fonctionnalités principales :

  • Vente d’un montant quelconque de monnaie virtuelle ou de packages de monnaie virtuelle à montant fixe.
  • Vente de monnaie virtuelle et de packages de monnaie virtuelle contre une devise réelle ou une monnaie virtuelle.
  • Limitation du nombre de packages de monnaie virtuelle disponibles à l’achat.
  • Limitation de la durée d’affichage de la monnaie virtuelle et des packages de monnaie virtuelle dans le magasin.
  • Packages de monnaie virtuelle gratuits.
Avis
Dans les campagnes de remise et les campagnes avec codes promo ou coupons, vous devez utiliser des packages de monnaie virtuelle. Des montants arbitraires de monnaie virtuelle ne peuvent être utilisés que dans les campagnes Bonus.

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

  • Montant libre — permet de vendre de la monnaie virtuelle pour le montant indiqué par l’utilisateur. Pour utiliser cette option, implémentez côté client un champ de saisie qui permet à l’utilisateur d’entrer le montant souhaité lors de l’achat.
  • Packages — permet de vendre de la monnaie virtuelle en montants prédéfinis. Le prix d’un package est défini séparément et peut différer du prix standard du même montant de cette monnaie.

Exemple : un package contient 100 pièces d’or et coûte 90 $, tandis que le prix d’une pièce d’or est de 1 $.

Restrictions :

  • Vous ne pouvez ajouter qu’un seul type de monnaie virtuelle à un package.
  • Un prix dans une autre monnaie virtuelle ne peut être configuré que via des appels API.
  • Un package de monnaie virtuelle peut être rendu gratuit — sans spécifier de prix en devise réelle ou en monnaie virtuelle. Vous pouvez le configurer via le Compte éditeur ou via des appels API. La monnaie virtuelle gratuite qui ne fait pas partie d’un package ne peut être créée que via des appels API.
  • Un package de monnaie virtuelle peut être rendu gratuit — sans spécifier de prix en devise réelle ou en monnaie virtuelle. Vous pouvez le configurer via votre compte ou via des appels API. La monnaie virtuelle gratuite qui ne fait pas partie d’un package ne peut être créée que via des appels API.
  • Un package de monnaie virtuelle peut être rendu gratuit — sans spécifier de prix en devise réelle ou en monnaie virtuelle. Vous pouvez le configurer dans le compte pour les jeux mobiles ou via des appels API. La monnaie virtuelle gratuite qui ne fait pas partie d’un package ne peut être créée que via des appels API.
  • Le montant de monnaie virtuelle dans un package ne peut être indiqué que sous forme de nombre entier.

Comment configurer

Configurer dans le Compte éditeur

Configurer dans votre compte

Note
Avant de configurer la monnaie virtuelle ou des packages de monnaie virtuelle, il est recommandé de créer des groupes pour trier les objets et gérer leur affichage dans votre magasin.

Configurer via l’API

Pour configurer des monnaies virtuelles, vous pouvez utiliser les appels de la sous-section Admin du groupe Objets et monnaie virtuels.

Avis
Les appels de la sous-section Admin ne sont pas destinés à construire un catalogue de magasin côté client. Vous ne devez pas les utiliser pour des pages de destination, des magasins en ligne et des logiques en jeu.
TâcheAppel API
Créer une monnaie virtuelle.Create virtual currency.
Récupérer une monnaie virtuelle.Get virtual currency.
Récupérer la liste des monnaies virtuelles.Get list of virtual currencies.
Mettre à jour une monnaie virtuelle.Update virtual currency.
Supprimer une monnaie virtuelle.Delete virtual currency.
Limiter la quantité de monnaie virtuelle disponible à l’achat.Dans les appels API Create virtual currency ou Update virtual currency, transmettez les paramètres suivants :
  • limits — spécifie la quantité maximale de monnaie virtuelle disponible à l’achat.
  • limits.recurrent_schedule — définit la fréquence de réinitialisation de la limite.
Créer un package de monnaie virtuelle.Create virtual currency package.
Récupérer un package de monnaie virtuelle.Get virtual currency package.
Récupérer la liste des packages de monnaie virtuelle.Get list of virtual currency packages.
Mettre à jour un package de monnaie virtuelle.Update virtual currency package.
Supprimer un package de monnaie virtuelle.Delete virtual currency package.
Limiter le nombre de packages de monnaie virtuelle disponibles à l’achat.Dans les appels API Create virtual currency package ou Update virtual currency package, transmettez les paramètres suivants :
  • limits — spécifie le nombre maximal de packages de monnaie virtuelle disponibles à l’achat.
  • limits.recurrent_schedule — définit la fréquence de réinitialisation de la limite.
Avis
La période d’affichage de la monnaie virtuelle dans le magasin ne peut être configurée qu’à l’aide d’appels API.

Afficher la monnaie virtuelle dans le catalogue

L’affichage de la monnaie virtuelle ou des packages de monnaie virtuelle dépend de la manière dont le catalogue est implémenté — via l’éditeur de site ou via l’API.

Afficher via l’éditeur de site

Note
Seuls les packages de monnaie virtuelle peuvent être affichés dans le catalogue du magasin.

Pour afficher un package de monnaie virtuelle :

  1. Créer un package de monnaie virtuelle.

  2. Dans votre projet dans le Compte éditeur, allez à la section Storefronts > Websites.

  3. Cliquez sur le volet du site souhaité.

  1. Créer un package de monnaie virtuelle.

  2. Dans le projet dans votre compte, allez à la section Storefronts > Websites.

  3. Cliquez sur le volet du site souhaité.

  1. Créer un package de monnaie virtuelle.

  2. Dans le projet dans votre compte, allez à la section Storefronts > Websites.

  3. Cliquez sur le volet du site souhaité.

  1. Créer un package de monnaie virtuelle.

  2. Dans le projet dans votre compte, allez à la section Storefronts > Websites.

  3. Cliquez sur le volet du site souhaité.

  1. Créer un package de monnaie virtuelle.

  2. Dans votre projet dans le compte pour les jeux mobiles, accédez à la section Web Shop.

  3. Cliquez sur le volet du site souhaité.

  1. Si votre site comprend plusieurs pages, sélectionnez celle qu’il vous faut :

    1. Cliquez sur le titre de la page actuelle en haut de l’éditeur.
    2. Sélectionnez la page nécessaire dans la liste déroulante.

  2. Dans la section du bloc Store, sélectionnez dans le champ Item type le package de monnaie virtuelle que vous souhaitez vendre sur le site web.

  1. Définir une disposition de carte d’objet.

  2. Après avoir effectué toutes les modifications nécessaires et préparé votre site web pour le lancement :

    1. Dans le coin supérieur droit de l’éditeur de site, cliquez sur Publish.
    2. Cochez les cases à côté des pages que vous souhaitez publier.
    3. Cliquez sur Publish.

Avis

Si la publication du site web n’est pas disponible, assurez-vous que toutes les conditions sont remplies :

  • Il n’y a pas de sections vides sur le site (indiquées par un indicateur rouge).
  • Le contrat de licence avec Xsolla a été signé.
  • La page principale est publiée ou sélectionnée pour publication. Vous ne pouvez pas publier des pages enfants avant la page principale.

Une fois le site publié, une section avec des packages de monnaie virtuelle sera disponible. Si aucun package n’est affiché, vérifiez que leur statut est défini sur Available et qu’aucune limite d’affichage basée sur le temps n’est active.

Obtenir des informations sur la monnaie virtuelle via l’API

Pour récupérer le catalogue des monnaies virtuelles et des packages de monnaie virtuelle côté client, utilisez les appels de la sous-section Catalog du groupe Objets et monnaie virtuels.

TâcheAppel API
Obtenir une monnaie virtuelle par SKU.Transmettez le paramètre virtual_currency_sku à l’appel API Get virtual currency by SKU.
Obtenir une liste de monnaies virtuelles.Get virtual currency list.
Obtenir un package de monnaie virtuelle par SKU.Transmettez le paramètre virtual_currency_package_sku à l’appel API Get virtual currency package by SKU.
Obtenir une liste de packages de monnaie virtuelle.Get virtual currency package list.

Attribuer de la monnaie virtuelle aux utilisateurs

Selon le type d’objet et les paramètres d’intégration, une monnaie virtuelle est attribuée à l’utilisateur de l’une des manières suivantes :

  • Si vous avez intégré PlayFab, la monnaie virtuelle et les objets sont automatiquement ajoutés à l’inventaire PlayFab de l’utilisateur.

  • Si vous utilisez un système de distribution personnalisé, tous les objets virtuels et la monnaie virtuelle sont attribués de votre côté. Nous recommandons de configurer un gestionnaire de webhook pour recevoir les données de commande sur votre backend. Les données nécessaires sont incluses dans le webhook Paiement de commande réussi.

Pour plus de détails sur ce point et d’autres méthodes de récupération des données d’achat, consultez la section Configurer le suivi du statut de la commande.

Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 15 Mai 2026

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

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !
Impossible d'envoyer votre commentaire
Réessayez plus tard ou contactez-nous à [email protected].