Restrictions régionales de vente

Comment ça marche

Les restrictions de vente régionales vous permettent de contrôler dans quels pays les clés de jeu peuvent être vendues et contribuent à prévenir les abus ; par exemple, lorsqu’un utilisateur achète une clé à prix réduit dans une région et l’active dans une autre.

Le pays de l’utilisateur est passé via le paramètre country lors de la requête du catalogue (appel API Lire la liste des jeux). Si ce paramètre n’est pas fourni, le pays est déterminé à partir de l’adresse IP de l’utilisateur. Le catalogue est ensuite généré en fonction du pays de l’utilisateur.

Avis
Lorsque les restrictions de vente régionales sont activées, un pays doit appartenir à au moins une région pour que les clés puissent y être vendues. Si un pays n’appartient à aucune région, la vente de clés y sera impossible.

Qui peut l'utiliser

Les partenaires qui souhaitent limiter la disponibilité des clés de jeu dans certaines régions.

Flux d'intégration

Pour configurer des restrictions régionales :

  1. Créez les régions où les UGS de jeux seront disponibles en appelant l’API Créer une région. L’API renvoie l’ID de la région, nécessaire à l’étape suivante.

Exemple de création d’une région Amérique du Nord incluant les États-Unis et le Canada :

Copy
Full screen
Small screen
1{
2  "name": {
3     "en-US": "North America",
4   },
5  "countries": ["US", "CA"]
6}
Note
Le code pays est spécifié dans le format ISO 3166-1 alpha-2. Consultez la liste des pays pris en charge par Xsolla avant de créer une région.

  1. Passez l'ID de la région au tableau regions en appelant l'API de la catégorie Admin du groupe Clés du jeu lors de la création ou du téléchargement d'un jeu.

Exemple d’un tableau regions avec les ID des régions où les clés de jeu peuvent être vendues :

Copy
Full screen
Small screen
1"regions": [
2  {
3     "id": 123
4  },
5  {
6     "id": 456
7  }
8]
Avis
Une fois les régions configurées et assignées à un jeu, les clés ne peuvent être téléchargées qu’en utilisant l’appel API Télécharger des codes.
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 19 Septembre 2025

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !
Impossible d'envoyer votre commentaire
Réessayez plus tard ou contactez-nous à doc_feedback@xsolla.com.