Prix locaux

Afin d’augmenter les ventes dans les pays à faible pouvoir d’achat, vous pouvez définir des prix régionaux pour tous les objets du catalogue. Par défaut, les prix sont en USD. Vous pouvez également configurer des restrictions régionales.

Vous pouvez ajouter, modifier et supprimer des prix régionaux :

• via le Compte éditeur lors de la création ou la modification d’un objet
• en important les prix depuis un fichier JSON via le Compte éditeur ou à l’aide de l’appel API Import items via JSON file
• à l’aide des méthodes API

Comment ça marche

Les prix du catalogue sont basés sur le pays de l’utilisateur.

Pendant le paiement via Pay Station, le prix du bien est converti dans la devise du pays de l’utilisateur et inclut les taxes, le cas échéant.

Détermination du pays

• Lors de la récupération du catalogue des objets, le pays de l’utilisateur est passé dans le paramètre country dans les méthodes de la sous-section Catalogue du groupe de méthodes Objets et monnaie virtuels ou Game keys.
  Si le pays n’est pas spécifié, il sera déterminé en fonction de l’adresse IP de l’utilisateur. Ensuite, les prix du catalogue des objets sont sélectionnés pour le pays de l’utilisateur.
• Lors de l’achat d’un objet :
  • Si vous utilisez les méthodes côté client pour obtenir un jeton de paiement, il est important de les utiliser uniquement côté client et non côté serveur. Le pays et la devise dans les méthodes côté client sont déterminés par l’adresse IP de l’utilisateur. Utiliser cette méthode côté serveur peut entraîner une détermination incorrecte de la devise et affecter les modes de paiement dans Pay Station.
  • Si vous utilisez la méthode serveur Créer un jeton de paiement pour un achat, assurez-vous de passer l’objet country dans le corps de la requête ou l’adresse IP de l’utilisateur dans l’en-tête X-User-Ip.

1. 1. Si le pays est passé dans le paramètre country.value en même temps que l'adresse IP dans l'en-tête X-User-Ip, la valeur du pays dans le paramètre country.value prévaut.

Principes d'affichage des prix dans le catalogue des objets

Pour tous les objets du catalogue, vous devez utiliser la même liste de devises dans laquelle les prix sont spécifiés. Cette démarche est essentielle pour garantir que tous les objets du catalogue apparaissent dans une même devise. Si le prix n’est pas spécifié pour l’un des objets dans l’un des pays, les prix de l’ensemble du catalogue dans ce pays sont affichés dans la devise par défaut.

Si les objets ont des devises par défaut différentes, les prix s’affichent dans la devise par défaut du premier objet du catalogue. Si un objet ne possède pas de prix dans cette devise, la réponse à la demande de catalogue retournera une valeur de prix null pour cet objet. Cela peut entraîner un affichage incorrect du prix et affecter la présentation de l’ensemble du catalogue.

Exemples :

• 1 objet, 1 devise, pas de prix régionaux
• 1 objet, avec prix régionaux
• Objets multiples, avec prix régionaux, une devise par défaut
• Objets multiples, avec prix régionaux, différentes devises par défaut

La devise par défaut de l’objet est l’USD et le prix est de 5 USD, sans paramètres spécifiques pour les pays. Dans ce cas, tous les utilisateurs, quel que soit leur pays, verront ce prix.

Le projet a des prix dans les devises suivantes :

• prix par défaut — 7 USD ;
• prix en euros — 6 EUR ;
• prix régionaux :
  • Allemagne — 8 EUR,
  • Italie — 5 EUR,
  • Malaisie — 20 MYR,
  • Afrique du Sud — 90 ZAR.

Selon le pays de l’utilisateur, l’affichage des prix dans le catalogue sera le suivant :

Pays de l’utilisateur	Prix catalogue	Commentaire
États-Unis	7 USD	Aux États-Unis, l’USD est la devise utilisée. Aucun prix spécial n’est spécifié pour les États-Unis.
Japon	7 USD	Aucune devise n’est spécifiée pour le Japon, le prix est donc affiché dans la devise par défaut.
France	6 EUR	En France, l’EUR est la devise utilisée. Aucun prix spécial n’est spécifié pour la France.
Allemagne	8 EUR	Un prix régional est spécifié pour l’Allemagne.
Italie	5 EUR	Un prix régional est spécifié pour l’Italie.
Malaisie	20 MYR	Un prix régional est spécifié pour la Malaisie.
Afrique du Sud	90 ZAR	Un prix régional est spécifié pour l’Afrique du Sud.

Le projet dispose de prix dans les devises suivantes :

• le prix par défaut pour tous les objets en dollars américains (USD) ;
• en Malaisie, les prix de tous les objets sont en ringgit malaisien (MYR) ;
• en Afrique du Sud, les prix de tous les objets sauf un sont en rands sud-africains (ZAR).

Dans ce cas, le catalogue est affiché en MYR pour les utilisateurs de Malaisie, mais en USD pour les utilisateurs d’Afrique du Sud. Cela est dû au fait que le prix en ZAR n’a pas été spécifié pour l’un des objets.

Le projet dispose de prix dans les devises suivantes :

• le prix par défaut pour 1_test_item est en dollars américains (USD) ;
• le prix par défaut pour 2_test_item est en euros (EUR) ;
• en Afrique du Sud, le prix pour 1_test_item est indiqué en rands sud-africains (ZAR), pour 2_test_item il n’est pas spécifié.

Dans ce cas, pour les utilisateurs d’Afrique du Sud, le prix s’affiche dans la devise par défaut du premier objet du catalogue, c’est-à-dire 1_test_item.

La devise par défaut du 1_test_item est l’USD, tandis que celle du 2_test_item est l’EUR. De plus, aucun prix en USD n’est disponible pour ce dernier.

Par conséquent, la valeur de prix retournée pour 2_test_item sera null.

Configurer dans le Compte éditeur lors de la création ou de la modification d'un objet

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

3. Ajoutez :
   • image ;
   • UGS ;
   • un ou plusieurs groupes auxquels l’objet appartient ;
   • nom ;
   • description ;
   • propriété de l’objet : consommables, non consommables ou à durée limitée.
4. Dans le bloc Price settings, sélectionnez Paid item.
5. Réglez la bascule Pricing in real currency sur On et appuyez sur Set up prices.

6. Dans la fenêtre qui s’ouvre, spécifiez la devise et le prix par défaut. Vous pouvez remplacer le dollar américain par une autre devise par défaut.

7. Configurez les prix locaux. Pour ce faire, deux options s’offrent à vous, manuellement ou automatiquement :

• Pour définir les prix manuellement :

1. Appuyez sur Add local price et ajoutez les prix ligne par ligne.

2. Appuyez sur Apply.

• Pour définir les prix automatiquement :

1. Appuyez sur Calculate using default price. Une liste des pays sera générée par ordre alphabétique, et le prix dans la devise locale sera calculé pour chaque pays en fonction des taux de change et des taxes.

2. Pour supprimer les pays où les prix régionaux ne sont pas nécessaires, appuyez sur le bouton X situé à droite du prix.

3. Pour modifier un prix calculé automatiquement, changez la valeur dans la ligne correspondante.

4. Appuyez sur Apply changes.

8. Si vous souhaitez ajouter le prix en monnaie virtuelle, réglez le bouton Pricing in virtual currency sur On et indiquez le prix.
9. Si vous souhaitez limiter le nombre d’achats d’un objet par utilisateur :

1. Réglez la bascule Limit number of times one user can buy this item sur On.

2. Spécifiez le nombre d'achats autorisés.

3. Sélectionnez un intervalle de réinitialisation :

• No regular refresh

• Daily

• Weekly

• Monthly

• Custom interval. L'intervalle est calculé à partir de la date de début de la période d'affichage de l'objet dans le magasin.

10. Vous pouvez définir une durée maximale pendant laquelle l’objet sera affiché dans le magasin. Pour ce faire, utilisez la section Show item in store et indiquez les dates :
    • Always – l’objet sera disponible en magasin sans aucune restriction de temps.
    • Durée limitée – vous pouvez spécifier une ou plusieurs périodes d’affichage. Définissez le fuseau horaire et la plage horaire pour chaque période. Si nécessaire, cochez la case No end date pour afficher l’objet à partir de la date sélectionnée sans date de fin.

11. Appuyez sur Create item.

1. Ouvrez le projet dans le Compte éditeur et accédez à Items catalog > All items > Virtual items.
2. Appuyez sur ⋮ à côté de l’objet souhaité et sélectionnez Edit dans la liste déroulante.
3. Dans la section Price Settings, appuyez sur Edit sous le prix par défaut.

Configuration dans le Compte éditeur lors de l'importation des prix depuis un fichier

Vous pouvez importer des prix régionaux à partir d’un fichier pour des objets prédéfinis.

Fonctionnalités

• Téléchargez ou mettez à jour des prix régionaux pour plusieurs objets à la fois.
• Prise en charge de tous les types de biens :
  • objets virtuels ;
  • monnaie virtuelle ;
  • packages de monnaie virtuelle ;
  • lots ;
  • packages de clés de jeu pour une plateforme spécifique.
• Validation des données téléchargées. Si la structure du fichier ou le format des données ne répond pas aux exigences, une liste d’erreurs s’affichera lors de l’importation.

Structure du fichier

Le fichier doit être au format CSV et contenir les colonnes suivantes :

• SKU — UGS de l’objet pour lequel des prix régionaux doivent être définis.
• Country — code du pays au format ISO 3166-1 alpha-2. Consultez la liste des pays pris en charge par Xsolla avant d’uploader le fichier CSV. Le remplissage des cellules de cette colonne est facultatif. Consultez les exemples d’affichage des prix si le pays n’est pas spécifié.
• Currency — code de devise selon la norme ISO 4217.
• Amount — prix de l’objet. Utilisez un point comme séparateur de décimales.

• IsDefault — détermine si le prix est le prix par défaut. Spécifiez :

  • 1 — pour la ligne avec le prix par défaut. Il est affiché pour tous les pays sans prix régional ;
  • 0 — pour toutes les autres lignes. Vous pouvez également laisser la cellule dans la colonne IsDefault vide.

Note

Le prix par défaut ne doit pas être régional : laissez la cellule de la colonne Country vide.

EXEMPLE

Fichier correctement rempli (plusieurs articles, 3 devises, prix régionaux disponibles).

Fichier mal rempli (plusieurs objets, 3 devises, prix régionaux disponibles).
Erreur : Dans virtual-item-1 et bundle-1, les cellules des groupes dans la colonne Country ne sont pas vides.

Pour chaque nouvel objet ajouté, définissez le prix dans la devise par défaut. Sinon, une erreur s’affichera lors de l’importation du fichier.

EXEMPLE

Fichier correctement rempli (plusieurs articles, 3 devises, prix régionaux disponibles).

Fichier mal rempli (plusieurs objets, 3 devises, prix régionaux disponibles).
Erreur : il n’y a pas de devise par défaut pour les groupes virtual-item-1 et bundle-1.

• Platform — UGS de la plateforme. Utilisée pour fixer les prix régionaux des clés de jeu, elle ne s’applique pas à d’autres objets.

  Plateformes disponibles.

  UGS de la plateforme	Nom de la plateforme
  steam	Steam
  playstation	PlayStation
  xbox	Xbox
  uplay	Uplay
  origin	Origin
  drmfree	DRM Free
  gog	GOG
  epicgames	Epic Games Store
  nintendo_eshop	Nintendo Switch eShop
  discord_game_store	Discord Game Store
  oculus	Oculus
  viveport	Viveport
  stadia	Google Stadia

Note

Les clés de jeu portant la même UGS, mais associées à des plateformes différentes sont considérées comme des entités distinctes. Chaque entité doit disposer d’un prix spécifié dans la devise par défaut.

EXEMPLE

Fichier bien rempli (plusieurs clés de jeu, 3 devises, prix régionaux disponibles, 2 plateformes).

Fichier mal rempli (plusieurs clés de jeu, 3 devises, prix régionaux disponibles, 2 plateformes).
Erreur 1 : le groupement incorrect des clés de jeu par SKU et Platform, a conduit à l’identification de neuf entités au lieu de trois.
Erreur 2 : les groupes 3, 4, 5 et 6 n’ont pas de prix par défaut en raison d’un groupement incorrect.
Erreur 3 : le groupe 9 écrasera les données du groupe 7 parce qu’il contient un ensemble complet de prix pour la même entité. Par conséquent, game-key-2 pour la plateforme playstation ne comportera qu’un prix en MYR après l’importation.

Exemples de fichiers complétés et d'erreurs possibles

Exemples de remplissage correct du fichier CSV pour l’importation :

• Plusieurs objets, 3 devises, pas de prix régionaux
• Plusieurs objets, 1 devise, pas de prix régionaux
• Plusieurs clés de jeu, 3 devises, prix régionaux disponibles, 1 plateforme
• Plusieurs clés de jeu, 3 devises, pas de prix régionaux, 2 plateformes

Copy

Full screen

Small screen

• csv

 1SKU,Currency,Amount,Country,IsDefault
 2virtual-item-1,EUR,9.09,,0
 3virtual-item-1,USD,10.1,,1
 4virtual-item-1,MYR,47,,0
 5virtual-currency-1-pack-100,EUR,2.09,,0
 6virtual-currency-1-pack-100,USD,2.3,,1
 7virtual-currency-1-pack-100,MYR,24,,0
 8bundle-1,EUR,15,,0
 9bundle-1,USD,17,,1
10bundle-1,MYR,82,,0

Copy

Full screen

Small screen

• csv

1SKU,Currency,Amount,Country,IsDefault
2virtual-item-1,USD,10.1,,1
3virtual-currency-1-pack-100,USD,2.3,,1
4bundle-1,USD,17,,1

Copy

Full screen

Small screen

• csv

 1SKU,Currency,Amount,Country,IsDefault,Platform
 2game-key-1,EUR,9.09,,1,steam
 3game-key-1,EUR,9.2,DE,0,steam
 4game-key-1,EUR,8.09,IT,0,steam
 5game-key-1,USD,10.1,US,0,steam
 6game-key-1,MYR,47,MY,0,steam
 7game-key-2,EUR,2.09,,1,steam
 8game-key-2,EUR,2.2,DE,0,steam
 9game-key-2,EUR,1.79,IT,0,steam
10game-key-2,USD,2.3,US,0,steam
11game-key-2,MYR,24,MY,0,steam

Copy

Full screen

Small screen

• csv

 1SKU,Currency,Amount,Country,IsDefault,Platform
 2game-key-1,USD,10.1,,1,steam
 3game-key-1,EUR,9.09,,0,steam
 4game-key-1,MYR,47,,0,steam
 5game-key-1,USD,17,,1,playstation
 6game-key-1,EUR,15,,0,playstation
 7game-key-1,MYR,82,,0,playstation
 8game-key-2,USD,2.3,,1,steam
 9game-key-2,EUR,2.09,,0,steam
10game-key-2,MYR,24,,0,steam

• Plusieurs clés de jeu, 3 devises, pas de prix régionaux, 2 plateformes
• Plusieurs clés de jeu, 3 devises, prix régionaux disponibles, 2 plateformes
• Plusieurs objets, 3 devises, prix régionaux disponibles
• Plusieurs objets, 3 devises, prix régionaux disponibles
• Plusieurs objets, 3 devises, pas de prix régionaux

Erreur : les groupes game-key-1 + steam et game-key-2 + steam n’ont pas de prix par défaut.

Erreur : les groupes game-key-1 + steam et game-key-2 + steam ont US indiqué comme pays pour les prix par défaut.

Erreur : les groupes virtual-item-1 et bundle-1 n’ont pas de prix par défaut.

Erreur : les groupes virtual-item-1 et bundle-1 ont US indiqué comme pays pour les prix par défaut.

Erreur 1 : le groupement incorrect des objets par SKU a conduit à l’identification de cinq entités au lieu des trois.
Erreur 2 : le groupe 3 n’a pas de prix par défaut en raison d’un groupement incorrect.
Erreur 3 : le groupe 4 écrasera les données du groupe 2, car il contient un ensemble complet de prix pour le même objet. Par conséquent, le SKU pour virtual-currency-1-pack-100 ne comportera qu’un prix en MYR après l’importation.

Importation de fichiers

Pour importer des prix à partir d’un fichier :

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, appuyez sur Items catalog et accédez à la section contenant n’importe quel type d’objet.
3. Appuyez sur Import prices.

4. Dans la fenêtre d’importation, vous pouvez télécharger le modèle de fichier et ajouter les valeurs.
5. Téléchargez le fichier dans le champ correspondant de la fenêtre d’importation.
6. En cas d’erreur lors de l’importation, la fenêtre d’importation affiche une liste de ces erreurs ainsi que des recommandations de correction. Apportez les modifications nécessaires au fichier et téléchargez-le à nouveau.

Après un téléchargement réussi, les prix régionaux des objets ayant les UGS spécifiées seront mis à jour en fonction des prix figurant dans le fichier. Les prix spécifiés précédemment seront supprimés.

Example:

Plusieurs prix sont indiqués dans différentes devises et plusieurs prix régionaux sont définis pour l’objet dans le Compte éditeur. Cependant, dans le fichier importé, il n’y a qu’un seul prix en euros. Après l’importation du fichier, seul un prix en euros sera spécifié pour cet objet dans le Compte éditeur.

Vous pouvez également définir des prix régionaux lors de l’importation d’objets à l’aide de l’appel API de fichier Import items via JSON.

Configuration à l'aide des méthodes API

Pour définir les prix régionaux à l’aide des méthodes API, passez un tableau d’objets contenant les paramètres de prix pour les pays :

• dans les méthodes de création et de mise à jour des objets virtuels ;
• dans les méthodes de création et de mise à jour de la monnaie virtuelle ;
• dans les méthodes de création et de mise à jour des packages de monnaie virtuelle ;
• dans les méthodes de création et de mise à jour des lots ;

• dans les méthodes de création et de mise à jour des packages de clés de jeu.

 1"prices": [
 2  {
 3    "amount": 100,
 4    "currency": "USD",
 5    "is_enabled": true,
 6    "is_default": true
 7  },
 8  {
 9    "amount": 200,
10    "currency": "CZK",
11    "country_iso": "CZ",
12    "is_enabled": false,
13    "is_default": false
14  }
15]