Prix locaux

Vous pouvez définir des prix régionaux pour tous les objets de votre catalogue afin d’augmenter les ventes dans les pays à faible pouvoir d’achat. 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 de la manière suivante :

• à l’aide des méthodes API

Comment ça marche

Le prix de l’objet est déterminé lors de la demande du catalogue, en fonction du pays de l’utilisateur. Pendant l’achat via Pay Station, le prix de l’objet est converti dans la devise du pays de l’utilisateur et inclut les taxes, le cas échéant.

Détermination du pays

Le pays de l’utilisateur est déterminé à différentes étapes de l’utilisation du catalogue et du paiement, comme suit :

• Lors de la requête du catalogue des objets, le pays de l’utilisateur est transmis dans le paramètre country des méthodes des groupes Virtual items and currency ou Game keys.

  Si le pays n’est pas spécifié, il est déterminé à partir de l’adresse IP de l’utilisateur. Les prix du catalogue d’objets sont alors sélectionnés en fonction du pays de l’utilisateur.

• Lors de l’achat d’un objet :

  • Si vous utilisez les méthodes client pour obtenir un jeton de paiement, utilisez-les côté client et non côté serveur. Le pays et la devise dans les méthodes client sont déterminés par l’adresse IP de l’utilisateur. L’utilisation des méthodes client côté serveur peut entraîner une détermination incorrecte de la devise et affecter les modes de paiement dans l’interface de paiement.

  • Si vous utilisez la méthode serveur Create payment token for purchase, transmettez le pays dans le paramètre user.country.value du corps de la requête ou l’adresse IPv4 de l’utilisateur dans l’en-tête X-User-Ip. Si les deux valeurs sont transmises, user.country.value est prioritaire. Les adresses IPv6 ne sont pas prises en charge : en transmettre une peut entraîner une détection incorrecte du pays et de la devise.

  Note

  Vous pouvez transmettre la devise dans le paramètre settings.currency. Cette valeur a priorité sur la valeur du pays et influe sur l’affichage de la devise de paiement. Les modes de paiement dans l’interface de paiement restent toutefois déterminés par la valeur du pays dans le paramètre user.country.value.

Principes d’affichage des prix dans le catalogue d’objets

Utilisez la même liste de devises pour tous les objets du catalogue. Les prix sont traités selon la logique suivante :

• Si au moins un objet n’a pas de prix défini pour le pays sélectionné, les prix de l’ensemble du catalogue d’objets dans ce pays basculent vers 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 dans le catalogue	Commentaire
USA	7 USD	Les États-Unis utilisent l’USD. Aucun prix spécial pour les États-Unis n’est défini.
Japan	7 USD	La devise du Japon n’est pas spécifiée, le prix s’affiche donc dans la devise par défaut.
France	6 EUR	La France utilise l’EUR. Aucun prix spécial pour la France n’est défini.
Germany	8 EUR	Un prix régional est spécifié pour l’Allemagne.
Italy	5 EUR	Un prix régional est spécifié pour l’Italie.
Malaysia	20 MYR	Un prix régional est spécifié pour la Malaisie.
South Africa	90 ZAR	Un prix régional est spécifié pour l’Afrique du Sud.

Le projet comporte des prix dans les devises suivantes :

• le prix par défaut pour tous les objets est 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 comporte des prix dans les devises suivantes :

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

Dans ce cas, pour les utilisateurs d’Afrique du Sud, le prix doit s’afficher dans la devise par défaut du premier objet du catalogue — 1_test_item.

La devise par défaut du 1_test_item est l’USD. Elle ne correspond pas à la devise par défaut du 2_test_item — l’EUR. De plus, il n’y a pas de prix en USD dans sa liste de prix.

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

Pour créer un objet virtuel avec prix régional :

2. Cliquez sur Create manually, puis sélectionnez Virtual item dans la liste déroulante.

3. Dans la section General settings, indiquez les éléments suivants :
   • SKU
   • Un ou plusieurs groupes auxquels l’objet doit appartenir (facultatif)
   • Name
   • Short description
   • Extended description — pour l’ajouter, activez la bascule correspondante (facultatif)

4. Dans la section Media, téléchargez une ou plusieurs images ou vidéos (facultatif) — depuis votre appareil ou via un lien. Dans le magasin créé avec l’éditeur de site Xsolla, toutes les fiches d’objet affichent le fichier marqué comme Main, tandis que les autres fichiers ne sont disponibles que dans les fiches avec galerie de médias. Le fichier marqué comme Main est également renvoyé dans les réponses des appels API de récupération du catalogue.

5. Dans la section Price settings, sélectionnez Paid item.

6. Activez la bascule Real currency prices et cliquez sur Set up prices.

7. Dans la fenêtre qui s’ouvre, indiquez la devise et le prix par défaut. Vous pouvez remplacer l’USD par une autre devise par défaut.

8. Configurez les prix régionaux. Deux méthodes sont possibles, 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 pour lesquels vous n’avez pas besoin de définir de prix régionaux, cliquez sur l’icône moins à droite du prix.

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

4. Cliquez sur Apply.

9. Si vous souhaitez ajouter un prix en monnaie virtuelle, activez la bascule Virtual currency prices et indiquez les valeurs.

10. Pour limiter le nombre d’objets disponibles à l’achat :

    1. Activez la bascule dans la section Limits et indiquez la quantité.
    2. Configurez la fréquence de réinitialisation de la limite. Pour cela, sélectionnez une période dans la liste déroulante :
       • Daily.
       • Weekly.
       • Monthly.
       • Custom interval. L’intervalle est calculé à partir de la date de début d’affichage de l’objet dans le magasin.
       • No regular refresh.
    3. Définissez le planning de réinitialisation en précisant les paramètres correspondant à la période sélectionnée.

11. Pour définir une durée d’affichage limitée pour l’objet (facultatif) :

    1. Activez la bascule dans la section Add specific display period.
    2. Indiquez le fuseau horaire ainsi que le début et la fin de la période.

    Pour laisser la fin de la période d’affichage indéfinie, activez la bascule No end date.

12. Configurez les attributs à l’aide de l’une des options suivantes (facultatif) :
    1. Ajouter des attributs et leurs valeurs au format JSON.
    2. Créer manuellement des attributs et leurs valeurs et les lier aux objets.

13. Si l’objet payant sera utilisé dans des mécaniques avec récompense aléatoire (par exemple, loot boxes ou gacha), activez la bascule Mark as paid randomized reward.

14. Cliquez sur Create.

15. Dans la fenêtre qui s’ouvre, sélectionnez le statut de l’objet et cliquez sur Continue.

L’objet créé apparaît dans la section All items.

Pour modifier les prix :

2. Cliquez sur ⋮ à côté de l’objet souhaité et sélectionnez Edit dans la liste déroulante.

3. Dans la section Price settings, cliquez sur l’icône d’édition sous le prix par défaut.

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

Fonctionnalités :

• Importer ou mettre à jour des prix régionaux pour plusieurs objets en une fois.
• Prise en charge des objets de tous types:
  • objets virtuels
  • monnaie virtuelle
  • packages de monnaie virtuelle
  • lots
  • packages de clés de jeu sur une plateforme spécifique
• Validation des données importées. Si la structure du fichier ou le format des données ne répondent pas aux exigences, une liste d’erreurs s’affiche lors de l’import.

Structure du fichier

Colonnes obligatoires du fichier :

• SKU — l’UGS de l’objet pour lequel définir des prix régionaux.
• Country — le code pays au format ISO 3166-1 alpha-2. Vérifiez la liste des pays pris en charge par Xsolla avant d’importer le fichier CSV. Le remplissage de cette colonne est facultatif. Vous pouvez consulter des exemples d’affichage des prix si le pays n’est pas spécifié.
• Currency — le code devise au format ISO 4217.
• Amount — le prix de l’objet. Utilisez un point pour les décimales.
• IsDefault — indique s’il s’agit du prix par défaut. Spécifiez :
  • 1 — pour la ligne avec le prix par défaut. Il s’affiche dans tous les pays sans prix régionaux.
  • 0 — pour toutes les autres lignes. Vous pouvez aussi laisser la cellule de la colonne IsDefault vide.

Note

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

EXEMPLE

Fichier correctement rempli (plusieurs objets, 3 devises, des prix régionaux sont disponibles).

Fichier mal rempli (plusieurs objets, 3 devises, des prix régionaux sont disponibles).
Erreur : pour 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 objets, 3 devises, des prix régionaux sont disponibles).

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

• Platform — l’UGS de la plateforme. Utilisée pour définir des prix régionaux des clés de jeu, non utilisée pour les 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 ayant la même UGS mais des plateformes différentes sont considérées comme des entités distinctes. Chaque entité doit avoir un prix spécifié dans la devise par défaut.

EXEMPLE

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

Fichier mal rempli (plusieurs clés de jeu, 3 devises, des prix régionaux sont disponibles, 2 plateformes).
Erreur 1 : regrouper incorrectement les clés de jeu par SKU et Platform entraîne la détection 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 à cause du mauvais regroupement.
Erreur 3 : le groupe 9 écrasera les données du groupe 7 car ils contiennent l’ensemble complet de prix pour la même entité. En conséquence, la game-key-2 pour la plateforme playstation n’aura qu’un prix en MYR après l’import.

Exemples de remplissage du fichier et erreurs possibles

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

• 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

Exemples de remplissage incorrect du fichier CSV pour l’import :

• 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 devises 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 : regroupement incorrect des objets par SKU, entraînant la détection de cinq entités au lieu de trois.
Erreur 2 : le groupe 3 n’a pas de prix par défaut en raison du mauvais regroupement.
Erreur 3 : le groupe 4 écrasera les données du groupe 2, car ils ont un ensemble complet de prix pour le même objet. En conséquence, l’SKU pour virtual-currency-1-pack-100 n’aura qu’un prix en MYR après l’import.

Import du fichier

Pour importer des prix à partir d’un fichier :

3. Cliquez sur Import/Export et, dans la liste déroulante du bloc Import, sélectionnez Prices from CSV.

4. Téléchargez le fichier dans le champ correspondant de la fenêtre d’import.

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 :

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

Paramétrage via les 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

Exemple du tableau :

 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]