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.
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
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.
| Tâche | Appel 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 :
|
| 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 :
|
Pour plus d’informations sur les limites, consultez les guides suivants :
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
Pour afficher un package de monnaie virtuelle :
Dans votre projet dans le Compte éditeur, allez à la section Storefronts > Websites.
Cliquez sur le volet du site souhaité.
Dans le projet dans votre compte, allez à la section Storefronts > Websites.
Cliquez sur le volet du site souhaité.
Dans le projet dans votre compte, allez à la section Storefronts > Websites.
Cliquez sur le volet du site souhaité.
Dans le projet dans votre compte, allez à la section Storefronts > Websites.
Cliquez sur le volet du site souhaité.
Dans votre projet dans le compte pour les jeux mobiles, accédez à la section Web Shop.
Cliquez sur le volet du site souhaité.
Si votre site comprend plusieurs pages, sélectionnez celle qu’il vous faut :
- Cliquez sur le titre de la page actuelle en haut de l’éditeur.
- Sélectionnez la page nécessaire dans la liste déroulante.
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.
Après avoir effectué toutes les modifications nécessaires et préparé votre site web pour le lancement :
- Dans le coin supérieur droit de l’éditeur de site, cliquez sur Publish.
- Cochez les cases à côté des pages que vous souhaitez publier.
- Cliquez sur Publish.
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âche | Appel 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.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.




