Restrictions de vente de clés

Comment ça marche

Vous pouvez limiter le nombre de clés de jeu que l’utilisateur peut acheter.

Si l’utilisateur a atteint la limite spécifiée, il ne sera plus en mesure d’acheter des clés supplémentaires et une erreur avec le code 0401-1421 sera renvoyée. Dans ce cas, vous devez informer l’utilisateur qu’il a atteint la limite d’achat.

Vous pouvez afficher le nombre maximal de clés de jeux disponibles pour l’utilisateur ainsi que le nombre de clés restant.

Au fur et à mesure de la vente des clés, vous serez averti par e-mail lorsqu’il restera 25 %, 10 % et 0 % de clés téléchargées dans chaque package. Vous serez averti si vous avez l’un des rôles suivants dans le Compte éditeur :

• développeur ;
• propriétaire.

Seul le propriétaire du projet peut modifier les rôles dans le Compte éditeur dans la section Company settings > Users.

Comment configurer

Pour définir une limite d’achat lors de la création d’un package de clés de jeu dans le Compte éditeur, réglez la bascule Limit number of times one user can buy game key sur On et spécifiez le nombre de fois que la clé peut être achetée.

Utilisez les méthodes de la sous-section Catalogue du groupe de méthodes Clés de jeu pour obtenir des informations sur les clés de jeu.

Dans la réponse, vous recevrez les informations suivantes en plus des informations sur la clé de jeu :

• le nombre maximum de clés de jeu que l’utilisateur peut acheter ;
• le nombre restant de clés de jeu que l’utilisateur peut acheter.

Exemple de réponse avec les attributs utilisateur :

{
  "sku": "game_1",
  "name": "Game name",
  "groups": [
    {
      "external_id": "all",
      "name": "All games"
    },
    {
      "external_id": "Xsolla",
      "name": "Xsolla games"
    }
  ],
  "type": "game_key",
  "description": "Game description",
  "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
  "attributes": {
    "$ref": "../components/examples/client-attribute-game-horror.yaml#/value"
  },
  "is_free": false,
  "price": {
    "amount": "30.5",
    "amount_without_discount": "30.5",
    "currency": "USD"
  },
  "virtual_prices": [],
  "can_be_bought": true,
  "drm_name": "Steam",
  "drm_sku": "steam",
  "has_keys": true,
  "is_pre_order": true,
  "release_date": "2020-08-11T10:00:00+03:00",
  "limits": {
    "per_user": {
        "total": 5,
        "available": 5
    },
    "per_item": null
  },
}