La monnaie virtuelle est de l’argent virtuel qui est utilisé pour acheter et vendre des objets dans le jeu. Selon son objectif, une monnaie virtuelle affecte l’équilibre économique du jeu ou est liée à la monétisation de l’application. Vous pouvez également créer une monnaie premium : une monnaie virtuelle qui est liée à la plateforme d’achat et qui ne peut être obtenue qu’en échange d’argent réel.

La monnaie virtuelle peut être vendue en quantités prédéfinies. Pour un package donné, vous pouvez définir un prix spécial qui ne correspond pas nécessairement à la quantité de la monnaie virtuelle qu’il contient.

Voir la section Monnaie virtuelle pour en savoir plus sur la monnaie virtuelle.

Pour configurer une monnaie virtuelle via le Compte éditeur :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Add et sélectionnez Virtual currency dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   1. Image (facultatif) ;
   2. UGS ;
   3. Nom de la monnaie virtuelle.
4. Pour configurer l’affichage de la monnaie virtuelle dans le magasin, sélectionnez le statut approprié.

5. Pour définir un prix, appuyez sur Set up prices et indiquez le prix en devise réelle. Si nécessaire, configurez les prix régionaux.
6. Configurez les attributs en utilisant l’une des méthodes suivantes (facultatif) :

1. 1. Ajoutez des attributs et leurs valeurs au format JSON.

1. 2. Créez manuellement des attributs et des valeurs et associez-les à des objets spécifiques.

7. Vérifiez les paramètres et appuyez sur Create currency.

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Add et sélectionnez Virtual currency package dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   1. Image (facultatif) ;
   2. UGS ;
   3. Un ou plusieurs groupes auxquels le package doit appartenir ;
   4. Nom ;
   5. Description (facultatif).
4. Pour configurer l’affichage de la monnaie virtuelle dans le magasin, sélectionnez le statut approprié.

5. Spécifiez la monnaie virtuelle incluse dans le package ainsi que sa quantité.
6. Définissez les prix ou créez un objet gratuit dans le champ Paid or free :

1. • Pour créer un package gratuit, sélectionnez Free package.

1. • Pour définir un prix, sélectionnez Paid package et indiquez le prix en devise réelle. Si nécessaire, configurez les prix régionaux.

7. Pour limiter le nombre de packages qu’un utilisateur peut acheter, activez la bascule Limit number of times one user can buy package et entrez la quantité souhaitée.
8. Pour configurer la fréquence de réinitialisation de la limite :

1. 1. Dans la liste déroulante, sélectionnez une période :
      • Daily ;
      • Weekly ;
      • Monthly ;
      • Custom interval – l’intervalle est calculé à partir de la date de début d’affichage du package ;
      • No regular refresh.

1. 2. Configurez le calendrier de réinitialisation en fonction de la période sélectionnée.

9. Configurez une limite de temps pour l’affichage du package (facultatif) :

1. 1. Dans le champ Show item in store, sélectionnez Limited time.

1. 2. Précisez le fuseau horaire ainsi que le début et la fin de la période.

1. 1. Si vous ne souhaitez pas définir de date de fin pour l’affichage de l’objet, cochez la case No end date.

10. Configurez les attributs en utilisant l’une des méthodes suivantes (facultatif) :

1. 1. Ajoutez des attributs et leurs valeurs au format JSON.

1. 2. Créez manuellement des attributs et des valeurs et associez-les à des objets spécifiques.

11. Vérifiez les paramètres et appuyez sur Create package.

Les objets virtuels sont le contenu du jeu que vous pouvez vendre contre des devises réelles et de la monnaie virtuelle.

Voir la section Objets virtuels pour en savoir plus sur les objets virtuels.

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Add et sélectionnez Virtual item dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   • Image (facultatif) ;
   • UGS ;
   • Un ou plusieurs groupes auxquels l’objet doit appartenir ;
   • Nom ;
   • Description (facultatif).
4. Pour configurer l’affichage de l’objet virtuel dans le magasin, sélectionnez le statut approprié.

5. Définissez les prix ou créez un objet gratuit dans le champ Paid or free :

1. • Pour créer un objet gratuit, sélectionnez Free item.

1. • Pour définir un prix, sélectionnez Paid item et indiquez le prix en devise réelle. Si nécessaire, configurez les prix régionaux.

6. Pour limiter le nombre d’objets qu’un utilisateur peut acheter, activez la bascule Limit number of times one user can buy this item et entrez la quantité souhaitée.
7. Pour configurer la fréquence de réinitialisation de la limite :

1. 1. Dans la liste déroulante, sélectionnez une période :
      • Daily ;
      • Weekly ;
      • Monthly ;
      • Custom interval – l’intervalle est calculé à partir de la date de début d’affichage de l’objet ;
      • No regular refresh.

1. 2. Configurez le calendrier de réinitialisation en fonction de la période sélectionnée.

8. Configurez une limite de temps pour l’affichage de l’objet (facultatif) :

1. 1. Dans le champ Show item in store, sélectionnez Limited time.

1. 2. Précisez le fuseau horaire ainsi que le début et la fin de la période.

1. 1. Si vous ne souhaitez pas définir de date de fin pour l’affichage de l’objet, cochez la case No end date.

9. Configurez les attributs en utilisant l’une des méthodes suivantes (facultatif) :

1. 1. Ajoutez des attributs et leurs valeurs au format JSON.

1. 2. Créez manuellement des attributs et des valeurs et associez-les à des objets spécifiques.

10. Vérifiez les paramètres et appuyez sur Create item.

Un lot est un ensemble de plusieurs biens vendus en une seule unité. Vous pouvez ajouter des biens de différents types à un lot :

• Monnaie virtuelle ;
• Package de monnaie virtuelle ;
• Objets virtuels, y compris des objets à durée limitée ;
• Lots.

Voir la section Lots pour en savoir plus sur les lots.

Pour créer un lot :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Add et sélectionnez Bundle dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   • Image (facultative).
   • UGS.
   • Un ou plusieurs groupes auxquels le lot doit appartenir.
   • Nom.
   • Description (facultative).
4. Configurez les attributs du lot (facultatif) à l’aide de l’une des méthodes suivantes :
   • Ajoutez les attributs et leurs valeurs au format JSON.
   • Créez manuellement des attributs et des valeurs, puis associez-les à des objets spécifiques.
5. Appuyez sur Next.
6. Si la personnalisation côté partenaire est activée, vous pouvez choisir entre un lot standard ou dynamique. Les lots dynamiques permettent d’ignorer la création d’objets dans Xsolla et de renvoyer le contenu généré par votre serveur lors de la consultation du catalogue. Si la personnalisation côté partenaire est désactivée, le sélecteur de type de lot n’apparaît pas et un lot standard est créé automatiquement.

7. Ajoutez des objets au lot :
   1. Sélectionnez le type d'objet ;
   2. Indiquez une ou plusieurs UGS d'objets à inclure dans le lot ;
   3. Définissez la quantité pour chaque UGS.

8. Appuyez sur Next.
9. Définissez le prix du lot dans le champ Paid or Free :
   • Pour créer un lot gratuit, sélectionnez Free bundle.
   • Pour définir un prix, sélectionnez Paid bundle et indiquez le prix en devise réelle ou en monnaie virtuelle. Vous ne pouvez pas créer de lot dont le prix est nul. Si nécessaire, configurez les prix régionaux.
10. Pour limiter le nombre de lots disponibles à l’achat, activez la bascule Limit bundle purchases per user et entrez la quantité souhaitée.

11. Pour configurer la fréquence de réinitialisation de la limite :
    1. Dans la liste déroulante, sélectionnez une période :
       • Daily
       • Weekly
       • Monthly
       • Custom interval — l'intervalle est calculé à partir de la date de début d'affichage du lot
       • No regular refresh
    2. Configurez le calendrier de réinitialisation en fonction de la période sélectionnée.

12. Appuyez sur Next.

13. Configurez l'affichage du lot dans le magasin :
    1. Choisissez le statut ;
    2. Définissez une durée d'affichage pour le lot (facultatif) : indiquez le fuseau horaire ainsi que les dates de début et de fin. Si vous ne souhaitez pas indiquer de date de fin, cochez la case No end date.

14. Appuyez sur Next.
15. Vérifiez les paramètres et appuyez sur Save.

Vous pouvez configurer des plans d’abonnement dans le Compte éditeur ou via l’appel API Créer un plan.

Pour configurer un plan d’abonnement dans le Compte éditeur :

1. Accédez à la section Items catalog > Subscriptions.
2. Dans l'onglet Subscription plan, appuyez sur Create subscription plan.

3. Choisissez et configurez le type de plan :
   • Plan régulier avec paiements réguliers ;
   • Plan à vie avec paiement unique et durée de validité illimitée ;
   • Passe de saison avec paiement unique et durée de validité limitée.

Configurer un plan régulier

1. Spécifiez :
   1. Nom du plan ;
   2. Description (facultatif) : la description du plan s'affiche dans l'interface de paiement lorsque les utilisateurs achètent un abonnement.

2. Cliquez sur Next.
3. Choisissez l'une des options de frais d'abonnement :
   • Regular : le montant de chaque paiement est spécifié manuellement ;
   • Including setup fee : le montant de chaque paiement ainsi que le montant des frais de mise en service sont spécifiés manuellement. Utilisez ce paramètre si vous souhaitez facturer à l'abonné des frais supplémentaires tels que la connexion d'une licence, la configuration d'un système, la formation d'un utilisateur ou la fourniture d'une consultation. Dans ce cas, le premier paiement inclura les frais de mise en service, les paiements restants seront égaux au montant du paiement régulier ;

• • Associated with the first payment : le montant de chaque paiement est égal au premier paiement effectué par l'utilisateur. Le coût de l'abonnement et le type de devise sont passés dans les paramètres purchase.checkout.amount et purchase.checkout.currency lors de l'ouverture de l'interface de paiement. Utilisez cette option si vous souhaitez gérer les prix de votre côté et avoir la possibilité de définir des prix individuels pour des utilisateurs spécifiques.

4. Que vous choisissiez des frais d'abonnement réguliers ou avec des frais de mise en service, vous pouvez définir différents prix d'abonnement pour différentes devises. Pour ce faire, procédez comme suit :

• 1. Dans les champs Currency et Price, sélectionnez la devise requise et spécifiez la valeur du prix de l'abonnement. Pour un abonnement avec frais de mise en service, entrez également la valeur des frais de mise en service dans le champ correspondant ;

• 2. Cliquez sur + pour ajouter des prix dans d'autres devises ;

• 3. Spécifiez la devise par défaut.

5. Configurez le cycle de facturation :
   1. Spécifiez la fréquence de paiement ;
   2. Spécifiez le nombre de jours de la période d'essai pendant lesquels l'abonnement peut être utilisé sans paiement. Mettez la valeur 0 pour créer un plan sans période d'essai.

6. Spécifiez les paramètres pour le paiement unique. Avec ce type de renouvellement d'abonnement, les utilisateurs effectuent des paiements via un lien de paiement envoyé par e-mail :
   1. Rappel d'expiration : spécifiez le nombre de jours avant la date d'expiration de l'abonnement quand l'utilisateur reçoit un rappel. Si vous mettez la valeur 6 ou plus, l'utilisateur reçoit un rappel supplémentaire un jour avant la date d'expiration. Pour ne pas envoyer de rappels, mettez la valeur 0 ;
   2. Période de grâce : le nombre de jours pendant lesquels les utilisateurs peuvent continuer à utiliser leur abonnement après sa date d'expiration et avoir la possibilité de le renouveler. Mettez la valeur 0 pour créer un plan sans période de grâce.

7. Spécifiez les paramètres pour le paiement automatique. Avec ce type de renouvellement d'abonnement, les paiements sont effectués automatiquement à l'aide des informations de facturation enregistrées sans aucune intervention de l'utilisateur :
   1. Rappel d'expiration de l'abonnement ;
   2. Nombre de nouvelles tentatives après la première tentative infructueuse de facturation de l'abonnement. Le système réessaiera une fois par jour.

8. Cliquez sur Next.

9. Cliquez sur Create.

Configurer un plan à vie

1. Spécifiez :
   1. Nom du plan ;
   2. Description (facultatif) : la description du plan s'affiche dans l'interface de paiement lorsque les utilisateurs achètent un abonnement.

2. Cliquez sur Next.
3. Choisissez l'une des options de frais d'abonnement :
   • Regular : le montant de chaque paiement est spécifié manuellement ;
   • Associated with the first payment : le montant de chaque paiement est égal au premier paiement effectué par l'utilisateur. Le coût de l'abonnement et le type de devise sont passés dans les paramètres purchase.checkout.amount et purchase.checkout.currency lors de l'ouverture de l'interface de paiement. Utilisez cette option si vous souhaitez gérer les prix de votre côté et avoir la possibilité de définir des prix individuels pour des utilisateurs spécifiques.

4. Dans le champ Refund period, spécifiez le nombre de jours au cours desquels l'utilisateur peut se désinscrire et demander un remboursement.

5. Si vous choisissez des frais d'abonnement réguliers, vous pouvez définir différents prix d'abonnement pour différentes devises. Pour ce faire, procédez comme suit :

• 1. Dans les champs Currency et Price, sélectionnez la devise requise et spécifiez la valeur du prix de l'abonnement ;

• 2. Cliquez sur + pour ajouter des prix dans d'autres devises ;

• 3. Spécifiez la devise par défaut.

6. Cliquez sur Next.

7. Cliquez sur Create.

Configurer le passe de saison

1. Spécifiez :
   1. Nom du plan ;
   2. Période de validité du passe de saison ;
   3. Description (facultatif) : la description du plan s'affiche dans l'interface de paiement lorsque les utilisateurs achètent un abonnement.

2. Cliquez sur Next.
3. Choisissez l'une des options de frais d'abonnement :
   • Regular : le montant de chaque paiement est spécifié manuellement ;
   • Associated with the first payment : le montant de chaque paiement est égal au premier paiement effectué par l'utilisateur. Le coût de l'abonnement et le type de devise sont passés dans les paramètres purchase.checkout.amount et purchase.checkout.currency lors de l'ouverture de l'interface de paiement. Utilisez cette option si vous souhaitez gérer les prix de votre côté et avoir la possibilité de définir des prix individuels pour des utilisateurs spécifiques.

4. Dans le champ Refund period, spécifiez le nombre de jours au cours desquels l'utilisateur peut se désinscrire et demander un remboursement.

5. Si vous choisissez des frais d'abonnement réguliers, vous pouvez définir différents prix d'abonnement pour différentes devises. Pour ce faire, procédez comme suit :

• 1. Dans les champs Currency et Price, sélectionnez la devise requise et spécifiez la valeur du prix de l'abonnement ;

• 2. Cliquez sur + pour ajouter des prix dans d'autres devises ;

• 3. Spécifiez la devise par défaut.

6. Cliquez sur Next.

7. Cliquez sur Create.