Ограничения на продажу ключей

Как это работает

Вы можете ограничить количество игровых ключей, которое доступно пользователю для покупки.

Если пользователь купил все игровые ключи в рамках заданного ограничения, ключ будет недоступен для покупки: вернется ошибка с кодом 0401-1421. В этом случае отобразите пользователю информацию о превышении ограничения на покупку.

Вы можете отобразить в интерфейсе максимальное доступное количество ключей и оставшееся количество ключей, которое доступно пользователю.

По мере продажи ключей вы будете получать уведомления по электронной почте, когда останется 25%, 10% и 0% загруженных ключей в каждом из пакетов. Вы получите уведомление, если у вас одна из следующих ролей в Личном кабинете:

• разработчик;
• владелец.

Изменить роли может владелец проекта в Личном кабинете в разделе Настройки компании > Пользователи.

Как настроить

Чтобы задать ограничение на покупку, при создании пакета игровых ключей в Личном кабинете установите переключатель Ограничивать покупку ключей пользователем в положение Вкл и укажите доступное для покупки количество.

Вы можете получить информацию об игровых ключах, используя методы подраздела Catalog из группы методов Игровые ключи.

В ответе, кроме информации об игровом ключе, вы получите следующую информацию:

• максимальное количество ключей, которое может купить пользователь;
• оставшееся количество ключей, доступное пользователю для покупки.

Пример ответа c атрибутами пользователей:

{
  "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
  },
}