Prix locaux

Les partenaires qui souhaitent augmenter leurs ventes dans les pays à faible pouvoir d’achat peuvent configurer des politiques de prix régionaux, permettant d’adapter le coût des biens aux utilisateurs de différents pays.

Lors de la configuration du catalogue des objets, vous pouvez établir des prix régionaux pour les objets virtuels et les packages de clés de jeu. Par défaut, le prix de chaque objet ou package est fixé en USD. Vous pouvez définir des restrictions régionales et des prix régionaux en même temps.

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

• dans le Compte éditeur lors de la création/modification d’un objet ;
• dans le Compte éditeur lors de l’importation des prix à partir d’un fichier ;
• à 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 pour 1_test_item est l’USD, ce qui diffère de la devise par défaut pour 2_test_item, qui est l’EUR. De plus, aucun prix en USD n’est répertorié pour cet objet dans la liste des prix.

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 votre projet dans le Compte éditeur, accédez à la section Store > Objets virtuels et cliquez sur Configurer.
2. Cliquez sur + et sélectionnez Créer un objet dans la liste déroulante.

3. Ajoutez :
   • l'image ;
   • l'UGS ;
   • le ou les groupes auxquels l'objet doit appartenir ;
   • la description ;
   • la propriété de l'objet (consommable, non consommable ou à durée limitée).
4. Dans le bloc Paramètres de prix, choisissez Objet payant.
5. Réglez la bascule Prix en devises réelles sur On et cliquez sur Configurer les prix.

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. Vous pouvez le faire de deux manières, manuellement ou automatiquement :
   • Pour définir les prix manuellement :
   1. Cliquez sur + Ajouter un prix local et ajoutez les prix ligne par ligne.
   2. Cliquez sur Appliquer.

• Pour définir les prix automatiquement :
1. Cliquez sur Calculate using default price. Une liste de pays est générée par ordre alphabétique et le prix dans la devise régionale est calculé pour chaque pays en fonction des taux de change et des taxes.
2. Pour supprimer les pays pour lesquels les prix régionaux ne sont pas nécessaires, cliquez sur l'icône X à droite du prix.

3. Pour modifier un prix calculé automatiquement, changez la valeur dans la ligne correspondante.
4. Cliquez sur Appliquer les modifications.

8. Si vous souhaitez ajouter le prix en monnaie virtuelle, réglez la bascule Prix en monnaie virtuelle sur On et indiquez le prix.
9. Si vous souhaitez limiter la disponibilité des objets pour des utilisateurs spécifiques, réglez la bascule Limiter le nombre de fois que l'utilisateur peut acheter cet objet sur On et spécifiez le nombre.
10. Si vous souhaitez afficher l'objet dans le magasin, réglez la bascule Afficher l'objet dans le magasin sur On.
11. Cliquez sur Créer un objet.

Pour modifier les prix :

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Store > Objets virtuels.
2. Cliquez sur ⋯ à côté de l’objet souhaité et sélectionnez Modifier l’objet dans la liste déroulante.
3. Dans la section Paramètres de prix, cliquez sur Modifier 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’affiche pendant l’importation.

Structure du fichier

• 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

• 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

SKU,Currency,Amount,Country,IsDefault
virtual-item-1,EUR,9.09,,0
virtual-item-1,USD,10.1,,1
virtual-item-1,MYR,47,,0
virtual-currency-1-pack-100,EUR,2.09,,0
virtual-currency-1-pack-100,USD,2.3,,1
virtual-currency-1-pack-100,MYR,24,,0
bundle-1,EUR,15,,0
bundle-1,USD,17,,1
bundle-1,MYR,82,,0

Copy

Full screen

Small screen

• csv

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

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault,Platform
game-key-1,EUR,9.09,,1,steam
game-key-1,EUR,9.2,DE,0,steam
game-key-1,EUR,8.09,IT,0,steam
game-key-1,USD,10.1,US,0,steam
game-key-1,MYR,47,MY,0,steam
game-key-2,EUR,2.09,,1,steam
game-key-2,EUR,2.2,DE,0,steam
game-key-2,EUR,1.79,IT,0,steam
game-key-2,USD,2.3,US,0,steam
game-key-2,MYR,24,MY,0,steam

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault,Platform
game-key-1,USD,10.1,,1,steam
game-key-1,EUR,9.09,,0,steam
game-key-1,MYR,47,,0,steam
game-key-1,USD,17,,1,playstation
game-key-1,EUR,15,,0,playstation
game-key-1,MYR,82,,0,playstation
game-key-2,USD,2.3,,1,steam
game-key-2,EUR,2.09,,0,steam
game-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

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Store et accédez à la section contenant n’importe quel type de bien.
3. Cliquez 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.

Exemple :

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.

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.

"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]