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 :

1. Ouvrez votre projet dans le Compte éditeur.
2. Cliquez sur Store dans le menu latéral et connectez le module Virtual Currency.

3. Dans l'onglet Prices, cliquez sur New virtual currency.

Pour configurer un package de monnaie virtuelle :

1. Ouvrez votre projet dans le Compte éditeur.
2. Cliquez sur Store dans le menu latéral et accédez à la section Virtual Currency.
3. Accédez à Packages.
4. Cliquez sur New package.

5. Spécifiez les paramètres suivants :
   • Image du package (facultatif) ;
   • UGS du package ;
   • Nom du package ;
   • Brève description du package ;
   • Monnaie virtuelle dans le package ;
   • Prix en devise réelle et en monnaie virtuelle ;
   • Devise par défaut ;
   • Attribut (facultatif).

6. Pour limiter le nombre de fois que l'utilisateur peut acheter un package de monnaie virtuelle, réglez la bascule Limit the number of times one user can buy package sur On et spécifiez la limite.
7. Vous pouvez définir une période d'affichage limitée pour le package de monnaie virtuelle. Pour ce faire, sélectionnez Time period, 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.
8. Cliquez 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.

Il existe 3 types d’objets virtuels :

• Consommables – objets que l’utilisateur peut avoir en grande quantité et acheter plusieurs fois. Leur quantité diminue lorsqu’il les utilise.
• Non consommables – objets qui ne peuvent être obtenus ou achetés qu’une seule fois. Ils sont conservés dans l’inventaire de l’utilisateur et ne peuvent pas être retirés de l’inventaire en étant consommés côté client. Vous ne pouvez les retirer que côté serveur.
• Objet à durée limitée – objet non consommable disponible pendant une période limitée et qui ne disparaît pas de l’inventaire à son expiration. L’utilisateur doit acheter à nouveau cet objet pour l’activer.

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

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

Pour créer des groupes d’objets virtuels :

1. Ouvrez votre projet dans le Compte éditeur.
2. Cliquez sur Store dans le menu latéral et connectez le module Virtual Items.

3. Cliquez sur Create a group.

4. Spécifiez les paramètres suivants :
   • Code du groupe ;
   • Nom du groupe.
5. Pour afficher le groupe dans le catalogue, réglez la bascule Show group in Store sur On.

6. Cliquez sur Create group.

Pour configurer un objet virtuel :

1. Ouvrez votre projet dans le Compte éditeur.
2. Cliquez sur Store dans le menu latéral et connectez le module Virtual Items.
3. Cliquez sur Create item.

4. Spécifiez :
   • Image ;
   • UGS ;
   • Un ou plusieurs groupes auxquels l'objet doit appartenir ;
   • Nom ;
   • Description.

• Propriété de l'objet : objets consommables, non consommables ou à durée limitée ;
• Prix en devises réelles ou en monnaie virtuelle.

5. Pour limiter le nombre de fois que l'utilisateur peut acheter un objet, réglez la bascule Limit number of times one user can buy this item sur On et spécifiez la limite.
6. Vous pouvez définir une période d'affichage limitée pour l'objet. Pour ce faire, sélectionnez Time period, 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.
7. Cliquez 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 configurer un lot :

1. Ouvrez votre projet dans le Compte éditeur.
2. Cliquez sur Store dans le menu latéral et connectez le module Bundles.

3. Cliquez sur Créer un lot.
4. Spécifiez les paramètres suivants :
   • Image (facultatif) ;
   • UGS ;
   • Nom ;
   • Brève description (facultatif) ;
   • Type de produit ;
   • Prix.

5. Pour limiter le nombre de fois que l'utilisateur peut acheter un lot, réglez la bascule Limit the number of times one user can buy bundle sur On et spécifiez la limite.
6. Vous pouvez définir une période d'affichage limitée pour le lot. Pour ce faire, sélectionnez Time period, 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.
7. Cliquez 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 Subscriptions.
2. Dans l'onglet Subscription plan, cliquez 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.