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

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

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

Примечание
Для корректного отображения количества ключей, которое доступно пользователю, рекомендуем настроить аутентификацию через Xsolla Login. Для неавторизованного пользователя доступное количество ключей будет возвращаться к исходному показателю при каждом открытии каталога игр.

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

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

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

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

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

Примечание

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

При открытии платежного интерфейса и оплате ключа все неоплаченные заказы с этим ключом становятся недействительными.

Пример: пользователь может открыть форму оплаты ключа с ограничением на покупку в нескольких вкладках браузера, пока ключ не был куплен. Это автоматически приводит к созданию нескольких заказов на один ключ. После покупки ключа на одной вкладке Xsolla аннулирует все неоплаченные заказы с ключом.

Для кого подходит

Для партнеров, у которых подключен продукт Buy Button и модуль Игровые ключи.

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

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

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

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

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

Пример ответа:

Copy
Full screen
Small screen

{
  "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
  },
}
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 22 января 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!