Prix régionaux

Lors de la configuration du catalogue des objets, vous pouvez définir des politiques de prix pour les utilisateurs de différents pays (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 de clés de jeu est défini en USD. Vous pouvez définir des restrictions régionales et des prix régionaux en même temps.

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, veillez à utiliser une même liste de devises dans lesquelles 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 la devise par défaut varie pour les objets, les prix seront affichés dans la devise par défaut du premier objet du catalogue. Si l’un des objets ne comporte pas de prix dans cette devise, une valeur de prix null lui sera attribuée dans la réponse. Cela pourrait entraîner un affichage incorrect du prix de l’objet et potentiellement affecter l’affichage global du catalogue.

Exemples :

• 1 objet, 1 devise, pas de prix régionaux
• 1 objet, 2 devises, 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.

Deux options de prix sont définies pour l’objet : en USD et en EUR ; mais les prix spécifiques aux pays ne sont pas spécifiés. Dans ce cas, les utilisateurs des pays où l’EUR est utilisé verront le prix en 7 EUR. Pour tous les autres pays, le prix affiché sera 5 USD, car c’est la devise par défaut.

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.

Qui peut l'utiliser

Les partenaires qui souhaitent stimuler leurs ventes dans les pays à faible pouvoir d’achat en définissant des politiques de prix pour les utilisateurs de différents pays.

Comment configurer

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.

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

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Store.
3. Dans le volet Virtual Items, cliquez sur Configure.
4. Cliquez sur + et sélectionnez Create item dans la liste déroulante.

5. Spécifiez :
   • l'image ;
   • l'UGS ;
   • le ou les groupes auxquels l'objet doit appartenir ;
   • le nom ;
   • la description ;
   • la propriété de l'objet — consommable, non consommable ou à durée limitée.
6. Dans le bloc Price settings, choisissez Paid item.
7. Réglez la bascule Pricing in real currency sur On et spécifiez le prix. Si vous ne définissez pas de prix régionaux, le prix de l'objet sera le même pour tous les pays, et ce, en dollars américains.

8. Définissez les prix :
   • Pour définir le prix d'un objet dans différentes devises, cliquez sur + et spécifiez la devise et le prix ;
   • Pour définir des prix spéciaux pour des pays, cliquez sur Add pricing et spécifiez le pays, la devise et la quantité. Définissez autant de prix régionaux que vous souhaitez.
9. Pour ajouter le prix en monnaie virtuelle, réglez la bascule Pricing in virtual currency sur On et spécifiez le prix.
10. Pour limiter la disponibilité des objets à des utilisateurs spécifiques, réglez la bascule Limit number of times one user can buy this item sur On et précisez le nombre.
11. Pour afficher un objet dans Store, réglez la bascule Show item in store sur On.
12. Cliquez sur Create item.

Importer à partir d'un fichier dans le Compte éditeur

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

• 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
      }
    ]