Restrictions régionales de vente

Comment ça marche

Les restrictions régionales de vente vous permettent de contrôler dans quels pays les objets peuvent être vendus 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é dans le paramètre country lors de la requête du catalogue à l’aide des appels API des sous-sections Catalogue des groupes Clés de jeu et Objets et monnaie virtuels. Si ce paramètre n’est pas fourni, le pays est déterminé à partir de l’adresse IP de l’utilisateur. Le système génère ensuite un catalogue des objets disponibles dans le pays de l’utilisateur.

Qui peut l'utiliser

Les partenaires qui souhaitent limiter la disponibilité dans certains pays ou certaines régions.

Flux d'intégration

Note
Si des régions spécifiques sont définies pour un objet et que le pays de l’utilisateur n’en fait pas partie, l’objet n’est pas disponible dans ce pays.
Pour configurer des restrictions régionales de vente :
  1. Créez des régions dans lesquelles les objets seront disponibles via l’appel API Créer une région. L’API renvoie l’ID de la région, dont vous aurez besoin à 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 dans le tableau regions lors de la création ou de la mise à jour d’un objet à l’aide des appels API correspondants de la sous-section Administrateur :
Exemple d’un tableau regions avec les ID des régions où l’objet peut être vendu :
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: 13 Février 2026

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.