Lorsque vous créez des objets virtuels côté Xsolla, vous avez la possibilité de configurer les prix et les restrictions régionales, ainsi que d’utiliser le système de promotions et d’autres fonctionnalités de Xsolla, qui sont régulièrement enrichies et mises à jour.

Créer un groupe

Pour configurer des objets virtuels, vous devez d’abord configurer des groupes d’objets virtuels. Ces groupes vous permettent de structurer votre catalogue à plusieurs niveaux et de gérer l’affichage des objets dans le magasin.

1. Ouvrez le projet dans votre Compte éditeur.
2. Dans le menu latéral, cliquez sur Store.
3. Dans le volet Virtual Items, cliquez sur :
   • Connect — si vous n'avez jamais configuré d'objets virtuels auparavant ;
   • Configure — si vous avez déjà configuré des objets virtuels.
4. Dans la liste déroulante, sélectionnez Create group.

5. Spécifiez les paramètres suivants :
   • External ID — identifiant du groupe dans le magasin utilisé pour gérer le groupe d'objets virtuels via des appels API. Il doit être unique pour chaque groupe ;
   • Group name.
6. Réglez la bascule Show group in store sur On pour afficher les objets de ce groupe dans le magasin.
7. Cliquez sur Create group.

Créer des objets virtuels

1. Cliquez sur le nom du groupe créé.
2. Cliquez sur Create item.

3. Spécifiez les informations relatives à l'objet. Champs obligatoires :
   • SKU — identifiant unique de l'objet ;
   • Item name ;
   • Description ;
   • Price in real currency.
4. Réglez la bascule Show item in store sur On.
5. Cliquez sur Create item.

Aux étapes qui suivent, vous aurez besoin du SKU de l’objet créé :

Utilisez les appels API de la sous-section Admin du groupe Virtual Items & Currency pour configurer les objets virtuels.

Une autorisation de base est requise pour utiliser les appels API. Passez le code Authorization:Basic <your_authorization_basic_key>, où <your_authorization_basic_key> est la paire merchant ID:API key encodée conformément à la norme Base64. Accédez au Compte éditeur pour trouver les paramètres suivants :

• Merchant ID est affiché :
  • Dans la section Company settings > Company ;
  • Dans l'URL de la barre d'adresse du navigateur sur n'importe quelle page du Compte éditeur. L'URL est au format suivant : https:​//publisher.xsolla.com/<merchant ID>/<Publisher Account section>.

• L'API key ne s'affiche dans le Compte éditeur qu'une seule fois lors de sa création, vous devez donc la conserver de votre côté. Vous pouvez créer une nouvelle clé dans les sections suivantes :
  • Company settings > API keys ;
  • Project settings > API keys.

Utilisez les appels API de la sous-section Catalog du groupe Virtual Items & Currency pour obtenir le catalogue des objets virtuels côté client. Ces appels ne nécessitent pas d’autorisation de base.

Utilisez l’appel API Get virtual items list pour obtenir la liste complète des objets non divisés en groupes. Pour obtenir la liste des objets du groupe défini, passez le paramètre external_id à l’appel Get items list by specified group.