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

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

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

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

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

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

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

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

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

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

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

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

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

Пример ответа на вебхук с атрибутами пользователей:

 1{
 2  "sku": "game_1",
 3  "name": "Game name",
 4  "groups": [
 5    {
 6      "external_id": "all",
 7      "name": "All games"
 8    },
 9    {
10      "external_id": "Xsolla",
11      "name": "Xsolla games"
12    }
13  ],
14  "type": "game_key",
15  "description": "Game description",
16  "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
17  "attributes": {
18    "$ref": "../components/examples/client-attribute-game-horror.yaml#/value"
19  },
20  "is_free": false,
21  "price": {
22    "amount": "30.5",
23    "amount_without_discount": "30.5",
24    "currency": "USD"
25  },
26  "virtual_prices": [],
27  "can_be_bought": true,
28  "drm_name": "Steam",
29  "drm_sku": "steam",
30  "has_keys": true,
31  "is_pre_order": true,
32  "release_date": "2020-08-11T10:00:00+03:00",
33  "limits": {
34    "per_user": {
35        "total": 5,
36        "available": 5
37    },
38    "per_item": null
39  },
40}